--- psiconv/trunk/lib/psiconv/data.h	2004/01/26 12:59:54	188
+++ psiconv/trunk/lib/psiconv/data.h	2004/03/04 21:55:40	239
@@ -1,6 +1,6 @@
 /*
     data.h - Part of psiconv, a PSION 5 file formats converter
-    Copyright (c) 1999, 2000  Frodo Looijaard <frodol@dds.nl>       
+    Copyright (c) 1999-2004  Frodo Looijaard <frodol@dds.nl>       
 
     This program is free software; you can redistribute it and/or modify
     it under the terms of the GNU General Public License as published by
@@ -183,10 +183,23 @@
 } *psiconv_border;
 
 /* Complete bullet information.
-   If indent if off, the bullet is at the first line indentation level,
-   and the line text begins right after it. If it is on, the bullet is at 
-   the minimum of the first line and left indentation, and the text starts
-   at the maximum of both. */
+   The interaction of left and first line indentation and bullets is quite 
+   complicated.
+
+   BULLET       FIRST  BULLET      FIRST LINE             NEXT LINES
+
+   None         = 0    -           Left+First             Left
+                > 0    -           Left+First             Left
+                < 0    -           Left+First             Left
+
+   Indent Off   = 0    Left        Left(+Bullet)          Left
+                > 0    Left        Left+First             Left
+		< 0    Left+First  Left+First(+Bullet)    Left
+
+   Indent On    = 0    Left        Left(+Bullet)          Left
+                > 0    Left        Left+First             Left+First
+		< 0    Left+First  Left                   Left
+*/
 typedef struct psiconv_bullet_s
 {
   psiconv_bool_t on;           /* Whether the bullet is shown */
@@ -476,7 +489,8 @@
 /* A Word Style.
    All information about a single Style.
    A builtin style may not be changed in the Word program.
-   Outline level is zero if unused. */
+   Outline level is zero if unused. 
+   The name may be NULL for the normal style! */
 typedef struct psiconv_word_style_s
 {
   psiconv_character_layout character; /* character-level layout */
@@ -492,7 +506,8 @@
                                          /* Of struct psiconv_word_style_s */
 
 /* A Word Styles Section
-   All information about styles. */
+   All information about styles. 
+   Note that the name of the normal style is NULL! */
 typedef struct psiconv_word_styles_section_s
 {
   psiconv_word_style normal;      /* The normal (unspecified) style */