[Pkg-electronics-devel] New geda-xgsch2pcb version

[أحمد المحمودي]

On Sat, Jan 02, 2010 at 04:37:27PM +0000, Peter Clifton wrote:
> > In order for the update process to work properly, you should never
> > launch \fIpcb\fP to edit your PCB layout except through \fIxgsch2pcb\fP.
> > If you are editing the layout without \fIxgsch2pcb\fP running and then
> > wish to edit your layout you should close \fIpcb\fP, launch
> > \fIxgsch2pcb\fP and then use the 'Edit layout' button to launch \fIpcb\fP
> > again.
> "
> 
> That isn't correct any more.. but I see it is indeed in the README..
> I'll remove that paragraph! Can you take it out of the manpage too
> please.

Sure !

> I'm not personally that convinced of the merits of having comprehensive
> manpages for GUI apps. (I can completely see it for command line ones
> though). Debian policy states that apps should have manpages, and I'm
> not against including a simple one upstream - it certainly doesn't
> detract from anything.
> 
> I'd be more inclined, if we included one upstream, to keep it very
> minimal. By describing the GUI and operation in detail, I'd then have
> the app, the README _and_ the manpage to update, every time there is any
> substantial change - they _will_ get out of sync, as with the above
> paragraph!
> 
> [...]
> 
> Thanks for creating the manpage.. the more "standards compliant" these
> packages become, the easier it is to keep them updated in Debian. I look
> forward to taking this upstream.

Well, how about having the documentation in the manpage only, and the 
README would contain installation info. ?

-- 
 ‎أحمد المحمودي (Ahmed El-Mahmoudy)
  Digital design engineer
 GPG KeyID: 0xEDDDA1B7 (@ subkeys.pgp.net)
 GPG Fingerprint: 8206 A196 2084 7E6D 0DF8  B176 BC19 6A94 EDDD A1B7