From mboxrd@z Thu Jan 1 00:00:00 1970 X-Msuck: nntp://news.gmane.io/gmane.emacs.gnus.general/80559 Path: news.gmane.org!not-for-mail From: Steinar Bang Newsgroups: gmane.emacs.gnus.general Subject: Re: where is the gnus-sync documentation? Date: Tue, 08 Nov 2011 22:53:32 +0100 Organization: Probably a good idea Message-ID: <87hb2ez3fn.fsf@dod.no> References: <87vcqw3ny3.fsf@dod.no> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: dough.gmane.org 1320789240 1601 80.91.229.12 (8 Nov 2011 21:54:00 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Tue, 8 Nov 2011 21:54:00 +0000 (UTC) To: ding@gnus.org Original-X-From: ding-owner+M28842@lists.math.uh.edu Tue Nov 08 22:53:56 2011 Return-path: Envelope-to: ding-account@gmane.org Original-Received: from util0.math.uh.edu ([129.7.128.18]) by lo.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1RNtcB-0008Qh-UE for ding-account@gmane.org; Tue, 08 Nov 2011 22:53:56 +0100 Original-Received: from localhost ([127.0.0.1] helo=lists.math.uh.edu) by util0.math.uh.edu with smtp (Exim 4.63) (envelope-from ) id 1RNtc5-00055w-Em; Tue, 08 Nov 2011 15:53:49 -0600 Original-Received: from mx2.math.uh.edu ([129.7.128.33]) by util0.math.uh.edu with esmtps (TLSv1:AES256-SHA:256) (Exim 4.63) (envelope-from ) id 1RNtc4-00055i-7Q for ding@lists.math.uh.edu; Tue, 08 Nov 2011 15:53:48 -0600 Original-Received: from quimby.gnus.org ([80.91.231.51]) by mx2.math.uh.edu with esmtps (TLSv1:AES256-SHA:256) (Exim 4.76) (envelope-from ) id 1RNtc3-0003Xa-4Z for ding@lists.math.uh.edu; Tue, 08 Nov 2011 15:53:48 -0600 Original-Received: from lo.gmane.org ([80.91.229.12]) by quimby.gnus.org with esmtp (Exim 4.72) (envelope-from ) id 1RNtc1-0007bb-Lj for ding@gnus.org; Tue, 08 Nov 2011 22:53:45 +0100 Original-Received: from list by lo.gmane.org with local (Exim 4.69) (envelope-from ) id 1RNtc0-0008N8-1C for ding@gnus.org; Tue, 08 Nov 2011 22:53:44 +0100 Original-Received: from cm-84.208.231.161.getinternet.no ([84.208.231.161]) by main.gmane.org with esmtp (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Tue, 08 Nov 2011 22:53:43 +0100 Original-Received: from sb by cm-84.208.231.161.getinternet.no with local (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Tue, 08 Nov 2011 22:53:43 +0100 X-Injected-Via-Gmane: http://gmane.org/ Mail-Followup-To: ding@gnus.org Original-Lines: 52 Original-X-Complaints-To: usenet@dough.gmane.org X-Gmane-NNTP-Posting-Host: cm-84.208.231.161.getinternet.no Mail-Copies-To: never User-Agent: Gnus/5.110018 (No Gnus v0.18) Emacs/23.3 (gnu/linux) Cancel-Lock: sha1:ZJOpPM1H15MFnOr+K6ZYf9VL5eg= X-Spam-Score: -6.1 (------) List-ID: Precedence: bulk Xref: news.gmane.org gmane.emacs.gnus.general:80559 Archived-At: >>>>> Dave Abrahams : > on Sun Nov 06 2011, Steinar Bang wrote: >>>>>>> Dave Abrahams : >>> I want to understand what this module is for >> Personally, I use gnus-sync v1 to sync nntp tick marks between three >> different gnus installations (home desktop, home netbook, and work). > That's what I figured, roughly. >> But the new version of gnus-sync is capable of more. > what, specifically? I'm not quite sure yet. Topics for one thing. Ted would know. >>> and how to use it. >> Ah... that bit is still in the process of being nailed out, I think...? > Even some very rough tutorial/getting started guide would be lovely. Ok, from gnus-sync.el: 1. install CouchDB, set up a real server admin user, and create a database, e.g. "tzz" and save the URL, e.g. http://lesync.info:5984/tzz 2. run `M-: (gnus-sync-lesync-setup "http://lesync.info:5984/tzz" "tzzadmin" "mypassword" "mysalt" t t)' (If you run it more than once, you have to remove the entry from _users yourself. This is intentional. This sets up a database admin for the "tzz" database, distinct from the server admin user in (1) above.) Then add the following to your .gnus.el (adjust the URL as appropriate): (setq gnus-sync-backend '(lesync "http://lesync.info:5984/tzz") gnus-sync-newsrc-groups '("nntp" "nnrss")) Then start using the sync database: Initially save the current read state to the database: `C-u M-x gnus-sync-save RET' (the prefix makes it save the current state of all groups) On later sessions do `M-x gnus-sync-read RET' after starting gnus, and then a `g' to fix the read count. After reading some nntp stuff, you can do `M-x gnus-sync-save RET' at any point in time (it takes hardly any time at all).