The OpenNET Project / Index page

[ новости /+++ | форум | wiki | теги | ]

Поиск:  Каталог документации / Документация по FreeBSD / Руководства по FreeBSD на английском

Chapter 6. Structuring documents under doc/

Table of Contents
61.
6.1. The top level, doc/
6.2. The lang.encoding/ directories
6.3. Document specific information

The doc/ tree is organised in a particular fashion, and the documents that are part of the FDP are in turn organised in a particular fashion. The aim is to make it simple to add new documentation in to the tree and:

  1. make it easy to automate converting the document to other formats

  2. promote consistency between the different documentation organisations, to make it easier to switch between working on different documents

  3. make it easy to decide where in the tree new documentation should be placed

In addition, the documentation tree has to accommodate documentation that could be in many different languages and in many different encodings. It is important that the structure of the documentation tree does not enforce any particular defaults or cultural preferences.

6.1. The top level, doc/

There are two types of directory under doc/, each with very specific directory names and meanings.

share/ Contains files that are not specific to the various translations and encodings of the documentation. Contains subdirectories to further categorise the information. For example, the files that comprise the make(1) infrastructure are in share/mk, while the additional SGML support files (such as the FreeBSD extended DocBook DTD) are in share/sgml.
lang.encoding/ One directory exists for each available translation and encoding of the documentation, for example en_US.ISO_8859-1/ and zh_TW.Big5/. The names are long, but by fully specifying the language and encoding we prevent any future headaches should a translation team want to provide the documentation in the same language but in more than one encoding. This also completely isolates us from any problems that might be caused by a switch to Unicode.

For questions about FreeBSD, e-mail <questions@FreeBSD.org>.
For questions about this documentation, e-mail <doc@FreeBSD.org>.




Партнёры:
PostgresPro
Inferno Solutions
Hosting by Hoster.ru
Хостинг:

Закладки на сайте
Проследить за страницей
Created 1996-2024 by Maxim Chirkov
Добавить, Поддержать, Вебмастеру