Remove commented asterisks

There were tons of them. Why?
This commit is contained in:
Gergely Polonkai 2014-07-24 00:00:15 +02:00
parent 0bc893bff2
commit f9c50818c0

View File

@ -45,8 +45,6 @@
<toc/>
<!-- ***************************************************************** -->
<chapter id="ch-TreeView">
<title>Lists and Trees: the GtkTreeView Widget</title>
@ -212,20 +210,6 @@ main (int argc, char **argv)
</sect1>
</chapter>
<!-- ************************************************************** -->
<!-- ************************************************************** -->
<!-- ************************************************************** -->
<!-- ************************************************************** -->
<!-- ************************************************************** -->
<!-- ************************************************************** -->
<!-- ************************************************************** -->
<chapter id="sec-treeview-components">
<title>Components: Model, Renderer, Column, View</title>
@ -270,20 +254,6 @@ main (int argc, char **argv)
<literal>GtkHBox</literal>.</para>
</chapter>
<!-- ************************************************************** -->
<!-- ************************************************************** -->
<!-- ************************************************************** -->
<!-- ************************************************************** -->
<!-- ************************************************************** -->
<!-- ************************************************************** -->
<!-- ************************************************************** -->
<chapter id="sec-treemodels">
<title>GtkTreeModels for Data Storage: GtkListStore and
GtkTreeStore</title>
@ -345,8 +315,6 @@ main (int argc, char **argv)
rows, the model will also notify the store, and your row will appear in or
disappear from the view as well.</para>
<!-- ************************************************************** -->
<sect1 id="sec-treemodel-data">
<title>How Data is Organised in a Store</title>
@ -443,8 +411,6 @@ main (int argc, char **argv)
row.</para>
</sect1>
<!-- ************************************************************** -->
<sect1 id="sec-treemodel-rowref">
<title>Refering to Rows: GtkTreeIter, GtkTreePath,
GtkTreeRowReference</title>
@ -858,13 +824,9 @@ onTreeViewRowActivated (GtkTreeView *view, GtkTreePath *path,
</sect2>
</sect1>
<!-- ************************************************************** -->
<sect1 id="sec-treemodel-add-rows">
<title>Adding Rows to a Store</title>
<!-- ************************************************************** -->
<sect2 id="sec-liststore-add-rows">
<title>Adding Rows to a List Store</title>
@ -902,8 +864,6 @@ onTreeViewRowActivated (GtkTreeView *view, GtkTreePath *path,
data to the rows in the next section.</para>
</sect2>
<!-- ************************************************************** -->
<sect2 id="sec-treestore-add-rows">
<title>Adding Rows to a Tree Store</title>
@ -954,8 +914,6 @@ onTreeViewRowActivated (GtkTreeView *view, GtkTreePath *path,
</programlisting>
</sect2>
<!-- ************************************************************** -->
<sect2 id="sec-treestore-adding-many-rows">
<title>Speed Issues when Adding a Lot of Rows</title>
@ -1005,8 +963,6 @@ onTreeViewRowActivated (GtkTreeView *view, GtkTreePath *path,
</sect2>
</sect1>
<!-- ************************************************************** -->
<sect1 id="sec-treemodel-data-manipulation">
<title>Manipulating Row Data</title>
@ -1092,8 +1048,6 @@ onTreeViewRowActivated (GtkTreeView *view, GtkTreePath *path,
of data to be stored (and retrieved).</para>
</sect1>
<!-- ************************************************************** -->
<sect1 id="sec-treemodel-data-retrieval">
<title>Retrieving Row Data</title>
@ -1275,8 +1229,6 @@ onTreeViewRowActivated (GtkTreeView *view, GtkTreePath *path,
</sect2>
</sect1>
<!-- ************************************************************** -->
<sect1 id="sec-treemodel-remove-row">
<title>Removing Rows</title>
@ -1394,8 +1346,6 @@ onTreeViewRowActivated (GtkTreeView *view, GtkTreePath *path,
</programlisting>
</sect1>
<!-- ************************************************************** -->
<sect1 id="sec-treemodel-remove-many-rows">
<title>Removing Multiple Rows</title>
@ -1506,8 +1456,6 @@ onTreeViewRowActivated (GtkTreeView *view, GtkTreePath *path,
want to remove all rows.</para>
</sect1>
<!-- ************************************************************** -->
<sect1 id="sec-treemodel-storing-gobjects">
<title>Storing GObjects (Pixbufs etc.)</title>
@ -1569,8 +1517,6 @@ onTreeViewRowActivated (GtkTreeView *view, GtkTreePath *path,
<literal>GtkTreeView</literal> widget.</para>
</sect1>
<!-- ************************************************************** -->
<sect1 id="sec-treemodel-storing-structs">
<title>Storing Data Structures: of Pointers, GBoxed Types, and GObject
(TODO)</title>
@ -1852,20 +1798,6 @@ yourself. Some code snippets:
</sect1>
</chapter>
<!-- ************************************************************** -->
<!-- ************************************************************** -->
<!-- ************************************************************** -->
<!-- ************************************************************** -->
<!-- ************************************************************** -->
<!-- ************************************************************** -->
<!-- ************************************************************** -->
<chapter id="sec-treeview">
<title>Creating a Tree View</title>
@ -1881,8 +1813,6 @@ yourself. Some code snippets:
view = gtk_tree_view_new();
</programlisting>
<!-- ************************************************************** -->
<sect1 id="sec-treeview-connect-model">
<title>Connecting Tree View and Model</title>
@ -1905,8 +1835,6 @@ yourself. Some code snippets:
(after all, we do not want to go down the road of global variables,
which will inevitably lead to the Dark Side, do we?).</para>
<!-- ************************************************************** -->
<sect2 id="sec-treeview-connect-model-refcounting">
<title>Reference counting</title>
@ -1956,8 +1884,6 @@ yourself. Some code snippets:
</sect2>
</sect1>
<!-- ************************************************************** -->
<sect1 id="sec-treeview-look">
<title>Tree View Look and Feel</title>
@ -1996,20 +1922,6 @@ yourself. Some code snippets:
</sect1>
</chapter>
<!-- ************************************************************** -->
<!-- ************************************************************** -->
<!-- ************************************************************** -->
<!-- ************************************************************** -->
<!-- ************************************************************** -->
<!-- ************************************************************** -->
<!-- ************************************************************** -->
<chapter id="sec-treeviewcol-renderer">
<title>Mapping Data to the Screen: GtkTreeViewColumn and
GtkCellRenderer</title>
@ -2049,8 +1961,6 @@ yourself. Some code snippets:
'Representative' column only contains one cell renderer to display the
representative's name.</para>
<!-- ************************************************************** -->
<sect1 id="sec-renderer">
<title>Cell Renderers</title>
@ -2331,8 +2241,6 @@ main (int argc, char **argv)
functions</link>.</para>
</sect1>
<!-- ************************************************************** -->
<sect1 id="sec-treeview-col-attributes">
<title>Attributes</title>
@ -2426,8 +2334,6 @@ main (int argc, char **argv)
set up cell data functions.</para>
</sect1>
<!-- ************************************************************** -->
<sect1 id="sec-treeview-col-celldatafunc">
<title>Cell Data Functions</title>
@ -2527,8 +2433,6 @@ main (int argc, char **argv)
same height, there should not be any visible delay though).</para>
</sect1>
<!-- ************************************************************** -->
<sect1 id="sec-treeview-celltext-types">
<title>GtkCellRendererText and Integer, Boolean and Float Types</title>
@ -2594,8 +2498,6 @@ main (int argc, char **argv)
function</link>.</para>
</sect1>
<!-- ************************************************************** -->
<sect1 id="sec-treeview-col-utf8-pango">
<title>GtkCellRendererText, UTF8, and pango markup</title>
@ -2725,8 +2627,6 @@ main (int argc, char **argv)
escaped, even if you do not use pango markup in the text.</para>
</sect1>
<!-- ************************************************************** -->
<sect1 id="sec-treeview-col-example">
<title>A Working Example</title>
@ -2928,8 +2828,6 @@ main (int argc, char **argv)
</programlisting>
</sect1>
<!-- ************************************************************** -->
<sect1 id="sec-treeview-col-whole-row">
<title>How to Make a Whole Row Bold or Coloured</title>
@ -2980,8 +2878,6 @@ main (int argc, char **argv)
favorite shade of orange.</quote></para>
</sect1>
<!-- ************************************************************** -->
<sect1 id="sec-treeview-col-pixbufs">
<title>How to Pack Icons into the Tree View</title>
@ -3077,25 +2973,9 @@ main (int argc, char **argv)
</sect1>
</chapter>
<!-- ************************************************************** -->
<!-- ************************************************************** -->
<!-- ************************************************************** -->
<!-- ************************************************************** -->
<!-- ************************************************************** -->
<!-- ************************************************************** -->
<!-- ************************************************************** -->
<chapter id="sec-sel-click-menus">
<title>Selections, Double-Clicks and Context Menus</title>
<!-- ************************************************************** -->
<sect1 id="sec-selections">
<title>Handling Selections</title>
@ -3128,8 +3008,6 @@ main (int argc, char **argv)
selected or not (which you need to do if you want all rows that are
<emphasis>not</emphasis> selected for example).</para>
<!-- ************************************************************** -->
<sect2 id="sec-selections-modes">
<title>Selection Modes</title>
@ -3160,8 +3038,6 @@ main (int argc, char **argv)
</itemizedlist>
</sect2>
<!-- ************************************************************** -->
<sect2 id="sec-selections-current">
<title>Getting the Currently Selected Rows</title>
@ -3282,8 +3158,6 @@ main (int argc, char **argv)
</programlisting>
</sect2>
<!-- ************************************************************** -->
<sect2 id="sec-selections-function">
<title>Using Selection Functions</title>
@ -3391,8 +3265,6 @@ main (int argc, char **argv)
</programlisting>
</sect2>
<!-- ************************************************************** -->
<sect2 id="sec-selections-check-row">
<title>Checking Whether a Row is Selected</title>
@ -3409,8 +3281,6 @@ main (int argc, char **argv)
not.</para>
</sect2>
<!-- ************************************************************** -->
<sect2 id="sec-selections-selecting-rows">
<title>Selecting and Unselecting Rows</title>
@ -3430,8 +3300,6 @@ main (int argc, char **argv)
ever need to do that.</para>
</sect2>
<!-- ************************************************************** -->
<sect2 id="sec-selections-row-count">
<title>Getting the Number of Selected Rows</title>
@ -3480,8 +3348,6 @@ main (int argc, char **argv)
</sect2>
</sect1>
<!-- ************************************************************** -->
<sect1 id="sec-selections-double-click">
<title>Double-Clicks on a Row</title>
@ -3534,8 +3400,6 @@ main (int argc, char **argv)
</programlisting>
</sect1>
<!-- ************************************************************** -->
<sect1 id="sec-selections-context-menus">
<title>Context Menus on Right Click</title>
@ -3668,20 +3532,6 @@ main (int argc, char **argv)
</sect1>
</chapter>
<!-- ************************************************************** -->
<!-- ************************************************************** -->
<!-- ************************************************************** -->
<!-- ************************************************************** -->
<!-- ************************************************************** -->
<!-- ************************************************************** -->
<!-- ************************************************************** -->
<chapter id="sec-sorting">
<title>Sorting</title>
@ -3719,8 +3569,6 @@ main (int argc, char **argv)
model that maps the unsorted rows of a child model (e.g. a list store or
tree store) into a sorted state without changing the child model.</para>
<!-- ************************************************************** -->
<sect1 id="sec-sorting-tree-sortable">
<title>GtkTreeSortable</title>
@ -3894,8 +3742,6 @@ main (int argc, char **argv)
(otherwise bad things will happen).</para>
</sect1>
<!-- ************************************************************** -->
<sect1 id="sec-sorting-model-sort">
<title>GtkTreeModelSort</title>
@ -3976,8 +3822,6 @@ main (int argc, char **argv)
you call tree view functions.</para>
</sect1>
<!-- ************************************************************** -->
<sect1 id="sec-sorting-view-cols">
<title>Sorting and Tree View Column Headers</title>
@ -4000,8 +3844,6 @@ main (int argc, char **argv)
column ID and sort order for you if you click on a column header.</para>
</sect1>
<!-- ************************************************************** -->
<sect1 id="sec-sorting-string-nocase">
<title>Case-insensitive String Comparing</title>
@ -4053,20 +3895,6 @@ main (int argc, char **argv)
</sect1>
</chapter>
<!-- ************************************************************** -->
<!-- ************************************************************** -->
<!-- ************************************************************** -->
<!-- ************************************************************** -->
<!-- ************************************************************** -->
<!-- ************************************************************** -->
<!-- ************************************************************** -->
<chapter id="sec-editable-cells">
<title>Editable Cells</title>
@ -4275,20 +4103,6 @@ void cell_toggled_callback (GtkCellRendererToggle *cell,
</sect1>
</chapter>
<!-- ************************************************************** -->
<!-- ************************************************************** -->
<!-- ************************************************************** -->
<!-- ************************************************************** -->
<!-- ************************************************************** -->
<!-- ************************************************************** -->
<!-- ************************************************************** -->
<chapter id="sec-misc">
<title>Miscellaneous</title>
@ -4538,8 +4352,6 @@ onButtonPress (GtkWidget *view, GdkEventButton *bevent, gpointer data)
</programlisting>
</sect1>
<!-- ************************************************************** -->
<sect1 id="sec-misc-glade">
<title>Glade and Tree Views</title>
@ -4572,20 +4384,6 @@ onButtonPress (GtkWidget *view, GdkEventButton *bevent, gpointer data)
</sect1>
</chapter>
<!-- ************************************************************** -->
<!-- ************************************************************** -->
<!-- ************************************************************** -->
<!-- ************************************************************** -->
<!-- ************************************************************** -->
<!-- ************************************************************** -->
<!-- ************************************************************** -->
<chapter id="sec-dnd">
<title>Drag'n'Drop (DnD) **** needs revision ***</title>
@ -4607,8 +4405,6 @@ onButtonPress (GtkWidget *view, GdkEventButton *bevent, gpointer data)
tree view widget. You usually want to use the tree-view specific
Drag-and-Drop framework.</para>
<!-- ************************************************************** -->
<sect1 id="sec-dnd-selected-item-info">
<title>Drag'n'Dropping Row-Unrelated Data to and from a Tree View from
other Windows or Widgets</title>
@ -4815,8 +4611,6 @@ view_onDragMotion (GtkWidget *widget, GdkDragContext *context, gint x,
<literal>gtk_tree_view_get_path_at_pos</literal></ulink>.</para>
</sect1>
<!-- ************************************************************** -->
<sect1 id="sec-dnd-rows-within-tree">
<title>Dragging Rows Around Within a Tree **** TODO ***</title>
@ -4836,8 +4630,6 @@ view_onDragMotion (GtkWidget *widget, GdkDragContext *context, gint x,
place the row to move exact to the pixel on the target row).</para>
</sect1>
<!-- ************************************************************** -->
<sect1 id="sec-dnd-rows-between-trees">
<title>Dragging Rows from One Tree to Another **** TODO ***</title>
@ -4845,25 +4637,9 @@ view_onDragMotion (GtkWidget *widget, GdkDragContext *context, gint x,
</sect1>
</chapter>
<!-- ************************************************************** -->
<!-- ************************************************************** -->
<!-- ************************************************************** -->
<!-- ************************************************************** -->
<!-- ************************************************************** -->
<!-- ************************************************************** -->
<!-- ************************************************************** -->
<chapter id="sec-custom-models">
<title>Writing Custom Models</title>
<!-- ************************************************************** -->
<sect1 id="sec-custom-models-when">
<title>When is a Custom Model Useful?</title>
@ -4905,8 +4681,6 @@ view_onDragMotion (GtkWidget *widget, GdkDragContext *context, gint x,
keep track of.</para>
</sect1>
<!-- ************************************************************** -->
<sect1 id="sec-custom-models-what">
<title>What Does Writing a Custom Model Involve?</title>
@ -4996,8 +4770,6 @@ view_onDragMotion (GtkWidget *widget, GdkDragContext *context, gint x,
attributes).</para>
</sect1>
<!-- ************************************************************** -->
<sect1 id="sec-custom-model-list">
<title>Example: A Simple Custom List Model</title>
@ -5073,8 +4845,6 @@ view_onDragMotion (GtkWidget *widget, GdkDragContext *context, gint x,
<para>Let's look at the code sections in a bit more detail:</para>
<!-- ************************************************************** -->
<sect2 id="sec-custom-model-list-header">
<title>custom-list.h</title>
@ -5101,8 +4871,6 @@ view_onDragMotion (GtkWidget *widget, GdkDragContext *context, gint x,
as you extend it to suit your needs.</para>
</sect2>
<!-- ************************************************************** -->
<sect2 id="sec-custom-model-list-body">
<title>custom-list.c</title>
@ -5347,8 +5115,6 @@ custom_list_tree_model_init (GtkTreeModelIface *iface)
</sect2>
</sect1>
<!-- ************************************************************** -->
<sect1 id="sec-custom-model-tree">
<title>From a List to a Tree</title>
@ -5365,8 +5131,6 @@ custom_list_tree_model_init (GtkTreeModelIface *iface)
<para>TODO: do we need anything else here?</para>
</sect1>
<!-- ************************************************************** -->
<sect1 id="sec-custom-model-sorting">
<title>Additional interfaces, here: the GtkTreeSortable
interface</title>
@ -5783,8 +5547,6 @@ custom_list_tree_model_init (GtkTreeModelIface *iface)
when sorting by name.</para>
</sect1>
<!-- ************************************************************** -->
<sect1 id="sec-custom-model-code">
<title>Working Example: Custom List Model Source Code</title>
@ -5813,8 +5575,6 @@ custom_list_tree_model_init (GtkTreeModelIface *iface)
</listitem>
</itemizedlist>
<!-- ************************************************************** -->
<sect2 id="sec-custom-model-code-header">
<title>custom-list.h</title>
@ -5929,8 +5689,6 @@ void custom_list_append_record (CustomList *custom_list,
</itemizedlist>
</sect2>
<!-- ************************************************************** -->
<sect2 id="sec-custom-model-code-body">
<title>custom-list.c</title>
@ -6609,8 +6367,6 @@ custom_list_append_record (CustomList *custom_list,
</itemizedlist>
</sect2>
<!-- ************************************************************** -->
<sect2 id="sec-custom-model-code-example">
<title>main.c</title>
@ -6706,20 +6462,6 @@ main (int argc, char **argv)
</sect1>
</chapter>
<!-- ************************************************************** -->
<!-- ************************************************************** -->
<!-- ************************************************************** -->
<!-- ************************************************************** -->
<!-- ************************************************************** -->
<!-- ************************************************************** -->
<!-- ************************************************************** -->
<chapter id="sec-custom-cell-renderers">
<title>Writing Custom Cell Renderers</title>
@ -7360,20 +7102,6 @@ main (int argc, char **argv)
</sect1>
</chapter>
<!-- ************************************************************** -->
<!-- ************************************************************** -->
<!-- ************************************************************** -->
<!-- ************************************************************** -->
<!-- ************************************************************** -->
<!-- ************************************************************** -->
<!-- ************************************************************** -->
<chapter id="sec-other-info">
<title>Other Resources</title>
@ -7473,20 +7201,6 @@ main (int argc, char **argv)
</itemizedlist>
</chapter>
<!-- ************************************************************** -->
<!-- ************************************************************** -->
<!-- ************************************************************** -->
<!-- ************************************************************** -->
<!-- ************************************************************** -->
<!-- ************************************************************** -->
<!-- ************************************************************** -->
<chapter id="sec-treeviewtut-license">
<title>Copyright, License, Credits, and Revision History</title>