1
0
Fork 0
doc/about/contribute/documentation/file-names.en.tm

59 lines
2.1 KiB
Plaintext
Raw Normal View History

2011-09-02 06:57:35 +08:00
<TeXmacs|1.0.7.12>
2011-08-28 15:59:50 +08:00
<style|tmdoc>
<\body>
2011-09-02 06:57:35 +08:00
<tmdoc-title|Conventions for the names of files>
2011-08-28 15:59:50 +08:00
Most documentation should be organized as a function of the topic in a
directory tree. The subdirectories of the top directory are the following:
<\description>
2011-09-02 06:57:35 +08:00
<item*|about>Various information about the <TeXmacs> system (authors,
changes, <abbr|etc.>).
2011-08-28 15:59:50 +08:00
2011-09-02 06:57:35 +08:00
<item*|devel>Documentation for developers.
2011-08-28 15:59:50 +08:00
2011-09-02 06:57:35 +08:00
<item*|main>The main documentation.
2011-08-28 15:59:50 +08:00
</description>
Please try to keep the number of entries per directory reasonably small.
File names in the main directory should be of the form
<verbatim|type-name.language.tm>. In the other directories, they are of the
form <verbatim|name.language.tm>. Here <verbatim|type> is a major
indication for the type of documentation; it should be one of the
following:
<\description>
2011-09-02 06:57:35 +08:00
<item*|man>For inclusion in the <TeXmacs> manual.
2011-08-28 15:59:50 +08:00
2011-09-02 06:57:35 +08:00
<item*|tut>For inclusion in the <TeXmacs> tutorial.
2011-08-28 15:59:50 +08:00
</description>
You should try to keep the documentation on the same topic together,
regardless of the type. Indeed, this allows you to find more easily all
existing documentation on a particular topic. Also, it may happen that you
want to include some documentation which was initially meant for the
tutorial in the manual. The <verbatim|language> in which is the
documentation has been written should be a two letter code like
<verbatim|en>, <verbatim|fr>, etc. The main <verbatim|name> of your file
should be the same for the translations in other languages. For instance,
<verbatim|man-keyboard.en.tm> should not be translated as
<verbatim|man-clavier.fr.tm>.
2011-09-02 06:57:35 +08:00
<tmdoc-copyright|1998--2002|Joris van der Hoeven>
2011-08-28 15:59:50 +08:00
2011-09-02 06:57:35 +08:00
<tmdoc-license|Permission is granted to copy, distribute and/or modify this
document under the terms of the GNU Free Documentation License, Version 1.1
or any later version published by the Free Software Foundation; with no
Invariant Sections, with no Front-Cover Texts, and with no Back-Cover
Texts. A copy of the license is included in the section entitled "GNU Free
Documentation License".>
2011-08-28 15:59:50 +08:00
</body>
<\initial>
<\collection>
<associate|language|english>
</collection>
2011-09-02 06:57:35 +08:00
</initial>