svn commit - mysqldoc@docsrva: r7589 - in trunk: . userguide workbench-pro

[plavin]

Author: plavin
Date: 2007-08-29 20:11:32 +0200 (Wed, 29 Aug 2007)
New Revision: 7589

Log:
Add directory for WorkbenchPro


Added:
   trunk/workbench-pro/Makefile
   trunk/workbench-pro/all-entities.ent
   trunk/workbench-pro/installing.xml
   trunk/workbench-pro/legalnotice.en.xml
   trunk/workbench-pro/uninstalling.xml
   trunk/workbench-pro/version.ent
   trunk/workbench-pro/workbench-pro.ent
   trunk/workbench-pro/workbench-pro.xml
Modified:
   trunk/userguide/php-pdo.xml


Modified: trunk/userguide/php-pdo.xml
===================================================================
--- trunk/userguide/php-pdo.xml	2007-08-29 16:40:49 UTC (rev 7588)
+++ trunk/userguide/php-pdo.xml	2007-08-29 18:11:32 UTC (rev 7589)
Changed blocks: 2, Lines Added: 5, Lines Deleted: 8; 1267 bytes

@@ -779,9 +779,7 @@
       can't use SQL statements that are unsupported by the underlying
       database. You cannot, for instance successfully issue a
       <literal>CREATE TRIGGER</literal> statement against a MySQL 4.1
-      database. PDO is a data-access abstraction layer providing uniform
-      methods for accessing different databases or different versions of
-      the same database.
+      database.
     </para>
 
     <para>

@@ -800,14 +798,13 @@
     </para>
     
     <para>
-      Whether you work with multiple, different databases or 
-      a number of different versions of the same database, 
-      using PDO gives you a uniform, object-oriented 
-      data-access layer.
+      PDO is a data-access abstraction layer providing uniform, object-oriented
+      methods for accessing different databases or different versions of
+      the same database.
     </para>
 
     <para>
-      [Find the code <ulink url="code.tar">here</ulink>. ]
+      [Find the code <ulink url="code.tar.gz">here</ulink>. ]
     </para>
 
   </section>


Added: trunk/workbench-pro/Makefile
===================================================================
--- trunk/workbench-pro/Makefile	                        (rev 0)
+++ trunk/workbench-pro/Makefile	2007-08-29 18:11:32 UTC (rev 7589)
Changed blocks: 1, Lines Added: 78, Lines Deleted: 0; 2283 bytes

@@ -0,0 +1,78 @@
+# Makefile for [NAME OF DOCUMENT HERE]
+
+# Location of repository root relative to current directory
+REPO_ROOT = ..
+
+# Location of directory containing Makefile components
+MAKE_DIR = $(REPO_ROOT)/make.d
+
+# Set any variables here that should override imported standard variables
+
+DOC_LANG = en
+MAIN_DOC_BASENAME = workbench-pro
+
+# Set IDMAP and remap variables
+
+IDMAP_LANG = $(DOC_LANG)
+IDMAP_MAIN = refman
+IDMAP_VER = 5.1
+
+IDMAP_URLBASE = $(IDMAP_MAIN)/$(IDMAP_VER)/$(IDMAP_LANG)
+IDMAP_REFS = . 
+IDMAP_SRCS = $(call base_xml_files)
+
+# Import standard variables
+
+include $(MAKE_DIR)/vars-layout
+include $(MAKE_DIR)/vars-shell
+include $(MAKE_DIR)/vars-docbook
+
+# Import default target rule (causes help message to print)
+
+include $(MAKE_DIR)/default-target
+
+# Files for which to generate dependencies
+DEPEND_FILES = workbench-pro.xml
+
+# ... put any special-case target rules here ...
+
+# Include this clean target if you generate plain text output
+# from the document
+clean::
+	$(RM) workbench-pro.txt
+
+# Import document dependency specifications
+
+include Makefile.depends
+
+# Import standard target rules
+# (comment out or remove any that you don't need)
+
+include $(MAKE_DIR)/xml-valid
+include $(MAKE_DIR)/xml-format
+include $(MAKE_DIR)/xml-prep
+# xml-html for single-page HTML output with no images
+# xml-html-dir for single-page HTML output that also has images
+include $(MAKE_DIR)/xml-html
+include $(MAKE_DIR)/xml-html-dir
+include $(MAKE_DIR)/xml-html-section
+include $(MAKE_DIR)/xml-html-chapter
+include $(MAKE_DIR)/xml-html-web
+include $(MAKE_DIR)/xml-chm
+include $(MAKE_DIR)/xml-xhtml
+include $(MAKE_DIR)/xml-xhtml-dir
+include $(MAKE_DIR)/xml-xhtml-section
+include $(MAKE_DIR)/xml-xhtml-chapter
+include $(MAKE_DIR)/xml-pdf
+include $(MAKE_DIR)/xml-toc
+include $(MAKE_DIR)/xml-txt
+include $(MAKE_DIR)/xml-info
+include $(MAKE_DIR)/xml-man
+include $(MAKE_DIR)/xml-help
+include $(MAKE_DIR)/xml-remark
+include $(MAKE_DIR)/xml-depend
+include $(MAKE_DIR)/xml-useless
+
+# Import directory specific extensions
+
+include $(MAKE_DIR)/Makefile.ext


