Re: Groff examples repository
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
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
> > 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
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
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? > > 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
Re: Groff examples repository
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
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
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
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
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
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
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
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
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
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
Groff examples repository
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
Re: groff-examples repository
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
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
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
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
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
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
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. :-)
groff-examples repository
Dave Kemper wrote: > These would be great candidates for the groff-examples repository that > I keep trying to trick someone into creating and maintaining > (http://lists.gnu.org/archive/html/groff/2021-05/msg00059.html). So > far no one has fallen for it. I'm skimming through the archives to try to create such a document -- it is taking a lot of time since it goes back to 1999 and many of the examples have been rendered obsolete by the growth of groff -- and 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. Should they be part of MORE.STUFF? Although I don't see any macro packages being listed there so maybe not? Wim Stockman wrote: > I see the troff.org domain name is well a goed candidate to host something > like that. Maybe it would also nice to make it Lo Fi in a gopher format and > Gemini capsule ? > I don't know who maintainers are of the troff.org domain. Maybe we could > ask them to collaborate. I'm currently writing the document in gemini markup and will then use a tool to translate it to html. I cannot speak for the owners of troff.org but I can host the final document on the web and on geminispace myself if need be. I do not have much knowledge of gopher though. Thomas