[GRASS5] Patch for bug#3345 (debian bug#313307)

[Daniel Calvelo Aros]

Ok, there you are. This patch does correctly escape backslashes before
processing and then re-escapes single and double quotes where they could be
active characters for roff. 

I noticed that backslashes are seldom used in the docs, but on two occasions
they are intended to be actual roff escapes:

- r.mapcalc uses '\e' to denote continuation once. It uses '\' one paragraph
later for the same. I think with this patch applied the '\e' should be changed
to '\'. Note that for roff \e is the escape character, which can be changed,
whereas \(rs is the backslash glyph. BTW, the docs for r.mapcalc contain
several tables written as preformatted text, which can be rewritten as proper
tables.

- r.watershed uses both \u and \d escapes, which are roff codes for switching
on and off superscript. Those should be changed to something html-ish.

Otherwise, occurrences of '\' are for verbatim continuation lines or as
html-unescaped shell-like special characters: \t, \n,...

Hope I got it right this time. Sorry for the previous noise.

-- Daniel Calvelo Aros

---------- Original Message -----------
From: Markus Neteler <neteler at itc.it>
To: daniel.calvelo at minag.gob.pe
Cc: Steve Halasz <debian at adkgis.org>, grass5 at grass.itc.it
Sent: Thu, 14 Jul 2005 10:32:08 +0200
Subject: Re: [GRASS5] Patch for bug#3345 (debian bug#313307)

> OK, patch reverted.
> Hopefully you'll find a solution!
> 
>  Markus
> 
> On Wed, Jul 13, 2005 at 01:59:15PM -0500, Daniel Calvelo Aros wrote:
> > AAAARGH! Revert and ry this one instead. Silly me... I'll look futher into
> > where to properly escape backslashes. I'd guess a previous pass but don't have
> > my sources right now.
> > 
> > -- Daniel Calvelo Aros
> > 
> > ---------- Original Message -----------
> > From: Markus Neteler <neteler at itc.it>
> > To: Steve Halasz <debian at adkgis.org>
> > Cc: daniel.calvelo at minag.gob.pe, grass5 at grass.itc.it
> > Sent: Wed, 13 Jul 2005 12:21:11 +0200
> > Subject: Re: [GRASS5] Patch for bug#3345 (debian bug#313307)
> > 
> > > Patch applied. but now it looks a bit unhealthy (RHEL4):
> > > 
> > > g.manual -m v.in.ascii
> > > 
> > > NAME
> > >        \(rsfI\(rsfBv.in.ascii\(rsfR\(rsfR   - Convert GRASS ascii 
> > > file or points file       to binary vector.
> > > 
> > > SYNOPSIS
> > >        \(rsfBv.in.ascii\(rsfR
> > > 
> > > Patch the patch? Revert?
> > > 
> > >  Markus
> > > 
> > > On Tue, Jul 12, 2005 at 10:37:34PM -0400, Steve Halasz wrote:
> > > > Thanks for the patch!
> > > > 
> > > > On Tue, 2005-07-12 at 21:20 -0500, Daniel Calvelo Aros wrote:
> > > > > Hi,
> > > > > 
> > > > > The attached patch should fix bug #3345 (actually g.html2man not
escaping
> > > > > control characters for roff). It seems to do the right thing for me.
Please
> > > > > test and close. I don't know how it should be resolved in the debian
> > > > > bugtracker. 
> > > > 
> > > > The debian bug will be closed automatically by placing a (Closes:
> > > > #313307) in the changelog when I upload a version of grass containing
> > > > the fix to the debian archive.
> > > > 
> > > > Steve
> > > >
> > > 
> > > -- 
> > > Markus Neteler     <neteler itc it>       http://mpa.itc.it
> > > ITC-irst -  Centro per la Ricerca Scientifica e Tecnologica
> > > MPBA - Predictive Models for Biol. & Environ. Data Analysis
> > > Via Sommarive, 18        -       38050 Povo (Trento), Italy
> > > 
> > > _______________________________________________
> > > grass5 mailing list
> > > grass5 at grass.itc.it
> > > http://grass.itc.it/mailman/listinfo/grass5
> > ------- End of Original Message -------
> >
> 
> -- 
> Markus Neteler     <neteler itc it>       http://mpa.itc.it
> ITC-irst -  Centro per la Ricerca Scientifica e Tecnologica
> MPBA - Predictive Models for Biol. & Environ. Data Analysis
> Via Sommarive, 18        -       38050 Povo (Trento), Italy
> 
> _______________________________________________
> grass5 mailing list
> grass5 at grass.itc.it
> http://grass.itc.it/mailman/listinfo/grass5
------- End of Original Message -------

-------------- next part --------------
A non-text attachment was scrubbed...
Name: g.html2man.quotes.patch
Type: application/octet-stream
Size: 459 bytes
Desc: not available
Url : http://lists.osgeo.org/pipermail/grass-dev/attachments/20050716/4ddd1d62/g.html2man.quotes.obj