Re: Groff examples repository

2021-09-14 Thread Thomas Dupond
Hi Ingo,

Ingo Schwarze  wrote:

> Hi Thomas,
>
> I added a link to it to
>
>   https://mandoc.bsd.lv/links.html

Thank you :) .

> I think on your start page, you ought to add a link to
>
>   https://www.gnu.org/software/groff/ .

Of course! It seemed so obvious but I forgot it!

> Since John Gardner will (rightly) insist that examples of mdoc(7)
> code are nothing more than mere examples of roff(7) code, i would
> consider a link to
>
>   https://mandoc.bsd.lv/mdoc/

Link added on the front page.

> useful as well; your call.
>
> If you want to add a full-blown example of how to use groff to
> set up a complete conference presentation, feel free to link to
>
>   https://www.openbsd.org/papers/eurobsdcon2018-mandoc.roff
>   https://www.openbsd.org/papers/eurobsdcon2018-mandoc.pdf

I'm impressed by the many things groff can do.  Nice work.  I linked to
it in https://froude.eu/groff/examples/conference.html

> Even if you consider mdoc(7) off-topic, you definitely want to link
> to these two pages:
>
>   https://mandoc.bsd.lv/mdoc/details/recursion.html
>   https://mandoc.bsd.lv/mdoc/details/redefine_self.mdoc
>
> You think that is insane?
>
> Well, i can't really disagree with you.  :-)
>
>
> Then again, if a programming language can be used to print Fibonacci
> numbers, that *is* useful, don't you think?
>
>  $ man -cl redefine_self.mdoc
> ()()
>
> 1 1 2 3 5 8 13 21 34 55 89 144 233 377 610 987 1597 2584

This is insane.  It is absolutely needed on the examples repository.  Thank
you for this.

Regards,
Thomas




Re: Groff examples repository

2021-08-30 Thread Thomas Dupond
Dave Kemper  wrote:

> On 8/25/21, Thomas Dupond  wrote:
> > The Groff examples repository is now available on the web at
> > https://froude.eu/groff and on geminispace at gemini://froude.eu/groff
>
> Fantastic!  Thanks so much for putting this together.
>
> I see that each page has a link to the source mailing list post, so
> that the original contributor can be identified.  But for pages with
> code that has a specific author (not all the pages fall into this
> category), I wonder if the author ought to be credited on the
> repository page itself as well.

Sure thing, every page has a credit to the author directly in the text
now.

Regards,

Thomas




Re: Groff examples repository

2021-08-29 Thread John Gardner
>
> Since John Gardner will (rightly) insist that examples of mdoc(7) code are
> nothing more than mere examples of roff(7) code


To quote Heisenberg: *"You're goddamn right."* ;-)

The Groff examples repository is now available on the web at
> https://froude.eu/groff
>

Feel free to plunder my stupid macro package for anything you consider
worth sharing:

https://github.com/Alhadis/Mono

When copy+pasting from the macro package, be aware that many internal
registers and strings use names containing ASCII control characters, which
mightn't be visible in your browser/editor. Specifically, ^B, ^C, ^E, ^F, ^G,
^?.

On Mon, 30 Aug 2021 at 03:36, Ingo Schwarze  wrote:

> Hi Thomas,
>
> On 8/25/21, Thomas Dupond  wrote:
>
> > The Groff examples repository is now available on the web at
> > https://froude.eu/groff and on geminispace at gemini://froude.eu/groff
>
> Nice.
>
> I added a link to it to
>
>   https://mandoc.bsd.lv/links.html
>
> I think on your start page, you ought to add a link to
>
>   https://www.gnu.org/software/groff/ .
>
> Since John Gardner will (rightly) insist that examples of mdoc(7)
> code are nothing more than mere examples of roff(7) code, i would
> consider a link to
>
>   https://mandoc.bsd.lv/mdoc/
>
> useful as well; your call.
>
> If you want to add a full-blown example of how to use groff to
> set up a complete conference presentation, feel free to link to
>
>   https://www.openbsd.org/papers/eurobsdcon2018-mandoc.roff
>   https://www.openbsd.org/papers/eurobsdcon2018-mandoc.pdf
>
> Parts of the contents of that presentation are also loosely related
> to roff(7), but that is incidental.  The point why it might matter
> here really is the full-blown example of setting up complete slides
> for a conference presentation.
>
> Yours,
>   Ingo
>
>


