This file is indexed.

/usr/include/syndication/atom/link.h is in kdepimlibs5-dev 4:4.8.5-0ubuntu0.3.

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
/*
 * 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_LINK_H
#define SYNDICATION_ATOM_LINK_H

#include <syndication/elementwrapper.h>

class QDomElement;
class QString;

namespace Syndication {
namespace Atom {
/**
 * A link, pointing to webpages, media files on the web ("podcast"),
 * related content, etc. See rel() for details.
 *
 * @author Frank Osterfeld
 */
class SYNDICATION_EXPORT Link : public Syndication::ElementWrapper
{
    public:

        /**
         * creates a null link object.
         */
        Link();

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

        /**
         * URL of the referenced resource (required)
         */
        QString href() const;

        /**
         * the relation between the feed/entry and the linked resource.
         *
         * The value of rel() is usually one of the following:
         *
         * @c "alternate": The URL points to an alternate version of the
         * feed/entry. In practice, this is the article described in an entry,
         * or the homepage of the feed.
         *
         * @c "enclosure": The link describes an Enclosure. See
         * Syndication::Enclosure for more information.
         *
         * @c "related": links to web resources with related content. E.g., an
         * article discussing KDE might link to the KDE homepage.
         *
         * @c "self": "identifies a resource equivalent to the containing
         * element". This is usually the URL of the feed source itself.
         *
         * @c "via": The link points to the source of the information contained
         * in the feed/entry
         *
         * @return the rel value specified in the feed. Default value is
         * @c "alternate"
         */
        QString rel() const;

        /**
         * MIME type of the linked resource. (optional)
         *
         * @return MIME type following (e.g., "text/html", "audio/mpeg"),
         * or a null string if not set
         */
        QString type() const;

        /**
         * the language of the linked resource. (optional)
         * If used together with a rel() value of "alternate", it
         * implies a translated version of the entry.
         *
         * @return a language tag as defined in RFC 3066,
         * or a null string if not specified
         */
        QString hrefLanguage() const;

        /**
         * human-readable information about the link. (optional)
         *
         * @return the link title as plain text ("<", "&" are text, not
         * markup!), or a null string if not specified
         */
        QString title() const;

        /**
         * size of the linked resource in bytes. (optional)
         *
         * @return file size in bytes, or 0 if not specified
         */
        uint length() const;

        /**
         * description of the link object for debugging purposes
         *
         * @return debug string
         */
        QString debugInfo() const;
};

} // namespace Atom
} // namespace Syndication

#endif // SYNDICATION_ATOM_LINK_H