some documentation fixes, a pause point

new/design.h

@@ -9,7 +9,7 @@ also, in the future.
 
 @author Dick Hollenbeck <dick@softplc.com>
 
-@date   October-December 2010
+@date   October 2010 - January 2011
 
 @section intr_sec Introduction
 
@@ -370,10 +370,10 @@ class HTTP_LIB_SOURCE : public LIB_SOURCE
 protected:
 
     /**
-     * Constructor ( const STRING& aSvnURL )
-     * sets up a LIB_SOURCE using aSvnURI which points to a subversion
+     * Constructor ( const STRING& aHttpURL )
+     * sets up a LIB_SOURCE using aHttpURI which points to a subversion
      * repository.
-     * @see LIBS::GetLibrary().
+     * @see LIB_TABLE::LookupPart()
      *
      * @param aHttpURL is a full URL of a document root repo directory.  Example might
      *  be "http://kicad.org/libs"
@@ -401,7 +401,7 @@ protected:
      * Constructor SVN_LIB_SOURCE( const STRING& aSvnURL )
      * sets up a LIB_SOURCE using aSvnURI which points to a subversion
      * repository.
-     * @see LIBS::GetLibrary().
+     * @see LIB_TABLE::LookupPart().
      *
      * @param aSvnURL is a full URL of a subversion repo directory.  Example might
      *  be "svn://kicad.org/repos/library/trunk"
@@ -430,7 +430,7 @@ protected:
      * sets up a LIB_SOURCE using aSchematicFile which is a full path and filename
      * for a schematic not related to the schematic being editing in
      * this EESCHEMA session.
-     * @see LIBS::GetLibrary().
+     * @see LIB_TABLE::LookupPart().
      *
      * @param aSchematicFile is a full path and filename.  Example:
      *  "/home/user/kicadproject/design.sch"
@@ -471,4 +471,6 @@ public:
 
 /// @todo add simple unit test infrastructure.
 
+/// @todo review: http://www.sfml-dev.org/tutorials/1.2/graphics-wxwidgets.php
+
 // EOF

new/sch_dir_lib_source.h

@@ -144,7 +144,7 @@ protected:
     /**
      * Constructor DIR_LIB_SOURCE( const STRING& aDirectoryPath )
      * sets up a LIB_SOURCE using aDirectoryPath in a file system.
-     * @see LIBS::GetLibrary().
+     * @see LIB_TABLE::LookupPart().
      *
      * @param aDirectoryPath is a full file pathname of a directory which contains
      *  the library source of part files.  Examples might be "C:\kicad_data\mylib" or

new/sch_lib.cpp

@@ -171,7 +171,7 @@ const PART* LIB::lookupPart( const LPID& aLPID ) throw( IO_ERROR )
         }
     }
 
-    // load all the revisions for this part name
+    // load all the revisions for this part name, only if it has any
     PARTS::iterator  pi = parts->find( aLPID.GetPartName() );
 
     PART_REVS*  revs = pi != parts->end() ? pi->second : NULL;

new/sch_lib.h

@@ -46,7 +46,7 @@ class LIB_TABLE;
  */
 class LIB_SOURCE
 {
-    friend class LIBS;      ///< the LIB factory is LIBS::GetLibrary()
+    friend class LIBS;      ///< the LIB factory is thru LIB_TABLE::LookupPart()
     friend class LIB;       ///< the LIB uses these functions.
 
 protected:                  ///< derived classes must implement

new/sch_lib_table.h

@@ -223,6 +223,7 @@ public:
      *   (lib (logical LOGICAL)(type TYPE)(full_uri FULL_URI)(options OPTIONS))
      *   (lib (logical LOGICAL)(type TYPE)(full_uri FULL_URI)(options OPTIONS))
      *   (lib (logical LOGICAL)(type TYPE)(full_uri FULL_URI)(options OPTIONS))
+     *  )
      * </pre>
      *
      * When this function is called, the input token stream given by \a aLexer

new/sch_part.cpp

@@ -38,6 +38,11 @@ using namespace SCH;
 struct XY {};
 struct AT {};
 
+class POLY_LINE
+{
+
+};
+
 
 //-----</temporary home for PART sub objects, move after stable>-----------------
 
@@ -196,6 +201,11 @@ public:
                 contains |= PB(ANCHOR);
                 break;
 
+            case T_line:
+
+                break;
+
+
         /*
             case T_value:
                 if( contains & PB(VALUE) )
@@ -245,9 +255,6 @@ public:
             case T_polyline:
                 break;
 
-            case T_line:
-                break;
-
             case T_rectangle:
                 break;
 

new/sch_part.h

@@ -145,10 +145,10 @@ public:
      *
      * @param aLexer is an instance of SWEET_LEXER, rewound at the first line.
      *
-     * @param aLibTable is the LIB_TABLE view that is in effect for inheritance,
+     * @param aLibTable is the LIB_TABLE "view" that is in effect for inheritance,
      *  and comes from the big containing SCHEMATIC object.
      */
-    void Parse( SWEET_LEXER* aLexer, LIB_TABLE* aTable ) throw( IO_ERROR );
+    void Parse( SWEET_LEXER* aLexer, LIB_TABLE* aLibTable ) throw( IO_ERROR );
 
 /*
     void SetBody( const STR_UTF& aSExpression )