Re: Groff examples repository

2021-08-29 Thread Heinz-Jürgen Oertel
Am Sonntag, 29. August 2021, 22:46:54 CEST schrieb Thomas Dupond:
> Heinz-Jürgen Oertel  wrote:
> 
> > Hi,
> >
> > in the past for technical papers I often used dformat:
> >
> > https://noxz.tech/guides/groff/papers/dformat_--_a_program_for_typesetting_data_formats__142.pdf
> 
> This is excellent, I'm always impressed by what can be achieved with
> groff and pic.
> 
> > extracted the source from this paper, but it can be found now at
> >
> > https://github.com/sathlan/dformat
> >
> > Unfortunately it does not contain the changes I did to use gpic
> > "shaded" command to use Colored Objects
> 
> Would you mind sharing your changes so I can include them?


may be it will be better to incorporate it int the github project mentioned 
above. 

attached a small example illustrating it.

> >
> > Regards
> > Heinz
> 
> The DFORMAT program is now listed on the website at
> https://froude.eu/groff/examples/dformat.html and on gemini at
> gemini://froude.eu/groff/examples/dformat.gmi
> 
> Regards,
> 
> Thomas

Thanks Thomas

Heinz


example.pdf
Description: Adobe PDF document


Re: Groff examples repository

2021-08-29 Thread Ingo Schwarze
Hi Thomas,

sorry for the afterthought...

Ingo Schwarze wrote on Sun, Aug 29, 2021 at 07:34:56PM +0200:

>   https://mandoc.bsd.lv/mdoc/

Even if you consider mdoc(7) off-topic, you definitely want to link
to these two pages:

  https://mandoc.bsd.lv/mdoc/details/recursion.html
  https://mandoc.bsd.lv/mdoc/details/redefine_self.mdoc

You think that is insane?

Well, i can't really disagree with you.  :-)


Then again, if a programming language can be used to print Fibonacci
numbers, that *is* useful, don't you think?

 $ man -cl redefine_self.mdoc
()()

1 1 2 3 5 8 13 21 34 55 89 144 233 377 610 987 1597 2584

  ()

Yours,
  Ingo



Re: Groff examples repository

2021-08-29 Thread Ingo Schwarze
Hi Thomas,

On 8/25/21, Thomas Dupond  wrote:

> The Groff examples repository is now available on the web at
> https://froude.eu/groff and on geminispace at gemini://froude.eu/groff

Nice.

I added a link to it to

  https://mandoc.bsd.lv/links.html

I think on your start page, you ought to add a link to

  https://www.gnu.org/software/groff/ .

Since John Gardner will (rightly) insist that examples of mdoc(7)
code are nothing more than mere examples of roff(7) code, i would
consider a link to

  https://mandoc.bsd.lv/mdoc/

useful as well; your call.

If you want to add a full-blown example of how to use groff to
set up a complete conference presentation, feel free to link to

  https://www.openbsd.org/papers/eurobsdcon2018-mandoc.roff
  https://www.openbsd.org/papers/eurobsdcon2018-mandoc.pdf

Parts of the contents of that presentation are also loosely related
to roff(7), but that is incidental.  The point why it might matter
here really is the full-blown example of setting up complete slides
for a conference presentation.

Yours,
  Ingo



Re: Groff examples repository

2021-08-29 Thread Dave Kemper
On 8/25/21, Thomas Dupond  wrote:
> The Groff examples repository is now available on the web at
> https://froude.eu/groff and on geminispace at gemini://froude.eu/groff

Fantastic!  Thanks so much for putting this together.

I see that each page has a link to the source mailing list post, so
that the original contributor can be identified.  But for pages with
code that has a specific author (not all the pages fall into this
category), I wonder if the author ought to be credited on the
repository page itself as well.



Re: Groff examples repository

2021-08-29 Thread Keith Marshall
On 28/08/2021 17:14, Douglas McIlroy wrote:
> A small anomaly. Consider
> 
> .de .
> .tm Hi
> ,..
> ..

I'm guessing that the comma, before the first ".." is an unintended
introduction?

