[ruby-talk:01371] Re: MOre FAQ stuff

From: Dave Thomas <[e-mail]>
> Sorry to spam the list with all this FAQ stuff, but...

"Please sir, just stick to the FAQs. It's up to the judge to decide if it's
spam."

And while we're on the subject of apologies, let me express my deep sorrow
for expressing Ruby's elegant and simple syntax as:

    Ruby = Reifies unsurpassable baby yacc.

(Blame Armin S. A. Roehrl's note for inspiring that one.)

Anyway, back to work.

First a question that I'm reluctant to ask after all you have done so far,
but in the name of even more user friendliness, here goes: Is there some
reasonably easy way to generate the single big html file with the same table
of contents that the online html file has?


Anyway, the current FAQ looks GREAT overall (although I'm still going
through it).

Thanks for the excellent job.

RRRRRR!!!,
Conrad

(Ruby Rocks!, Ruby Rolls!, Ruby Rules!)

===================

I don't know if you want to bother with these things in the future (or I can
mail direct to you if no one else on the mail list is likely to check for or
notice such things) but for this time, some items I noticed are mentioned
below.

Format:
    section number,
    original line,
    suggested change.

1.1

Ruby is a simple and powerful object-oriented scripting language
Ruby is a simple and powerful object-oriented programming language

1.5

Precompiled Cygwin and djgpp binaries

<<I know what Cygwin refers to, but not djgpp. Many other readers may not
know either. (Pun was accidental.) Recommend brief explanation.>>

1.10

It is useful to understand Ruby regular expressions.
It is useful for understanding Ruby regular expressions.

1.11

it is good Netiquette to
it is good netiquette to

2.2

    for i in 1..3 do
        Thread.pass
        a += i
        print localName, ": ", a, "\n"
      end

<<"end" needs outdent>>

6.4

<<Long comment needs to be split for printing.>>

7.20

What is the difference between ".." and "...?"
What is the difference between ".." and "..."?

8.5

Your Tk version may be old, try a newer version.

<<I struggled with this one. In my case, my version was *too new* (Matz
fixed problem) and was installed in non-standard location (to facilitate NFS
mounting of various tools, including Ruby). If the make/build stuff can't
find your various X and Tcl and Tk include and lib files in
"expected/standard locations", it will not build the needed stuff, and it
does not explicitly tell you, although you can spot the missing compile
message in the output from make if you know what to look for. Also if you
are trying to run rolodex-j or widget on a "non-Japanese" machine, they will
just hang up and do nothing. (This will be the subject of another
forthcoming post/thread.)>>

\d.\d+

<<I also noticed that "..." occurred in both compressed and ventelated
forms, in both text and examples.>>

\d.\d+

<<Double quotes seem to angle every which way.>>