From mboxrd@z Thu Jan 1 00:00:00 1970 From: tsd@tsdye.com (Thomas S. Dye) Subject: Re: [RFC] Org version of the Org manual Date: Thu, 07 Mar 2013 07:35:05 -1000 Message-ID: References: <87ehfuonx6.fsf@Rainer.invalid> <87zjyhotvi.fsf@yagnesh.org> Mime-Version: 1.0 Content-Type: text/plain Return-path: Received: from eggs.gnu.org ([208.118.235.92]:58103) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1UDepO-0001SA-Gs for emacs-orgmode@gnu.org; Thu, 07 Mar 2013 12:42:04 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1UDejH-0006cc-N0 for emacs-orgmode@gnu.org; Thu, 07 Mar 2013 12:36:06 -0500 Received: from oproxy5-pub.bluehost.com ([67.222.38.55]:38081) by eggs.gnu.org with smtp (Exim 4.71) (envelope-from ) id 1UDejH-0006cD-85 for emacs-orgmode@gnu.org; Thu, 07 Mar 2013 12:35:43 -0500 In-Reply-To: <87zjyhotvi.fsf@yagnesh.org> (Yagnesh Raghava Yakkala's message of "Wed, 06 Mar 2013 16:44:01 +0900") 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: Yagnesh Raghava Yakkala Cc: Achim Gratz , emacs-orgmode@gnu.org Aloha Yagnesh Raghava Yakkala, Yagnesh Raghava Yakkala writes: > Hello Thomas, > >> These instructions assume more knowledge than I have. Could you be more >> specific about "in the Org worktree"? Should I create a branch where I >> do this? Or, should I put this in one of the upstream branches and >> arrange to push it into the Org repo? In any case, can you suggest a >> location? /contrib? /doc? > > IIUC, Achim means, > > cd /source/directory/of/org-mode > git clone http:github.com/tsdye/orgmanual # or your most updated repo of orgmanual > > git submodule add orgmanual # optional > git commit -m "Commit Message" # optional > > cd orgmanual > Create_Makefile # [1] > ln -s ../doc/org-version.inc . > > cd .. > update_local.mk_file # [2] > make orgmanual > > For me also texi2dvi failed, but orgmanual.info is generated fine and looks > great. Thanks for the detailed instructions, which helped me greatly. The orgmanual now creates a pdf file, too, but one lacking the indexes and with links that look like they need another run through TeX. When I'm done running `make orgmanual', my directory is very neat and tidy, which is nice, but I'll need to look at the auxiliary files used to build the indexes, so I can debug. Should I run texi2dvi outside `make orgmanual', or would some other workflow better fit my needs? Suggestions warmly welcomed. Thanks again for your help. All the best, Tom -- Thomas S. Dye http://www.tsdye.com