> The second .. emits "Hi". This fragment also emits "Hi":
> 
> .de end end
> .tm Hi
> .end
> 
> But this (with macro . not previously defined)
> does not:
> 
> .de . .
> .tm Hi
> ..

Even if macro "." were previously defined, the latter should not emit
"Hi".  Footnote 16, in reference to ".de" and its variations, within the
groff reference manual[1], explains this, (with an essentially similar
example): during a macro definition, '..' is never handled as a call to
'.', even if you say '.de foo .' explicitly.

[1]: https://www.gnu.org/software/groff/manual/groff.pdf

(FWIW, I think I would have s/handled/interpreted/)

-- 
Cheers, Keith



Re: Groff examples repository

2021-08-29 Thread G. Branden Robinson
At 2021-08-28T12:14:17-0400, Douglas McIlroy wrote:
> -
> 
> A small anomaly. Consider
> 
> .de .
> .tm Hi
> ,..
> ..
> 
> The second .. emits "Hi". This fragment also emits "Hi":
> 
> .de end end
> .tm Hi
> .end
> 
> But this (with macro . not previously defined)
> does not:
> 
> .de . .
> .tm Hi
> ..

I used the same example last week to update the "Writing Macros" section
of our Texinfo manual.  The concept of "copy mode" confused me deeply
when I first arrived in the groff community and finally I realized that
the statement, used repeatedly about escapes in our documentation, that
certain ones are "interpreted in copy mode" makes a lot more sense to
people who already know what copy mode is than those who don't.
Recasting ensued.

I have added some of this material to groff(7) as well, albeit in
aggressively condensed form and with no examples.

It may go without saying, but I have some minor revisions to the below
queued already.  Nevertheless I think in its present state it renders
the subject more accessible.

*** SNIP ***
5.21 Writing Macros
===

A "macro" is a stored collection of text and control lines that can be
used multiple times.  Use macros to define common operations.  *Note
Strings::, for a (limited) alternative syntax to call macros.  While
requests exist for the purpose of creating macros, simply calling an
undefined macro, or interpolating it as a string, will cause it to be
defined as empty.  *Note Identifiers::.

 -- Request: .de name [end]
 Define a macro NAME, replacing the definition of any existing
 request, macro, string, or diversion called NAME.  GNU 'troff'
 enters "copy mode", storing subsequent input lines in an internal
 buffer.  If the optional second argument is not specified, the
 macro definition ends with the control line '..' (two dots).
 Alternatively, END identifies a macro whose call syntax ends the
 definition of NAME; END is then called normally.  Spaces or tabs
 are permitted after the control character in the line containing
 this ending token (either '.' or 'END'), but a tab immediately
 after the token prevents its recognition as the end of a macro
 definition.(1)  (*note Writing Macros-Footnote-1::)

 Here is a small example macro called 'P' that causes a break and
 inserts some vertical space.  It could be used to separate
 paragraphs.

  .de P
  .  br
  .  sp .8v
  ..

 We can define one macro within another.  Attempting to nest '..'
 naïvely will end the outer definition because the inner definition
 isn't interpreted as such until the outer macro is later
 interpolated.  We can use an end macro instead.  Each level of
 nesting should use a unique end macro.

 An end macro need not be defined until it is called.  This fact
 enables a nested macro definition to begin inside one macro and end
 inside another.  Consider the following example.(2)  (*note Writing
 Macros-Footnote-2::)

  .de m1
  .  de m2 m3
  you
  ..
  .de m3
  Hello,
  Joe.
  ..
  .de m4
  do
  ..
  .m1
  know?
  .  m3
  What
  .m4
  .m2
  => Hello, Joe.  What do you know?

 A nested macro definition _can_ be terminated with '..', and nested
 macros _can_ reuse end macros, but these control lines must be
 escaped multiple times for each level of nesting.  The necessity of
 this escaping and the utility of nested macro definitions will
 become clearer when we employ macro parameters and consider the
 behavior of copy mode in detail.

 -- Request: .de1 name [end]
 The 'de1' request defines a macro that executes with compatibility
 mode disabled (*note Implementation Differences::).  On entry, the
 state of compatibility mode enablement is saved, and on exit it is
 restored.  Observe the extra backlash before the interpolation of
 register 'xxx'; we'll explore this subject in *note Copy Mode::.

  .nr xxx 12345
  .de aa
  The value of xxx is \\n[xxx].
  .  br
  ..
  .de1 bb
  The value of xxx is \\n[xxx].
  ..
  .cp 1
  .aa
  error-> warning: register '[' not defined
  => The value of xxx is 0xxx].
  .bb
  => The value of xxx is 12345.

 -- Request: .dei name [end]
 -- Request: .dei1 name [end]
 The 'dei' request defines a macro indirectly.  That is, it
 interpolates strings named NAME and END before performing the
 definition.

 The following examples are equivalent.

  .ds xx aa
  .ds yy bb
  .dei xx yy

  .de aa bb

 The 'dei1' request is similar to 'dei', but with compatibility mode
 

