mike-m
3baf2ffb17
Revert r103213. It broke several sections of live website.
...
llvm-svn: 103219
2010-05-07 00:28:04 +00:00
mike-m
6b8861e9f6
Overhauled llvm/clang docs builds. Closes PR6613.
...
NOTE: 2nd part changeset for cfe trunk to follow.
*** PRE-PATCH ISSUES ADDRESSED
- clang api docs fail build from objdir
- clang/llvm api docs collide in install PREFIX/
- clang/llvm main docs collide in install
- clang/llvm main docs have full of hard coded destination
assumptions and make use of absolute root in static html files;
namely CommandGuide tools hard codes a website destination
for cross references and some html cross references assume
website root paths
*** IMPROVEMENTS
- bumped Doxygen from 1.4.x -> 1.6.3
- splits llvm/clang docs into 'main' and 'api' (doxygen) build trees
- provide consistent, reliable doc builds for both main+api docs
- support buid vs. install vs. website intentions
- support objdir builds
- document targets with 'make help'
- correct clean and uninstall operations
- use recursive dir delete only where absolutely necessary
- added call function fn.RMRF which safeguards against botched 'rm -rf';
if any target (or any variable is evaluated) which attempts
to remove any dirs which match a hard-coded 'safelist', a verbose
error will be printed and make will error-stop.
llvm-svn: 103213
2010-05-06 23:45:43 +00:00
Dan Gohman
61830209a6
Fix typos in comments.
...
llvm-svn: 97257
2010-02-26 20:18:32 +00:00
Benjamin Kramer
1791be26f8
Documentation: Perform automated correction of common typos.
...
llvm-svn: 83849
2009-10-12 14:46:08 +00:00
Chris Lattner
9abd08f6f9
disuade people from using ostream.
...
llvm-svn: 79866
2009-08-23 21:53:47 +00:00
Chris Lattner
8d7c0ec32a
make owen happy by being explicit.
...
llvm-svn: 78688
2009-08-11 17:38:15 +00:00
Chris Lattner
553acfa328
discourage else after "noreturn" statements.
...
llvm-svn: 77387
2009-07-28 22:54:04 +00:00
Daniel Dunbar
2d76dc5a14
Tweak, raw_ostream is a ostream, not iostream replacement
...
llvm-svn: 77017
2009-07-24 23:54:34 +00:00
Daniel Dunbar
06b94defcb
CodingStandards: Emphasize use of raw_ostream more.
...
- Chris, please approve.
llvm-svn: 77010
2009-07-24 23:04:51 +00:00
Chris Lattner
4cd4c075df
fix some wording problems Daniel pointed out, make a example actually real.
...
llvm-svn: 76751
2009-07-22 16:54:14 +00:00
Chris Lattner
c075ba7f73
fix typo noticed by Duncan
...
llvm-svn: 76747
2009-07-22 16:30:39 +00:00
Chris Lattner
e0b6253737
remove Bill from the author list: his contribution (describing llvm::Ostream
...
and friends) has been removed awhile ago.
llvm-svn: 76724
2009-07-22 05:43:01 +00:00
Chris Lattner
44d0425937
add some more topics to the coding standards doc:
...
* Use Early Exits and 'continue' to Simplify Code
* Turn Predicate Loops into Predicate Functions
* Spaces Before Parentheses
* Namespace Indentation
* Anonymous Namespaces
llvm-svn: 76723
2009-07-22 05:40:54 +00:00
Chris Lattner
3ca9ece03f
be explicit about making comments real sentences.
...
llvm-svn: 75406
2009-07-12 00:10:24 +00:00
Chris Lattner
8cf96dce25
got confused again
...
llvm-svn: 74514
2009-06-30 06:27:54 +00:00
Chris Lattner
14c5ccf843
fix some issues Jeff Yasskin noticed
...
llvm-svn: 74512
2009-06-30 06:20:03 +00:00
Chris Lattner
f6944ea787
add a note about re-evaluating end() every time through a loop.
...
llvm-svn: 74511
2009-06-30 06:13:23 +00:00
Chris Lattner
5e7dd59063
tt'ify.
...
llvm-svn: 67505
2009-03-23 04:53:34 +00:00
Chris Lattner
750312aa5e
VC++ 6.0 is not future work :)
...
Do not recommend llvm::OStream anymore. Use raw_ostream or MemoryBuffer.
llvm-svn: 67504
2009-03-23 04:52:53 +00:00
Misha Brukman
7d77c2fac7
So *this* is where all the trailing whitespace in file header comments come
...
from: copy-pasted straight from the coding standards doc!
Oh, the irony.
llvm-svn: 61586
2009-01-02 16:58:42 +00:00
Misha Brukman
b8ad12675e
* <div align=center> is not valid HTML 4.01 - removed alignment
...
* <sup> cannot appear inside a <pre> - replaced <pre> with <tt> and <br>
* Added standard "Notes" section
* Sprinkled fixed-width <tt> tags in a few places for consistency
llvm-svn: 60889
2008-12-11 19:37:04 +00:00
Misha Brukman
74411f221b
Global replace of yellow W3C "valid HTML/CSS" icons with blue ones.
...
llvm-svn: 60880
2008-12-11 17:34:48 +00:00
Misha Brukman
b800b6704e
s/A Few Coding Standards/LLVM Coding Standards/g
...
llvm-svn: 60859
2008-12-10 23:07:02 +00:00
Nick Lewycky
d1de4fbcf0
Fix spelling mistake.
...
llvm-svn: 60250
2008-11-29 20:13:25 +00:00
Dan Gohman
83971772a6
Fix a few HTML tidiness issues.
...
llvm-svn: 59966
2008-11-24 17:18:39 +00:00
Matthijs Kooijman
a337c8e1a1
Not that using stream headers other than iostream is allowed.
...
llvm-svn: 54209
2008-07-30 12:14:10 +00:00
Chris Lattner
a046dec1c1
clarify :)
...
llvm-svn: 53218
2008-07-08 05:12:37 +00:00
Nick Lewycky
8331fc08d8
Add a standard for control-flow unreachable assertions in functions that return
...
values, so as to avoid warnings on some platforms.
llvm-svn: 51831
2008-05-31 23:54:55 +00:00
Chris Lattner
5c09e20cab
Don't attribute in file headers anymore. See llvmdev for the
...
discussion of this change.
llvm-svn: 45409
2007-12-29 19:56:08 +00:00
Chris Lattner
5f898a044f
Update links.
...
llvm-svn: 43964
2007-11-09 21:49:08 +00:00
Bill Wendling
1b887c2663
Clarify some of the iostreams stuff.
...
llvm-svn: 43766
2007-11-06 09:36:34 +00:00
Bill Wendling
901656a25c
Validation fixes
...
llvm-svn: 42229
2007-09-22 10:03:25 +00:00
Reid Spencer
f9208e46d2
Subversionify the documentation.
...
llvm-svn: 38442
2007-07-09 08:04:31 +00:00
Chris Lattner
3bc1890e47
clarify the 'developed by' line
...
llvm-svn: 34400
2007-02-19 03:33:06 +00:00
Chris Lattner
61a62b514e
fix a grammar ambiguity noticed by Duncan
...
llvm-svn: 34151
2007-02-10 18:35:31 +00:00
Bill Wendling
6568e0fb01
Removed reference to "cnull" because typical users shouldn't need to use
...
it.
llvm-svn: 32869
2007-01-04 08:38:04 +00:00
Bill Wendling
10d7a4b963
Added example of how to code print() methods so that they will disappear
...
from the code if "cnull" is passed into them.
llvm-svn: 32641
2006-12-17 11:40:40 +00:00
Bill Wendling
6cc4dc27b3
Fixed some formatting.
...
llvm-svn: 32392
2006-12-09 01:35:43 +00:00
Bill Wendling
5f6eafe7ca
Another example of using the llvm IO streams.
...
llvm-svn: 32391
2006-12-09 01:27:51 +00:00
Bill Wendling
c9305b7b85
Add documentation for how to use the new LLVM streams.
...
llvm-svn: 32390
2006-12-09 01:20:34 +00:00
Jim Laskey
799d4b373c
Fix a couple typos.
...
llvm-svn: 29416
2006-07-31 20:18:49 +00:00
Chris Lattner
92a0b69813
Add some advice
...
llvm-svn: 29324
2006-07-27 04:24:14 +00:00
Reid Spencer
1667ea03b6
Changes docs for llvm.cs.uiuc.edu -> llvm.org
...
llvm-svn: 26746
2006-03-14 05:39:39 +00:00
Chris Lattner
9d52e29e8f
Add a section about using namespaces.
...
llvm-svn: 25054
2006-01-01 21:59:22 +00:00
Misha Brukman
06697b27de
Documentation which contains smileys won't be taken seriously by some people.
...
llvm-svn: 18474
2004-12-04 00:32:12 +00:00
Misha Brukman
18327f84a5
Use <tt> around "#include" and "std::endl"
...
llvm-svn: 17258
2004-10-26 16:18:43 +00:00
Misha Brukman
f6f69456f2
Use <tt> around header names
...
llvm-svn: 17256
2004-10-26 16:07:46 +00:00
Misha Brukman
3110b23d46
* Fix spelling and grammar errors
...
* Close <p> tags properly
* Break up paragraphs with blank lines, clean up text alignment
* Delete unbalanced "
llvm-svn: 17254
2004-10-26 15:45:13 +00:00
Reid Spencer
0ab7446879
Add a blurb about the use of class vs. struct keyword in class decls.
...
llvm-svn: 16500
2004-09-23 16:03:48 +00:00
Misha Brukman
51c10acf8d
Fix grammar, eliminate double parenthesized sentence fragment.
...
llvm-svn: 15313
2004-07-28 22:37:57 +00:00