]> https://gitweb.dealii.org/ - dealii.git/commitdiff
Properly reference Code Complete.
authorWolfgang Bangerth <bangerth@colostate.edu>
Wed, 9 Sep 2020 21:50:43 +0000 (15:50 -0600)
committerWolfgang Bangerth <bangerth@colostate.edu>
Wed, 9 Sep 2020 21:53:15 +0000 (15:53 -0600)
doc/doxygen/references.bib
examples/step-1/doc/intro.dox
examples/step-26/step-26.cc

index 1955584265fd6808b237130cca587ede68d8c31d..99dd40919496b29063f49081634dddfe85e2103b 100644 (file)
@@ -907,3 +907,12 @@ year = {2008},
   year      = {2001},
   doi       = {10.1023/A:1014268310921}
 }
+
+
+
+@Book{CodeComplete,
+  author =    {Steve McConnell},
+  title =        {Code Complete},
+  publisher =    {Microsoft Press},
+  year =         2004,
+  edition =   {second}}
index 3a78ecedbbe7d7acbf07cc52bd301d1103e338d9..bc704d07a9d4836074dbf869bd2f1ab4a3355cdd 100644 (file)
@@ -188,7 +188,7 @@ are worthwhile browsing through before you start any large-scale programming:
 - You will benefit from becoming a better programmer. An excellent
   resource to this end is the book "<a
   href="https://en.wikipedia.org/wiki/Code_Complete">Code
-  Complete</a>" by Steve McConnell (ISBN 978-0735619678). It's already
+  Complete</a>" by Steve McConnell @code CodeComplete . It's already
   a few years old, with the last edition published in 2004, but it has
   lost none of its appeal as a guide to good programming practices,
   and some of the principal developers use it as a group reading
index df150e3d40f709dd384f431d664362d035429170..2f9e2ed363e4fea95d59e5a2bedfe3afbff4bd1f 100644 (file)
@@ -648,10 +648,10 @@ namespace Step26
 // state that there may be occasions where they can help avoid code
 // duplication and awkward control flow. This may be one of these
 // places, and it matches the position Steve McConnell takes in his
-// excellent book "Code Complete" about good programming practices
-// (see the mention of this book in the introduction of step-1) that
-// spends a surprising ten pages on the question of <code>goto</code>
-// in general.
+// excellent book "Code Complete" @cite CodeComplete about good
+// programming practices (see the mention of this book in the
+// introduction of step-1) that spends a surprising ten pages on the
+// question of <code>goto</code> in general.
 
 
 // @sect3{The <code>main</code> function}

In the beginning the Universe was created. This has made a lot of people very angry and has been widely regarded as a bad move.

Douglas Adams


Typeset in Trocchi and Trocchi Bold Sans Serif.