Re: Groff examples repository

2021-08-29 Thread Heinz-Jürgen Oertel
Am Mittwoch, 25. August 2021, 18:50:56 CEST schrieb Thomas Dupond:
> 
> 
> As noted on the first page, feel free to email me any macro you find
> interesting, I will put it online as soon as I can :) .


Hi,

in the past for technical papers I often used dformat:

https://noxz.tech/guides/groff/papers/dformat_--_a_program_for_typesetting_data_formats__142.pdf


extracted the source from this paper, but it can be found now at 

https://github.com/sathlan/dformat

Unfortunately it does not contain the changes I did to use gpic "shaded" 
command to use Colored Objects


Regards
Heinz








Re: Groff examples repository

2021-08-28 Thread Thomas Dupond
Douglas McIlroy  wrote:

> https://froude.eu/groff/examples/reflow.html is a very cleanly written and
> interesting demo. The following comments might perfect it even further.
>
> It would be helpful to remark that .YY is a dumping ground, never to be
> used.
>
> Point out that EB need not be defined. It carries the .tm for the demo, but
> is irrelevant to the underlying purpose. Nevertheless, it's useful to
> illustrate that the macro-end indicator will be expanded if it's defined.
> (But see below.)

I added both of your explanations to the page, I hope that it's as clear
as you are.

> At first glance I read "Text before" and "Text after" as headings for
> paragraphs that show how the processed text would look before and after
> expansion to 2cm height. A change to "Preceding text" and "Following text"
> would avert this mistake.

Indeed, done.

> -
>
> A small anomaly. Consider
>
> .de .
> .tm Hi
> ,..
> ..
>
> The second .. emits "Hi". This fragment also emits "Hi":
>
> .de end end
> .tm Hi
> .end
>
> But this (with macro . not previously defined)
> does not:
>
> .de . .
> .tm Hi
> ..

This is very interesting!  I did not add it to the page though.  I don't
think it would be very helpful in this particular example of reflowing
text to know that there are anomalies in end macros.

> Doug

Regards,

Thomas




Re: Groff examples repository

2021-08-28 Thread Douglas McIlroy
https://froude.eu/groff/examples/reflow.html is a very cleanly written and
interesting demo. The following comments might perfect it even further.

It would be helpful to remark that .YY is a dumping ground, never to be
used.

Point out that EB need not be defined. It carries the .tm for the demo, but
is irrelevant to the underlying purpose. Nevertheless, it's useful to
illustrate that the macro-end indicator will be expanded if it's defined.
(But see below.)

At first glance I read "Text before" and "Text after" as headings for
paragraphs that show how the processed text would look before and after
expansion to 2cm height. A change to "Preceding text" and "Following text"
would avert this mistake.

-

A small anomaly. Consider

.de .
.tm Hi
,..
..

The second .. emits "Hi". This fragment also emits "Hi":

.de end end
.tm Hi
.end

But this (with macro . not previously defined)
does not:

.de . .
.tm Hi
..

Doug

For the record, here's the reflow example.

