sane-project-website/old-archive/2001-05/0243.html

124 wiersze
4.7 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: Re: how to write a manpage</TITLE>
<META NAME="Author" CONTENT="scc (fsanta@arrakis.es)">
<META NAME="Subject" CONTENT="Re: how to write a manpage">
</HEAD>
<BODY BGCOLOR="#FFFFFF" TEXT="#000000">
<H1>Re: how to write a manpage</H1>
<!-- received="Sat, 19 May 2001 03:07:34 +0200" -->
<!-- isoreceived="20010519010734" -->
<!-- sent="Sat, 19 May 2001 03:07:34 +0200" -->
<!-- isosent="20010519010734" -->
<!-- name="scc" -->
<!-- email="fsanta@arrakis.es" -->
<!-- subject="Re: how to write a manpage" -->
<!-- id="01051903073400.00590@horche" -->
<!-- inreplyto="3B065FA4.7973AE09@t-online.de" -->
<STRONG>From:</STRONG> scc (<A HREF="mailto:fsanta@arrakis.es?Subject=Re:%20how%20to%20write%20a%20manpage&In-Reply-To=&lt;01051903073400.00590@horche&gt;"><EM>fsanta@arrakis.es</EM></A>)<BR>
<STRONG>Date:</STRONG> Fri May 18 2001 - 18:07:34 PDT
<P>
<!-- next="start" -->
<LI><STRONG>Next message:</STRONG> <A HREF="0244.html">Levente NOVÁK: "Re: [dev] microtek2 backend for SANE-1.0.5 ready for testing"</A>
<UL>
<LI><STRONG>Previous message:</STRONG> <A HREF="0242.html">Harri Hohteri: "Re: Version problems (and others)"</A>
<LI><STRONG>In reply to:</STRONG> <A HREF="0239.html">Karsten Festag: "how to write a manpage"</A>
<!-- nextthread="start" -->
<LI><STRONG>Next in thread:</STRONG> <A HREF="0247.html">Matt Mozur: "Re: how to write a manpage"</A>
<!-- reply="end" -->
<LI><STRONG>Messages sorted by:</STRONG>
<A HREF="date.html#243">[ date ]</A>
<A HREF="index.html#243">[ thread ]</A>
<A HREF="subject.html#243">[ subject ]</A>
<A HREF="author.html#243">[ author ]</A>
</UL>
<HR NOSHADE><P>
<!-- body="start" -->
<P>
Hi.
<BR>
<P>Good question. I think that the man page idea goes back to when unix was on
<BR>
teletypes and was written for experts by experts. Command line stuff works
<BR>
well in this format but many of the current Linux stuff doesn't. If you do
<BR>
find out that there is a document somewhere on how to write a man page, then
<BR>
could it include a section for Linux beginners too? Or at least examples? And
<BR>
not too many 'see also's'? I found that the very worse people to ask for help
<BR>
are those with root access as they seem incapable of expressing themselves in
<BR>
anything other than --./configure makefile [-- switch] -x_file language.
<BR>
<P>From Ana at FeF, Spain. Secretary and changeover-to-Linux sufferer for most
<BR>
of last year!
<BR>
<P><P>On Saturday 19 May 2001 13:57, you wrote:
<BR>
<EM>&gt; Hi all developers,
</EM><BR>
<EM>&gt; I've never written a manpage before, but now it's time to start. What is
</EM><BR>
<EM>&gt; the best strategy and what tools to use?
</EM><BR>
<EM>&gt;
</EM><BR>
<EM>&gt; I feel like this is a dumb question, but I didn't find some useful
</EM><BR>
<EM>&gt; information about this.
</EM><BR>
<EM>&gt;
</EM><BR>
<EM>&gt; Thanks for your help
</EM><BR>
<EM>&gt;
</EM><BR>
<EM>&gt; Karsten
</EM><BR>
<EM>&gt;
</EM><BR>
<EM>&gt; --
</EM><BR>
<EM>&gt; Source code, list archive, and docs: <A HREF="http://www.mostang.com/sane/">http://www.mostang.com/sane/</A>
</EM><BR>
<EM>&gt; To unsubscribe: echo unsubscribe sane-devel | mail <A HREF="mailto:majordomo@mostang.com?Subject=Re:%20how%20to%20write%20a%20manpage&In-Reply-To=&lt;01051903073400.00590@horche&gt;">majordomo@mostang.com</A>
</EM><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:%20how%20to%20write%20a%20manpage&In-Reply-To=&lt;01051903073400.00590@horche&gt;">majordomo@mostang.com</A>
</PRE>
<P><!-- body="end" -->
<HR NOSHADE>
<UL>
<!-- next="start" -->
<LI><STRONG>Next message:</STRONG> <A HREF="0244.html">Levente NOVÁK: "Re: [dev] microtek2 backend for SANE-1.0.5 ready for testing"</A>
<LI><STRONG>Previous message:</STRONG> <A HREF="0242.html">Harri Hohteri: "Re: Version problems (and others)"</A>
<LI><STRONG>In reply to:</STRONG> <A HREF="0239.html">Karsten Festag: "how to write a manpage"</A>
<!-- nextthread="start" -->
<LI><STRONG>Next in thread:</STRONG> <A HREF="0247.html">Matt Mozur: "Re: how to write a manpage"</A>
<!-- reply="end" -->
<LI><STRONG>Messages sorted by:</STRONG>
<A HREF="date.html#243">[ date ]</A>
<A HREF="index.html#243">[ thread ]</A>
<A HREF="subject.html#243">[ subject ]</A>
<A HREF="author.html#243">[ 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>Sat May 19 2001 - 05:50:33 PDT</EM>
</EM>
</SMALL>
</BODY>
</HTML>