doc/storage.texi

   1 @node Storage
   2 @unnumbered Storage
   3
   4 Each feed is kept in separate subdirectory in the @file{feeds/}. Its
   5 name is not important, but human readable is preferable choice. It
   6 contains:
   7
   8 @table @file
   9
  10 @item url
  11 File with the URL of the feed. This is the only file you have to
  12 manually deal with.
  13
  14 @item etag, hdr, out
  15 Those files are used by @command{curl} to keep the content, its proper
  16 @code{mtime} (for @code{If-Modified-Since} header generation),
  17 @code{ETag} and response headers for debugging.
  18
  19 @item feed.zst
  20 It contains the content itself. Compressed with
  21 @url{https://facebook.github.io/zstd/, Zstandard}.
  22
  23 @item download.hash, parse.hash
  24 SHA-512 hash of the @file{feed.zst}, used to determine if feed was
  25 updated and parser has to do the job.
  26
  27 @item title
  28 Automatically generated file with the title of the feed.
  29
  30 @item cur/, new/, tmp/
  31 Directories necessary for making the directory Maildir mailbox. They
  32 contain parsed news posts.
  33
  34 @end table