Bug#269787: manpage improvements ?
Siward de Groot
Siward de Groot <siward@wanadoo.nl>, 269787@bugs.debian.org
Fri, 11 Feb 2005 21:42:41 +0100
--Boundary-00=_CjRDCFwFq3+nREh
Content-Type: text/plain;
charset="iso-8859-1"
Content-Transfer-Encoding: 7bit
Content-Disposition: inline
On Wednesday 02 February 2005 13:59, you wrote:
| Hi Siward,
|
| #269787: manpage improvements ?
| has been sitting in my bug pile for months now. If you really want your
| suggestions implemented, the best thing for you to do would be to write
| up your new improved manpage and create a diff against the old one.
|
| I'll then submit it upstream for inclusion if they approve it. I just
| don't have the time to take care of this myself.
|
| Yours sincerely,
| Andrew "Netsnipe" Lau
Hi Andrew,
it is pleasant that you take my bugreport serious.
The bugs i reported are not really important,
and i filed them so you would know about them,
so feel free to close.
However, i hope that you'll find time to add suggests for yelp and addressbook
(and perhaps also for the other packages whose manpages are SEE ALSO'd,
though they are not referenced in this manpage at all).
That said, i did write up a new improved manpage,
on the odd chance that you and balsa's authors will like this format,
and maybe find it usefull to cut&paste some things from it
when the manpage gets updated.
I attached a diff, which removes nearly all lines from the original manpage,
so i also attached my version in plain, called balsa.2
( to distinguish it from the original,
not because i think the manpage belongs in section 2 (which i don't)).
I made 5 kinds of changes :
debianization, updating, (minor) bugfixing, manpage format, and what i like.
I debianized the manpage by
- adding a maintainer section
- adding packagenames to see-also's
(because these manpages are not necessarily installed)
- adding paragraphs about where and how to report packaging bugs
- changed 'system documentation browser' to 'GNOME documentation browser'
- added the conffile to the FILES section
I updated it by
- experimenting
- adding content from `dpkg -s balsa`
- adding that one needs yelp to have a menu
(you were so friendly to tell me that)
I fixed 3 miniscule bugs
- header had 'version' in lowerleft, followed by '3 january 2003`
- dash that separates name and whatis was not escaped
(as is requested by man(7))
- AUTHORS file had versionnumber in filename
I started reformatting in order to have all options in the SYNTAX aligned,
which i think is much easier to read.
I also changed section title 'synopsis' to 'syntax', because
* i like to call things what they are, and
* i find a synopsis to be
the most usefull addition to debian's current documentation,
(taking 'synopsis' to mean:
an overview including the 1% of info that 99% of users want to read)
(man balsa is too small to need a separate section for this,
i have tried to synopsize the syntax of 'balsa' in paragraph 6)
I like documentation to be correct and clear,
and ofcourse i have my own preferred way that a text should look
(second and further lines of a sentence indented).
Correctness made me describe effects of options as i found them to be ;
please note that i am not trying to troll,
i do like balsa, and i thank all of you for giving me this nice program :-).
As i was reformatting anyway,
i made this manpage in my favourite format too.
Manpage format is not easy,
because it can be displayed on resizable terminals,
and, maybe because i limited myself to the macros encouraged by man(7),
it can only wrap lines to the current indent position,
and considers every line that is not indented relative to the current indent
as a continuation of the currrent line.
As i use newlines to indicate the end of a thought,
i had to use ".RS 0\n.RE\n" to force linebreaks,
(wrapping is impossible to get right for all displaywidths).
I changed the .BR style shortcuts to explicit \fB \fR ,
to only have one syntax for specifying font.
I rephrased many sentences to make them shorter than 80 characters,
so i linewrapping wouldn't need to occur.
And i added whatis's to the see-also, to be more user-friendly.
(i changed GNOME's whatis, to actually convey some usefull info).
I also rephrased the copyright, so it would be easier for me to understand.
To whoever may read this :
please consider this a curiosum that you are free to use as you like.
have fun !
Siward
<home.wanadoo.nl/siward>
--Boundary-00=_CjRDCFwFq3+nREh
Content-Type: text/x-diff;
charset="iso-8859-1";
name="balsa.diff"
Content-Transfer-Encoding: 7bit
Content-Disposition: attachment;
filename="balsa.diff"
--- balsa.1 2005-02-08 19:29:51.000000000 +0100
+++ balsa.2 2005-02-11 20:16:33.000000000 +0100
@@ -1,112 +1,234 @@
-.TH Balsa 1 "03 January 2003" Version 2.2.6
+.TH Balsa 1 "03 January 2003" "Version 2.2.6" "Gnome Manpage"
.SH NAME
-Balsa - the GNOME email client.
-
-.SH SYNOPSIS
-.B balsa
-.RB [ \-\^\-help ]
-.RB [ \-\^\-version ]
-.RB [ \-c ]
-.RB [ \-\^\-checkmail ]
-.RB [ \-m
-.IR USER@HOST.TLD ]
-.RB [ \-\^\-compose=\fIUSER@HOST.TLD\fP ]
-.RB [ \-a
-.IR FILENAME ]
-.RB [ \-\^\-attach=\fIFILENAME\fP ]
-.RB [ \-o
-.IR MAILBOX ]
-.RB [ \-\^\-open\-mailbox=\fIMAILBOX\fP ]
-.RB [ \-u ]
-.RB [ \-\^\-open\-unread\-mailbox ]
-.RB [ \-d ]
-.RB [ \-\^\-debug\-pop ]
-
+ Balsa \- the GNOME email client.
.SH DESCRIPTION
+You can use Balsa to fetch, read, write and send e-mails.
+
+It supports
+ * local mailboxes in maildir, mbox and/or mh format,
+ * nested mailboxes,
+ * protocols POP3, IMAP and SMTP,
+ * multithreaded mail retrieval,
+ * GnuPG/GPG encryption, LDAP, Kerberos and SSL,
+ * MIME (view images, save parts),
+ * multiple charactersets,
+ * GPE addressbook,
+ * printing and spell-checking.
+
+Balsa is an integral part of the GNOME desktop environment,
+ but it can also be used standalone
+ (though it will print some errormessages then).
+
+For help on using Balsa, see the documentation in it's help menu
+ (you may need to install yelp to have a help menu).
+
+This manpage tells about the options of the '\fBbalsa\fR' command,
+ which is used to start Balsa.
+.RS 0
+.RE
+Most of these options let you tell Balsa that when it starts
+ it should immediately open a mailbox, or the composer ,
+ and things like that.
+.RS 0
+.RE
+There is also an option to debug POP connections.
.PP
-\fIBalsa\fP is an e-mail reader. This client is part of the GNOME desktop
-environment. It supports local mailboxes, POP3 and IMAP. For help on using Balsa, see the program documentation in the help menu.
+When you start Balsa from the commandline of an (x)terminal,
+ not only can you use the commandline options described below,
+ any errormessages are printed to that terminal too
+ (whether you execute that command in the background or not).
+
+.SH SYNTAX
+\fBbalsa \fR[ \fB\ \fR \fB\-\-help \fR] \\
+\fR \fR[ \fB\ \fR \fB\-\-version \fR] \\
+\fR \fR[ \fB\-c \fR| \fB\-\-checkmail \fR] \\
+\fR \fR[( \fB\-m \fR| \fB\-\-compose=\fR)\fIemail-address \fR] \\
+\fR \fR[( \fB\-a \fR| \fB\-\-attach=\fR)\fIfilename \fR] \\
+\fR \fR[( \fB\-o \fR| \fB\-\-open\-mailbox=)\fImailbox\fR[\fI:mailbox\fR]... ] \\
+\fR \fR[ \fB\-u \fR| \fB\-\-open\-unread\-mailbox \fR] \\
+\fR \fR[ \fB\-d \fR| \fB\-\-debug\-pop \fR]
.SH OPTIONS
-.TP
-.BR \-c ", " \-\^\-checkmail
-Balsa will immediately check for new mail when the program is launched
-
-.TP
-.BR \-i ", " \-\^\-open-inbox
-Balsa will open the Inbox on startup.
-
-.TP
-.BI \-m " USER@HOST.TLD" "\fR,\fP \-\^\-compose=" USER@HOST.TLD
-When invoked with this option, balsa will open a new message with the
-specified address in the To: field. The parameter can be specified
-also in URL format - it makes it possible to use balsa as mailto
-protocol handler by setting the mailto protocol command to balsa -m
-"%s" in URL handlers section of GNOME control center.
-
-.TP
-.BI \-a " FILENAME" "\fR,\fP \-\^\-attach=" FILENAME
-When invoked with this option, balsa will open a new message with the
-specified file already attached to the message.
-
-.TP
-.BI \-o " MAILBOX" "\fR,\fP \-\^\-open-mailbox=" MAILBOX
-Balsa will open automatically at startup the mailbox or mailboxes specified on the command line with this option. Multiple mailboxes are delimited by semicolons.
-
-.TP
-.BR \-u ", " \-\^\-open-unread-mailbox
-Open the first unread mailbox when balsa is launched.
-
-.TP
-.BR \-d ", " \-\^\-debug-pop
-Dumps the POP3 communication to stderr. Useful for debugging POP3
-connections.
+.PP
+\fB\-? \fR, \fB\-\-help\fR
+.RS 7
+Displays a message describing commandline syntax of Balsa ,
+ giving many more options than are presented in this manpage ;
+ Balsa exits immediately after that.
+.RS 0
+.RE
+Some of these options work (and thus should be in this manpage)
+ for example --display ,
+ others don't (and thus should be deleted from the message)
+ for example --disable-crash-dialog .
+.RS 0
+.RE
+The message states that version is 2.8.0 ,
+ while current version is 2.2.6 ,
+ so perhaps these options will be implemented in future.
+.RE
+.PP
+\fB\-\-version\fR
+.RS 7
+Balsa prints it's version and exits.
+.RE
+
+.PP
+\fB\-c \fR, \fB\-\-checkmail\fR
+.RS 7
+Balsa starts and checks for new mail immediately.
+.RE
+
+.PP
+\fB\-i \fR, \fB\-\-open-inbox
+.RS 7
+Balsa starts and opens the Inbox.
+.RE
+
+.PP
+\fB\-m \fIemail-address \fR, \fB\-\-compose=\fIemail-address\fR
+.RS 7
+When invoked with this option,
+ Balsa will open it's email-composer for a new message
+ with the specified address in the To: field.
+.RS 0
+.RE
+The email-address parameter can be specified
+ as user@host, e.g. \fBbalsa-list@gnome.org \fR,
+ or in URL format, e.g. \fB"Balsa List <balsa-list@gnome.org>" \fR.
+.RS 0
+.RE
+You can use Balsa as mailto protocol handler
+ by, in the URL handlers section of the GNOME control center,
+ setting the mailto protocol command to : \fBbalsa -m "%s"\fR
+.RE
+.PP
+\fB\-a \fIFILENAME \fR, \fB\-\-attach=\fIFILENAME\fR
+.RS 7
+When invoked with this option,
+ Balsa will open it's email-composer for a new message
+ with the specified file already attached to the message.
+.RS 0
+.RE
+Example : \fBbalsa -a /home/siward/balsa-new.1.gz\fR
+.RE
+.PP
+\fB\-o \fIMAILBOX\fR[\fI:MAILBOX\fR]... , \fB\-\-open-mailbox=\fIMAILBOX\fR[\fI:MAILBOX\fR]...
+.RS 7
+Multiple mailboxes can be specified by separating their names by semicolons.
+.RS 0
+.RE
+This should make \FIBalsa\FR start and open the specified mailbox(es).
+.RS 0
+.RE
+However, it doesnt open any mailboxes,
+ and if -o is used with multiple mailboxes, Balsa crashes.
+.RS 0
+.RE
+Example : \fBbalsa -o Inbox:Draftbox\fR
+.RE
+.PP
+\fB\-u \fR, \fB\-\-open-unread-mailbox\fR
+.RS 7
+Open the first mailbox that contains unread messages.
+.RS 0
+.RE
+Balsa doesn't know what a mailbox contains until it has opened it,
+so this option doesn't really open any mailbox.
+.RE
+.PP
+\fB\-d \fR, \fB\-\-debug-pop\fR
+.RS 7
+Makes Balsa print the POP3 communication to stderr,
+ including the full text of every message.
+.RS 0
+.RE
+The former can be useful for debugging POP3 connections.
+.RE
.SH WEBSITE
-http://balsa.gnome.org/
+Balsa's website is \fI
+.URL http://balsa.gnome.org
+http://balsa.gnome.org\fR
.SH SUGGESTIONS AND BUG REPORTS
-Any bugs found should be reported to the Balsa Developer mailing list
-at balsa-list@gnome.org or you may want to make use of the online
-bug-tracking system available on the web at
-http://bugzilla.gnome.org/. See http://balsa.gnome.org/bugs.html
-for more information on reporting bugs.
-
-Before reporting bugs, please check to see if the bug is mentioned
-in the FAQ's or the mailing list archive. See the section on Other
-Info for locations of these.
-
-When reporting Balsa bugs, it is important to include a
-reliable way to reproduce the bug, version number of Balsa (as well as
-GTK and GNOME), OS name and version, and any relevant hardware
-specs.
-
-If a bug is causing a crash, it is very useful if a stack trace
-can be provided. And of course, patches to rectify the bug are even
-better.
+Any bugs found in Balsa can be reported through
+ the Balsa Developer mailing list at \fBbalsa-list@gnome.org \fR,
+ or the online bug-tracking system at \fBhttp://bugzilla.gnome.org/ \fR.
+.RS 0
+.RE
+See http://balsa.gnome.org/bugs.html for more information on reporting Balsa bugs.
+
+Before reporting Balsa bugs, please check to see if the bug is mentioned
+in the FAQ's or the Balsa mailing list archive.
+.RS 0
+.RE
+I don't know where these are to be found, so you'll just have to search the web for them.
+
+When reporting Balsa bugs, it is important to include
+ * a reliable way to reproduce the bug,
+ * version number of Balsa (as well as GTK and GNOME),
+ * OS name and version,
+ * any relevant hardware specs.
+
+Bugs related to the Debian packaging of Balsa can be reported to your friendly Debian
+maintainer by filing a bugreport on package 'balsa' in Debian's Bug Tracking System
+(BTS) at www.debian.org/Bugs .
+.RS 0
+.RE
+Please use the 'reportbug' program to file such bugs.
+
+Before reporting Debian bugs, please check to see whether it has already been reported,
+by querying the BTS.
+.RS 0
+.RE
+The solution to your problem may already be in there.
+
+For Debian bugs the same information is needed as for Balsa's ,
+ but the reportbug program includes this automatically.
+
+If a bug is causing a crash,
+ it is very useful if a stack trace can be provided.
+.RS 0
+.RE
+And of course, patches to rectify the bug are even better.
.SH AUTHORS
-See the AUTHORS file included with Balsa, probably at
-/usr/share/doc/balsa-2.2.6/AUTHORS
+See the AUTHORS file included with Balsa,
+ at \fB/usr/share/doc/balsa/AUTHORS \fR.
-.SH FILES
-.BR ~/.gnome2/balsa
-Balsa's preferences file.
+.SH MAINTAINER
+Debian's Balsa package is currently maintained by
+ Andrew Lau <netsnipe@users.sourceforge.net>
-.BR ~/.gnome2_private/balsa
-Balsa's POP and IMAP passwords file.
+.SH FILES
+\fB ~/.gnome2/balsa \fRBalsa's preferences file.
+\fB ~/.gnome2_private/balsa \fRBalsa's POP and IMAP passwords file.
+\fB /etc/sound/events/balsa.soundlist \fRsystem-wide configuration file
.SH SEE ALSO
-.BR mailcap (5)
-.BR metamail (1)
-.BR sendmail (8)
-
+\fBmailcap \fR(5) - metamail capabilities file (package: mime-support)
+.RS 0
+.RE
+\fBmetamail \fR(1) - infrastructure for mailcap-based multimedia mail
+ (package: metamail)
+.RS 0
+.RE
+\fBsendmail \fR(8) - a Mail Transfer Agent (package: exim4-daemon-light)
+.RS 0
+.RE
+\fByelp \fR(1) - browse Gnome documentation (package: yelp)
+.RS 0
+.RE
+\fBGNOME \fR(1) - modern desktop environment (package: gnome-bin)
.SH COPYRIGHT
(c) 1997-2003 Stuart Parmenter and others, see AUTHORS for a list of people.
-Permission to use, copy, modify, and distribute this software and its
-documentation for any purpose and without fee is hereby granted,
-provided that the above copyright notice appear in all copies and that
-both that copyright notice and this permission notice appear in
-supporting documentation.
+Permission to use, copy, modify, and distribute this software and its documentation,
+ for any purpose and without needing to pay any fee,
+ is hereby granted, provided that
+ the above copyright notice appear in all copies, and that
+.RS 2
+both that copyright notice and this permission notice appear in supporting documentation.
+
--Boundary-00=_CjRDCFwFq3+nREh
Content-Type: application/x-troff;
name="balsa.2"
Content-Transfer-Encoding: 7bit
Content-Disposition: attachment;
filename="balsa.2"
.TH Balsa 1 "03 January 2003" "Version 2.2.6" "Gnome Manpage"
.SH NAME
Balsa \- the GNOME email client.
.SH DESCRIPTION
You can use Balsa to fetch, read, write and send e-mails.
It supports
* local mailboxes in maildir, mbox and/or mh format,
* nested mailboxes,
* protocols POP3, IMAP and SMTP,
* multithreaded mail retrieval,
* GnuPG/GPG encryption, LDAP, Kerberos and SSL,
* MIME (view images, save parts),
* multiple charactersets,
* GPE addressbook,
* printing and spell-checking.
Balsa is an integral part of the GNOME desktop environment,
but it can also be used standalone
(though it will print some errormessages then).
For help on using Balsa, see the documentation in it's help menu
(you may need to install yelp to have a help menu).
This manpage tells about the options of the '\fBbalsa\fR' command,
which is used to start Balsa.
.RS 0
.RE
Most of these options let you tell Balsa that when it starts
it should immediately open a mailbox, or the composer ,
and things like that.
.RS 0
.RE
There is also an option to debug POP connections.
.PP
When you start Balsa from the commandline of an (x)terminal,
not only can you use the commandline options described below,
any errormessages are printed to that terminal too
(whether you execute that command in the background or not).
.SH SYNTAX
\fBbalsa \fR[ \fB\ \fR \fB\-\-help \fR] \\
\fR \fR[ \fB\ \fR \fB\-\-version \fR] \\
\fR \fR[ \fB\-c \fR| \fB\-\-checkmail \fR] \\
\fR \fR[( \fB\-m \fR| \fB\-\-compose=\fR)\fIemail-address \fR] \\
\fR \fR[( \fB\-a \fR| \fB\-\-attach=\fR)\fIfilename \fR] \\
\fR \fR[( \fB\-o \fR| \fB\-\-open\-mailbox=)\fImailbox\fR[\fI:mailbox\fR]... ] \\
\fR \fR[ \fB\-u \fR| \fB\-\-open\-unread\-mailbox \fR] \\
\fR \fR[ \fB\-d \fR| \fB\-\-debug\-pop \fR]
.SH OPTIONS
.PP
\fB\-? \fR, \fB\-\-help\fR
.RS 7
Displays a message describing commandline syntax of Balsa ,
giving many more options than are presented in this manpage ;
Balsa exits immediately after that.
.RS 0
.RE
Some of these options work (and thus should be in this manpage)
for example --display ,
others don't (and thus should be deleted from the message)
for example --disable-crash-dialog .
.RS 0
.RE
The message states that version is 2.8.0 ,
while current version is 2.2.6 ,
so perhaps these options will be implemented in future.
.RE
.PP
\fB\-\-version\fR
.RS 7
Balsa prints it's version and exits.
.RE
.PP
\fB\-c \fR, \fB\-\-checkmail\fR
.RS 7
Balsa starts and checks for new mail immediately.
.RE
.PP
\fB\-i \fR, \fB\-\-open-inbox
.RS 7
Balsa starts and opens the Inbox.
.RE
.PP
\fB\-m \fIemail-address \fR, \fB\-\-compose=\fIemail-address\fR
.RS 7
When invoked with this option,
Balsa will open it's email-composer for a new message
with the specified address in the To: field.
.RS 0
.RE
The email-address parameter can be specified
as user@host, e.g. \fBbalsa-list@gnome.org \fR,
or in URL format, e.g. \fB"Balsa List <balsa-list@gnome.org>" \fR.
.RS 0
.RE
You can use Balsa as mailto protocol handler
by, in the URL handlers section of the GNOME control center,
setting the mailto protocol command to : \fBbalsa -m "%s"\fR
.RE
.PP
\fB\-a \fIFILENAME \fR, \fB\-\-attach=\fIFILENAME\fR
.RS 7
When invoked with this option,
Balsa will open it's email-composer for a new message
with the specified file already attached to the message.
.RS 0
.RE
Example : \fBbalsa -a /home/siward/balsa-new.1.gz\fR
.RE
.PP
\fB\-o \fIMAILBOX\fR[\fI:MAILBOX\fR]... , \fB\-\-open-mailbox=\fIMAILBOX\fR[\fI:MAILBOX\fR]...
.RS 7
Multiple mailboxes can be specified by separating their names by semicolons.
.RS 0
.RE
This should make \FIBalsa\FR start and open the specified mailbox(es).
.RS 0
.RE
However, it doesnt open any mailboxes,
and if -o is used with multiple mailboxes, Balsa crashes.
.RS 0
.RE
Example : \fBbalsa -o Inbox:Draftbox\fR
.RE
.PP
\fB\-u \fR, \fB\-\-open-unread-mailbox\fR
.RS 7
Open the first mailbox that contains unread messages.
.RS 0
.RE
Balsa doesn't know what a mailbox contains until it has opened it,
so this option doesn't really open any mailbox.
.RE
.PP
\fB\-d \fR, \fB\-\-debug-pop\fR
.RS 7
Makes Balsa print the POP3 communication to stderr,
including the full text of every message.
.RS 0
.RE
The former can be useful for debugging POP3 connections.
.RE
.SH WEBSITE
Balsa's website is \fI
.URL http://balsa.gnome.org
http://balsa.gnome.org\fR
.SH SUGGESTIONS AND BUG REPORTS
Any bugs found in Balsa can be reported through
the Balsa Developer mailing list at \fBbalsa-list@gnome.org \fR,
or the online bug-tracking system at \fBhttp://bugzilla.gnome.org/ \fR.
.RS 0
.RE
See http://balsa.gnome.org/bugs.html for more information on reporting Balsa bugs.
Before reporting Balsa bugs, please check to see if the bug is mentioned
in the FAQ's or the Balsa mailing list archive.
.RS 0
.RE
I don't know where these are to be found, so you'll just have to search the web for them.
When reporting Balsa bugs, it is important to include
* a reliable way to reproduce the bug,
* version number of Balsa (as well as GTK and GNOME),
* OS name and version,
* any relevant hardware specs.
Bugs related to the Debian packaging of Balsa can be reported to your friendly Debian
maintainer by filing a bugreport on package 'balsa' in Debian's Bug Tracking System
(BTS) at www.debian.org/Bugs .
.RS 0
.RE
Please use the 'reportbug' program to file such bugs.
Before reporting Debian bugs, please check to see whether it has already been reported,
by querying the BTS.
.RS 0
.RE
The solution to your problem may already be in there.
For Debian bugs the same information is needed as for Balsa's ,
but the reportbug program includes this automatically.
If a bug is causing a crash,
it is very useful if a stack trace can be provided.
.RS 0
.RE
And of course, patches to rectify the bug are even better.
.SH AUTHORS
See the AUTHORS file included with Balsa,
at \fB/usr/share/doc/balsa/AUTHORS \fR.
.SH MAINTAINER
Debian's Balsa package is currently maintained by
Andrew Lau <netsnipe@users.sourceforge.net>
.SH FILES
\fB ~/.gnome2/balsa \fRBalsa's preferences file.
\fB ~/.gnome2_private/balsa \fRBalsa's POP and IMAP passwords file.
\fB /etc/sound/events/balsa.soundlist \fRsystem-wide configuration file
.SH SEE ALSO
\fBmailcap \fR(5) - metamail capabilities file (package: mime-support)
.RS 0
.RE
\fBmetamail \fR(1) - infrastructure for mailcap-based multimedia mail
(package: metamail)
.RS 0
.RE
\fBsendmail \fR(8) - a Mail Transfer Agent (package: exim4-daemon-light)
.RS 0
.RE
\fByelp \fR(1) - browse Gnome documentation (package: yelp)
.RS 0
.RE
\fBGNOME \fR(1) - modern desktop environment (package: gnome-bin)
.SH COPYRIGHT
(c) 1997-2003 Stuart Parmenter and others, see AUTHORS for a list of people.
Permission to use, copy, modify, and distribute this software and its documentation,
for any purpose and without needing to pay any fee,
is hereby granted, provided that
the above copyright notice appear in all copies, and that
.RS 2
both that copyright notice and this permission notice appear in supporting documentation.
--Boundary-00=_CjRDCFwFq3+nREh--