From mboxrd@z Thu Jan 1 00:00:00 1970 From: Bastien Subject: Re: Multiple (natural) languages in a single org-file Date: Wed, 11 Apr 2012 08:30:56 +0200 Message-ID: <87iph6aifz.fsf@gnu.org> References: <87linka45j.fsf@gmail.com> <86lim35ako.fsf@iro.umontreal.ca> <3699.1334121814@alphaville> Mime-Version: 1.0 Content-Type: text/plain Return-path: Received: from eggs.gnu.org ([208.118.235.92]:39273) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SHr3q-0002n3-4E for emacs-orgmode@gnu.org; Wed, 11 Apr 2012 02:29:47 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1SHr3o-0002Ft-BG for emacs-orgmode@gnu.org; Wed, 11 Apr 2012 02:29:45 -0400 Received: from mail-wg0-f49.google.com ([74.125.82.49]:39036) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SHr3o-0002Fp-24 for emacs-orgmode@gnu.org; Wed, 11 Apr 2012 02:29:44 -0400 Received: by wgbdr1 with SMTP id dr1so392352wgb.30 for ; Tue, 10 Apr 2012 23:29:42 -0700 (PDT) In-Reply-To: <3699.1334121814@alphaville> (Nick Dokos's message of "Wed, 11 Apr 2012 01:23:34 -0400") List-Id: "General discussions about Org-mode." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org Sender: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org To: nicholas.dokos@hp.com Cc: =?us-ascii?Q?=22=3D=3Futf-8=3FQ=3FFran=3DC3?= =?us-ascii?Q?=3DA7ois=3F=3D=22?= Pinard , emacs-orgmode@gnu.org Hi Nicholas, (btw, do you prefer "Nick" or "Nicholas"?) Nick Dokos writes: > None of this is an argument for leaving the manual as is: if you had a > problem finding the information, then others will too, so the manual > should be improved. Done. > But the information is there, and moreover, learning how to find it in > this instance has the huge advantage of teaching one how to find it for > all the other options as well. The question as always is how far to go > in documenting all the options: it would be good to document them all > (as Bastien would say: "patches are welcome"), but is it better to learn > searching tricks or to submit patches to improve the doc? Each one of us > would probably answer that question differently (we have different > "breaking points"). The "how far" question is related to the "where" question. - The Org compact guide: "vital" options should be there. This guide should also point to the manual for further exploration. - The Org manual: the most used/useful options should be there. The manual should point to a specific Worg page for more. - Worg: anything else. Of course, "vital" and "used/useful" are moving targets, but that's why we have the mailing list and the discussions. To shoot them together. What we really *really* is a good tutorial on how to digg all the documentation aspects of Emacs. Basically, how to go from checking the manual to checking with C-h v and other functions. Any taker? > So you might prepare a doc patch (please do!) - I > might go on a searching expedition and find things you didn't [fn:1]. > The first one benefits everybody, the second one benefits mainly me, but > sometimes I can find a teaching moment and tell other people how to do > something: which is why I spent a half-hour writing this :-) [fn:2] I hope the community realizes how precious are all these hours that you spent in patiently fighting with everyone issues... at least here, this is immensely appreciated! So, thanks again for this. -- Bastien