.\" 
.\" begin block of text for multiple processing
.de BB
.tm starting to read text...
.de XX EB
..
.\" 
.\" end block
.de EB
.tm finished reading text.
..
.\" 
.\" delayed space macro, counts occurrences as well
.de SP
.nr NN +1
.sp \\n(QQu
..
.\" 
.\" now gather text
.BB
This text can be
.SP
processed
.SP
multiple
.SP
times.
.EB
.\" 
.\" process text once to determine height
.nr QQ 0
.nr NN 0
.di YY
.XX
.br
.di
.tm the text has a height of \n(dn units
.\" 
.\" now make text fit into exactly 2 cm
.nr QQ 2c-\n(dnu/\n(NNu \" note left-to-right, no precedence rules
.\" reprocessing to verify is not really necessary, just for demo
.di YY
.XX
.br
.di
.nr OO 2c
.tm the text now has a height of \n(dn units, 2 cm is \n(OO units
.\" 
.\" output text
.sp 3c
Text before.
.br
\M[yellow]\h'-.1c'\v'-.75v'\D'P 0 2c \n(dlu+.2c 0 0 -2c'
This yellow box has a height of 2 cm.
.sp -1
.XX
.br
Text after.


Re: Groff examples repository

2021-08-26 Thread Thomas Dupond
Oliver Corff  wrote:

> Hi Thomas,
>
> a very nice collection this is!

Thanks!

> One little typo in the overview, "Relowing the text [...]" should be
> "Reflowing [...]".

Fixed it and some other typos (should have run aspell sooner).

> Best wishes,
>
> Oliver.

Regards,

Thomas




Re: Groff examples repository

2021-08-25 Thread Oliver Corff

Hi Thomas,

a very nice collection this is!

One little typo in the overview, "Relowing the text [...]" should be
"Reflowing [...]".

Best wishes,

Oliver.


On 8/25/21 6:50 PM, Thomas Dupond wrote:

Hi everyone,

The Groff examples repository is now available on the web at
https://froude.eu/groff and on geminispace at gemini://froude.eu/groff
They have exactly the same content and I plan to make it available on
the gopherspace.

Sorry it took such a long time.

As noted on the first page, feel free to email me any macro you find
interesting, I will put it online as soon as I can :) .

Regards,
Thomas Dupond



--
Dr. Oliver Corff
-- China Consultant --
Wittelsbacherstr. 5A
D-10707 Berlin
Tel.: +49-30-8572726-0
Fax : +49-30-8572726-2
mailto:oliver.co...@email.de




Re: groff-examples repository

2021-07-15 Thread Wim Stockman
Hi Thomas,
I have my gopher and Gemini server up and running almost for a year now. So
I can mirror the groff section on my gopher and Gemini capsule. The url of
my Gemini and gopher are yasendfile.org.
I also have no problem to dedicate some time to this little projects.
I don't know if you already tested the titan protocol to make it a Gemini
wiki :-)
Kind regards
Wim Stockman

Op do 15 jul. 2021 22:49 schreef Thomas Dupond :

> Hans Bezemer  wrote:
>
> > One of the advantages is that users can submit their own
> > snippets.
>
> Wim Stockman  wrote:
>
> > Maybe create some managed wikipage
> > So the community can contribute to it.
>
> As much as I enjoy the kind words around this project, I would like to
> say that my trade is not related in any way to software development so
> maintaining a wikipage is beyond my grasp.
>
> Sorry if it's a bummer :/ I will go for a static website for now.
>
> If anyone finds an interesting groff macro, feel free to email it to me,
> I will add it to the web page (when it launches).
>
> Thomas
>
>
>


Re: groff-examples repository

2021-07-15 Thread Thomas Dupond
Hans Bezemer  wrote:

> One of the advantages is that users can submit their own
> snippets.

Wim Stockman  wrote:

> Maybe create some managed wikipage
> So the community can contribute to it.

As much as I enjoy the kind words around this project, I would like to
say that my trade is not related in any way to software development so
maintaining a wikipage is beyond my grasp.

Sorry if it's a bummer :/ I will go for a static website for now.

If anyone finds an interesting groff macro, feel free to email it to me,
I will add it to the web page (when it launches).

Thomas




Re: groff-examples repository

2021-07-14 Thread Heinz-Jürgen Oertel
Am Mittwoch, 14. Juli 2021, 22:52:39 CEST schrieb Wim Stockman:
> Maybe create some managed wikipage
> So the community can contribute to it.
> kind regards
> Wim Stockman

+1

-- 
mit freundlichen Grüßen aus Halle (Saale)
   Heinz-Jürgen Oertel





Re: groff-examples repository

2021-07-14 Thread Wim Stockman
Maybe create some managed wikipage
So the community can contribute to it.
kind regards
Wim Stockman

Op wo 14 jul. 2021 om 09:18 schreef Hans Bezemer :

> To have a place where groff examples can be found would be
> great!
>
> I would like to add a suggestion.
>
> I've used lilypond frequently to typeset scores.
> They have a snippet-repository[1] which I found very useful
> at the time.
>
> One of the advantages is that users can submit their own
> snippets.
>
> Kind regards,
>
> Hans
> [1] https://lsr.di.unimi.it/LSR/html/whatsthis.html
>
> On 21/07/13 09:06AM, Wim Stockman wrote:
> > This is fantastic :-).
> >
> >
> > Op di 13 jul. 2021 om 04:41 schreef Dave Kemper :
> >
> > > On 7/12/21, Thomas Dupond  wrote:
> > > > I'm skimming through the archives to try to create such a document
> > >
> > > Fantastic!
> > >
> > > > it is taking a lot of time since it goes back to 1999
> > >
> > > Happily, the entire archives don't need to be scoured at once.  Having
> > > something out there in incomplete form is better than having nothing
> > > out there; it can always be expanded as you or others have the chance
> > > to peruse more of the email archive and find new things.
> > >
> > > Here are a few that I've found useful at various times.
> > >
> > > Typesetting arbitrary fractions
> > > http://lists.gnu.org/archive/html/groff/2005-11/msg00029.html
> > > (with a caveat in
> > > http://lists.gnu.org/archive/html/groff/2013-09/msg00022.html)
> > >
> > > Rotating or reversing characters (PostScript ouptut only)
> > > http://lists.gnu.org/archive/html/groff/2000-08/msg00068.html
> > >
> > > Reflowing text several times to determine an optimum configuration
> > > http://lists.gnu.org/archive/html/groff/2008-12/msg6.html
> > >
> > > Outputting cut marks
> > > http://lists.gnu.org/archive/html/groff/2008-12/msg00024.html
> > >
> > > Command-line utility to show all the potential hyphenation points
> > > groff knows for a word
> > > http://lists.gnu.org/archive/html/groff/2018-11/msg00023.html
> > >
> > > and of course the strchr / strrchr macros that kick-started the
> > > present discussion
> > > http://lists.gnu.org:443/archive/html/groff/2021-06/msg00101.html
> > >
> > > > I wondered what would be actually eligible to end up in the document.
> > > >
> > > > I'm currently keeping examples using native groff syntax but I'm
> > > > hesitant on including personal macro sets posted to the mailing list.
> > >
> > > The great thing about volunteering to start a project is you get to
> > > dictate its ground rules. :-)
> > >
> > >
>
>


Re: groff-examples repository

2021-07-14 Thread Hans Bezemer
To have a place where groff examples can be found would be
great!

I would like to add a suggestion.

I've used lilypond frequently to typeset scores.
They have a snippet-repository[1] which I found very useful
at the time.

One of the advantages is that users can submit their own
snippets.

Kind regards,

Hans
[1] https://lsr.di.unimi.it/LSR/html/whatsthis.html

On 21/07/13 09:06AM, Wim Stockman wrote:
> This is fantastic :-).
> 
> 
> Op di 13 jul. 2021 om 04:41 schreef Dave Kemper :
> 
> > On 7/12/21, Thomas Dupond  wrote:
> > > I'm skimming through the archives to try to create such a document
> >
> > Fantastic!
> >
> > > it is taking a lot of time since it goes back to 1999
> >
> > Happily, the entire archives don't need to be scoured at once.  Having
> > something out there in incomplete form is better than having nothing
> > out there; it can always be expanded as you or others have the chance
> > to peruse more of the email archive and find new things.
> >
> > Here are a few that I've found useful at various times.
> >
> > Typesetting arbitrary fractions
> > http://lists.gnu.org/archive/html/groff/2005-11/msg00029.html
> > (with a caveat in
> > http://lists.gnu.org/archive/html/groff/2013-09/msg00022.html)
> >
> > Rotating or reversing characters (PostScript ouptut only)
> > http://lists.gnu.org/archive/html/groff/2000-08/msg00068.html
> >
> > Reflowing text several times to determine an optimum configuration
> > http://lists.gnu.org/archive/html/groff/2008-12/msg6.html
> >
> > Outputting cut marks
> > http://lists.gnu.org/archive/html/groff/2008-12/msg00024.html
> >
> > Command-line utility to show all the potential hyphenation points
> > groff knows for a word
> > http://lists.gnu.org/archive/html/groff/2018-11/msg00023.html
> >
> > and of course the strchr / strrchr macros that kick-started the
> > present discussion
> > http://lists.gnu.org:443/archive/html/groff/2021-06/msg00101.html
> >
> > > I wondered what would be actually eligible to end up in the document.
> > >
> > > I'm currently keeping examples using native groff syntax but I'm
> > > hesitant on including personal macro sets posted to the mailing list.
> >
> > The great thing about volunteering to start a project is you get to
> > dictate its ground rules. :-)
> >
> >



Re: groff-examples repository

2021-07-13 Thread Wim Stockman
This is fantastic :-).


Op di 13 jul. 2021 om 04:41 schreef Dave Kemper :

> On 7/12/21, Thomas Dupond  wrote:
> > I'm skimming through the archives to try to create such a document
>
> Fantastic!
>
> > it is taking a lot of time since it goes back to 1999
>
> Happily, the entire archives don't need to be scoured at once.  Having
> something out there in incomplete form is better than having nothing
> out there; it can always be expanded as you or others have the chance
> to peruse more of the email archive and find new things.
>
> Here are a few that I've found useful at various times.
>
> Typesetting arbitrary fractions
> http://lists.gnu.org/archive/html/groff/2005-11/msg00029.html
> (with a caveat in
> http://lists.gnu.org/archive/html/groff/2013-09/msg00022.html)
>
> Rotating or reversing characters (PostScript ouptut only)
> http://lists.gnu.org/archive/html/groff/2000-08/msg00068.html
>
> Reflowing text several times to determine an optimum configuration
> http://lists.gnu.org/archive/html/groff/2008-12/msg6.html
>
> Outputting cut marks
> http://lists.gnu.org/archive/html/groff/2008-12/msg00024.html
>
> Command-line utility to show all the potential hyphenation points
> groff knows for a word
> http://lists.gnu.org/archive/html/groff/2018-11/msg00023.html
>
> and of course the strchr / strrchr macros that kick-started the
> present discussion
> http://lists.gnu.org:443/archive/html/groff/2021-06/msg00101.html
>
> > I wondered what would be actually eligible to end up in the document.
> >
> > I'm currently keeping examples using native groff syntax but I'm
> > hesitant on including personal macro sets posted to the mailing list.
>
> The great thing about volunteering to start a project is you get to
> dictate its ground rules. :-)
>
>


Re: groff-examples repository

2021-07-12 Thread Dave Kemper
On 7/12/21, Thomas Dupond  wrote:
> I'm skimming through the archives to try to create such a document

Fantastic!

> it is taking a lot of time since it goes back to 1999

Happily, the entire archives don't need to be scoured at once.  Having
something out there in incomplete form is better than having nothing
out there; it can always be expanded as you or others have the chance
to peruse more of the email archive and find new things.

Here are a few that I've found useful at various times.

Typesetting arbitrary fractions
http://lists.gnu.org/archive/html/groff/2005-11/msg00029.html
(with a caveat in http://lists.gnu.org/archive/html/groff/2013-09/msg00022.html)

Rotating or reversing characters (PostScript ouptut only)
http://lists.gnu.org/archive/html/groff/2000-08/msg00068.html

Reflowing text several times to determine an optimum configuration
http://lists.gnu.org/archive/html/groff/2008-12/msg6.html

Outputting cut marks
http://lists.gnu.org/archive/html/groff/2008-12/msg00024.html

Command-line utility to show all the potential hyphenation points
groff knows for a word
http://lists.gnu.org/archive/html/groff/2018-11/msg00023.html

and of course the strchr / strrchr macros that kick-started the
present discussion
http://lists.gnu.org:443/archive/html/groff/2021-06/msg00101.html

> I wondered what would be actually eligible to end up in the document.
>
> I'm currently keeping examples using native groff syntax but I'm
> hesitant on including personal macro sets posted to the mailing list.

The great thing about volunteering to start a project is you get to
dictate its ground rules. :-)