sane-project-website/old-archive/2001-06/0158.html

191 wiersze
6.9 KiB
HTML

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"
"http://www.w3.org/TR/REC-html40/loose.dtd">
<HTML>
<HEAD>
<TITLE>sane-devel: [dev] Updates/fixes of manual pages</TITLE>
<META NAME="Author" CONTENT="Henning Meier-Geinitz (henning@meier-geinitz.de)">
<META NAME="Subject" CONTENT="[dev] Updates/fixes of manual pages">
</HEAD>
<BODY BGCOLOR="#FFFFFF" TEXT="#000000">
<H1>[dev] Updates/fixes of manual pages</H1>
<!-- received="Sun Jun 10 11:26:01 2001" -->
<!-- isoreceived="20010610182601" -->
<!-- sent="Sun, 10 Jun 2001 20:28:13 +0200" -->
<!-- isosent="20010610182813" -->
<!-- name="Henning Meier-Geinitz" -->
<!-- email="henning@meier-geinitz.de" -->
<!-- subject="[dev] Updates/fixes of manual pages" -->
<!-- id="20010610202813.B4376@vortex.swb.de" -->
<STRONG>From:</STRONG> Henning Meier-Geinitz (<A HREF="mailto:henning@meier-geinitz.de?Subject=Re:%20[dev]%20Updates/fixes%20of%20manual%20pages&In-Reply-To=&lt;20010610202813.B4376@vortex.swb.de&gt;"><EM>henning@meier-geinitz.de</EM></A>)<BR>
<STRONG>Date:</STRONG> Sun Jun 10 2001 - 11:28:13 PDT
<P>
<!-- next="start" -->
<LI><STRONG>Next message:</STRONG> <A HREF="0159.html">Oliver Rauch: "xsane-win32-0.78 released"</A>
<UL>
<LI><STRONG>Previous message:</STRONG> <A HREF="0157.html">Oliver Rauch: "xsane-0.78 source released"</A>
<!-- nextthread="start" -->
<!-- reply="end" -->
<LI><STRONG>Messages sorted by:</STRONG>
<A HREF="date.html#158">[ date ]</A>
<A HREF="index.html#158">[ thread ]</A>
<A HREF="subject.html#158">[ subject ]</A>
<A HREF="author.html#158">[ author ]</A>
</UL>
<HR NOSHADE><P>
<!-- body="start" -->
<P>
Hi,
<BR>
<P>Today I took a look at all the manual pages. I fixed some small issues:
<BR>
<P>* Added sane(7) to all manual pages (if this wasn't done already)
<BR>
* Changed @LIBDIR@ from $(libdir) to $(libdir)/sane in doc/Makefile.in as
<BR>
&nbsp;&nbsp;this is the place where the SANE libraries are placed. This was wrong in
<BR>
&nbsp;&nbsp;all manual pages for years. As I didn't want to change all the
<BR>
&nbsp;&nbsp;manual pages, I did the change in Makefile.in.
<BR>
* Fixed output of whatis/apropos for some backends. These had an empty
<BR>
&nbsp;&nbsp;line after the &quot;.sh NAME&quot; and therefore the description line was
<BR>
&nbsp;&nbsp;empty. (test with &quot;apropos sane&quot;
<BR>
* Fixed some minor formatting issues in some backends. Hint: If you
<BR>
&nbsp;&nbsp;want to write something bold or italic and directly after that a &quot;.&quot;
<BR>
&nbsp;&nbsp;(period), you can use &quot;.IR important .&quot; or &quot;.BR important .&quot;.
<BR>
* I changed/updated some paragraphs in sane-scsi.
<BR>
<P>Details are in ChangeLog.
<BR>
<P>While reading through all the man pages I found some more issues
<BR>
(mostly minor things) that I didn't fix. I put the list to TODO, so we
<BR>
don't forget to fix them. If yor backend is listed here, please check
<BR>
your man page.I haven't read every single word of every man page so
<BR>
there are definitely more bugs than these:
<BR>
<P>&nbsp;&nbsp;* Check for logical errors and spelling
<BR>
&nbsp;&nbsp;&nbsp;&nbsp;- agfafocus (CONFIGURATION: Microtek scanners? SANE_DEBUG_AGFAFOCUS:
<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;SANE_DEBUG_UMAX values? Last paragraph of DEBUG)
<BR>
&nbsp;&nbsp;&nbsp;&nbsp;- apple (Compression (AppleScanner), Multiple Windows (AppleScanner),
<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;ftpdev.info.apple.com doesn't exist, DEBUG)
<BR>
&nbsp;&nbsp;&nbsp;&nbsp;- artec (BUGS)
<BR>
&nbsp;&nbsp;&nbsp;&nbsp;- mustek_pp (SEE ALSO, there is no sane-musteka4s2(5))
<BR>
&nbsp;&nbsp;&nbsp;&nbsp;- plustek: (<A HREF="http://www.linuxhacker.org/listscgi-bin/ezmlm-cgi/3">http://www.linuxhacker.org/listscgi-bin/ezmlm-cgi/3</A>: not found!)
<BR>
&nbsp;&nbsp;&nbsp;&nbsp;- umax_pp (DESCRIPTION: &quot;sticky&quot; bit --&gt; isn't this the &quot;setuid&quot; bit?;
<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;DEVICE NAMES: &quot;...only one parallel port this port...&quot;)
<BR>
<P>&nbsp;&nbsp;* Check for formatting bugs in manual pages:
<BR>
&nbsp;&nbsp;&nbsp;&nbsp;- apple (The list of scanners doesn't look like a table)
<BR>
&nbsp;&nbsp;&nbsp;&nbsp;- artec (CONFIGURATION: F&lt;artec.conf&gt; and similar)
<BR>
&nbsp;&nbsp;&nbsp;&nbsp;- nec (DESCRIPTION, list doesn't look like a table)
<BR>
&nbsp;&nbsp;&nbsp;&nbsp;- pie (Last two lines in table are not aligned; the last .PP generates a
<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;new page)
<BR>
&nbsp;&nbsp;&nbsp;&nbsp;- sharp (table isn't aligned)
<BR>
<P>&nbsp;&nbsp;* If you mention sane-devel, also mention the website concerning
<BR>
&nbsp;&nbsp;&nbsp;&nbsp;subscription (<A HREF="http://www.mostang.com/sane/mail.html">http://www.mostang.com/sane/mail.html</A>), because you can't
<BR>
&nbsp;&nbsp;&nbsp;&nbsp;write to sane-devel without subscribing.
<BR>
&nbsp;&nbsp;&nbsp;&nbsp;Or use your own mail address in the manual page.
<BR>
&nbsp;&nbsp;&nbsp;&nbsp;- abaton
<BR>
&nbsp;&nbsp;&nbsp;&nbsp;- agfafocus
<BR>
&nbsp;&nbsp;&nbsp;&nbsp;- apple
<BR>
&nbsp;&nbsp;&nbsp;&nbsp;- bh
<BR>
&nbsp;&nbsp;&nbsp;&nbsp;- dc210
<BR>
&nbsp;&nbsp;&nbsp;&nbsp;- dc240
<BR>
&nbsp;&nbsp;&nbsp;&nbsp;- dc25
<BR>
&nbsp;&nbsp;&nbsp;&nbsp;- epson
<BR>
&nbsp;&nbsp;&nbsp;&nbsp;- hp
<BR>
&nbsp;&nbsp;&nbsp;&nbsp;- microtek
<BR>
&nbsp;&nbsp;&nbsp;&nbsp;- mustek_pp
<BR>
&nbsp;&nbsp;&nbsp;&nbsp;- pint
<BR>
&nbsp;&nbsp;&nbsp;&nbsp;- st400
<BR>
&nbsp;
<BR>
&nbsp;&nbsp;* Use @LIBDIR@, @CONFIGDIR@ and the other @@ macros to refer to paths.
<BR>
&nbsp;&nbsp;&nbsp;&nbsp;These are updated when installing to a non-standard prefix.
<BR>
&nbsp;&nbsp;&nbsp;&nbsp;- umax
<BR>
&nbsp;
<BR>
Also please check if your manual page is uptodate with your backend.
<BR>
<P>Bye,
<BR>
&nbsp;&nbsp;Henning
<BR>
<P><PRE>
--
Source code, list archive, and docs: <A HREF="http://www.mostang.com/sane/">http://www.mostang.com/sane/</A>
To unsubscribe: echo unsubscribe sane-devel | mail <A HREF="mailto:majordomo@mostang.com?Subject=Re:%20[dev]%20Updates/fixes%20of%20manual%20pages&In-Reply-To=&lt;20010610202813.B4376@vortex.swb.de&gt;">majordomo@mostang.com</A>
</PRE>
<P><!-- body="end" -->
<HR NOSHADE>
<UL>
<!-- next="start" -->
<LI><STRONG>Next message:</STRONG> <A HREF="0159.html">Oliver Rauch: "xsane-win32-0.78 released"</A>
<LI><STRONG>Previous message:</STRONG> <A HREF="0157.html">Oliver Rauch: "xsane-0.78 source released"</A>
<!-- nextthread="start" -->
<!-- reply="end" -->
<LI><STRONG>Messages sorted by:</STRONG>
<A HREF="date.html#158">[ date ]</A>
<A HREF="index.html#158">[ thread ]</A>
<A HREF="subject.html#158">[ subject ]</A>
<A HREF="author.html#158">[ author ]</A>
</UL>
<!-- trailer="footer" -->
<HR NOSHADE>
<P>
<SMALL>
<EM>
This archive was generated by <A HREF="http://www.hypermail.org/">hypermail 2b29</A>
: <EM>Sun Jun 10 2001 - 11:27:13 PDT</EM>
</EM>
</SMALL>
</BODY>
</HTML>