[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Proposed announcement etc, 3.rd revision



I got some feedback on the proposed texts I posted 7.th february on
 - announcement text
 - intro.ldp manpage source
 - disk.ldp  - sample man page stub for the Multi Disk HOWTO

so once again yours truly sumbits a revised set of proposals,
quickly heading for an epic of Shakepearian proportions.

So, once again: please give me feedback!

I feel the announcement should be sent by the main
contact address for the LDP, otherwise I am likely to
receive a lot of incorrectly adressed email. I have
not gotten a comments to this so I hope this is settled.

There is a man2html translator program, but not on my
machine it seemed, so I hope if it is put up on a
web page we can use the translator so we can keep more of
the original formatting such as bold face and underlining

My man page authorship skills are not very good so I
hope someone more skilled can suggest improvements.
As a medium term solution I think we can make a
simple shell script to generate the stub contents.

If I have missed some comments/correctsion/etc please
let me know, all commens should have been used here.

==(Announcement)===


After some restructuring of the Linux Documentation Project (LDP)
we feel ready to serve the Linux community from the new home:
        http://www.linuxdoc.org/

The LDP has collected and produced numerous documents such as
 - guides
 - HOWTOs and mini-HOWTOs
 - FAQs
 - man pages
and more.

All in all the LDP endeavors to produce and provide a one-stop source of
information relating to the various aspects of Linux. There is now
a search engine on the front page to help you quickly and efficiently
locate the documents you need. If you have a question, chances are you
will find what you need here.

These documents are produced for you, the end users. That means if there
is anything in the documents you find unclear, ambiguous or incorrect
you should not hesitate in contacting the author. While the workload of
the authors in general may be high and they cannot be expected to answer
specific problems you may have on your machine, generally authors are
only happy to receive feedback on the documents.

Likewise, if you feel you have something to contribute or you wish to try
your hands as an LDP author you are welcome to contact the LDP coordinator
with your inputs (see the HOWTO-HOWTO). Remember that new documents are
produced all the time so it is important to contact the LDP before you
start writing in order to eliminate the possibility of duplicate work.

Remember that you do not have to be on-line to read the HOWTOs, in many
cases these documents are installed with your Linux distribution and can
be found at
        file:///usr/doc/HOWTO   /usr/doc/HOWTO/

===(intro.ldp)===

.ig \"-*- nroff -*-
Copyright (C) 2000 Stein Gjoen

Permission is granted to make and distribute verbatim copies of
this manual provided the copyright notice and this permission notice
are preserved on all copies.

Permission is granted to copy and distribute modified versions of this
manual under the conditions for verbatim copying, provided that the
entire resulting derived work is distributed under the terms of a
permission notice identical to this one.

Permission is granted to copy and distribute translations of this
manual into another language, under the above conditions for modified
versions, except that this permission notice may be included in
translations approved by the Free Software Foundation instead of in
the original English.
..
.TH "LDP Introduction" "ldp" "February 6, 2000" "LDP"
.SH "NAME"
.'
LDP \- Intro to the Linux Documentation Project, with help, guides and
documents
.'
.'
.SH "SYNOPSIS"
.'
The Linux Documentation Project (LDP) provides a variety of
free documentation resources including
guides, FAQs, HOWTOs, and man-pages to the Linux community.

.SH "AUTHORS"
.'
.'
The various documents in the LDP archives are maintained by individual
authors, and are listed in the beginning of each HOWTO. If you have
any questions or inputs to a document we encourage you to contact the
authors directly.

.SH "WEB PAGES"
.'
.'
The LDP now has its own dedicated web site as do many of
the various translations projects which are linked from the
main LDP web site at
.'
\fBhttp://www\&.linuxdoc\&.org/\fP

.SH "MAILING LISTS"
.'
.'
LDP has a number of mailing lists, mostly of use for authors:
.PP
.PD 0
.TP
.PD
\fB<ldp\-announce@lists\&.linuxdoc\&.org>\fP
Announcements from the LDP project
.TP
\fB<ldp\-discuss@lists\&.linuxdoc\&.org>\fP
General discussion on the LDP project
.PP
To join these lists send a mail with a body of "subscribe"
to \fB<ldp\-announce\-request@lists\&.linuxdoc\&.org>\fP
or \fB<ldp\-discuss\-request@lists\&.linuxdoc\&.org>\fP
respectively. These mailing lists are also archived at the
LinuxDoc site.

.SH "FILES"
.'
.'
Most distributions include the HOWTOs and mini-HOWTOs in the installation
.PD 0
.TP
\fB/usr/doc/\fP             (most documentation is here)
.TP
\fB/usr/doc/HOWTO/\fP       (HOWTO files)
.TP
\fB/usr/doc/HOWTO/mini/\fP  (mini-HOWTO files)
.PD
.'
.SH "SEE ALSO"
.'
\fIman\fP(1),
\fIinfo\fP(1)
.PP
\fBinfo\fP pages as read with \fIemacs\fP(1) or \fIinfo\fP(1).
.' (avoiding a yodl bug)
.' (avoiding a yodl bug)

===(intro.txt)===

LDP Introduction(ldp)                   LDP Introduction(ldp)


NAME
       LDP - Intro to the Linux Documentation Project, with help,
       guides and documents

SYNOPSIS
       The Linux Documentation Project (LDP) provides  a  variety
       of  free documentation   resources including guides, FAQs,
       HOWTOs, and man-pages to the Linux community.


AUTHORS
       The various documents in the LDP archives  are  maintained
       by  individual authors, and are listed in the beginning of
       each HOWTO. If you have any questions or inputs to a docu-
       ment we encourage you to contact the authors directly.


WEB PAGES
       The  LDP now has its own dedicated web site as do many of
       the various translations projects which  are  linked  from
       the main LDP web site at http://www.linuxdoc.org/


MAILING LISTS
       LDP  has a  number  of   mailing lists, mostly of use for
       authors:

       <ldp-announce@lists.linuxdoc.org>
              Announcements from the LDP project

       <ldp-discuss@lists.linuxdoc.org>
              General discussion on the LDP project

       To join these lists send a mail with a body of "subscribe"
       to  <ldp-announce-request@lists.linuxdoc.org> or <ldp-dis-
       cuss-request@lists.linuxdoc.org> respectively. These mail-
       ing lists are also archived at the LinuxDoc site.


FILES
       Most  distributions  include the HOWTOs and mini-HOWTOs in
       the installation
       /usr/doc/             (most documentation is here)
       /usr/doc/HOWTO/  (HOWTO files)
       /usr/doc/HOWTO/mini/  (mini-HOWTO files)

SEE ALSO
       man(1), info(1)

       info pages as read with emacs(1) or info(1).







LDP                     February 6, 2000                        1



===(disk.ldp)===

.ig \"-*- nroff -*-
Copyright (C) 2000 Stein Gjoen

Permission is granted to make and distribute verbatim copies of
this manual provided the copyright notice and this permission notice
are preserved on all copies.

Permission is granted to copy and distribute modified versions of this
manual under the conditions for verbatim copying, provided that the
entire resulting derived work is distributed under the terms of a
permission notice identical to this one.

Permission is granted to copy and distribute translations of this
manual into another language, under the above conditions for modified
versions, except that this permission notice may be included in
translations approved by the Free Software Foundation instead of in
the original English.
..
.TH "Multi Disk HOWTO" "ldp" "February 6, 2000" "LDP"
.SH "NAME"
.'
Multi Disk HOWTO \- Multi disk design, partitioning, formatting, tuning and
maintenence
.'
.'
.SH "ABSTRACT"
.'
This document describes how best to use multiple disks and partitions
for a Linux system. Although some of this text is Linux specific the
general approach outlined here can be applied to many other multi tasking
operating systems.

.SH "LOCATION"
.'
.'
The Multi Disk HOWTO is located at \fB/usr/doc/LDP/\fP

.SH "FILES"
.'
.'
Most distributions include the HOWTOs and mini-HOWTOs in the installation
.PD 0
.TP
\fB/dev/\fP             (device files)
.TP
\fB/etc/fstab\fP        (mount list)
.TP
\fB/etc/mdtab\fP        (old style RAID table)
.TP
\fB/etc/raidtab\fP      (new style RAID table)

.SH "RELATED HOWTOS"
.'
.'
Tips, Partition, Partition Rescue, Large-Disk, LILO, Software-RAID, Upgrade

.PD
.'
.SH "SEE ALSO"
.'
\fIfdisk\fP(8),
\fIcfdisk\fP(8),
\fIsfdisk\fP(8),
\fIfips\fP(8),
\fImkfs\fP(8),
\fImke2fs\fP(8),
\fItune2fs\fP(8),
\fIdumpe2fs\fP(8),
\fIfsck\fP(8),
\fIfsck.ext2\fP(8) or
\fIe2fsck\fP(8),
\fImount\fP(8),
\fIumount\fP(8),
\fIintro\fP(ldp)


===(disk.txt)===

Multi Disk HOWTO(ldp)                   Multi Disk HOWTO(ldp)


NAME
       Multi  Disk  HOWTO - Multi disk design, partitioning, for-
       matting, tuning and maintenence

ABSTRACT
       This document describes how best to use multiple disks and
       partitions  for a Linux system. Although some of this text
       is Linux specific the general approach outlined  here  can
       be  applied to many other multi tasking operating systems.


LOCATION
       The Multi Disk HOWTO is located at /usr/doc/LDP/


FILES
       Most distributions include the HOWTOs and  mini-HOWTOs  in
       the installation
       /dev/            (device files)
       /etc/fstab       (mount list)
       /etc/mdtab       (old style RAID table)
       /etc/raidtab     (new style RAID table)

RELATED HOWTOS
       Tips, Partition, Partition Rescue, Large-Disk, LILO, Soft-
       ware-RAID, Upgrade


SEE ALSO
       fdisk(8),   cfdisk(8),   sfdisk(8),   fips(8),   mkfs(8),
       mke2fs(8),  tune2fs(8), dumpe2fs(8), fsck(8), fsck.ext2(8)
       or e2fsck(8), mount(8), umount(8), intro(ldp)



LDP                     February 6, 2000                        1



===(end)===

Regards,
   Stein Gjoen


--  
To UNSUBSCRIBE, email to ldp-discuss-request@lists.debian.org
with a subject of "unsubscribe". Trouble? Contact listmaster@lists.debian.org