Added: trunk/workbench-pro/all-entities.ent
===================================================================
--- trunk/workbench-pro/all-entities.ent	                        (rev 0)
+++ trunk/workbench-pro/all-entities.ent	2007-08-29 18:11:32 UTC (rev 7589)
Changed blocks: 1, Lines Added: 13, Lines Deleted: 0; 785 bytes

@@ -0,0 +1,13 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!--
+  This file names all the entity files needed by .xml files in the
+  current directory.  All ENTITY declarations should be given
+  first, followed by references to the those entities.
+-->
+<!ENTITY % fixedchars.entities SYSTEM "../common/fixedchars.ent">
+<!ENTITY % workbench-pro.entities     SYSTEM "workbench-pro.ent">
+<!ENTITY % version.entities     SYSTEM "version.ent">
+
+%fixedchars.entities;
+%workbench-pro.entities;
+%version.entities;
\ No newline at end of file


Added: trunk/workbench-pro/installing.xml
===================================================================
--- trunk/workbench-pro/installing.xml	                        (rev 0)
+++ trunk/workbench-pro/installing.xml	2007-08-29 18:11:32 UTC (rev 7589)
Changed blocks: 1, Lines Added: 87, Lines Deleted: 0; 2896 bytes

@@ -0,0 +1,87 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+"http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd"
+[
+  <!ENTITY % all.entities SYSTEM "all-entities.ent">
+  %all.entities;
+]>
+<chapter id="workbench-pro-installing">
+
+  <title>Installation of &workbench_pro;</title>
+  
+  <section>
+    <title>Requirements</title>
+    
+    <para>
+      The  &workbench_pro; requires the Java
+      Runtime Environment (JRE). The minimum version supported is 5.0
+      update 8.
+    </para>
+    
+    <para>
+      A working, current
+      <literal>OpenGL</literal> installation is required by the
+      &workbench_pro;. To find out more about <literal>OpenGL</literal>
got
+      to <ulink url="http://www.opengl.org/">www.opengl.org</ulink>. The
+      installation of OpenGL is beyond the scope of this document.
+    </para>
+    
+    <para>
+      &workbench_pro; runs on recent 32-bit Windows NT based operating
+      systems, including Windows 2000, XP, Vista, and 2003. It doesn't run on
+      Windows NT 4 and below.
+    </para>
+    
+    
+  </section>
+  
+  <section>
+    
+    <title>Installing &workbench_pro;</title>
+    
+   
+    <para>
+      Download the zipped file to a convenient location and 
+      decompress it. 
+    </para>
+    
+    <para>
+      Unless you choose otherwise, &gui_tools; are installed in
+      <literal>C:\<replaceable>%PROGRAMFILES%</replaceable>\MySQL\MySQL
+        Tools for <replaceable>version</replaceable>\</literal>, where
+      <replaceable>%PROGRAMFILES%</replaceable> is the default
+      directory for programs on your machine and
+      <literal>version</literal> is the version number of &gui_tools;.
+      The <literal>%PROGRAMFILES%</literal>directory might be
+      <literal>C:\Program Files</literal> or
+      <literal>C:\programme</literal>.
+    </para>
+    
+    <note>
+      <para>
+        Installing &gui_tools; using the Windows installer
+        automatically creates entries in the <literal>Start</literal>
+        menu.
+      </para>
+    
+    
+  </section>
+  
+  <section id="&workbench_pro;-installation-zip">
+    
+    <title>Installing From the ZIP File</title>
+    
+    <para>
+      If you are having problems running the installer, as an
+      alternative, you can download a ZIP file without an installer.
+      That file is called
+     
<literal>mysql-gui-tools-noinstall-<replaceable>version</replaceable>-win32.zip</literal>.
+      Using a ZIP program, unpack it to the directory of your choice.
+      You may also want to create a shortcut on your desktop or the
+      quick launch bar.
+    </para>
+    
+  </section>
+  
+
+</chapter>


