Re: [RFC] Org version of the Org manual

[tsd@tsdye.com (Thomas S. Dye)]

Achim Gratz <Stromeko@nexgo.de> writes:

> Thomas S. Dye writes:
>> That works nicely.  I found the error and orgmanual.pdf is now produced
>> without errors.
>
> Progress! :-)
>
> With the current version from git I cannot export to texinfo

This is fixed now.

>
> I've extended the Makefile to approximate the one in doc/, HTML is
> produced both via makeinfo and as an export via ox-html.  To proceed in
> an orderly manner and prepare for an eventual integration into Org, can
> you please do the following in your Org clone:
>
> git checkout master
> git checkout -b orgmanual master
> git submodule add https://github.com/tsdye/orgmanual.git
> git commit -am 'make orgmanual/ a submodule'
>
> cd orgmanual
> git checkout -b orgmanual master
> git am orgmanual.patch
>
>
>
> cd ..
> git commit -am 'update submodule orgmanual'
> git am org.patch
>
>

This all worked fine.  Thanks for the detailed instructions.

>
> If you are unsure about any of this, please ask.  You can now edit/add
> these lines
>
> .PHONY: orgmanual
> EXTRADIRS=orgmanual
> orgmanual:
>         $(MAKE) -C $@
>
> to the top of your local.mk and should now be able to do a "make
> orgmanual".  Which types of documentation are produced can be controlled
> with ORG_MAKE_DOC (default is "info pdf html"), just like for the
> official manuals.  Also, "make cleanall" will now clean up in orgmanual
> also.  BTEST_POST should be configured to have a load-path pointing to a
> sufficiently advanced htmlize version for the HTML export.
>

I do have a problem here.  I think I have mis-configured BTEST_POST.

I have this:

BTEST_POST  =
              # -L <path-to>/ert      # needed for Emacs23, Emacs24 has ert built in
              # -L <path-to>/ess      # needed for running R tests
		-L contrib/lisp/htmlize.el  # need at least version 1.34 for source code formatting

Now 'make orgmanual' returns this:

local.mk:55: *** commands commence before first target.  Stop.

All the best,
Tom

-- 
Thomas S. Dye
http://www.tsdye.com