public inbox for gcc-bugs@sourceware.org
help / color / mirror / Atom feed
* [Bug preprocessor/114082] New: Guidelines for options are empty
@ 2024-02-23 19:30 roland.illig at gmx dot de
2024-02-23 19:50 ` [Bug driver/114082] " roland.illig at gmx dot de
` (3 more replies)
0 siblings, 4 replies; 5+ messages in thread
From: roland.illig at gmx dot de @ 2024-02-23 19:30 UTC (permalink / raw)
To: gcc-bugs
https://gcc.gnu.org/bugzilla/show_bug.cgi?id=114082
Bug ID: 114082
Summary: Guidelines for options are empty
Product: gcc
Version: 14.0
Status: UNCONFIRMED
Keywords: documentation
Severity: normal
Priority: P3
Component: preprocessor
Assignee: unassigned at gcc dot gnu.org
Reporter: roland.illig at gmx dot de
Target Milestone: ---
https://gcc.gnu.org/onlinedocs/gccint/Guidelines-for-Options.html
The section is empty, and it has been so since its creation in 2018.
When I saw that section, I wasn't sure whether this was a technical error on
the web server (unlikely but still possible) or in the .texi processing.
Since the section has been missing since 2018, it may be better to remove it
completely. Or, alternatively, write down the most common consensus, to be
amended later.
^ permalink raw reply [flat|nested] 5+ messages in thread
* [Bug driver/114082] Guidelines for options are empty
2024-02-23 19:30 [Bug preprocessor/114082] New: Guidelines for options are empty roland.illig at gmx dot de
@ 2024-02-23 19:50 ` roland.illig at gmx dot de
2024-02-24 1:56 ` pinskia at gcc dot gnu.org
` (2 subsequent siblings)
3 siblings, 0 replies; 5+ messages in thread
From: roland.illig at gmx dot de @ 2024-02-23 19:50 UTC (permalink / raw)
To: gcc-bugs
https://gcc.gnu.org/bugzilla/show_bug.cgi?id=114082
--- Comment #1 from Roland Illig <roland.illig at gmx dot de> ---
If you decide to keep the guidelines, here are a few ideas:
* Use the simplest English you can, while still being precise.
* Don't try to be funny. (See #114083 for a possible case)
^ permalink raw reply [flat|nested] 5+ messages in thread
* [Bug driver/114082] Guidelines for options are empty
2024-02-23 19:30 [Bug preprocessor/114082] New: Guidelines for options are empty roland.illig at gmx dot de
2024-02-23 19:50 ` [Bug driver/114082] " roland.illig at gmx dot de
@ 2024-02-24 1:56 ` pinskia at gcc dot gnu.org
2024-02-24 1:58 ` pinskia at gcc dot gnu.org
2024-02-26 8:27 ` rguenth at gcc dot gnu.org
3 siblings, 0 replies; 5+ messages in thread
From: pinskia at gcc dot gnu.org @ 2024-02-24 1:56 UTC (permalink / raw)
To: gcc-bugs
https://gcc.gnu.org/bugzilla/show_bug.cgi?id=114082
Andrew Pinski <pinskia at gcc dot gnu.org> changed:
What |Removed |Added
----------------------------------------------------------------------------
Ever confirmed|0 |1
Last reconfirmed| |2024-02-24
Status|UNCONFIRMED |NEW
Keywords| |FIXME
--- Comment #2 from Andrew Pinski <pinskia at gcc dot gnu.org> ---
No it is empty in ux.texi:
```
@node Guidelines for Options
@section Guidelines for Options
@cindex command-line options, guidelines for
@cindex options, guidelines for
@cindex guidelines for options
@c TODO
```
^ permalink raw reply [flat|nested] 5+ messages in thread
* [Bug driver/114082] Guidelines for options are empty
2024-02-23 19:30 [Bug preprocessor/114082] New: Guidelines for options are empty roland.illig at gmx dot de
2024-02-23 19:50 ` [Bug driver/114082] " roland.illig at gmx dot de
2024-02-24 1:56 ` pinskia at gcc dot gnu.org
@ 2024-02-24 1:58 ` pinskia at gcc dot gnu.org
2024-02-26 8:27 ` rguenth at gcc dot gnu.org
3 siblings, 0 replies; 5+ messages in thread
From: pinskia at gcc dot gnu.org @ 2024-02-24 1:58 UTC (permalink / raw)
To: gcc-bugs
https://gcc.gnu.org/bugzilla/show_bug.cgi?id=114082
Andrew Pinski <pinskia at gcc dot gnu.org> changed:
What |Removed |Added
----------------------------------------------------------------------------
CC| |dmalcolm at gcc dot gnu.org,
| |pinskia at gcc dot gnu.org
--- Comment #3 from Andrew Pinski <pinskia at gcc dot gnu.org> ---
It was added in r9-3547-g92646d25778952 .
^ permalink raw reply [flat|nested] 5+ messages in thread
* [Bug driver/114082] Guidelines for options are empty
2024-02-23 19:30 [Bug preprocessor/114082] New: Guidelines for options are empty roland.illig at gmx dot de
` (2 preceding siblings ...)
2024-02-24 1:58 ` pinskia at gcc dot gnu.org
@ 2024-02-26 8:27 ` rguenth at gcc dot gnu.org
3 siblings, 0 replies; 5+ messages in thread
From: rguenth at gcc dot gnu.org @ 2024-02-26 8:27 UTC (permalink / raw)
To: gcc-bugs
https://gcc.gnu.org/bugzilla/show_bug.cgi?id=114082
--- Comment #4 from Richard Biener <rguenth at gcc dot gnu.org> ---
Can we simply comment the entire section?
^ permalink raw reply [flat|nested] 5+ messages in thread
end of thread, other threads:[~2024-02-26 8:27 UTC | newest]
Thread overview: 5+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2024-02-23 19:30 [Bug preprocessor/114082] New: Guidelines for options are empty roland.illig at gmx dot de
2024-02-23 19:50 ` [Bug driver/114082] " roland.illig at gmx dot de
2024-02-24 1:56 ` pinskia at gcc dot gnu.org
2024-02-24 1:58 ` pinskia at gcc dot gnu.org
2024-02-26 8:27 ` rguenth at gcc dot gnu.org
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).