This is the mail archive of the
gcc-patches@gcc.gnu.org
mailing list for the GCC project.
PATCH: faq.html, bugs.html
- To: <gcc-patches at gcc dot gnu dot org>
- Subject: PATCH: faq.html, bugs.html
- From: Rich Churcher <churcher at ihug dot com dot au>
- Date: 06 Jul 2001 02:15:44 +1000
- Cc: Gerald Pfeifer <pfeifer at dbai dot tuwien dot ac dot at>
- References: <Pine.BSF.4.33.0107050959160.93618-100000@taygeta.dbai.tuwien.ac.at>
Gerald Pfeifer <pfeifer@dbai.tuwien.ac.at> writes:
> On Thu, 5 Jul 2001 churcher@ihug.com.au wrote:
> > 1. Would you like all three of the other questions in the "bugs and
> > non-bugs" section moved out of the FAQ and into bugs.html?
>
> Glad you're asking. :-) Yes.
>
> > 2. In bugs.html I find the use of the definition list (<dl>) to be rather
> > difficult to read. May I suggest the following:
>
> You mean, formatting the HTML source differently? Personally, I find it
> easier to read what we currently have, but for example you could add some
> comment
>
> <!-- ----...---- ->
>
> before every <h3> in that document.
No, I mean making the output clearer. I was just thinking of adding
some whitespace and emphasising the points a bit, but really it's so
trivial I wouldn't even mention it if I weren't patching the file
already. If you don't like the way it looks, don't worry - just ask me
to resubmit without the format changes. Content Is King ;o)
The file is getting rather large. I've found it difficult to separate
the patches I was going to submit. Accordingly, I've submitted one
large patch which adds the FAQ questions, expands the "export" item,
and adds extended TOC links. Please feel free to ask me to resubmit if
you're not happy with the way it looks. I just couldn't find an easy
way to separate the changes out.
> > 3. Still looking at bugs.html, it's quite a long page. I suggest we
> > provide a more detailed contents at the top, listing more of the
> > subsections. Any objections to this?
>
> Agreed. Certainly no objections.
>
> I'm waiting for the patches... :-)
Here they are:
[bugs-patch]
2001-07-05 Rich Churcher <churcher@ihug.com.au>
* Add paragraph on lack of export keyword.
* Markup changes to make reading definition lists slightly easier.
* Add table of contents entries.
* Transplant FAQ questions into Non-bugs section.
* Created a "C" section to accomodate some FAQ questions.
[faq-patch]
2001-07-05 Rich Churcher <churcher@ihug.com.au>
* Remove "Bugs and Non-bugs" section - now in bugs.html
Oh, BTW - do you prefer to be Cc'd when the message contains
attachments, or not?
--
Cheers,
Rich.
bugs-patch.bz2
faq-patch.bz2