From mboxrd@z Thu Jan 1 00:00:00 1970 From: Matthew Lundin Subject: Re: Include FAQ to info? Date: Sat, 22 May 2010 12:32:28 -0400 Message-ID: <87zkzr523n.fsf@fastmail.fm> References: <87632swrjt.fsf@in-ulm.de> <87ocgk781m.fsf@stats.ox.ac.uk> <87eihf223r.fsf@mean.albasani.net> <239BEDB6-AB2B-4E5D-A4BE-8283BB96FEA8@gmail.com> <878w7lyop1.fsf@fastmail.fm> <87hbm85853.fsf@fastmail.fm> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Return-path: Received: from [140.186.70.92] (port=42565 helo=eggs.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1OFrcg-0004e8-43 for emacs-orgmode@gnu.org; Sat, 22 May 2010 12:32:27 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.69) (envelope-from ) id 1OFrce-0000Wy-TH for emacs-orgmode@gnu.org; Sat, 22 May 2010 12:32:26 -0400 Received: from out3.smtp.messagingengine.com ([66.111.4.27]:39021) by eggs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1OFrce-0000Wr-Nc for emacs-orgmode@gnu.org; Sat, 22 May 2010 12:32:24 -0400 In-Reply-To: (Alan E. Davis's message of "Sat, 22 May 2010 07:01:44 +1000") List-Id: "General discussions about Org-mode." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org Errors-To: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org To: "Alan E. Davis" Cc: Org Mode , Carsten Dominik Hi Alan, Thanks for sharing this! It looks very useful. I'll take a look at it and get back to you soon. Best, Matt "Alan E. Davis" writes: > Matthew: > > There's an interest in org-help.org?=C2=A0 Would there be any question ab= out > its inclusion in org? No.=C2=A0 It's currently in a state of disarray, > however.=C2=A0 Here are some of my thoughts about its current state.=C2= =A0 As I > mention below, I may be able to clean it up this Summer. > > =C2=A0 I am afraid I got bogged down, for a number of reasons.=C2=A0=C2= =A0 I am > stubborn, and don't want to admit defeat, but it would be even better > if someone who really understands org-mode was able to carry it > forward. =C2=A0 And I have some ideas about improving it, but haven't had > time or focus to get it done.=C2=A0 I'll attach a current copy, but there > are quite a few sections added, esp. at the end, that were gratuitously > personal notes as I was learning certain features.=C2=A0 If this were on > some kind of git repo, I'd be interested in working off of it, and I'd > learn to submit a patch, perhaps. > > One thing I thought about is the keystroke compatibility issue, that it > would be really nice if it worked like info.=C2=A0 As it is, it is an > editable file, and I end up having to kill it to avoid overwriting it > with some junk, when I use it.=C2=A0=C2=A0 The folding status is not pers= istent, > another nice thing to have (from info). > > The file opens up as a folded top-level outline.=C2=A0 The various headli= nes > I have set up to be links to the manual pages about the same topic.=C2=A0= At > I tried to have one or two main keybinding clues present in the folded > view at least headline.=C2=A0 So a clue to the keybindings, and a link to > the manual.=C2=A0 Even lower level headlines may have manual links.=C2=A0= That > particular feature I like *a lot*! > > I have gotten a bit lost with many of the new features, like babel, and > haven't kept up on some of those.=C2=A0 I was clueless about agenda, but > have begun to use it quite a bit, so at some point I worked on that > section, but it's a miasma, a tangled mass, at this point, and I should > have to clean that up.=C2=A0 This is an example of a section I started to > work on when I was learning a certain feature or set of features.=C2=A0 > > So I guess that main caveat at this point is that it's become a > personal help file, and more and more personal as time goes on.=C2=A0 Sum= mer > comes I would at some point clean it up. > > I assigned it to a key.=C2=A0 For my key-binding setup, it worked ok to > assign it to "C-c 7".=C2=A0=C2=A0 Maybe better to set it on a viewing mod= e, but I > have been prone to hack as a go. > > Be all that as it may be, here is the "current" state of the file on my > system.=C2=A0 > > Alan. > > On Sun, May 16, 2010 at 10:43 PM, Matthew Lundin > wrote: > > Carsten Dominik writes: >=20=20=20=20 > > Hi Matt, > > > > no, org-help.org is not about the FAQ, it is a separate document, > like > > a quick reference, made by Alan Davis. =C2=A0It is more than the > refcard, > > less than the manual. > > > > It seems to live here: > > > > =C2=A0http://osdir.com/ml/attachments/orgF54hhOaC48.org > > > > Get in touch with Alan at lngndvs@gmail.com =C2=A0Maybe with some > feedback > > between the two of you, we will have a way to ship this with > Org-mode > > and to link it in. >=20=20=20=20 > Great! I will contact Alan Davis about including org-help.org in > the > distribution. >=20=20=20=20 > - Matt > > > _______________________________________________ > Emacs-orgmode mailing list > Please use `Reply All' to send replies to the list. > Emacs-orgmode@gnu.org > http://lists.gnu.org/mailman/listinfo/emacs-orgmode