en/administrivia/administrivia.xml

<!-- retain these comments for translator revision tracking -->
<!-- $Id: administrivia.xml,v 1.6 2004/03/06 09:59:04 mck-guest Exp $ -->

<appendix id="administrivia">
 <title>Administrivia</title>


 <sect1 id="about">
 <title>About This Document</title>

<para>

This document is written in DocBook XML.  Output formats are generated
by various programs using information from the
<classname>docbook-xml</classname> and
<classname>docbook-xsl</classname> packages.

</para><para>

In order to increase the maintainability of this document, we use
a number of XML features, such as entities and profiling attributes.
These play a role akin to variables and conditionals in programming
languages.  The XML source to this document contains information for
each different architecture &mdash; profiling attributes are used to
isolate certain bits of text as architecture-specific.

</para>
 </sect1>

 <sect1 id="contributing">
 <title>Contributing to This Document</title>

<para>

If you have problems or suggestions regarding this document, you
should probably submit them as a bug report against the package
<classname>installer</classname>.  See the
<classname>reportbug</classname> package or read the online
documentation of the <ulink url="&url-bts;">Debian Bug
Tracking System</ulink>.  It would be nice if you could check the
<ulink url="&url-bts;install-doc">open bugs against
install-doc</ulink> to see whether your problem has already been
reported. If so, you can supply additional corroboration or helpful
information to
<email><replaceable>XXXX</replaceable>@bugs.debian.org</email>,
where <replaceable>XXXX</replaceable> is the number for the
already-reported bug.

</para><para>

Better yet, get a copy of the DocBook source for this document, and
produce patches against it.  The DocBook source can be found at the
<ulink url="&url-d-i-cvsweb;">debian-installer CVSWeb</ulink>. If
you're not familiar with DocBook, don't worry:
there is a simple cheatsheet in the manuals directory that will get
you started. It's like html, but oriented towards the meaning of 
the text rather than the presentation. Patches submitted to the 
debian-boot mailing list (see below) are welcomed.
For instructions on how to check out the sources via CVS, see
<ulink url="&url-d-i-readme;">README</ulink>
from the source root directory.

</para><para>

Please do <emphasis>not</emphasis> contact the authors of this
document directly.  There is also a discussion list for &d-i;, which
includes discussions of this manual.  The mailing list is
<email>debian-boot@lists.debian.org</email>.  Instructions for
subscribing to this list can be found at the <ulink
url="&url-debian-lists-subscribe;">Debian Mailing
List Subscription</ulink> page; or you can browse the <ulink
url="&url-debian-list-archives;">Debian Mailing List Archives</ulink>
online.

</para>

 </sect1> 

<!-- This is subject to constant flux, so we ripped that out -->

&contributors.xml;


 <sect1 id="contributors">
 <title>Major Contributions</title> 

<para>

Many, many Debian users and developers contributed to this document.
Particular note must be made for Michael Schmitz (m68k support), Frank
Neumann (original author of the <ulink
url="&url-m68k-old-amiga-install;">Amiga install manual</ulink>),
Arto Astala, Eric Delaunay/Ben Collins (SPARC information), Tapio
Lehtonen, and Stéphane Bortzmeyer for numerous edits and text.

</para><para>

Extremely helpful text and information was found in Jim Mintha's HOWTO
for network booting (no URL available), the <ulink
url="&url-debian-faq;">Debian FAQ</ulink>, the <ulink
url="&url-m68k-faq;">Linux/m68k FAQ</ulink>, the <ulink
url="&url-sparc-linux-faq;">Linux for SPARC Processors
FAQ</ulink>, the <ulink
url="&url-alpha-faq;">Linux/Alpha
FAQ</ulink>, amongst others.  The maintainers of these freely
available and rich sources of information must be recognized.

</para> 
 </sect1> 

 <sect1 id="trademarks">
 <title>Trademark Acknowledgement</title>
<para>

All trademarks are property of their respective trademark owners.

</para>
 </sect1> 
</appendix>

