docs: more cleanup
Dimitrie O. Paun
dimi at intelliware.ca
Tue Sep 23 10:27:33 CDT 2003
OK,
After applying this patch, please do a:
cvs rm -f documentation/{authors.ent,wine-doc.sgml}
The authors.ent was a real strange idea to begin with,
and wine-doc.sgml has not been used in a long time
(that is, should have been deleted long time ago).
ChangeLog
Dimitrie O. Paun <dpaun at rogers.com>
Move authors to the wine-user.sgml.
Remove unused files.
Index: documentation/configuring.sgml
===================================================================
RCS file: /var/cvs/wine/documentation/configuring.sgml,v
retrieving revision 1.34
diff -u -r1.34 configuring.sgml
--- documentation/configuring.sgml 2 Sep 2003 18:17:23 -0000 1.34
+++ documentation/configuring.sgml 23 Sep 2003 14:16:54 -0000
@@ -31,11 +31,6 @@
<sect1 id="config-requirements-windows" xreflabel="--Installing Section--">
<title>What are the requirements of a fully working Windows environment?</title>
- <para>
- Formerly a part of: "WWN #52 Feature: Replacing Windows".
- Written by &name-ove-kaaven; <email>&email-ove-kaaven;</email>
- </para>
-
<para>
A Windows installation is a very complex structure. It consists of
many different parts with very different functionality.
@@ -207,10 +202,6 @@
and a complete reference to all Wine configuration file settings (for
advanced users).
</para>
- <para>
- Parts taken from the former file <filename>wine/documentation/config</filename>,
- Copyright 1999 &name-adam-sacarny; <email>&email-adam-sacarny;</email>
- </para>
<sect2>
<title>Configuration File Introduction</title>
@@ -1378,12 +1369,6 @@
<sect2 id="config-no-windows">
<title>Installing Wine Without Windows</title>
- <para>
- Written by &name-james-juran; <email>&email-james-juran;</email>
- </para>
- <para>
- (Extracted from <filename>wine/documentation/no-windows</filename>)
- </para>
<para>
A major goal of Wine is to allow users to run Windows programs
@@ -1548,12 +1533,6 @@
<sect2 id="config-drive-vfat">
<title>Dealing With FAT/VFAT Partitions</title>
<para>
- Written by &name-steven-elliott; <email>&email-steven-elliott;</email>
- </para>
- <para>
- (Extracted from <filename>wine/documentation/linux-fat-permissions</filename>)
- </para>
- <para>
This document describes how FAT and
VFAT file system permissions work in Linux
with a focus on configuring them for Wine.
@@ -1766,40 +1745,9 @@
</sect2>
<sect2 id="config-drive-cdrom-labels">
- <sect2info>
- <authorgroup>
- <author>
- <firstname>Petr</firstname>
- <surname>Tomasek</surname>
- <affiliation>
- <address><email>&email-petr-tomasek;</email></address>
- </affiliation>
- <contrib>Nov 14 1999</contrib>
- </author>
- <author>
- <firstname>Andreas</firstname>
- <surname>Mohr</surname>
- <affiliation>
- <address><email>&email-andreas-mohr;</email></address>
- </affiliation>
- <contrib>Jan 25 2000</contrib>
- </author>
- </authorgroup>
- </sect2info>
<title>Drive labels and serial numbers</title>
<para>
- Written by &name-petr-tomasek; <email>&email-petr-tomasek;</email>
- Nov 14 1999
- </para>
- <para>
- Changes by &name-andreas-mohr; <email>&email-andreas-mohr;</email>
- Jan 25 2000
- </para>
- <para>
- (Extracted from <filename>wine/documentation/cdrom-labels</filename>)
- </para>
- <para>
Until now, your only possibility of specifying drive volume
labels and serial numbers was to set them manually in the wine
configuration file. By now, wine can read them directly from the
@@ -2065,13 +2013,6 @@
<title>DLL Overrides</title>
<para>
- Written by &name-ove-kaaven; <email>&email-ove-kaaven;</email>
-</para>
-<para>
- (Extracted from <filename>wine/documentation/dll-overrides</filename>)
-</para>
-
-<para>
The wine configuration file directives [DllDefaults]
and [DllOverrides] are the subject of some confusion. The
overall purpose of most of these directives are clear enough,
@@ -2458,10 +2399,6 @@
<title>Missing DLLs</title>
<para>
- Written by &name-andreas-mohr; <email>&email-andreas-mohr;</email>
-</para>
-
-<para>
In case Wine complains about a missing DLL, you should check whether
this file is a publicly available DLL or a custom DLL belonging
to your program (by searching for its name on the internet).
@@ -2516,10 +2453,6 @@
<title>Fetching native DLLs from a Windows CD</title>
<para>
- Written by &name-andreas-mohr; <email>&email-andreas-mohr;</email>
-</para>
-
-<para>
The Linux <command>cabextract</command> utility can be used to
extract native Windows .dll files from .cab files that are to be
found on many Windows installation CDs.
@@ -2555,13 +2488,6 @@
<sect2>
<title>Configuring the x11drv graphics driver</title>
-<para>
- Written by &name-ove-kaaven; <email>&email-ove-kaaven;</email>
-</para>
-<para>
- (Extracted from <filename>wine/documentation/x11drv</filename>)
-</para>
-
<sect3>
<title>x11drv modes of operation</title>
@@ -2806,11 +2732,6 @@
<title>Setting the Windows and DOS version value</title>
<para>
-Written by &name-andreas-mohr; <email>&email-andreas-mohr;</email>
-Oct 18 2002
-</para>
-
-<para>
The windows and DOS version value a program gets e.g. by calling the
Windows function GetVersion() plays a very important role:
If your Wine installation for whatever reason fails to provide
@@ -2876,15 +2797,6 @@
<sect1 id="config-win95look">
<title>Win95/98 Look And Feel</title>
<para>
-Written by &name-david-cuthbert; <email>&email-david-cuthbert;</email>
-</para>
-<para>
-(Extracted from <filename>wine/documentation/win95look</filename>)
-</para>
-<para>
-Win95/Win98 interface code is being introduced.
-</para>
-<para>
Instead of compiling Wine for Win3.1 vs. Win95 using
<constant>#define</constant> switches, the code now looks in a
special [Tweak.Layout] section of
@@ -2919,13 +2831,6 @@
<title>Keyboard</title>
<para>
-Written by &name-ove-kaaven; <email>&email-ove-kaaven;</email>
-</para>
-<para>
-(Extracted from <filename>wine/documentation/keyboard</filename>)
-</para>
-
-<para>
Wine now needs to know about your keyboard layout. This
requirement comes from a need from many apps to have the
correct scancodes available, since they read these directly,
@@ -3097,14 +3002,6 @@
<sect1 id="config-scsi-support">
<title>SCSI Support</title>
- <para>
- Written by &name-bruce-milner; <email>&email-bruce-milner;</email>;
- Additions by &name-andreas-mohr; <email>&email-andreas-mohr;</email>
- </para>
- <para>
- (Extracted from <filename>wine/documentation/aspi</filename>)
- </para>
-
<para>
This file describes setting up the Windows ASPI interface.
</para>
Index: documentation/fonts.sgml
===================================================================
RCS file: /var/cvs/wine/documentation/fonts.sgml,v
retrieving revision 1.15
diff -u -r1.15 fonts.sgml
--- documentation/fonts.sgml 21 Jul 2003 22:42:50 -0000 1.15
+++ documentation/fonts.sgml 23 Sep 2003 14:11:20 -0000
@@ -5,13 +5,6 @@
<title>Fonts</title>
<para>
- Written by &name-alex-korobka; <email>&email-alex-korobka;</email>
- </para>
- <para>
- (Extracted from <filename>wine/documentation/fonts</filename>)
- </para>
-
- <para>
<note>
<para>
The <command>fnt2bdf</command> utility is included with
@@ -387,13 +380,6 @@
<sect2 id="ttfont-server">
<title>Setting up a TrueType Font Server</title>
- <para>
- written by ???
- </para>
- <para>
- (Extracted from <filename>wine/documentation/ttfserver</filename>)
- </para>
-
<para>
Follow these instructions to set up a TrueType font server on your system.
</para>
Index: documentation/introduction.sgml
===================================================================
RCS file: /var/cvs/wine/documentation/introduction.sgml,v
retrieving revision 1.16
diff -u -r1.16 introduction.sgml
--- documentation/introduction.sgml 18 Aug 2003 20:11:29 -0000 1.16
+++ documentation/introduction.sgml 23 Sep 2003 14:22:00 -0000
@@ -14,16 +14,9 @@
of the Wine environment as a whole.
</para>
<para>
- It tries to target both the new Wine user (aka "bloody newbie"),
- by offering a step by step approach, and the experienced Wine
- user or expert, by offering the reference material mentioned
- above.
- </para>
- <para>
- The whole document has been extensively rewritten (in other
- words: the document then deserved to be called a document :-) by
- &name-andreas-mohr; <email>&email-andreas-mohr;</email> in
- March 2003.
+ It tries to target both the new Wine user, by offering a step by
+ step approach, and the experienced Wine user, by offering the reference
+ material mentioned above.
</para>
</sect2>
@@ -32,9 +25,8 @@
<para>
If during reading this document there is something you
can't figure out, or think could be explained better, or
- that should have been included, please immediately mail to
- either the &name-web-admin; <email>&email-web-admin;</email> or
- the &name-wine-devel; <email>&email-wine-devel;</email>, or
+ that should have been included, please immediately mail to the
+ <ulink url="mailto:wine-devel at winehq.org">wine-devel</ulink>, or
post a bug report to
<ulink url="http://bugs.winehq.com/">Wine's Bugzilla</ulink> to
let us know how this document can be improved. Remember, Open
@@ -119,13 +111,6 @@
<sect1 id="what-is-wine">
<title>What is Wine?</title>
- <para>
- <literallayout>
- Written by &name-john-sheets; <email>&email-john-sheets;</email>
- Modified by &name-dustin-navea; <email>&email-dustin-navea;</email>
- </literallayout>
- </para>
-
<sect2>
<title>Windows and Linux</title>
<!-- general description of wine, what does it do? -->
@@ -286,31 +271,6 @@
</sect2>
</sect1>
-<!-- *** Not really useful as is, but may be able to recycle this elsewhere...
- <sect1 id="getting-started">
- <title>Getting started</title>
-
- <para>
- Written by &name-john-sheets; <email>&email-john-sheets;</email>
- </para>
-
- <para>
- Wine can be pretty intimidating at first. The Wine
- distribution consists of over four thousand files and almost a
- million lines of source code
- <footnote>
- <para>Crudely calculated from running <command>find . | wc
- -l</command> and <command>cat `find . -name "*.c"` | wc
- -l</command>, respectively, from a fresh CVS checkout.</para>
- </footnote>,
- and is probably one of the steepest learning curves in the
- open source world. This chapter will give you a crash course
- in the important topics you need to know to get started with
- running Wine applications.
- </para>
- </sect1>
--->
-
<sect1 id="other-wines">
<title>Other, often "Enhanced" Wine offerings</title>
@@ -485,13 +445,6 @@
</sect1>
<sect1 id="wine-stats">
<title>Basic Wine Requirements</title>
-
- <para>
- <literallayout>
- Written by &name-andreas-mohr; <email>&email-andreas-mohr;</email>
- Modified by &name-dustin-navea; <email>&email-dustin-navea;</email>
- </literallayout>
- </para>
<para>
This section only mentions the most basic system requirements of
Index: documentation/printing.sgml
===================================================================
RCS file: /var/cvs/wine/documentation/printing.sgml,v
retrieving revision 1.16
diff -u -r1.16 printing.sgml
--- documentation/printing.sgml 21 Jul 2003 22:42:50 -0000 1.16
+++ documentation/printing.sgml 23 Sep 2003 14:15:39 -0000
@@ -6,13 +6,6 @@
<title>Printing</title>
<para>
- Written by &name-huw-davies; <email>&email-huw-davies;</email>
- </para>
- <para>
- (Extracted from <filename>wine/documentation/printing</filename>)
- </para>
-
- <para>
Printing in Wine can be done in one of two ways:
</para>
<orderedlist>
@@ -51,31 +44,6 @@
</para>
</sect3>
-<!--
- <sect3>
- <title>External printer drivers (non-working as of Jul 8, 01)</title>
- <para>
- At present only 16 bit drivers will work (note that these include
- win9x drivers). To use them, add
- </para>
- <screen>
-printer=on
- </screen>
- <para>
- to the [wine] section of the wine config file. This lets
- <function>CreateDC</function> proceed if its driver argument is a 16
- bit driver. You will probably also need to add
- </para>
- <screen>
-"TTEnable" = "0" "TTOnly" = "0"
- </screen>
- <para>
- to the [TrueType] section of <filename>~/.wine/config</filename>. The code for
- the driver interface is in <filename>graphics/win16drv</filename>.
- </para>
- </sect3>
--->
-
<sect3>
<title>Spooling</title>
<para>
@@ -109,13 +77,6 @@
<title>The Wine PostScript Driver</title>
<para>
- Written by &name-huw-davies; <email>&email-huw-davies;</email>
- </para>
- <para>
- (Extracted from <filename>wine/documentation/psdriver</filename>)
- </para>
-
- <para>
This allows Wine to generate PostScript files without
needing an external printer driver. Wine in this case uses the
system provided PostScript printer filters, which almost all use
@@ -314,12 +275,6 @@
</listitem>
</itemizedlist>
- <para>
- Please contact me if you want to help so that we can avoid duplication.
- </para>
- <para>
- &name-huw-davies; <email>&email-huw-davies;</email>
- </para>
</sect3>
</sect2>
</sect1>
Index: documentation/running.sgml
===================================================================
RCS file: /var/cvs/wine/documentation/running.sgml,v
retrieving revision 1.23
diff -u -r1.23 running.sgml
--- documentation/running.sgml 21 Jul 2003 22:42:50 -0000 1.23
+++ documentation/running.sgml 23 Sep 2003 04:57:50 -0000
@@ -2,15 +2,6 @@
<title>Running Wine</title>
<para>
- Written by &name-john-sheets; <email>&email-john-sheets;</email>
- Modified by &name-andreas-mohr; <email>&email-andreas-mohr;</email>
- </para>
- <para>
- Extended by &name-mike-hearn; <email>&email-mike-hearn;</email>, &name-eric-pouech; <email>&email-eric-pouech;</email>
- Modified by &name-andreas-mohr; <email>&email-andreas-mohr;</email>
- </para>
-
- <para>
This chapter will describe all aspects of running Wine, like e.g.
basic Wine invocation, command line parameters of various Wine
support programs etc.
Index: documentation/wine-user.sgml
===================================================================
RCS file: /var/cvs/wine/documentation/wine-user.sgml,v
retrieving revision 1.3
diff -u -r1.3 wine-user.sgml
--- documentation/wine-user.sgml 1 Apr 2003 03:26:13 -0000 1.3
+++ documentation/wine-user.sgml 23 Sep 2003 15:10:41 -0000
@@ -1,9 +1,5 @@
<!doctype book PUBLIC "-//OASIS//DTD DocBook V3.1//EN" [
-<!-- *** Include list of authors *** -->
-<!entity % authors SYSTEM "authors.ent">
-%authors;
-
<!entity introduction SYSTEM "introduction.sgml">
<!entity getting SYSTEM "getting.sgml">
<!entity compiling SYSTEM "compiling.sgml">
@@ -20,6 +16,62 @@
<book id="index">
<bookinfo>
<title>Wine User Guide</title>
+ <!-- Until we learn how to format this thing nicely,
+ we can't really incude it -->
+ <!--authorgroup>
+ <author>
+ <firstname>Huw</firstname>
+ <surname>Davies</surname>
+ </author>
+ <author>
+ <firstname>Steven</firstname>
+ <surname>Elliott</surname>
+ </author>
+ <author>
+ <firstname>Mike</firstname>
+ <surname>Hearn</surname>
+ </author>
+ <author>
+ <firstname>James</firstname>
+ <surname>Juran</surname>
+ </author>
+ <author>
+ <firstname>Ove</firstname>
+ <surname>Kaaven</surname>
+ </author>
+ <author>
+ <firstname>Alex</firstname>
+ <surname>Korobka</surname>
+ </author>
+ <author>
+ <firstname>Bruce</firstname>
+ <surname>Milner</surname>
+ </author>
+ <author>
+ <firstname>Andreas</firstname>
+ <surname>Mohr</surname>
+ </author>
+ <author>
+ <firstname>Dustin</firstname>
+ <surname>Navea</surname>
+ </author>
+ <author>
+ <firstname>Eric</firstname>
+ <surname>Pouech</surname>
+ </author>
+ <author>
+ <firstname>Adam</firstname>
+ <surname>Sacarny</surname>
+ </author>
+ <author>
+ <firstname>John</firstname>
+ <surname>Sheets</surname>
+ </author>
+ <author>
+ <firstname>Petr</firstname>
+ <surname>Tomasek</surname>
+ </author>
+ </authorgroup-->
</bookinfo>
&introduction;
@@ -28,6 +80,8 @@
&installing;
&configuring;
&running;
+ <!--&fonts;-->
+ <!--&printing;-->
&bugs;
&glossary;
--
Dimi.
More information about the wine-patches
mailing list