From mboxrd@z Thu Jan 1 00:00:00 1970 Path: main.gmane.org!not-for-mail From: Reiner Steib Newsgroups: gmane.emacs.devel Subject: Re: Refcard for Gnus Date: Thu, 30 Dec 2004 19:56:30 +0100 Message-ID: References: Reply-To: Reiner Steib NNTP-Posting-Host: deer.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: sea.gmane.org 1104433239 27862 80.91.229.6 (30 Dec 2004 19:00:39 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Thu, 30 Dec 2004 19:00:39 +0000 (UTC) Cc: Emacs development Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Thu Dec 30 20:00:26 2004 Return-path: Original-Received: from lists.gnu.org ([199.232.76.165]) by deer.gmane.org with esmtp (Exim 3.35 #1 (Debian)) id 1Ck5X8-0005cM-00 for ; Thu, 30 Dec 2004 20:00:26 +0100 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.33) id 1Ck5i5-0001FS-I3 for ged-emacs-devel@m.gmane.org; Thu, 30 Dec 2004 14:11:45 -0500 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.33) id 1Ck5hx-0001F7-Fd for emacs-devel@gnu.org; Thu, 30 Dec 2004 14:11:37 -0500 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.33) id 1Ck5hw-0001Eg-LP for emacs-devel@gnu.org; Thu, 30 Dec 2004 14:11:37 -0500 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.33) id 1Ck5hw-0001Ed-HR for emacs-devel@gnu.org; Thu, 30 Dec 2004 14:11:36 -0500 Original-Received: from [134.60.1.1] (helo=mail-new.rz.uni-ulm.de) by monty-python.gnu.org with esmtp (TLSv1:DES-CBC3-SHA:168) (Exim 4.34) id 1Ck5WG-00053r-Dg; Thu, 30 Dec 2004 13:59:33 -0500 Original-Received: from bridgekeeper.physik.uni-ulm.de (bridgekeeper.physik.uni-ulm.de [134.60.10.123]) by mail.uni-ulm.de (8.13.1/8.13.1) with ESMTP id iBUIxSh6022043; Thu, 30 Dec 2004 19:59:28 +0100 (MET) Original-Received: from me (bridgekeeper.physik.uni-ulm.de [134.60.10.123]) by bridgekeeper.physik.uni-ulm.de (Postfix) with SMTP id 699E31C17A; Thu, 30 Dec 2004 19:59:26 +0100 (CET) Original-Received: (nullmailer pid 24605 invoked by uid 170); Thu, 30 Dec 2004 18:56:31 -0000 Mail-Followup-To: Richard Stallman , Emacs development Original-To: Richard Stallman X-Face: :6KQZ[nyoS_edmB.%gw-=)BYth^|2+Y+^cu%I$FSx!&>-'om>3H7A|M&n(V7fIo3P.; yo.b yq4$p; ZaBtkv)\}biaiBQe"mD}iib1AA@99-fZ7i*bLhNRVC&0Wkxg9)SH?oWc@{ User-Agent: Gnus/5.11 (Gnus v5.11) Emacs/21.3.50 (gnu/linux) X-DCC-dcc3mcgill-Metrics: gemini 1275; Body=2 Fuz1=2 Fuz2=2 X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: main.gmane.org gmane.emacs.devel:31612 X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:31612 On Wed, Dec 29 2004, Richard Stallman wrote: > currently the Reference Card for Gnus is not included in Emacs. I > think it should be included. > > It would be good to include it. Could someone check if Vladimir Alexiev , Felix Natter and Luis Fernandes have copyright assignments on file? Else I will try to find out if their changes require assignments. ,----[ gnusref.tex ] | Copyright \copyright\ 1995 Free Software Foundation, Inc.\\* | Copyright \copyright\ 1995 Vladimir Alexiev | $<$vladimir@cs.ualberta.ca$>$.\\* | Copyright \copyright\ 2000 Felix Natter $<$fnatter@gmx.net$>$.\\* | Copyright \copyright\ 2001, 2002, 2003 \author.\\* | Created from the Gnus manual Copyright \copyright\ 1994 Lars Magne | Ingebrigtsen.\\* | and the Emacs Help Bindings feature (C-h b).\\* | Gnus logo copyright \copyright\ 1995 Luis Fernandes.\\* `---- [ Changed order of quoting: ] > The Emacs refcard is just one file. Can the Gnus refcard be > just one file? If we resign from some "features", we could put it in just one LaTeX file: a combination (say gnus-refcard.tex) of gnusref.tex and refcard.tex. Missing features would be: No graphical Gnus logo on the reference card and no reference booklet. If we want to keep the logo, we need two files: gnus-refcard.tex and gnuslogo-refcard.eps. If we go for one of those two options ((a) one LaTeX file or (b) one LaTeX plus eps logo), syncing of the LaTeX file between Gnus and Emacs would have to be done manually. But it is not very hard, because the content doesn't change often. I would recommend to take one of these options. For completeness, I'll explain the other files a well. You may skip the rest of this article if you agree to (a) or (b). > What role does each of those files play? 54730 gnusref.tex [2] gnusref.tex Main input file. It provides the actual content of the refcard (6 pages, two column layout) and reference booklet (20 pages, one column layout) as LaTeX macros. 5279 refcard.tex gnus-ref.tex LaTeX document for the reference card. Needs gnusref.tex and a graphical Gnus logo (gnuslogo-refcard.eps; or *.pdf generated using epstopdf). 539 bk-a4.tex gnus-bk-a4.tex 542 bk-lt.tex gnus-bk-lt.tex Small LaTeX wrapper files for the reference booklet (A4 and letter paper size). Needs [gnus-]booklet.tex (specifies layout and content), gnusref.tex and a bigger graphical Gnus logo (gnuslogo-booklet.eps; or *.pdf generated using epstopdf). > 1792 Makefile [1] gnus-Makefile > > Why does this need makefile rules? The user can create DVI, PS and PDF versions of the reference card and booklet (for different paper sizes: a4 and letter). The PDF versions require the logo as PDF file which is generated by Makefile rules. There are also Makefile rules for the paper size, e.g. you can say "make PAPERSIZE=letter gnus-booklet.ps" to get the reference booklet for letter paper. > Assuming there is a real need for them, we should put the rules into > etc/Makefile, rather than making a separate file. The simplified Makefile (only stuff for refcard and booklet) has around 50 lines. It's easier to maintain when it is kept separate if we include the booklet version, too. Bye, Reiner. -- ,,, (o o) ---ooO-(_)-Ooo--- | PGP key available | http://rsteib.home.pages.de/