summaryrefslogtreecommitdiff
path: root/sfeed.1
AgeCommit message (Collapse)Author
2023-01-07sfeed.1: reference sfeed_opml_importHiltjo Posthuma
It is used in the examples. (Do not directly reference iconv to keep some kind of clear reference list)
2022-05-02manual pages: properly escape some more backslashesHiltjo Posthuma
... and bump the date also.
2022-05-02manual pages: properly escape backslashesAnders Damsgaard
From the mdoc(7) extended introduction[0]: >To output a backslash, use the escape sequence ā€˜\eā€™. Never use the >escape sequence ā€˜\\ā€™ in any context. 0: https://mandoc.bsd.lv/mdoc/intro/escaping.html
2022-03-29sfeed.1: add an example to convert to UTF-8 using iconvHiltjo Posthuma
2021-11-26sfeed.1: add sfeed_curses exampleHiltjo Posthuma
2021-11-23sfeed.1: add a basic usage example for using the sfeed packageHiltjo Posthuma
"man sfeed" now hopefully more quickly gives a better overview how the tools work together. Reference the README for extended examples and use-cases.
2021-11-23sfeed.{1,5}: small rewording improvementHiltjo Posthuma
2021-11-23sfeed.{1,5}: the first author is parsedHiltjo Posthuma
The Atom RFC standard supports multiple authors, but this is usually one. The first author is parsed.
2021-10-25sfeed.{1,5}: small rewording for the '|' characterHiltjo Posthuma
2021-08-03man page improvementsHiltjo Posthuma
2021-07-06sfeed.{1,5}: number fields in the man pageHiltjo Posthuma
This makes it slightly easier to lookup fields and map the fields by field number in scripts (awk, cut) etc.
2021-04-28sfeed.{1,5}: improve documentation, the content-type field can be empty...Hiltjo Posthuma
... if there is no content.
2021-03-01sfeed.1: reference sfeed_update and sfeedrcHiltjo Posthuma
The shellscript is optional, but reference it in the documentation.
2021-03-01util: improve/refactor URI parsing and formattingHiltjo Posthuma
Removed/rewritten the functions: absuri, parseuri, and encodeuri() for percent-encoding. The functions are now split separately with the following purpose: - uri_format: format struct uri into a string. - uri_hasscheme: quick check if a string is absolute or not. - uri_makeabs: make a URI absolute using a base uri and the original URI. - uri_parse: parse a string into a struct uri. The following URLs are better parsed: - URLs with extra "/"'s in the path prepended are kept as is, no "/" is added either for empty paths. - URLs like "http://codemadness.org" are not changed to "http://codemadness.org/" anymore (paths are kept as is, unless they are non-empty and not start with "/"). - Paths are not percent-encoded anymore. - URLs with userinfo field (username, password) are parsed. like: ftp://user:password@[2001:db8::7]:2121/rfc/rfc1808.txt - Non-authoritive URLs like mailto:some@email.org, magnet URIs, ISBN URIs/urn, like: urn:isbn:0-395-36341-1 are allowed and parsed correctly. - Both local (file:///) and non-local (file://) are supported. - Specifying a base URL with a port will now only use it when the relative URL has no host and port set and follows RFC3986 5.2.2 more closely. - Parsing numeric port: parse as signed long and check <= 0, empty port is allowed. - Parsing URIs containing query, fragment, but no path separator (/) will now parse the component properly. For sfeed: - Parse the baseURI only once (no need to do it every time for making absolute URIs). - If a link/enclosure is absolute already or if there is no base URL specified then just print the link directly. There have also been other small performance improvements related to handling URIs. References: - https://tools.ietf.org/html/rfc3986 - Section "5.2.2. Transform References" have also been helpful.
2021-01-27typofixesHiltjo Posthuma
2021-01-02sfeed.1/sfeed_plain.1: add example, improve quoting the url for sfeed_web.1Hiltjo Posthuma
2020-10-12parse categories, add multiple field values support (for categories)Hiltjo Posthuma
Fields with multiple values are separated by '|'. In the future multiple enclosure support might be added. The categories tags are now parsed. This feature is useful for filtering and categorizing. Parsing of nested tags such as <author><name> has been improved. This code has been refactored. RSS <guid> isPermaLink is now handled differently also and will now prefer a permalink with "true" (link) over the ID. In practise multiple <guid> in an item does not happen.
2020-10-09man pages: tweak alignment of listsHiltjo Posthuma
2020-06-04sfeed.{1,5}: clarify the timestamp field a bitHiltjo Posthuma
In particular for RSS feeds where a pubDate is optional.
2020-03-15man pages (section 1): document exit statusHiltjo Posthuma
Document it so it can be relied upon in scripts.
2019-05-02sfeed.{1,5}: reword "saved" to outputHiltjo Posthuma
this program does not store anything, but just write to stdout.
2019-04-14sfeed: add support for the first enclosure of an itemHiltjo Posthuma
This is useful for example for podcasts (audio attachment), newsposts (usually some image) or comic strips (link to page, image as enclosure). thanks leot for the feedback!
2019-02-24documentation: fix typo to RFC reference for timestamps: RFC-3332 to RFC-3339Hiltjo Posthuma
2017-04-27man pages: fix a few warnings and improve a few wordsHiltjo Posthuma
- fix new warning check (start sentence at each line). - improve a few words.
2016-05-21improve wording in documentationHiltjo Posthuma
link to sfeed(5) in README to avoid having to duplicate documentation text.
2016-04-18simplify sfeed(5) format, remove feedtype alsoHiltjo Posthuma
Remove type of feed per item, it is not that interesting. sfeed(1) can parse both RSS and Atom feeds.
2016-04-10improve documentation, add sfeed(5) for the file formatHiltjo Posthuma
separate sfeed(5) page for just the feed file format.
2016-03-27time experimentHiltjo Posthuma
2016-01-31sfeed_frames.1: add a note about security considerationsHiltjo Posthuma
2015-09-23update documentation, dont use semantic Ar for non-argumentsHiltjo Posthuma
2015-08-07update documentationHiltjo Posthuma
2015-08-05improve man-pages and documentationHiltjo Posthuma
2015-07-29improve documentation: some fixesHiltjo Posthuma
2015-07-29update documentation regarding timezone parsingHiltjo Posthuma
Clarity CAVEAT concerning timezone parsing, some feeds incorrectly use non-RFC-822 timezones in RSS feeds, this will be interpreted as UTC+0. The formatted time will contain this timezone but without an offset.
2015-06-21improvementsHiltjo Posthuma
2015-05-24doc: fix warnings (mandoc -Tlint)Hiltjo Posthuma
and regenerate old man-style (make doc-oldman).
2015-01-04doc: improveHiltjo Posthuma
- mandoc: fix mandoc errors and warnings. - remove pre-generated HTML documentation.
2015-01-03time fixesHiltjo Posthuma
2015-01-02sfeed: add -v flag to display program versionHiltjo Posthuma
2015-01-02convert man pages to mandocHiltjo Posthuma
2014-05-08man pages: improve wordingHiltjo Posthuma
Signed-off-by: Hiltjo Posthuma <hiltjo@codemadness.org>
2014-05-08man pages: just hardcode versionHiltjo Posthuma
Signed-off-by: Hiltjo Posthuma <hiltjo@codemadness.org>
2012-08-06Change 'description' to 'content' in documentationHiltjo Posthuma
Signed-off-by: Hiltjo Posthuma <hiltjo@codemadness.org>
2012-08-03New initial repoHiltjo Posthuma
Signed-off-by: Hiltjo Posthuma <hiltjo@codemadness.org>