Re: [RFC] Org version of the Org manual

[Carsten Dominik <carsten.dominik@gmail.com>]

On 17.3.2013, at 02:19, Thomas S. Dye <tsd@tsdye.com> wrote:

> Hi Achim,
> 
> Achim Gratz <Stromeko@nexgo.de> writes:
> 
>> Hi Tom,
>> 
>> I'm playing around with the current version, here is what I have so far:
>> 
>> 
>> The arguments to #+attr_texinfo need to lose the double quotes
>> 
>> Index entries in description lists must be separated from their entry by
>> at least one blank line like in the example below, otherwise the second
>> such entry gets indented in the exported .texi file and that somehow
>> confuses texinfo for some of them.
>> 
>> - {{{kbd(v d)}}} or short {{{kbd(d)}}}, ~org-agenda-day-view~ ::
>> 
>>  {{{kindex(v d)}}}
>>  {{{kindex(d)}}}
>>  {{{vindex(org-agenda-span)}}}
>> 
>> 
>> With these hanges I get the manual exported correctly to all formats.
> 
> Done.  Thanks.
> 
> I brought the manual up-to-date and used @@info:@@ for the problem macro
> characters, so it should be completely converted to Org now.


I tried the file on github, and export to texinfo fails with the attached backtrace (exports to other backends as well).

I love this idea, so I really want to try.  Any ideas what might be wrong on my side?

- Carsten

