diff --git a/README.in.rst b/README.in.rst index 0364cfc..6595588 100644 --- a/README.in.rst +++ b/README.in.rst @@ -36,18 +36,27 @@ Alternatively, copy ``nnhackernews.el`` to a directory among ``C-h v RET load-pa Usage ===== -In your ``.gnus`` or ``.emacs``, +In your ``.emacs`` or ``init.el``, use ONE of the following: :: - (add-to-list 'gnus-secondary-select-methods - '(nnhackernews "")) + ;; Applies to first-time Gnus users + (custom-set-variables '(gnus-select-method (quote (nnhackernews "")))) + +or, if you're an existing Gnus user, + +:: + + ;; Applies to existing Gnus users + (add-to-list 'gnus-secondary-select-methods '(nnhackernews "")) + +Then ``M-x gnus``. Enter the ``nnhackernews:news`` newsgroup with ``RET``. Gnus will only show followup comments for threads you read, so be selective. If you accidentally read a thread, or decide the thread is uninteresting, you may ``C-k`` it to prevent Gnus from showing followups. Use ``C-k`` liberally. -The signal-to-noise of the hackernews firehose is such that I often "catch-up" via ``c`` to flush the unread threads. +When finished, "catch-up" via ``c`` to flush the unread threads. Gnus will not show comments for them. Create a post via ``a``. diff --git a/README.rst b/README.rst index cb9406b..28b13f7 100644 --- a/README.rst +++ b/README.rst @@ -36,18 +36,27 @@ Alternatively, copy ``nnhackernews.el`` to a directory among ``C-h v RET load-pa Usage ===== -In your ``.gnus`` or ``.emacs``, +In your ``.emacs`` or ``init.el``, use ONE of the following: :: - (add-to-list 'gnus-secondary-select-methods - '(nnhackernews "")) + ;; Applies to first-time Gnus users + (custom-set-variables '(gnus-select-method (quote (nnhackernews "")))) + +or, if you're an existing Gnus user, + +:: + + ;; Applies to existing Gnus users + (add-to-list 'gnus-secondary-select-methods '(nnhackernews "")) + +Then ``M-x gnus``. Enter the ``nnhackernews:news`` newsgroup with ``RET``. Gnus will only show followup comments for threads you read, so be selective. If you accidentally read a thread, or decide the thread is uninteresting, you may ``C-k`` it to prevent Gnus from showing followups. Use ``C-k`` liberally. -The signal-to-noise of the hackernews firehose is such that I often "catch-up" via ``c`` to flush the unread threads. +When finished, "catch-up" via ``c`` to flush the unread threads. Gnus will not show comments for them. Create a post via ``a``.