Hi!

I've been trying to add some documentation to stress the similarity (and
hopefully differences) of '-f' and '-F': my first attempt was to add
plains
S<(c.f. -F, --modfilter)>
and 
S<(c.f. -f, --filter)>
but then I thought that I might as well use an hyperlink, but... the
most obvious
L<S<(c.f. B<-F>, B<--modfilter>)>|/B<-F>, B<--modfilter>=I<FILTER>>
and 
L<S<(c.f. B<-f>, B<--filter>)>|/B<-f>, B<--filter>=I<FILTER>>
don't really work: 'podchecker' doesn't complain, but 'pod2html' fails
to give valid references (I mean it doesn't recognise what I'm trying to
point to), the problem is the formating in the item header; it somehow
confuses 'pod2html'.

I see several options:
- get a suggestion on that (I've searched a lot, but couldn't find
anything very useful).
- drop this idea of having a link (...).
- write it off as a bug in 'pod2html' (I've read some not so positive
comments on it), and hope that the issue will solve itself.
- reorganise the documentation not to have formating in the items text
(I don't think it's a good idea!).
- ?

Thanks!

Philippe

Steffen Mueller wrote:
> 
> Philippe Schaffnit schrieb:
> > Right! Thanks a lot for your quick reply: my mistake indeed!
> 
> No problem. Happens to everybody.
> 
> > I had overseen the difference between '--filter' and '--modfilter'...
> > (maybe a comment in the help: see the other one for each, could be
> > helpful, but anyone there's no substitue for *carefully* RTFM...)
> 
> You're right. Unless I am mistaken, you have commit access to the
> repository. Just add a short mention of the other switch if you like.
> 
> > PS: I'm sorry I missed the post you're mentioning, BTW, I don't seem to
> > be able to get on the list archive right now (something local?).
> 
> No idea.
> 
> > PPS: Yes, I had followed the dissusion which followed your introduction
> > of Squish, and I was only expecting a small nudge: I am experiencing
> > some difficulties packing a Perl::Tk script, and I am under the
> > impression that from some critical amount of code on, Tk starts
> > mis-behaving, which is what I was trying to look into...
> 
> Can't help you there. I successfully packaged a ~80k lines Tk
> application consisting of 35k lines of my code + CPAN modules. But it
> wasn't exactly pretty. (Lots of -M's and lots of "require Tk::FOO::BAR;"
> in the script to make pp happy)
> 
> Good luck!
> 
> Steffen

Reply via email to