This file is indexed.

/usr/include/syndication/atom/entry.h is in kdepimlibs5-dev 4:4.14.2-2+deb8u2.

This file is owned by root:root, with mode 0o644.

The actual contents of the file can be viewed below.

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
/*
 * This file is part of the syndication library
 *
 * Copyright (C) 2006 Frank Osterfeld <osterfeld@kde.org>
 *
 * This library is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Library General Public
 * License as published by the Free Software Foundation; either
 * version 2 of the License, or (at your option) any later version.
 *
 * This library is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 * Library General Public License for more details.
 *
 * You should have received a copy of the GNU Library General Public License
 * along with this library; see the file COPYING.LIB.  If not, write to
 * the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
 * Boston, MA 02110-1301, USA.
 *
 */

#ifndef SYNDICATION_ATOM_ENTRY_H
#define SYNDICATION_ATOM_ENTRY_H

#include <syndication/elementwrapper.h>
#include <syndication/specificitem.h>

#include <QtCore/QList>

#include <ctime>

class QDomElement;
class QString;

namespace Syndication {

class SpecificItemVisitor;

namespace Atom {

class Category;
class Content;
class Link;
class Person;
class Source;

/**
 * an Atom entry, equivalent to the "items" in the RSS world.
 *
 * @author Frank Osterfeld
 */
class SYNDICATION_EXPORT Entry : public ElementWrapper, public SpecificItem
{
    public:

        /**
         * creates a null entry object
         */
        Entry();

        /**
         * creates an Entry object wrapping an atom:entry element.
         * @param element a DOM element, should be a atom:entry element
         * (although not enforced), otherwise this object will not parse
         * anything useful
         */
        explicit Entry(const QDomElement& element);

        /**
         * Used by visitors for double dispatch. See SpecificVisitor
         * for more information.
         * @param visitor the visitor calling the method
         */

        bool accept(SpecificItemVisitor* visitor);

        /**
         * list of persons who are authors of this entry. (required)
         *
         * If the entry itself does not have explicit author description,
         * its source author description is used. If none of these exist,
         * the list of authors of the containing feed is used. That list
         * is set by setFeedAuthors().
         */
        QList<Person> authors() const;

        /**
         * a list of categories this entry is filed to (optional)
         */
        QList<Category> categories() const;

        /**
         * list of persons contributing to this entry (optional)
         */
        QList<Person> contributors() const;

        /**
         * ID of the article. (required)
         * The ID must be unique inside this feed. The atom spec defines it as a
         * URI (which is not enforced by this parser)
         */
        QString id() const;

        /**
         * links pointing to associated web sites and other resources.
         *
         * Links are optional if the entry provides Content.
         * Otherwise, it must contain at least one link with
         * a @c rel value of @c "alternate". (see Link).
         */
        QList<Link> links() const;

        /**
         * copyright information (optional)
         *
         * @return copyright information for the entry (intended for human
         * readers), or a null string if not specified
         */
        QString rights() const;

        /**
         * source description of the content (optional)
         *
         * If the content was copied from another feed, this object contains
         * information about the source feed.
         *
         * @return source description, or a null object if not
         * specified
         */
        Source source() const;

        /**
         * The datetime of the publication of this entry (optional).
         *
         * @return the publication date in seconds since epoch
         */
        time_t published() const;

        /**
         * The datetime of the last modification of this entry (required).
         *
         * @return the modification date in seconds since epoch
         */
        time_t updated() const;

        /**
         * a short summary, abstract or excerpt of an entry. (optional)
         * This is usually more verbose than title() and but does not
         * contain the whole content as content() does.
         *
         * @return the summary as HTML, or a null string if not specified
         */
        QString summary() const;

        /**
         * title of the entry (required).
         *
         * @return the title as HTML
         */
        QString title() const;

        /**
         * content of the entry (optional)
         * See @ref Content for details
         *
         * @return entry content, or a null content object if not specified
         */
        Content content() const;

        /**
         * returns all child elements of this entry not covered by this class.
         * This can be used to access additional metadata from Atom extensions.
         */
        QList<QDomElement> unhandledElements() const;

        /**
         * Sets the list of the containing feed's authors, which will be used
         * as a fallback in authors() in case both the entry itself and its
         * source have no explicit author description.
         * @param feedAuthors the list of feed's authors
         */
        void setFeedAuthors(const QList<Person>& feedAuthors);
        
        /**
         * returns a description of this entry for debugging purposes
         *
         * @return debug string
         */
        QString debugInfo() const;

    private:

        QList<Person> m_feedAuthors;
};


} // namespace Atom
} // namespace Syndication

#endif // SYNDICATION_ATOM_ENTRY_H