Added: trunk/workbench-pro/legalnotice.en.xml
===================================================================
--- trunk/workbench-pro/legalnotice.en.xml	                        (rev 0)
+++ trunk/workbench-pro/legalnotice.en.xml	2007-08-29 18:11:32 UTC (rev 7589)
Changed blocks: 1, Lines Added: 67, Lines Deleted: 0; 3103 bytes

@@ -0,0 +1,67 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!DOCTYPE legalnotice PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+"http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd">
+<legalnotice>
+
+<!--
+  The role attribute for each top-level legalnotice element determines
+  the context in which the element is used: 1) no role attribute: part
+  of the default legalnotice, used for regular documentation that is
+  not released under GPL; 2) role = legalnotice-gpl: for manpage
+  legalnotices, which are released under GPL; 3) role =
+  legalnotice-all: included in legalnotice for all documentation.
+-->
+
+  <para>
+    Copyright 2006-2007 MySQL AB
+  </para>
+
+  <para>
+    This documentation is NOT distributed under a GPL license. Use of
+    this documentation is subject to the following terms: You may create
+    a printed copy of this documentation solely for your own personal
+    use. Conversion to other formats is allowed as long as the actual
+    content is not altered or edited in any way. You shall not publish
+    or distribute this documentation in any form or on any media, except
+    if you distribute the documentation in a manner similar to how MySQL
+    disseminates it (that is, electronically for download on a Web site
+    with the software) or on a CD-ROM or similar medium, provided
+    however that the documentation is disseminated together with the
+    software on the same medium. Any other use, such as any
+    dissemination of printed copies or use of this documentation, in
+    whole or in part, in another publication, requires the prior written
+    consent from an authorized representative of MySQL AB. MySQL AB
+    reserves any and all rights to this documentation not expressly
+    granted above.
+  </para>
+
+  <para role="legalnotice-gpl">
+    Copyright 2007 MySQL AB
+  </para>
+
+  <para role="legalnotice-gpl">
+    This documentation is free software; you can redistribute it and/or
+    modify it under the terms of the GNU General Public License as
+    published by the Free Software Foundation; version 2 of the License.
+  </para>
+
+  <para role="legalnotice-gpl">
+    This documentation is distributed in the hope that it will be
+    useful, but WITHOUT ANY WARRANTY; without even the implied warranty
+    of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+    General Public License for more details.
+  </para>
+
+  <para role="legalnotice-gpl">
+    You should have received a copy of the GNU General Public License
+    along with the program; if not, write to the Free Software
+    Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
+    02110-1301 USA or see http://www.gnu.org/licenses/.
+  </para>
+
+  <para role="legalnotice-all">
+    Please email <email>docs@stripped</email> for more information or
+    if you are interested in doing a translation.
+  </para>
+
+</legalnotice>


Added: trunk/workbench-pro/uninstalling.xml
===================================================================
--- trunk/workbench-pro/uninstalling.xml	                        (rev 0)
+++ trunk/workbench-pro/uninstalling.xml	2007-08-29 18:11:32 UTC (rev 7589)
Changed blocks: 1, Lines Added: 40, Lines Deleted: 0; 1379 bytes

@@ -0,0 +1,40 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+"http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd"
+[
+  <!ENTITY % all.entities SYSTEM "all-entities.ent">
+  %all.entities;
+]>
+<chapter id="workbench-pro-uninstalling">
+
+  <title>Removing &workbench_pro;</title>
+  
+  <section id="guitools-uninstalling-windows">
+    
+    <title>Uninstalling &workbench_pro;</title>
+    
+    <para>
+      To uninstall &workbench_pro;, open the <literal>Control
+        Panel</literal> and Choose <literal>Add or Remove
+          Programs</literal>. Find the
<literal>&workbench_pro;</literal> entry
+      and choose the <guibutton>Remove</guibutton> button. Choosing this
+      option will remove all of the GUI Tools.
+    </para>
+    
+    <note>
+      <para>
+        Currently, there is no command line option for removing
+        &gui_tools;.
+      </para>
+    </note>
+    
+    <note>
+      <para>
+        Removing an application manually will not remove all the files
+        belonging to that application.
+      </para>
+    </note>
+    
+    </section>
+
+</chapter>


Added: trunk/workbench-pro/version.ent
===================================================================
--- trunk/workbench-pro/version.ent	                        (rev 0)
+++ trunk/workbench-pro/version.ent	2007-08-29 18:11:32 UTC (rev 7589)
Changed blocks: 1, Lines Added: 3, Lines Deleted: 0; 343 bytes

@@ -0,0 +1,3 @@
+<?xml version='1.0' encoding='utf-8'?>
+<!ENTITY workbench_pro_version "Alpha 1.0.2">
+


Added: trunk/workbench-pro/workbench-pro.ent
===================================================================
--- trunk/workbench-pro/workbench-pro.ent	                        (rev 0)
+++ trunk/workbench-pro/workbench-pro.ent	2007-08-29 18:11:32 UTC (rev 7589)
Changed blocks: 1, Lines Added: 4, Lines Deleted: 0; 361 bytes

@@ -0,0 +1,4 @@
+<?xml version='1.0' encoding='utf-8'?>
+<!ENTITY workbench_pro "MySQL Workbench">
+
+


Added: trunk/workbench-pro/workbench-pro.xml
===================================================================
--- trunk/workbench-pro/workbench-pro.xml	                        (rev 0)
+++ trunk/workbench-pro/workbench-pro.xml	2007-08-29 18:11:32 UTC (rev 7589)
Changed blocks: 1, Lines Added: 41, Lines Deleted: 0; 1081 bytes

@@ -0,0 +1,41 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+"http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd"
+[
+  <!ENTITY % all.entities SYSTEM "all-entities.ent">
+  %all.entities;
+]>
+<book id="workbench-pro" lang="en">
+
+  <title>TITLE OF DOCUMENT HERE</title>
+
+  <bookinfo>
+
+    <abstract>
+
+      <para>
+        [OPTIONAL HIGH-LEVEL DESCRIPTION OF DOCUMENT; edit or remove
+        this para]
+      </para>
+
+      <para>
+        Document generated on:
+
+<?dbtimestamp format="Y-m-d"?>
+
+        <remark role="repository.revision"/>
+      </para>
+
+    </abstract>
+
+    <xi:include href="legalnotice.en.xml"
+      xmlns:xi="http://www.w3.org/2001/XInclude"/>
+
+  </bookinfo>
+
+<!-- [DOCUMENT CONTENT GOES HERE; chapters, sections, etc.] -->
+  
+
+  <index/>
+
+</book>