Debugger entered--Lisp error: (error "Unknown marker at 281861")
  signal(error ("Unknown marker at 281861"))
  error("Unknown marker at %d" 281861)
  org-element-text-markup-successor(281883)
  #[(res) "\302\303\304\b\"!	!\207" [res limit intern format "org-element-%s-successor"] 4](text-markup)
  mapcar(#[(res) "\302\303\304\b\"!	!\207" [res limit intern format "org-element-%s-successor"] 4] (export-snippet footnote-reference inline-babel-call inline-src-block latex-or-entity line-break link macro radio-target statistics-cookie sub/superscript target text-markup timestamp))
  org-element--get-next-object-candidates(281883 (export-snippet footnote-reference inline-babel-call inline-src-block latex-or-entity line-break link macro radio-target statistics-cookie sub/superscript target text-markup timestamp) initial)
  byte-code("\306\b	\n#\211\x12\203\230\x01\307\310\311\312\313\n\"\"\n\"\211^[A\fV\203$\0\314\315
\"\210\202\224\x01\vAb\210\316\317\320\v@\"! \x1e\x1d\321\x0e\x1d\x1e\x1e\x1e\x1f\x0e\x1e;\203I\0\322\323\x0e\x1f\x0e\x1e#\202Q\0\324\x0e\x1eA@\x0e\x1f\"*\x1e \325\x0e\x1d\x1e\x1e\x1e\x1f\x0e\x1e;\203k\0\322\323\x0e\x1f\x0e\x1e#\202s\0\324\x0e\x1eA@\x0e\x1f\"*\x1e!\326\x0e\x1d\x1e\x1e\x1e\x1f\x0e\x1e;\203\215\0\322\323\x0e\x1f\x0e\x1e#\202\225\0\324\x0e\x1eA@\x0e\x1f\"*\211\x1e\"\fX\203\340\0\x0e\"\bU\204\254\0\x0e\"b\210\202\223\x01\314\315\x0e\x1d\327
\x1e#\x1e\x1f\211\x1e\x1e;\203\311\0\330\x0e\x1e\331\x0e\x1f\x0e#$\202\332\0\x0e\x1eA\332\x0e\x1eA@\x0e\x1f\x0e##\240\210\x0e\x1e+\"\210\202\223\x01\x0e \203\363\0\x0e \fV\204\363\0\x0e!\fW\203'\x01\314\315\x0e\x1d\327
\x1e#\x1e\x1f\211\x1e\x1e;\203\x10\x01\330\x0e\x1e\331\x0e\x1f\x0e#$\202!\x01\x0e\x1eA\332\x0e\x1eA@\x0e\x1f\x0e##\240\210\x0e\x1e+\"\210\202\223\x01\x0e b\210\x0e\x1d\327
\x1e#\x1e\x1f\211\x1e\x1e;\203F\x01\330\x0e\x1e\331\x0e\x1f\x0e#$\202W\x01\x0e\x1eA\332\x0e\x1eA@\x0e\x1f\x0e##\240\210\x0e\x1e+\210\x0e\x1d\x15\x0e\x1d\211\x1e\x1e9\203j\x01\x0e\x1e\202\210\x01\x0e\x1e\211\x1e\x1e:\204}\x01\x0e\x1e;\205\207\x01\333\202\207\x01\x0e\x1e@9\205\207\x01\x0e\x1e@)\x0e$\236A)\x11\334\x12\x0e!\x10,)\202\0\0
\207" [end restriction candidates closest-cand origin parent org-element--get-next-object-candidates rassq apply min mapcar cdr throw exit intern format "org-element-%s-parser" :contents-begin get-text-property 0 plist-get :contents-end :end :parent org-add-props nil plist-put plain-text initial object element property cbeg cend obj-end value org-element-object-restrictions] 8)
  org-element-context()
  org-macro-replace-all((("modification-time" . "(eval (format-time-string \"$1\" '(20805 22656)))") ("input-file" . "om.org") ("time" . "(eval (format-time-string \"$1\"))") ("property" . "(eval (org-entry-get nil \"$1\" 'selective))") ("page" . "@@info:@page@@") ("result" . "@@info:@result{}@@") ("enddefopt" . "@@info:@end defopt@@") ("defopt" . "@@info:@defopt@@") ("enddefun" . "@@info:@end defun@@") ("defun" . "@@info:@defun@@") ("noindent" . "@@info:@noindent@@") ("kbdkeys" . "{{{kbd($1{{{key($2)}}}{{{key($3)}}})}}}") ("ksksksksk" . "{{{kbd($1 {{{key($2)}}} $3 {{{key($4)}}} {{{key($5)}}})}}}") ("ksksksk" . "{{{kbd($1 {{{key($2)}}} $3 {{{key($4)}}})}}}") ("kbdspckey" . "{{{kbd($1 {{{key($2)}}})}}}") ("kbdkey" . "{{{kbd($1{{{key($2)}}})}}}") ("printindex" . "@@info:@printindex $1@@") ("value" . "{{{markup(value,$1)}}}") ("cite" . "{{{markup(cite,$1)}}}") ("var" . "{{{markup(var,$1)}}}") ("file" . "{{{markup(file,$1)}}}") ("command" . "{{{markup(command,$1)}}}") ("samp" . "{{{markup(samp,$1)}}}") ("key" . "{{{markup(key,$1)}}}") ("kbd" . "{{{markup(kbd,$1)}}}") ("markup" . "@@info:@$1{@@$2@@info:}@@") ("kindex" . "{{{index(k,$1)}}}") ("vindex" . "{{{index(v,$1)}}}") ("findex" . "{{{index(f,$1)}}}") ("pindex" . "{{{index(p,$1)}}}") ("cindex" . "{{{index(c,$1)}}}") ("index" . "@@info:@$1index $2@@")))
  org-export-as(texinfo nil nil nil nil)
  org-export-to-file(texinfo "./om.texi" nil nil nil nil)
  org-texinfo-export-to-texinfo(nil nil nil nil)
  org-export-dispatch(nil)
  call-interactively(org-export-dispatch nil nil)


> 
> I want to finish editing the Installation instructions, then tag the
> commit to indicate that it is "current" with org.texi.
> 
> Then, unless you think there is more to fix with the conversion, I'll
> get down to documenting Nicolas' work according to the instructions he
> gave me months ago. 
> 
> All the best,
> Tom
> 
> -- 
> Thomas S. Dye
> http://www.tsdye.com
>