[Top][All Lists]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: [O] Org version of texinfo manual

From: Achim Gratz
Subject: Re: [O] Org version of texinfo manual
Date: Sat, 10 May 2014 22:08:08 +0200
User-agent: Gnus/5.13 (Gnus v5.13) Emacs/24.4.50 (gnu/linux)

Achim Gratz writes:
> I'm still in favor of doing this, but it will be an uphill battle.  I'll
> have to check what the state of my local branch is on this, let me get
> back to you when it at least compiles the old version of the manual.

If you check out the orgmanual branch in Thomas' repository (and follow
the instructions on this list to integrate it into the Org build
system), then only these two patches are missing from my local version:

--8<---------------cut here---------------start------------->8---
    put back macros with "problematic characters"

        Modified   orgmanual.org
diff --git a/orgmanual.org b/orgmanual.org
index 0325614..ebe26ba 100644
--- a/orgmanual.org
+++ b/orgmanual.org
@@ -4254,13 +4254,10 @@ Priorities can be attached to any outline node; they do 
not need to be TODO
 #+attr_texinfo: :table-type table :indic @asis
-  - {{{kbd(C-c XXX)}}} ::
+  - {{{kbd(C-c \\,)}}} ::
-    {{{kindex(C-c ,)}}}
-    #+comment:    {{{kindex(@kbd{C-c ,})}}}
-    #+comment: Preceding line won't export to pdf
-    {{{findex(org-priority)}}}
-    #+comment: Should be C-c ,
+       {{{kindex(C-c \\,)}}}
+       {{{findex(org-priority)}}}
     Set the priority of the current headline (~org-priority~). The
     command prompts for a priority character {{{samp(A)}}}, {{{samp(B)}}}
@@ -9226,9 +9223,7 @@ the other commands, the cursor needs to be in the desired 
 - ~\~ ~org-agenda-filter-by-tag-refine~ ::
-  #+comment: {{{kindex(XXX)}}}
-  #+comment: Should be \
-  @@info:kindex \\@@
+  {{{kindex(\)}}}
   Narrow the current agenda filter by an additional condition. When
   called with prefix arg, remove the entries that /do/ have the tag, or
@@ -9350,11 +9345,9 @@ the other commands, the cursor needs to be in the 
desired line.
   Set tags for the current headline. If there is an active region in the
   agenda, change a tag for all headings in the region.
-- {{{kbd(,)}}} ::
+- {{{kbd(\\,)}}} ::
-  #+comment: {{{kindex(XXX)}}}
-  #+comment: Should be a comma
-  @@info:kindex ,@@
+  {{{kindex(\\,)}}}
   Set the priority for the current item (~org-agenda-priority~). Org
   mode prompts for the priority character. If you reply with
@@ -10691,12 +10684,9 @@ If you would like to see entities displayed as UTF8 
characters, use the
 following command:[fn:108]
 #+attr_texinfo: :table-type table :indic @asis
-- @@info:@kbd{C-c C-x XXX}@@ ::
-  #+comment: {{{kindex(C-c C-x XXX)}}}
-  #+comment: Should be \
+- {{{kbd(C-c C-x \)}}} ::
-  @@info:kindex C-c C-x \\
+  {{{kindex(C-c C-x \)}}}
   Toggle display of entities as UTF-8 characters. This does not change
   the buffer content which remains plain ASCII, but it overlays the
@@ -10740,9 +10730,7 @@ subscript, but ~a_{b}~ will.
 #+attr_texinfo: :table-type table :indic @asis
 - @@info:@kbd{C-c C-x \\}@@ ::
-  #+comment: {{{kindex(C-c C-x XXX)}}}
-  #+comment: Should be \
-  @@info:@kindex C-c C-x \@@
+  {{{kindex(C-c C-x \)}}}
   In addition to showing entities as UTF-8 characters, this command will
   also format sub- and superscripts in a WYSIWYM way.
--8<---------------cut here---------------end--------------->8---

--8<---------------cut here---------------start------------->8---
    Makefile: put HTML manual into subfolder

        Modified   Makefile
diff --git a/Makefile b/Makefile
index 7c45664..fec57d6 100644
--- a/Makefile
+++ b/Makefile
@@ -34,7 +34,7 @@ orgmanual.pdf:        LANG=C          # work around a bug in 
 orgmanual.pdf: orgmanual.texi
        $(TEXI2PDF) $<
 orgmanual:     orgmanual.texi
-       $(TEXI2HTML) $<
+       $(TEXI2HTML) $< -o $@
 orgmanual.html: orgmanual.org
        $(BEXP) $(EXHTML) $< $(ORG2HTML)
--8<---------------cut here---------------end--------------->8---
My addition to local.mk looks like this:

--8<---------------cut here---------------start------------->8---
.PHONY: manclean orgmanual
        $(MAKE) -C $@
        $(MAKE) -C orgmanual clean
clean:  manclean
--8<---------------cut here---------------end--------------->8---

+<[Q+ Matrix-12 WAVE#46+305 Neuron microQkb Andromeda XTk Blofeld]>+

Samples for the Waldorf Blofeld:

reply via email to

[Prev in Thread] Current Thread [Next in Thread]