en/administrivia/administrivia.xml

<!-- retain these comments for translator revision tracking -->
<!-- $Id$ -->

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


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

<para>

This manual was created for Sarge's debian-installer, based on
the Woody installation manual for boot-floppies, which was based
on earlier Debian installation manuals, and on the Progeny
distribution manual which was released under GPL in 2003.

</para><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><para condition="about-langteam">

Translators can use this paragraph to acknowledge the people responsible
for the translation of the manual.
Translation teams are advised to just mention the coordinator and maybe
major contributors and thank everybody else in a phrase like "all
translators and reviewers from the translation team for {your language}
at {your l10n mailinglist}".

See build/lang-options/README on how to enable this paragraph.
Its condition is "about-langteam".

</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>installation-guide</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;installation-guide">open bugs against
installation-guide</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-websvn;">debian-installer WebSVN</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 SVN, 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>

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

<para>

This document was originally written by Bruce Perens, Sven Rudolph, Igor
Grobman, James Treacy, and Adam Di Carlo. Sebastian Ley wrote the
Installation Howto.

</para><para>

Miroslav Kuře has documented a lot of the new functionality in Sarge's
debian-installer. Frans Pop was the main editor and release manager during
the Etch, Lenny and Squeeze releases.

</para><para>

Many, many Debian users and developers contributed to this document.
Particular note must be made of 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.
We have to thank Pascal Le Bail for useful information about booting
from USB memory sticks.

</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><para>

The section on chrooted installations in this manual
(<xref linkend="linux-upgrade"/>) was derived in part from
documents copyright Karsten M. Self.

</para><para arch="x86">

The section on installations over plip in this manual
(<xref linkend="plip"/>) was based on the
<ulink url="&url-plip-install-howto;">PLIP-Install-HOWTO</ulink>
by Gilles Lamiral.

