diff --git a/doc/sgpem2dman.texi b/doc/sgpem2dman.texi index 7127233..0f4185a 100644 --- a/doc/sgpem2dman.texi +++ b/doc/sgpem2dman.texi @@ -96,6 +96,10 @@ Free Documentation License''. @table @strong +@item 2006, January 27th, @r{--- Luca Vezzaro} +Added point on initialization lists and C-style +comments. + @item 2006, January 26th, @r{--- Matteo Settenvini} Added reference subsection about documenting code. Added decisional and communicative norms. @@ -580,6 +584,16 @@ You can also add to the end of your @file{~/.emacs} the line: to automatically associate the @samp{.tcc} extension to the @samp{c++-mode}. +@item +Constructor initialization list use the following format: +@verbatim +C::C(T1 arg1, T2 arg2, ...) : + m1(arg1), m2(arg2)... +{ + //... +} +@end verbatim + @end enumerate @c % -------------------------------------------------- @@ -780,6 +794,16 @@ often as possible, to ensure Unicode support. If you need a smart pointer, be sure to check out @code{glib::RefPtr<>}. +@item +"C-style" comments are useful but are also problematic when you +need a fast way to exclude code from execution. Since this +kind of comments cannot nest, C-style comments cannot be +used to exclude code already commented with these old-way +comments. For this reason there is no need to complicate our +lifes with two styles of comments, the C++ comment (//) is +more than enough, and typing isn't a problem since most editors +support batch-commenting for multiple lines of code. + @end enumerate