Re: [O] [RFC] Org version of the Org manual

[Carsten Dominik]

On 17.3.2013, at 02:19, Thomas S. Dye <address@hidden> wrote:

> Hi Achim,
> 
> Achim Gratz <address@hidden> 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\"!     !\207" [res limit intern format 
"org-element-%s-successor"] 4](text-markup)
  mapcar(#[(res) "\302\303\304\"!      !\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      
\n#\211\203\230
\307\310\311\312\313\n\"\"\n\"\211A\fV\203$\314\315
\"address@hidden"! \321;address@hidden"* 
\325;address@hidden"*!\326;address@hidden"*\211\"\fX\203\340\"U\204\254\"b\210\202\223
\314\315\327
#\211;address@hidden"\210\202\223
 \203\363 
\fV\204\363!\fW\203'
\314\315\327
#\211;address@hidden"\210\202\223
 b\210\327
#\211;address@hidden:\204}
;address@hidden@)$\236A)\334!,)\202
\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
>