</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	joeyh	11648	<!-- $Id$ -->
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	fjpop-guest	26027	This manual was created for Sarge's debian-installer, based on
14			the Woody installation manual for boot-floppies, which was based
15	holger-guest	64955	on earlier Debian installation manuals, and on the Progeny
16	fjpop-guest	26027	distribution manual which was released under GPL in 2003.
17
18			</para><para>
19
20	mck-guest	8166	This document is written in DocBook XML. Output formats are generated
21			by various programs using information from the
22			<classname>docbook-xml</classname> and
23			<classname>docbook-xsl</classname> packages.
24	toff	3230
25	mck-guest	8166	</para><para>
26	toff	3230
27	mck-guest	8166	In order to increase the maintainability of this document, we use
28			a number of XML features, such as entities and profiling attributes.
29			These play a role akin to variables and conditionals in programming
30			languages. The XML source to this document contains information for
31			each different architecture — profiling attributes are used to
32			isolate certain bits of text as architecture-specific.
33
34	fjp	38900	</para><para condition="about-langteam">
35	fjpop-guest	26027
36	fjp	38900	Translators can use this paragraph to acknowledge the people responsible
37			for the translation of the manual.
38	fjpop-guest	26027	Translation teams are advised to just mention the coordinator and maybe
39			major contributors and thank everybody else in a phrase like "all
40	fjp	38901	translators and reviewers from the translation team for {your language}
41			at {your l10n mailinglist}".
42	fjpop-guest	26027
43	fjp	38900	See build/lang-options/README on how to enable this paragraph.
44			Its condition is "about-langteam".
45	fjpop-guest	26027
46	mck-guest	8166	</para>
47	toff	3230	</sect1>
48
49			<sect1 id="contributing">
50			<title>Contributing to This Document</title>
51
52	mck-guest	8166	<para>
53
54			If you have problems or suggestions regarding this document, you
55	toff	3230	should probably submit them as a bug report against the package
56	fjp	43043	<classname>installation-guide</classname>. See the
57	mck-guest	8166	<classname>reportbug</classname> package or read the online
58	mck-guest	9967	documentation of the <ulink url="&url-bts;">Debian Bug
59	mck-guest	8166	Tracking System</ulink>. It would be nice if you could check the
60	fjp	43043	<ulink url="&url-bts;installation-guide">open bugs against
61			installation-guide</ulink> to see whether your problem has
62	mck-guest	14602	already been reported. If so, you can supply additional corroboration
63			or helpful information to
64	mck-guest	8166	<email><replaceable>XXXX</replaceable>@bugs.debian.org</email>,
65			where <replaceable>XXXX</replaceable> is the number for the
66			already-reported bug.
67	toff	3230
68	mck-guest	8166	</para><para>
69
70			Better yet, get a copy of the DocBook source for this document, and
71	toff	3230	produce patches against it. The DocBook source can be found at the
72	fjpop-guest	25030	<ulink url="&url-d-i-websvn;">debian-installer WebSVN</ulink>. If
73	mck-guest	8166	you're not familiar with DocBook, don't worry:
74	toff	3230	there is a simple cheatsheet in the manuals directory that will get
75	fjp	28672	you started. It's like html, but oriented towards the meaning of
76			the text rather than the presentation. Patches submitted to the
77	toff	3230	debian-boot mailing list (see below) are welcomed.
78	fjpop-guest	25030	For instructions on how to check out the sources via SVN, see
79	mck-guest	8166	<ulink url="&url-d-i-readme;">README</ulink>
80	toff	3230	from the source root directory.
81
82	mck-guest	8166	</para><para>
83
84			Please do <emphasis>not</emphasis> contact the authors of this
85			document directly. There is also a discussion list for &d-i;, which
86			includes discussions of this manual. The mailing list is
87	toff	3230	<email>debian-boot@lists.debian.org</email>. Instructions for
88	mck-guest	8166	subscribing to this list can be found at the <ulink
89			url="&url-debian-lists-subscribe;">Debian Mailing
90			List Subscription</ulink> page; or you can browse the <ulink
91			url="&url-debian-list-archives;">Debian Mailing List Archives</ulink>
92	toff	3230	online.
93
94	mck-guest	8166	</para>
95
96	fjp	28672	</sect1>
97	toff	3230
98			<sect1 id="contributors">
99	fjp	28672	<title>Major Contributions</title>
100	toff	3230
101	mck-guest	8166	<para>
102
103	joeyh	18673	This document was originally written by Bruce Perens, Sven Rudolph, Igor
104	joeyh	18675	Grobman, James Treacy, and Adam Di Carlo. Sebastian Ley wrote the
105			Installation Howto.
106	fjp	63941
107			</para><para>
108
109			Miroslav Kuře has documented a lot of the new functionality in Sarge's
110			debian-installer. Frans Pop was the main editor and release manager during
111			the Etch, Lenny and Squeeze releases.
112
113			</para><para>
114
115	holger-guest	64955	Many, many Debian users and developers contributed to this document.
116	fjpop-guest	26027	Particular note must be made of Michael Schmitz (m68k support), Frank
117	mck-guest	8166	Neumann (original author of the <ulink
118	mck-guest	9967	url="&url-m68k-old-amiga-install;">Amiga install manual</ulink>),
119	mck-guest	8166	Arto Astala, Eric Delaunay/Ben Collins (SPARC information), Tapio
120			Lehtonen, and Stéphane Bortzmeyer for numerous edits and text.
121	mck-guest	10377	We have to thank Pascal Le Bail for useful information about booting
122	fjp	63941	from USB memory sticks.
123	mck-guest	8166
124			</para><para>
125
126			Extremely helpful text and information was found in Jim Mintha's HOWTO
127			for network booting (no URL available), the <ulink
128	mck-guest	9967	url="&url-debian-faq;">Debian FAQ</ulink>, the <ulink
129			url="&url-m68k-faq;">Linux/m68k FAQ</ulink>, the <ulink
130			url="&url-sparc-linux-faq;">Linux for SPARC Processors
131	mck-guest	8166	FAQ</ulink>, the <ulink
132	mck-guest	9967	url="&url-alpha-faq;">Linux/Alpha
133	mck-guest	8166	FAQ</ulink>, amongst others. The maintainers of these freely
134			available and rich sources of information must be recognized.
135
136	dnusinow-guest	28857	</para><para>
137
138	fjp	28996	The section on chrooted installations in this manual
139			(<xref linkend="linux-upgrade"/>) was derived in part from
140			documents copyright Karsten M. Self.
141
142	fjp	39614	</para><para arch="x86">
143	fjp	29687
144			The section on installations over plip in this manual
145			(<xref linkend="plip"/>) was based on the
146			<ulink url="&url-plip-install-howto;">PLIP-Install-HOWTO</ulink>
147			by Gilles Lamiral.
148
149	fjp	28996	</para>
150	fjp	28672	</sect1>
151	toff	3230
152	mck-guest	8166	<sect1 id="trademarks">
153			<title>Trademark Acknowledgement</title>
154	toff	3230	<para>
155	mck-guest	8166
156			All trademarks are property of their respective trademark owners.
157
158	toff	3230	</para>
159	fjp	28672	</sect1>
160	mck-guest	8166	</appendix>
161