head 1.4; access; symbols pkgsrc-2013Q2:1.3.0.12 pkgsrc-2013Q2-base:1.3 pkgsrc-2013Q1:1.3.0.10 pkgsrc-2013Q1-base:1.3 pkgsrc-2012Q4:1.3.0.8 pkgsrc-2012Q4-base:1.3 pkgsrc-2012Q3:1.3.0.6 pkgsrc-2012Q3-base:1.3 pkgsrc-2012Q2:1.3.0.4 pkgsrc-2012Q2-base:1.3 pkgsrc-2012Q1:1.3.0.2 pkgsrc-2012Q1-base:1.3 pkgsrc-2011Q4:1.2.0.44 pkgsrc-2011Q4-base:1.2 pkgsrc-2011Q3:1.2.0.42 pkgsrc-2011Q3-base:1.2 pkgsrc-2011Q2:1.2.0.40 pkgsrc-2011Q2-base:1.2 pkgsrc-2011Q1:1.2.0.38 pkgsrc-2011Q1-base:1.2 pkgsrc-2010Q4:1.2.0.36 pkgsrc-2010Q4-base:1.2 pkgsrc-2010Q3:1.2.0.34 pkgsrc-2010Q3-base:1.2 pkgsrc-2010Q2:1.2.0.32 pkgsrc-2010Q2-base:1.2 pkgsrc-2010Q1:1.2.0.30 pkgsrc-2010Q1-base:1.2 pkgsrc-2009Q4:1.2.0.28 pkgsrc-2009Q4-base:1.2 pkgsrc-2009Q3:1.2.0.26 pkgsrc-2009Q3-base:1.2 pkgsrc-2009Q2:1.2.0.24 pkgsrc-2009Q2-base:1.2 pkgsrc-2009Q1:1.2.0.22 pkgsrc-2009Q1-base:1.2 pkgsrc-2008Q4:1.2.0.20 pkgsrc-2008Q4-base:1.2 pkgsrc-2008Q3:1.2.0.18 pkgsrc-2008Q3-base:1.2 cube-native-xorg:1.2.0.16 cube-native-xorg-base:1.2 pkgsrc-2008Q2:1.2.0.14 pkgsrc-2008Q2-base:1.2 cwrapper:1.2.0.12 pkgsrc-2008Q1:1.2.0.10 pkgsrc-2008Q1-base:1.2 pkgsrc-2007Q4:1.2.0.8 pkgsrc-2007Q4-base:1.2 pkgsrc-2007Q3:1.2.0.6 pkgsrc-2007Q3-base:1.2 pkgsrc-2007Q2:1.2.0.4 pkgsrc-2007Q2-base:1.2 pkgsrc-2007Q1:1.2.0.2 pkgsrc-2007Q1-base:1.2; locks; strict; comment @.\" @; 1.4 date 2013.07.02.01.13.30; author schmonz; state dead; branches; next 1.3; commitid ia8ovORoEVw1IPVw; 1.3 date 2012.04.04.14.27.41; author wiz; state Exp; branches; next 1.2; 1.2 date 2007.01.19.00.57.03; author schmonz; state Exp; branches; next 1.1; 1.1 date 2007.01.18.23.08.24; author schmonz; state Exp; branches; next ; desc @@ 1.4 log @Update to 3.5 (new upstream). From the changelog: v3.5 (2013-06-05) * Added digest generation and post-processing hooks. * Fix html2text configuration (ignored since 2012-10-04). * Fix opmlexport crash due to orphaned feed data. * Use feed names in OPML 'text' attributes. v3.4 (2013-05-14) * Added post-processing hooks for user-specified message manipulation. * Added settings for IMAP delivery. The old `use-smtp` boolean has been replaced by a new `email-protocol` setting. Non-IMAP users should adjust their configuration to set `email-protocol` to either `sendmail` or `smtp`. v3.3 (2013-04-13) * Fix SMTP message submission logic. * Fix error inheritence (super() calls). * Convert html2text parsing errors to `ProcessingError`s. * Cleanup html2text error handling. * Drop Google Reader rel-via manipulation. * Drop the wrapping elements from HTML mail v3.2 (2013-03-13) * Use extended interpolation in configuration files, to allow percent signs (%). * Added .as_string() fallback to email flattening (only used if `use-smtp = False` and `use-8bit = True`). * Added sendmail configuration option. Change this if you want to use an alternative, sendmail-compatible mailer. v3.1 (2013-02-14) * Import __url__, __author__, and __email__ in rss2email.error, which fixes bugs in formatting a number of errors. v3.0 (2013-02-13) * Changed project email (rss2email@@tremily.us) and homepage (http://github.com/wking/rss2email). * Split static configuration parameters into a ConfigParser-read config file (rss2email.cfg). Data that depends on the feed state is recorded using JSON (rss2email.json). * Use the XDG Base Directory Specification for standardized configuration and data file locations. * Converted the command line interface to argparse, with some restructuring along the way. * Added the r2e.1 man page (based on one from the Debian package). * Added setup.py and a PyPI page for simpler installation (http://pypi.python.org/pypi/rss2email). * Added Message-ID headers to outgoing email. * Added a test suite. * Upgraded to Python 3.2 to take advantage of cleaner Unicode handling and argparse. * Require Signed-off-by lines in new commit messages, following the Linux and Git projects. @ text @.TH R2E 1a .SH NAME r2e \- receive RSS feeds by email .SH SYNOPSIS .B r2e action [options] .SH DESCRIPTION .BR r2e is a simple program which you can run in your crontab. It watches RSS feeds and sends you nicely formatted email message for each new item. .P The program is configured by ~/.rss2email/config.py .P For a quick start with r2e, try these steps: .P .RS .nf .BI "r2e new " your@@address .BI "r2e add " http://feed.url/somewhere.rss .BI "r2e run " .RE .P The last command should eventually be put into your crontab, if you want things be sent you automatically. .SH ACTIONS .TP .B new [youremail] Create a new feedfile. If the second option is specified, it sets the default email address that mails are sent to. .TP .B add url [youremail] Subscribe to a feed. The first option is the URL of the feed. The optional second option is the email address to send new items to. Repeat for each feed you want to subscribe to. .TP .B run [--no-send] Scan the feeds and send emails for new items. This can be run in a cron job. The --no-send option stops r2e from sending any email. This can be useful the first time you run it, as otherwise it would send every available story. .TP .B email yournewemail Change the default email address. .TP .B list List all your currently subscribed feeds. .TP .B delete n Delete a feed, using its number from the list command. .SH "CONFIGURATION" The following configuration variables can be set in the ~/.rss2email/config.py config file. The file is a python file, so variables are set using a syntax like this: VARIABLE = "value" .P If the value is a number, the quotes may be omitted. Most configuration variables in the file are boolean values, where a 1 indicates the option is set, and a 0 disables it. .TP .B DEFAULT_FROM The email address messages are from by default, if the rss feed does not specify an email address. The default valus is "bozo@@dev.null" .TP .B FORCE_FROM If set, the DEFAULT_FROM address will always be used, otherwise use the email address specified by the feed, when possible. .TP .B HTML_MAIL If set, HTML mail will be sent as such. Otherwise, entries will be converted to plain text before sending. .TP .B TRUST_GUID If set, receive one email per post. Otherwise, a new email will be sent each time a post changes. .TP .B DATE_HEADER If set, the mail's date will be set to the date the item was posted, if possible. Otherwise, the date will be based on the time the email is sent. .TP .B QP_REQUIRED If set, do a quoted printible conversion; otherwise send message in 8 bits. .TP .B VERBOSE If set, feeds are named as they're processed. .SH FILES .TP .B ~/.rss2email/feeds.dat The database of feeds. Use r2e to add, remove, or modify feeds, do not edit it directly. .TP .B ~/.rss2email/config.py If this file exists, it it read to configure the program. .SH AUTHOR Aaron Swartz @ 1.3 log @Remove duplicate part of man page. Bump PKGREVISION. @ text @@ 1.2 log @Update to 2.60. From the changelog: * Now compatible with SunOS * Correctly handle international character sets in email From Plus changes from Debian: * Document more options in config.py * Flesh out manual page * Check exit status of sendmail, and die if it fails * Use fcntl even on non-Sunos-Unix @ text @a35 75 .B run [--no-send] [num] Scan the feeds and send emails for new items. This can be run in a cron job. .P The --no-send option stops r2e from sending any email. This can be useful the first time you run it, as otherwise it would send every available story. .P If a number is specified, r2e will only download that feed. The list command lists the feed numbers. .TP .B email yournewemail Change the default email address. .TP .B list List all your currently subscribed feeds. .TP .B delete n Delete a feed, using its number from the list command. .SH "CONFIGURATION" The program's behavior can be controlled via the ~/.rss2email/config.py config file. The file is a python file, so variables are set using a syntax like this: VARIABLE = "value" .P If the value is a number, the quotes may be omitted. Most configuration variables in the file are boolean values, where a 1 indicates the option is set, and a 0 disables it. .P See the example config.py file for a full list of available configuration variables. .SH FILES .TP .B ~/.rss2email/feeds.dat The database of feeds. Use r2e to add, remove, or modify feeds, do not edit it directly. .TP .B ~/.rss2email/config.py If this file exists, it it read to configure the program. .SH AUTHOR Aaron Swartz .TH R2E 1a .SH NAME r2e \- receive RSS feeds by email .SH SYNOPSIS .B r2e action [options] .SH DESCRIPTION .BR r2e is a simple program which you can run in your crontab. It watches RSS feeds and sends you nicely formatted email message for each new item. .P The program is configured by ~/.rss2email/config.py .P For a quick start with r2e, try these steps: .P .RS .nf .BI "r2e new " your@@address .BI "r2e add " http://feed.url/somewhere.rss .BI "r2e run " .RE .P The last command should eventually be put into your crontab, if you want things be sent you automatically. .SH ACTIONS .TP .B new [youremail] Create a new feedfile. If the second option is specified, it sets the default email address that mails are sent to. .TP .B add url [youremail] Subscribe to a feed. The first option is the URL of the feed. The optional second option is the email address to send new items to. Repeat for each feed you want to subscribe to. .TP @ 1.1 log @Instead of creating files from patches, place them readably in ${FILESDIR} for easier tracking of external changes (e.g., Debian, whence they came). No functional change. @ text @d36 75 @