Dear GROFF folks!
Despite succesfully using GROFF for quite a while, I never happened to use the
refer. My recent attempt to start using it revealed a strange groff/refer
combination behaviour I really cannot put up with.
Please, correct me if I am wrong, but my impression is that groff cannot
Hi Piotr,
> my impression is that groff cannot print references or a bibliography
> list, if not compiled together with some macro set: -ms, -mm, etc.
refer(1) is a preprocessor that outputs assignments to registers and
macro invocations. It is up to something downstream to provide macro
definit
> You should run refer directly on your example file and
> examine how it's changed it.
I was about to suggest the same.
Based on this (and just for fun), I quickly hacked together
the attached macros. They are by no means sufficient for a
real application, but they should give you some idea on
[I'm forwarding this to the list because I think it might be of general
interest.]
> 1. Do the macros you made assume the use of refer.tmac?
No, they provide similar functionality[*], but they're a
completely separate and independent implementation of that
functionality.
[*] Once they are p
On Wed, Jan 08, 2020, Tadziu Hoffmann wrote:
> In my opinion, the manual page [refer(1)] is perfectly adequate,
> if you accept that it is not a tutorial but rather a reference
> manual that you refer to for particular details of implementation
> or invocation.
The caveat is significant: you must
Hi Piotr,
Tadziu wrote:
> > I quess that groff -R automatically activates refer.tmac and all
> > registers like [F become available. Correct?
>
> No, -R only filters the input document through the "refer"
> preprocessor before processing it with the actual formatter "troff".
See groff(1)'s -V opt
Ralph,
Thank you for this valuable advice.
I will try to use it, especially and hopefully for exploring the internal
workings of some macro sets like pdfmark.
Piotr
Ralph Corderoy wrote ..
> Hi Piotr,
>
> Tadziu wrote:
> > > I quess that groff -R automatically activates refer.tmac and all
>
p.piat...@dragon.bas-net.by wrote ..
> Hi, Peter
>
> I am glad there is someone who shares my concern about the refer
> documentation because otherwise I would wonder if I really that lasy
> and stupid ... On the other hand, what else should be assumed by a
> documentation creator about the end us
Peter and Piotr,
You've both offered good, specific suggestions for improving the refer
man page. I encourage you to add these to the groff bug tracker
(http://savannah.gnu.org/bugs/?group=groff). Anyone can enter a bug
report, even without creating a savannah account, and filing a bug
makes it