On Fri, Sep 4, 2020 at 11:32 AM Hu, Jiangping <hujiangp...@cn.fujitsu.com> wrote: > > > I think the pages under gcc.gnu.org/projects/ are all hopelessly > > out-of-date and more recent (but still usually out-of-date) info > > is found on the wiki. > > > > So I'm not sure these kind of changes make sense. > > > > Eventually we should remove those pages? Or do we want > > to keep them for historical purposes (and edit them to reflect > > that purpose)? > > > Thanks for reply! > > Yes. This is indeed a question. We cannot ensure that anyone who > modifies the code can fully update the relevant documentation. > After a long time, the documentation may contain errors. > It is also not realistic to confirm those outdated documents > in detail and correct all the errors. > > On the other hand, for me, sometimes even if I know that a > document is out of date, I still read it because I think there > may be some useful information in it. In this case, if I am > troubled by an error in the document, I will want to modify it > to prevent others who have the same idea as me from being > troubled. > > In addition to deleting outdated documents, I don't know if > there is any other better way. Or, everyone should reach a > consensus not to read outdated documents.
Having three places with "documentation", the internals manual, the wiki and these web-pages doesn't help either. To me the only place to put documentation is the internals manual (and the source, of course). The wiki is good for project docs & status. The webpages are all from times we've had no wiki. Richard. > Regards! > Hujp > > > > Regards! > > > Hujp > > > > > > --- > > > htdocs/projects/tree-ssa/vectorization.html | 8 +++++++- > > > 1 file changed, 7 insertions(+), 1 deletion(-) > > > > > > diff --git a/htdocs/projects/tree-ssa/vectorization.html > > b/htdocs/projects/tree-ssa/vectorization.html > > > index 22d136c0..ab07eb28 100644 > > > --- a/htdocs/projects/tree-ssa/vectorization.html > > > +++ b/htdocs/projects/tree-ssa/vectorization.html > > > @@ -13,7 +13,13 @@ > > > <p>The goal of this project was to develop a loop and basic block > > > vectorizer in GCC, based on the <a href="./">tree-ssa</a> framework. > > > It has been completed and the functionality has been part of GCC > > > - for years.</p> > > > + for years. > > > + > > > + (Note: The <code>-ftree-vectorizer-verbose</code> flag below is now > > > + deprecated. New flag <code>-fopt-info</code> see <a href= > > > + "https://gcc.gnu.org/onlinedocs/gcc/Developer- > > Options.html#index-fopt-info"> > > > + https://gcc.gnu.org/onlinedocs/gcc/Developer-Options.html#index- > > fopt-info</a>) > > > + </p> > > > > > > <h2>Table of Contents</h2> > > > > > > -- > > > 2.17.1 > > > > > > > > > > > > > >
