Re: GNOME PPP uploaded to mentors.debian.net
On Mon, 2004-06-28 at 09:35, Dan Korostelev wrote:
> On Mon, 2004-06-28 at 09:17 +0200, Thomas Hood wrote:
>
> > Here's an improved version of the manpage. It still needs some work.
> GNOME PPP is not only a accound configurer like wvdialconf. It is a
> graphical frontend, a graphical dialer. It can dial, show status icon
> and show some details, much like KPPP. I'll write it there. Also it
> doesn't have an Info page. Wait for new package with updated manpage.
Your new manpage still contains superfluous material:
> This manual page documents briefly the
gnome-ppp command.
Superfluous.
> This manual page was written for the Debian
> distribution because the original program
> does not have a manual page.
Save this for the AUTHORS section.
> gnome-ppp is a GNOME program for easy config-
> uring and dialing PPP dialup accounts.
... for configuration and control of PPP dialup accounts.
> It
> uses wvdial as its dialing backend and stor-
> ing accound configuration in wvdial.conf for-
> mat, that can be used by plain wvdial.
gnome-ppp is a front end for wvdial. Thus, PPP
accounts set up using gnome-ppp can be used if
you run wvdial from the command line.
> Cur-
> rently it only supports one account per user,
> but multiple accounts configuring is planned
> for near future.
Don't document features that are only promised. That is
useless information. If the feature is added later then
you can add a description of the feature to the man page
at that time.
> GNOME PPP can also dock into your
> GNOME/XFCE4/others notification area and show
> connection detail while connected. See pro-
> gram's setup window.
In the setup dialog you can configure gnome-ppp
to provide connection information in the desktop
notification area.
> These programs follow the usual GNU command
> line syntax, with long options starting with
> two dashes (`-').
Superfluous.
> A summary of options is included below.
Superfluous.
> For a complete description, see the Info files.
These files are not included so they should not be mentioned.
--
Thomas Hood
Reply to: