Start with git helper scripts and extra documentation

2 files changed, 82 insertions, 0 deletions

diff --git a/doc/README b/doc/README
new file mode 100644
index 0000000..3cf3dd7
--- /dev/null
+++ b/doc/README
@@ -0,0 +1,36 @@
+ODB is an object-relational mapping (ORM) system for C++. It provides
+tools, APIs, and library support that allow you to persist C++ objects
+to a relational database (RDBMS) without having to deal with tables,
+columns, or SQL and without manually writing any of the mapping code.
+For more information see:
+
+http://www.codesynthesis.com/products/odb/
+
+This package contains the pre-compiled binary distribution of the ODB
+compiler. The top-level directory structure of this package is as
+follows:
+
+bin/          ODB compiler binary
+doc/          ODB system documentation
+man/          man pages for the ODB compiler
+<arch>-<os>/  GCC compiler binaries, see manifest inside for details
+
+To install this package simply unpack it into a directory of your choice,
+for example /opt/. You can run the ODB compiler by either using the
+absolute path, for example:
+
+/opt/odb-x.y.z-i686-linux-gnu/bin/odb --version
+
+Or you can add the bin/ directory to the PATH environment variable, for
+example:
+
+export PATH=/opt/odb-x.y.z-i686-linux-gnu/bin:$PATH
+odb --version
+
+Note also that while you can move the ODB compiler directory around, you
+cannot move individual sub-directories or files inside it. For example,
+copying or linking the ODB compiler executable to /usr/local/bin/ will
+not work.
+
+Send questions, bug reports, or any other feedback to the 
+odb-users@codesynthesis.com mailing list.
diff --git a/doc/README-WIN b/doc/README-WIN
new file mode 100644
index 0000000..7db442d
--- /dev/null
+++ b/doc/README-WIN
@@ -0,0 +1,46 @@
+ODB is an object-relational mapping (ORM) system for C++. It provides
+tools, APIs, and library support that allow you to persist C++ objects
+to a relational database (RDBMS) without having to deal with tables,
+columns, or SQL and without manually writing any of the mapping code.
+For more information see:
+
+http://www.codesynthesis.com/products/odb/
+
+This package contains the pre-compiled binary distribution of the ODB
+compiler for Windows. The top-level directory structure of this package
+is as follows:
+
+bin/          ODB compiler binary
+doc/          ODB system documentation
+man/          man pages for the ODB compiler
+mingw/        GCC compiler, MinGW, and MSYS binaries, see manifest
+              inside for details
+
+To install this package simply unpack it into a directory of your choice,
+for example C:\tools. The ODB compiler binary will be in the bin\
+directory inside the package directory, for example 
+C:\tools\odb-x.y.z-i686-windows\bin\. You can run the ODB compiler by
+either using the absolute path, for example:
+
+
+C:\tools\odb-x.y.z-i686-windows\bin\odb --version
+
+Or you can add the bin\ directory to the Path environment variable. To
+accomplish this, open Control Panel, then System, select the Advanced tab
+and click on the Environment Variables button. If you have administrator
+privileges, select the Path variable from the System variables list.
+Otherwise, select (or create) the Path variable from the User variables
+list. Click the Edit button and add the bin\ directory to the list. Click
+Ok, then log off and log on again for the changes to take effect. Once this
+is done, you should be able to run the ODB compiler by using just its name,
+for example:
+
+odb --version
+
+Note also that while you can move the ODB compiler directory around, you
+cannot move individual sub-directories or files inside it. For example,
+copying the ODB compiler executable to
+C:\Windows will not work.
+
+Send questions, bug reports, or any other feedback to the 
+odb-users@codesynthesis.com mailing list.