emacs-orgmode@gnu.org archives
 help / color / mirror / code / Atom feed
* Org mode manual export
@ 2021-05-22 17:12 Thomas S. Dye
  2021-05-22 17:30 ` Greg Minshall
  2021-05-22 17:48 ` Kyle Meyer
  0 siblings, 2 replies; 4+ messages in thread
From: Thomas S. Dye @ 2021-05-22 17:12 UTC (permalink / raw)
  To: orgmode

Aloha all,

The Org mode FAQ on Worg correctly reports that the Org mode 
manual is written in Org mode, but it implies that it is exported 
to texinfo using pandoc--"You can export .org files to texinfo 
using Pandoc".

I thought the manual was exported to texinfo with ox-texinfo, but 
I don't know for certain.

Can someone confirm how the Org mode manual is exported to 
texinfo, please?

I'll update the FAQ if necessary.

All the best,
Tom

--
Thomas S. Dye
https://tsdye.online/tsdye


^ permalink raw reply	[flat|nested] 4+ messages in thread

* Re: Org mode manual export
  2021-05-22 17:12 Org mode manual export Thomas S. Dye
@ 2021-05-22 17:30 ` Greg Minshall
  2021-05-22 17:48 ` Kyle Meyer
  1 sibling, 0 replies; 4+ messages in thread
From: Greg Minshall @ 2021-05-22 17:30 UTC (permalink / raw)
  To: Thomas S. Dye; +Cc: orgmode

Thomas, indeed, aloha.

while waiting for authoritative information, i'll notice that the
Makefile calls an elisp function
----
(defun org-make-manuals ()
  "Generate the Texinfo files out of Org manuals."
  (require 'ox-texinfo)
  (dolist (manual '("../doc/org-manual.org" "../doc/org-guide.org"))
    (find-file manual)
    (org-texinfo-export-to-texinfo)))
----

and, (org-texinfo-export-to-texinfo) (in ox-texinfo.el) seems a
fully-functioning export module, and i don't see any reference to pandoc
in it.  (but, i've never looked at that code before.)

cheers, Greg


^ permalink raw reply	[flat|nested] 4+ messages in thread

* Re: Org mode manual export
  2021-05-22 17:12 Org mode manual export Thomas S. Dye
  2021-05-22 17:30 ` Greg Minshall
@ 2021-05-22 17:48 ` Kyle Meyer
  2021-05-22 18:12   ` Thomas S. Dye
  1 sibling, 1 reply; 4+ messages in thread
From: Kyle Meyer @ 2021-05-22 17:48 UTC (permalink / raw)
  To: Thomas S. Dye, orgmode

Thomas S. Dye writes:

> Aloha all,
>
> The Org mode FAQ on Worg correctly reports that the Org mode 
> manual is written in Org mode, but it implies that it is exported 
> to texinfo using pandoc--"You can export .org files to texinfo 
> using Pandoc".
>
> I thought the manual was exported to texinfo with ox-texinfo, but 
> I don't know for certain.
>
> Can someone confirm how the Org mode manual is exported to 
> texinfo, please?

Yes, you're right that ox-texinfo is used.

In doc/Makefile there's

  org.texi orgguide.texi:	org-manual.org org-guide.org
  	$(BATCH) 				      \
  	  --eval '(add-to-list `load-path "../lisp")' \
  	  --eval '(load "../mk/org-fixup.el")' 	      \
  	  --eval '(org-make-manuals)'

where org-make-manuals is defined in mk/org-fixup.el as

  (defun org-make-manuals ()
    "Generate the Texinfo files out of Org manuals."
    (require 'ox-texinfo)
    (dolist (manual '("../doc/org-manual.org" "../doc/org-guide.org"))
      (find-file manual)
      (org-texinfo-export-to-texinfo)))


^ permalink raw reply	[flat|nested] 4+ messages in thread

* Re: Org mode manual export
  2021-05-22 17:48 ` Kyle Meyer
@ 2021-05-22 18:12   ` Thomas S. Dye
  0 siblings, 0 replies; 4+ messages in thread
From: Thomas S. Dye @ 2021-05-22 18:12 UTC (permalink / raw)
  To: Kyle Meyer; +Cc: orgmode

Done.  Thanks!

All the best,
Tom

Kyle Meyer <kyle@kyleam.com> writes:

> Thomas S. Dye writes:
>
>> Aloha all,
>>
>> The Org mode FAQ on Worg correctly reports that the Org mode
>> manual is written in Org mode, but it implies that it is 
>> exported
>> to texinfo using pandoc--"You can export .org files to texinfo
>> using Pandoc".
>>
>> I thought the manual was exported to texinfo with ox-texinfo, 
>> but
>> I don't know for certain.
>>
>> Can someone confirm how the Org mode manual is exported to
>> texinfo, please?
>
> Yes, you're right that ox-texinfo is used.
>
> In doc/Makefile there's
>
>   org.texi orgguide.texi:	org-manual.org org-guide.org
>   	$(BATCH) 				      \
>   	  --eval '(add-to-list `load-path "../lisp")' \
>   	  --eval '(load "../mk/org-fixup.el")' 	      \
>   	  --eval '(org-make-manuals)'
>
> where org-make-manuals is defined in mk/org-fixup.el as
>
>   (defun org-make-manuals ()
>     "Generate the Texinfo files out of Org manuals."
>     (require 'ox-texinfo)
>     (dolist (manual '("../doc/org-manual.org" 
>     "../doc/org-guide.org"))
>       (find-file manual)
>       (org-texinfo-export-to-texinfo)))


--
Thomas S. Dye
https://tsdye.online/tsdye


^ permalink raw reply	[flat|nested] 4+ messages in thread

end of thread, other threads:[~2021-05-22 18:13 UTC | newest]

Thread overview: 4+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2021-05-22 17:12 Org mode manual export Thomas S. Dye
2021-05-22 17:30 ` Greg Minshall
2021-05-22 17:48 ` Kyle Meyer
2021-05-22 18:12   ` Thomas S. Dye

Code repositories for project(s) associated with this inbox:

	https://git.savannah.gnu.org/cgit/emacs/org-mode.git

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).