Groups | Search | Server Info | Keyboard shortcuts | Login | Register [http] [https] [nntp] [nntps]

Groups > gnu.groff.bug > #1889

[bug #58653] Please add back in the mdoc(7) manual

Show key headers only | View raw

Follow-up Comment #8, bug #58653 (project groff):

I'm not an mdoc user, so have no position on the specifics of its
documentation.  But I have to agree with this point:

[comment #4 comment #4:]
> [comment #3 comment #3:]
> > When learning a completely new language totally from scratch, i typically
go for the formal standard / formal language definition
> 
> May I suggest that, perhaps, you are a bit of an exception?

Ingo's approach is admirable but I don't think it's the norm, certainly not
for me and others I've worked with.

In general I think it behooves experienced users to listen to new users when
they say what has helped them get a handle on learning something.  Hackerb9,
as someone who has just gone through that initial learning curve, is in a
unique position to say what has been most useful.  There may be fatal flaws in
the particular mdoc(7) page he consulted, but what aspects of it were helpful,
and how can those be worked into something that's useful to beginners without
oversimplifying to the point of inaccuracy?

It's not like the groff package is any stranger to overlapping documentation,
having the Texinfo package for complete documentation for the core language,
and the groff(7) man page as a terse reference guide.

    _______________________________________________________

Reply to this item at:

  <https://savannah.gnu.org/bugs/?58653>

_______________________________________________
  Message sent via Savannah
  https://savannah.gnu.org/

Back to gnu.groff.bug | Previous | Next | Find similar

Thread

[bug #58653] Please add back in the mdoc(7) manual Dave <INVALID.NOREPLY@gnu.org> - 2020-06-27 21:55 -0400

csiph-web