kopia lustrzana https://gitlab.com/sane-project/website
191 wiersze
6.9 KiB
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=<20010610202813.B4376@vortex.swb.de>"><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>
|
||
|
this is the place where the SANE libraries are placed. This was wrong in
|
||
|
<BR>
|
||
|
all manual pages for years. As I didn't want to change all the
|
||
|
<BR>
|
||
|
manual pages, I did the change in Makefile.in.
|
||
|
<BR>
|
||
|
* Fixed output of whatis/apropos for some backends. These had an empty
|
||
|
<BR>
|
||
|
line after the ".sh NAME" and therefore the description line was
|
||
|
<BR>
|
||
|
empty. (test with "apropos sane"
|
||
|
<BR>
|
||
|
* Fixed some minor formatting issues in some backends. Hint: If you
|
||
|
<BR>
|
||
|
want to write something bold or italic and directly after that a "."
|
||
|
<BR>
|
||
|
(period), you can use ".IR important ." or ".BR important .".
|
||
|
<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> * Check for logical errors and spelling
|
||
|
<BR>
|
||
|
- agfafocus (CONFIGURATION: Microtek scanners? SANE_DEBUG_AGFAFOCUS:
|
||
|
<BR>
|
||
|
SANE_DEBUG_UMAX values? Last paragraph of DEBUG)
|
||
|
<BR>
|
||
|
- apple (Compression (AppleScanner), Multiple Windows (AppleScanner),
|
||
|
<BR>
|
||
|
ftpdev.info.apple.com doesn't exist, DEBUG)
|
||
|
<BR>
|
||
|
- artec (BUGS)
|
||
|
<BR>
|
||
|
- mustek_pp (SEE ALSO, there is no sane-musteka4s2(5))
|
||
|
<BR>
|
||
|
- 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>
|
||
|
- umax_pp (DESCRIPTION: "sticky" bit --> isn't this the "setuid" bit?;
|
||
|
<BR>
|
||
|
DEVICE NAMES: "...only one parallel port this port...")
|
||
|
<BR>
|
||
|
<P> * Check for formatting bugs in manual pages:
|
||
|
<BR>
|
||
|
- apple (The list of scanners doesn't look like a table)
|
||
|
<BR>
|
||
|
- artec (CONFIGURATION: F<artec.conf> and similar)
|
||
|
<BR>
|
||
|
- nec (DESCRIPTION, list doesn't look like a table)
|
||
|
<BR>
|
||
|
- pie (Last two lines in table are not aligned; the last .PP generates a
|
||
|
<BR>
|
||
|
new page)
|
||
|
<BR>
|
||
|
- sharp (table isn't aligned)
|
||
|
<BR>
|
||
|
<P> * If you mention sane-devel, also mention the website concerning
|
||
|
<BR>
|
||
|
subscription (<A HREF="http://www.mostang.com/sane/mail.html">http://www.mostang.com/sane/mail.html</A>), because you can't
|
||
|
<BR>
|
||
|
write to sane-devel without subscribing.
|
||
|
<BR>
|
||
|
Or use your own mail address in the manual page.
|
||
|
<BR>
|
||
|
- abaton
|
||
|
<BR>
|
||
|
- agfafocus
|
||
|
<BR>
|
||
|
- apple
|
||
|
<BR>
|
||
|
- bh
|
||
|
<BR>
|
||
|
- dc210
|
||
|
<BR>
|
||
|
- dc240
|
||
|
<BR>
|
||
|
- dc25
|
||
|
<BR>
|
||
|
- epson
|
||
|
<BR>
|
||
|
- hp
|
||
|
<BR>
|
||
|
- microtek
|
||
|
<BR>
|
||
|
- mustek_pp
|
||
|
<BR>
|
||
|
- pint
|
||
|
<BR>
|
||
|
- st400
|
||
|
<BR>
|
||
|
|
||
|
<BR>
|
||
|
* Use @LIBDIR@, @CONFIGDIR@ and the other @@ macros to refer to paths.
|
||
|
<BR>
|
||
|
These are updated when installing to a non-standard prefix.
|
||
|
<BR>
|
||
|
- umax
|
||
|
<BR>
|
||
|
|
||
|
<BR>
|
||
|
Also please check if your manual page is uptodate with your backend.
|
||
|
<BR>
|
||
|
<P>Bye,
|
||
|
<BR>
|
||
|
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=<20010610202813.B4376@vortex.swb.de>">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>
|