Re: Bug#144456: ITP: qref -- debian quick reference.
Javi,
I can not see what your new doc dir arrangement staffs are since I do
not have shell access.
On Mon, May 06, 2002 at 10:59:59AM +0200, Javier Fern?ndez-Sanguino Pe?a wrote:
>That does not mean that it cannot reside in the CVS. Maybe there will
>be problems generating it automatically but even so, it can have a
>place under the DDP CVS. Please read
>http://www.debian.org/doc/docpolicy.en.html (debiandoc is preferred but
>other format might be used).
Sorry my ignorance. I never saw this :(
Interesting but really old.
-------
[IMG] Debian Project Select a server near you:
[______________] [ Go ]
About Debian News Distribution Support Developers' Corner Search
DDP Documentation Policy
Here is a list of decisions that were made on our mailing list and
approved by our Documentation Manager, Susan G. Kleinmann.
~~~~~~~~~~~~~~~~~~?
why (s)he is not participating
in this discussion?
* All manuals of the Debian Documentation Project (DDP) will be released
under DFSG-compliant licenses, most likely GPL.
No problem.
* We'll use the following directory structure:
These looks inconsistent in terms of choice of file types.
Filesystem:
/usr/share/doc/manuals/somemanual/index.html
/usr/share/doc/manuals/somemanual.ps.gz (optional)
Why just ps and no pdf?
WWW server:
http://www.debian.org/doc/manuals/somemanual/
FTP server:
ftp://ftp.debian.org/debian/doc/manuals/somemanual.html.tar.gz
ftp://ftp.debian.org/debian/doc/manuals/somemanual.text.gz
ftp://ftp.debian.org/debian/doc/manuals/somemanual.dvi.gz
ftp://ftp.debian.org/debian/doc/manuals/somemanual.ps.gz
ftp://ftp.debian.org/debian/doc/manuals/somemanual.sgml.tar.gz
Please note that this part of the policy hasn't been universally
accepted yet, so those URIs may not work. The real locations of
documents may vary for backwards compatibility.
---
Is not this more reasonable: (Osamu's thoughts)
Filesystem:
/usr/share/doc/manuals/somemanual/index.en.html
/usr/share/doc/manuals/somemanual/others.en.html
/usr/share/doc/manuals/somemanual/somemanual.en.txt.gz
/usr/share/doc/manuals/somemanual/somemanual.en.pdf(.gz)
/usr/share/doc/manuals/somemanual/somemanual.en.ps.gz
WWW server:
http://www.debian.org/doc/manuals/somemanual/index.en.html
http://www.debian.org/doc/manuals/somemanual/others.en.html
http://www.debian.org/doc/manuals/somemanual/somemanual.en.txt
http://www.debian.org/doc/manuals/somemanual/somemanual.en.pdf
http://www.debian.org/doc/manuals/somemanual/somemanual.en.ps
FTP server:
ftp://ftp.debian.org/debian/doc/manuals/somemanual/somemanual.en.html.tar.gz
ftp://ftp.debian.org/debian/doc/manuals/somemanual/somemanual.en.txt.gz
ftp://ftp.debian.org/debian/doc/manuals/somemanual/somemanual.en.pdf(.gz)
ftp://ftp.debian.org/debian/doc/manuals/somemanual/somemanual.en.ps.gz
ftp://ftp.debian.org/debian/doc/manuals/somemanual/somemanual.sgml.tar.gz
---
* We'll use SGML as source format.
Note that this does not mean that users have to learn SGML to submit
changes to our documents. We accept all other formats as well.
However, they will be translated into SGML by one of the Debian-Doc
people.
The other options were: LaTeX, HTML, Texinfo, and several other minor
formats.
* We'll use debiandoc-sgml for our documents.
The other options were linuxdoc-sgml or DocBook. Linuxdoc is no longer
maintained; DocBook is judged by many to be too big and complex and
difficult to customize.
* Every Debian document will have a single person listed as Maintainer
and might also have additional people listed as Co-Maintainers.
Maybe we need to have single author (+ single translator).
--------------------------------------------------------------------------
Please send all comments, criticisms and suggestions about these web pages
to our mailing list.
~~~~~~~~~~~~ where? be specific. www? or doc?
--------------------------------------------------------------------------
Back to the Debian Project homepage.
--------------------------------------------------------------------------
This page is also available in the following languages:
catal`a dansk Deutsch espanol franc,ais hrvatski Italiano
Russkij (Russkij) svenska
How to set the default document language
--------------------------------------------------------------------------
See the Debian contact page for information on contacting us.
Last Modified: Sun, May 5 00:03:50 UTC 2002
Copyright (c) 1997-2002 SPI; See license terms
This is very confusing statement. This must be last CVS co.
--
~\^o^/~~~ ~\^.^/~~~ ~\^*^/~~~ ~\^_^/~~~ ~\^+^/~~~ ~\^:^/~~~ ~\^v^/~~~ +++++
Osamu Aoki @ Cupertino CA USA
See "User's Guide": http://www.debian.org/doc/manuals/users-guide/
See "Debian reference": http://www.debian.org/doc/manuals/reference/
"Debian reference" Project at: http://qref.sf.net
I welcome your constructive criticisms and corrections.
--
To UNSUBSCRIBE, email to debian-doc-request@lists.debian.org
with a subject of "unsubscribe". Trouble? Contact listmaster@lists.debian.org
Reply to: