[cfe-dev] decent manual for clang

[Gordon Keiser]

I was strongly considering putting together at least a quick manual for command line flags, optimization levels, and same for passing things into LLVM from the -mllvm option.   Unfortunately tracking down the relationship between one of the undocumented flags in the tablegen and what it eventually causes to happen in the rest of the build process became very complicated very fast, and some of the other flags don't seem to do what their names imply due to language standards being followed by Clang which other compilers might have considered optimizations, particularly the aggressive constant folding and command line options that *seem* related to it not doing what one would expect. 

-Gordon


> -----Original Message-----
> From: cfe-dev-bounces at cs.uiuc.edu [mailto:cfe-dev-bounces at cs.uiuc.edu]
> On Behalf Of Douglas Gregor
> Sent: Wednesday, May 02, 2012 10:07 AM
> To: Li, Samuel
> Cc: cfe-dev at cs.uiuc.edu
> Subject: Re: [cfe-dev] decent manual for clang
> 
> 
> On May 1, 2012, at 11:46 PM, "Li, Samuel" <samuel.li at spx.com> wrote:
> 
> > It's necessary that we have a full edition of Clang manual even if Clang is
> compatible with GCC.
> 
> Yes, we certainly should have a complete Clang manual independent of GCC's
> manual.
> 
> > Do we have one? If not, anybody working on that?
> 
> We do not have such a manual, and I don't know of anyone actively work on
> one.
> 
> 	- Doug
> 
> > -----Original Message-----
> > From: cfe-dev-bounces at cs.uiuc.edu [mailto:cfe-dev-bounces at cs.uiuc.edu]
> On Behalf Of Don Quixote de la Mancha
> > Sent: 2012年5月2日 14:17
> > To: cfe-dev at cs.uiuc.edu
> > Subject: Re: [cfe-dev] decent manual for clang
> >
> > On Tue, May 1, 2012 at 10:43 PM, Ran Regev <Ran.Regev at ecitele.com>
> wrote:
> >> I'm looking for a *full* user manual for clang.
> >> I can find few things under clang --help I can find few more here:
> >> http://clang.llvm.org/docs/UsersManual.html
> >>
> >> But not everything is present.
> >> For instance, the -g, -ggdb and alike are not listed.
> >
> > While not the correct way to address your problem, you're quite likely to
> find what you need to know in the GCC manual, because many of CLang's
> command-line arguments are compatible with GCC.  Also look at GNU's
> manuals for the compilers for the individual programming languages - if you
> use CLang to build C++, then look at the g++ manual, for example, or third-
> party books, online tutorials, HOWTOs and the like for g++.
> >
> > Every software product needs a good manual, but one cannot simply copy
> the GNU manuals into CLangs unless the licenses for both manuals are
> compatible, which they are not likely to be.
> >
> > --
> > Don Quixote de la Mancha
> > Dulcinea Technologies Corporation
> > Software of Elegance and Beauty
> > http://www.dulcineatech.com
> > quixote at dulcineatech.com
> > _______________________________________________
> > cfe-dev mailing list
> > cfe-dev at cs.uiuc.edu
> > http://lists.cs.uiuc.edu/mailman/listinfo/cfe-dev
> >
> >
> > _______________________________________________
> > cfe-dev mailing list
> > cfe-dev at cs.uiuc.edu
> > http://lists.cs.uiuc.edu/mailman/listinfo/cfe-dev
>