Documentation of option --data-dir

[tobiasschweizer]

I found out that the directory passed to the option --data-dir has to contain a folder templates in order to work properly. For example, if you use the options --template=mytemplate.latex and --data-dir=/home/myuser/myfolder pandoc expects to find mytemplate.latex at this location: /home/myuser/myfolder/templates/mytemplate.latex.

This behaviour is totally fine but it was not clear to me just after having read the man:

--data-dir=DIRECTORY
Specify the user data directory to search for pandoc data files.

Maybe, you could just add some information to this section.

[jgm]

I think the information is there:

   A `reference.odt`, `reference.docx`, `default.csl`,
    `epub.css`, `templates`, `slidy`, `slideous`, or `s5` directory
    placed in this directory will override pandoc's normal defaults.

This says clearly that a templates directory placed here will override defaults.
But I see a way to clarify the docs in the --template option.

[tobiasschweizer]

Great, that will make it even more clear