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
  20 It contains the content itself.
  21
  22 @item feed.download
  23 Used as intermediate target for the @command{redo} build system and
  24 contains SHA-512 hash of the @file{feed} file. It is used to nearly
  25 completely skip file copying/moving on filesystem if feed was not
  26 modified.
  27
  28 @item title
  29 Automatically generated file with the title of the feed.
  30
  31 @item cur/, new/, tmp/
  32 Directories necessary for making the directory Maildir mailbox. They
  33 contain parsed news posts.
  34
  35 @end table