From mboxrd@z Thu Jan 1 00:00:00 1970 X-Msuck: nntp://news.gmane.io/gmane.comp.tex.context/81287 Path: news.gmane.org!not-for-mail From: Sietse Brouwer Newsgroups: gmane.comp.tex.context Subject: Re: man pages for ConTeXt: looking for volunteers Date: Thu, 21 Mar 2013 15:44:39 +0100 Message-ID: References: Reply-To: mailing list for ConTeXt users NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Trace: ger.gmane.org 1363877121 10473 80.91.229.3 (21 Mar 2013 14:45:21 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Thu, 21 Mar 2013 14:45:21 +0000 (UTC) To: mailing list for ConTeXt users Original-X-From: ntg-context-bounces@ntg.nl Thu Mar 21 15:45:48 2013 Return-path: Envelope-to: gctc-ntg-context-518@m.gmane.org Original-Received: from balder.ntg.nl ([195.12.62.10]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1UIgkU-00063R-7Y for gctc-ntg-context-518@m.gmane.org; Thu, 21 Mar 2013 15:45:46 +0100 Original-Received: from localhost (localhost [127.0.0.1]) by balder.ntg.nl (Postfix) with ESMTP id D94D3101F5; Thu, 21 Mar 2013 15:45:22 +0100 (CET) X-Virus-Scanned: Debian amavisd-new at balder.ntg.nl Original-Received: from balder.ntg.nl ([127.0.0.1]) by localhost (balder.ntg.nl [127.0.0.1]) (amavisd-new, port 10024) with LMTP id V4-xsoZXw+Y1; Thu, 21 Mar 2013 15:45:17 +0100 (CET) Original-Received: from balder.ntg.nl (localhost [IPv6:::1]) by balder.ntg.nl (Postfix) with ESMTP id 3F7BF101E5; Thu, 21 Mar 2013 15:45:17 +0100 (CET) Original-Received: from localhost (localhost [127.0.0.1]) by balder.ntg.nl (Postfix) with ESMTP id 3E72D101E5 for ; Thu, 21 Mar 2013 15:45:16 +0100 (CET) X-Virus-Scanned: Debian amavisd-new at balder.ntg.nl Original-Received: from balder.ntg.nl ([127.0.0.1]) by localhost (balder.ntg.nl [127.0.0.1]) (amavisd-new, port 10024) with LMTP id QnC26zk43l0Y for ; Thu, 21 Mar 2013 15:45:12 +0100 (CET) Original-Received: from filter2-ams.mf.surf.net (filter2-ams.mf.surf.net [192.87.102.70]) by balder.ntg.nl (Postfix) with ESMTP id 70665101E3 for ; Thu, 21 Mar 2013 15:45:12 +0100 (CET) Original-Received: from mail-ee0-f52.google.com (mail-ee0-f52.google.com [74.125.83.52]) by filter2-ams.mf.surf.net (8.14.3/8.14.3/Debian-9.4) with ESMTP id r2LEjAS9020625 for ; Thu, 21 Mar 2013 15:45:10 +0100 Original-Received: by mail-ee0-f52.google.com with SMTP id b15so1662400eek.25 for ; Thu, 21 Mar 2013 07:45:10 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=x-received:mime-version:in-reply-to:references:from:date:message-id :subject:to:content-type; bh=6u3oZX0XaAe6seRq9ai0oTwO/Y1neaAyZUykBljZheE=; b=AT/YhOotwyRlFkypMipE5+QXMmq9K23QrurIRAuN/iiuRLBc/Mhx+3+2MPQoc6xnl+ 1NWBwFBE1NgyhkU/CD2hW44Y4mnWdsOh1z7QHcnOP1c/b8PI/N63hYYkw3FHQvtB7tsa Bnu/e9dB+OR+EXp2GvyURl/5x3mvEdyVAGrSJqHEBHWPWrO6tlQnZaYFHXUB8AC/5oeh jhTUvu4WNNmRKl2K+l4rlzamU93iGHqhK5FtVUaDbxVxb2Doshk+ofToHJ18g9GBTiP0 rtxZna/ZyreXR9PFzEkY1KKrL6mfVU6+ZtPuHIGVjW/0vgYDpBOxoMfOll+wgnQ7JUz9 Z06w== X-Received: by 10.15.23.193 with SMTP id h41mr83047197eeu.17.1363877110039; Thu, 21 Mar 2013 07:45:10 -0700 (PDT) Original-Received: by 10.14.219.66 with HTTP; Thu, 21 Mar 2013 07:44:39 -0700 (PDT) In-Reply-To: X-Bayes-Prob: 0.0001 (Score 0, tokens from: @@RPTN) X-CanIt-Geo: ip=74.125.83.52; country=US; region=CA; city=Mountain View; postalcode=94043; latitude=37.4192; longitude=-122.0574; metrocode=807; areacode=650; http://maps.google.com/maps?q=37.4192,-122.0574&z=6 X-CanItPRO-Stream: uu:ntg-context@ntg.nl (inherits from uu:default, base:default) X-Canit-Stats-ID: 0QJeeJatp - 9b5299b182c3 - 20130321 (trained as not-spam) X-Scanned-By: CanIt (www . roaringpenguin . com) on 192.87.102.70 X-BeenThere: ntg-context@ntg.nl X-Mailman-Version: 2.1.14 Precedence: list List-Id: mailing list for ConTeXt users List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: ntg-context-bounces@ntg.nl Original-Sender: ntg-context-bounces@ntg.nl Xref: news.gmane.org gmane.comp.tex.context:81287 Archived-At: Mojca wrote: > Hans just implemented auto-conversion of help into man pages for the > lua scripts. > but if > there are any volunteers to help polishing out and provide either > more extensive descriptions, examples, ... or overall improvements, An excellent idea. To cut the work into bite-sized pieces: over the coming weeks, I will post these files on the list one by one and solicit specific improvements / check for befuddlement. First, though, I have some questions: 1. I assume the man pages are created from the XML files, and we should edit the XML files -- is this correct? 2. Is the XML-to-man script included in the distribution? That would (a) make it easier to check the result of an edit, and (b) make it easier to find the answer to question 3 for myself. ;-) 3. Is there a key to specify bold and italic in the XML? (\fB...\fP and \fI...\fP in the man page.) Or, if you want to keep it semantic: are (\fB) and (\fI, or also \fB) supported? 4. I really really like the groupings of the flags in the XML files. This useful grouping doesn't show up in the man pages, however. Perhaps the end of a subcategory could correspond to .TP ---- in the man pages? 5. Lastly, I think it would be good to include a standard SEE ALSO block at the end of each man page, to list all the scripts we have man pages for. This will make it easier for users to discover the man pages. Example below. If such a block could be supported, I would be happy to write it. Cheers, Sietse ___________________________________________________________________________________ If your question is of interest to others as well, please add an entry to the Wiki! maillist : ntg-context@ntg.nl / http://www.ntg.nl/mailman/listinfo/ntg-context webpage : http://www.pragma-ade.nl / http://tex.aanhet.net archive : http://foundry.supelec.fr/projects/contextrev/ wiki : http://contextgarden.net ___________________________________________________________________________________