1	toff	3230	<!-- retain these comments for translator revision tracking -->
2	mck-guest	9967	<!-- $Id: administrivia.xml,v 1.6 2004/03/06 09:59:04 mck-guest Exp $ -->
3	toff	3230
4	mck-guest	8166	<appendix id="administrivia">
5	toff	3230	<title>Administrivia</title>
6
7
8			<sect1 id="about">
9			<title>About This Document</title>
10
11			<para>
12
13	mck-guest	8166	This document is written in DocBook XML. Output formats are generated
14			by various programs using information from the
15			<classname>docbook-xml</classname> and
16			<classname>docbook-xsl</classname> packages.
17	toff	3230
18	mck-guest	8166	</para><para>
19	toff	3230
20	mck-guest	8166	In order to increase the maintainability of this document, we use
21			a number of XML features, such as entities and profiling attributes.
22			These play a role akin to variables and conditionals in programming
23			languages. The XML source to this document contains information for
24			each different architecture — profiling attributes are used to
25			isolate certain bits of text as architecture-specific.
26
27			</para>
28	toff	3230	</sect1>
29
30			<sect1 id="contributing">
31			<title>Contributing to This Document</title>
32
33	mck-guest	8166	<para>
34
35			If you have problems or suggestions regarding this document, you
36	toff	3230	should probably submit them as a bug report against the package
37	mck-guest	8166	<classname>installer</classname>. See the
38			<classname>reportbug</classname> package or read the online
39	mck-guest	9967	documentation of the <ulink url="&url-bts;">Debian Bug
40	mck-guest	8166	Tracking System</ulink>. It would be nice if you could check the
41	mck-guest	9967	<ulink url="&url-bts;install-doc">open bugs against
42	mck-guest	8166	install-doc</ulink> to see whether your problem has already been
43			reported. If so, you can supply additional corroboration or helpful
44			information to
45			<email><replaceable>XXXX</replaceable>@bugs.debian.org</email>,
46			where <replaceable>XXXX</replaceable> is the number for the
47			already-reported bug.
48	toff	3230
49	mck-guest	8166	</para><para>
50
51			Better yet, get a copy of the DocBook source for this document, and
52	toff	3230	produce patches against it. The DocBook source can be found at the
53	mck-guest	8166	<ulink url="&url-d-i-cvsweb;">debian-installer CVSWeb</ulink>. If
54			you're not familiar with DocBook, don't worry:
55	toff	3230	there is a simple cheatsheet in the manuals directory that will get
56			you started. It's like html, but oriented towards the meaning of
57			the text rather than the presentation. Patches submitted to the
58			debian-boot mailing list (see below) are welcomed.
59			For instructions on how to check out the sources via CVS, see
60	mck-guest	8166	<ulink url="&url-d-i-readme;">README</ulink>
61	toff	3230	from the source root directory.
62
63	mck-guest	8166	</para><para>
64
65			Please do <emphasis>not</emphasis> contact the authors of this
66			document directly. There is also a discussion list for &d-i;, which
67			includes discussions of this manual. The mailing list is
68	toff	3230	<email>debian-boot@lists.debian.org</email>. Instructions for
69	mck-guest	8166	subscribing to this list can be found at the <ulink
70			url="&url-debian-lists-subscribe;">Debian Mailing
71			List Subscription</ulink> page; or you can browse the <ulink
72			url="&url-debian-list-archives;">Debian Mailing List Archives</ulink>
73	toff	3230	online.
74
75	mck-guest	8166	</para>
76
77	toff	3230	</sect1>
78
79	mck-guest	8166	<!-- This is subject to constant flux, so we ripped that out -->
80	toff	3230
81	mck-guest	8166	&contributors.xml;
82
83
84	toff	3230	<sect1 id="contributors">
85			<title>Major Contributions</title>
86
87	mck-guest	8166	<para>
88
89			Many, many Debian users and developers contributed to this document.
90			Particular note must be made for Michael Schmitz (m68k support), Frank
91			Neumann (original author of the <ulink
92	mck-guest	9967	url="&url-m68k-old-amiga-install;">Amiga install manual</ulink>),
93	mck-guest	8166	Arto Astala, Eric Delaunay/Ben Collins (SPARC information), Tapio
94			Lehtonen, and Stéphane Bortzmeyer for numerous edits and text.
95
96			</para><para>
97
98			Extremely helpful text and information was found in Jim Mintha's HOWTO
99			for network booting (no URL available), the <ulink
100	mck-guest	9967	url="&url-debian-faq;">Debian FAQ</ulink>, the <ulink
101			url="&url-m68k-faq;">Linux/m68k FAQ</ulink>, the <ulink
102			url="&url-sparc-linux-faq;">Linux for SPARC Processors
103	mck-guest	8166	FAQ</ulink>, the <ulink
104	mck-guest	9967	url="&url-alpha-faq;">Linux/Alpha
105	mck-guest	8166	FAQ</ulink>, amongst others. The maintainers of these freely
106			available and rich sources of information must be recognized.
107
108	toff	3230	</para>
109			</sect1>
110
111	mck-guest	8166	<sect1 id="trademarks">
112			<title>Trademark Acknowledgement</title>
113	toff	3230	<para>
114	mck-guest	8166
115			All trademarks are property of their respective trademark owners.
116
117	toff	3230	</para>
118			</sect1>
119	mck-guest	8166	</appendix>
120