Re: A couple of comments on the new docs

2001-09-04 Thread John Levon
On Mon, Sep 03, 2001 at 10:27:25PM -0400, John Weiss wrote: > during kindergarten.) So, "DocStyle" tends towards the shrill, > because the volunteers wouldn't bother to listen to my polite > requests. Sad but true. I don't doubt that was true then, but I don't think we should a priori assume n

Re: A couple of comments on the new docs

2001-09-03 Thread John Weiss
On Mon, Aug 27, 2001 at 02:22:36PM -0700, Mike Ressler wrote: > > > On Fri, Aug 24, 2001 at 10:33:36PM -0400, Larry Kollar wrote: > > > > > - The "put a (tm) after PostScript or we'll get sued" is also, shall > > >we say, shrill. Unless the team has been warned repeatedly, the worst > > > >

Re: A couple of comments on the new docs

2001-08-31 Thread Mike Ressler
On Thu, 30 Aug 2001, Larry Kollar wrote: > > specifically, Chapter 8 (page 95). Is this sort of thing what you had in > > mind? > > Vaguely. But without numbered sections, and the body text shifted to > the right. If I understand it, he's hanging the section numbers into > the left margin. The "m

Re: A couple of comments on the new docs

2001-08-30 Thread Larry Kollar
> Check out the PDF file included with Peter Wilson's (who is my hero with > his "ancient" and "bookhand" fonts) package "memoir" on CTAN, > specifically, Chapter 8 (page 95). Is this sort of thing what you had in > mind? Vaguely. But without numbered sections, and the body text shifted to the r

Re: A couple of comments on the new docs

2001-08-28 Thread Mike Ressler
On Mon, 27 Aug 2001, Larry Kollar wrote: > internal (specification) documents these days. The current style sets > headings in a sans font (like koma-script) and outdents them somewhat > (which seems to be nearly impossible to do automatically using LaTeX, > I've tried although I'm no LaTeXnician)

Re: A couple of comments on the new docs

2001-08-27 Thread Larry Kollar
Mike Ressler wrote: > I haven't toned the Postscript (tm) :-) stuff down yet. I agree it gets a > bit pendantic - maybe I'll poke around on the Web and find out what common > practice is. In the commercial realm, accepted practice is to put the tm or R mark (as appropriate) only after the *first

Re: A couple of comments on the new docs

2001-08-27 Thread Mike Ressler
I must be half asleep ... On Mon, 27 Aug 2001, Mike Ressler wrote: > I haven't toned the Postscript (tm) :-) stuff down yet. I agree it gets a > bit pendantic - maybe I'll poke around on the Web and find out what common ^ pedantic > practice is. Things like The Gimp should ha

Re: A couple of comments on the new docs

2001-08-27 Thread Mike Ressler
On Sat, 25 Aug 2001, John Levon wrote: > On Fri, Aug 24, 2001 at 10:33:36PM -0400, Larry Kollar wrote: > > > - The comment about "'dialog' is a programmer term" is a bit dated. > >Even st00p1d Mac users[1] know what a dialog box is. To me, "popup" > >is a menu or tooltip. (Not that I thi

Re: A couple of comments on the new docs

2001-08-26 Thread John Levon
On Sun, Aug 26, 2001 at 10:27:38PM -0400, Larry Kollar wrote: > That's good to hear. Will it be "dialog box" or simply "dialog," or has > that been resolved yet? just "dialog" I think. Brvty s good ;) I'm not particular though. > The CVS from Thursday evening. ok regards john -- "Premature

Re: A couple of comments on the new docs

2001-08-26 Thread Larry Kollar
John Levon wrote: > > [everyone knows] what a dialog box is. To me, "popup" > > is a menu or tooltip. > > actually, this will get changed. the doc team agreed some time ago to > standardise on "dialog". In other words, I agree completely ;) That's good to hear. Will it be "dialog box" or simp

Re: A couple of comments on the new docs

2001-08-24 Thread John Levon
On Fri, Aug 24, 2001 at 10:33:36PM -0400, Larry Kollar wrote: > - The comment about "'dialog' is a programmer term" is a bit dated. >Even st00p1d Mac users[1] know what a dialog box is. To me, "popup" >is a menu or tooltip. (Not that I think it will get changed, but actually, this will

A couple of comments on the new docs

2001-08-24 Thread Larry Kollar
CVS'ed the docs and started looking through them yesterday. I *love* the quote from "Shoe" to begin with! The kids ran into the computer room, wondering what was so funny -- then they didn't get the joke. (Actually, the joke's on me, using one for a living.) I read through DocStyle, and have tw