 |
| ||||||
|---|---|---|---|---|---|---|---|
All milestone release are for test purpose of developers.
Evolutions required for next version:
Need to check coherence attributes documentation between doc name used and Schema definition.
Create a validation program of all references in order to check their validity.
Xs2Dtd.
Presentation of attribute facets other than enumerations.
Find a css way to word-split programlisting elements generating a <pre> HTML
element.
Bug to correct:
GUI : Understands why messages appears more than once.
Big effort on the documentation, thanks to Asdrad
Few tuning of the Index.
Correct different bugs
Adding informaltable to allowed docbook contents
A lot of fine tuning plus compatibility with Epic 5.2.
Switch from JBuilder GUI maker to Matisse, used under NetBeans 5.5.
Correct different bugs
No modification made on SchemaDoc itself except to enable to manage also, in the same time analdoc (Section 12, “Document analysis extensions”).
Brand new version including:
switch to epic 5 and integration of XMLMind XML Editor (xxe);
new design of the publishing management;
early implementation of xs2dtd;
new elements: sd:alsoDocuments, sd:objAttributeDoc;
Careful, the Epic package provided now works with Epic 4.4. If there is a need to use it with Epic 4.3, everything needs to be recompiled.
Careful also to naming changes:
the namespace of SchemaDoc is set to "http://www.tireme.fr/XMLSchema/documentation/V1/"
DTD are set to a TIREME organization.
For example, main public called out DTD is "-//TIREME//DTD Documentation Of Schema Reference//EN"
the namespace of SchemaDoc is set to "http://www.tireme.fr/XMLSchema/documentation/V1/"
DTD are set to a TIREME organization.
For example, main public called out DTD is "-//TIREME//DTD Documentation Of Schema Reference//EN"
Contains row in object definition is no more present as soon as XML spy graphics are presents.
Adding a "new configuration from scratch" feature.
Reorganization of input parameters loading.
New feature added (sd:alsoDocuments) enabling not to document everything. (to be documented and installed on paper)
Adding a warning for all not used objects (to be documented)
Features added:
Adding documentation for XSLT transformations. The mechanism is set ut but need to rework documentation information itself and genera.
tion
Enable to load a SchemaDoc document even if invalid this is mainly for being able to use Adept revision change system.
For HTML output, add a possibility to call an external
stylesheet for specific needs purpose (specificNeeds.xslt). In this implementation, this is used for managing Adept revision
change system.
Modifications of the installation: the program now
install its own needed classes in a lib directory. This is a recommendation from Bruno, in order to be sure
that the installed workstation has the need programs in the right
version. This also simplify the installation process. Last, this also
simplify the tree structure where there is no more need to have a
directory containing a SchemaDoc directory.
For being able to use this package, the previous scripts used
needs to be simplified for environment variables (SchemaDoc_ENV_HOME), class path, endorsed directories
and environment variables sent to Java (SchemaDoc_pgm_home): see Section 6.2.1.1, “Starting the tool” for more details.
Features added:
Validation of twice defined object documentations.
For HTML fragmentation, make usage of id attribute of sect1 elements as soon as provided for enabling to manage the way file names are labelled. The same for xs:schema id attribute.
Modify the end user interface in order to provide direct access to tables of contents.
Bug corrected
area of graphics in documentation are now making the link straight within documentation section if exists.
Features added:
Add two new SchemaDoc elements. sd:concept and sd:principle (removed in 2.0).
Create new direct access table using glossEntry.
A lot of rework on the documentation in order to make it a little bit more usable and accessible.
Features added:
Create a new GUI configuration file management if it does not exists. The configuration file goes to the sample document.
Refuse to remove the last configuration of a configuration file.
Adding a new feature in the user interface enabling to automatically remove all png files generated by XMLSpy and that are not used in the SchemaDoc documentation.
Creating an installation package.
Bugs:
Correct the "file document open" menu item that was not openning a file chooser.
Removes the limitation for graphics of a redefinition, due to the fact that it is now possible within XMLSpy 5.4.
Enabling to have a multiple defined object in two different sections of a grove. For being able to manage this :
change the id/idref mechanism in order to use either unqualified ids (type+namespace+objName) or qualified, concatenating after the schema file ID.
Change the way XMLSpy is managed, using the index documentation generated by XMLSpy.
Adding a schemaId attribute to the linkendAsCharReq group.
Features added:
Add a limitation section to the documentation Section 10, “Limitations”.
Bug corrected
Previous versions were obliging prefix specific declarations for DocBook and Schema namespaces. This is no more relevant.
Features added:
Enables a sd:localAttributeRef regarding to an xs:attributeGroup, as it is done for xs:element and xs:complexType.
Manages language either for the user interface and labels contained within documentation.
Updates pdf generation in order to have a better conformance to the specs.
Removes jpeg requirements for pdf generation.
Computes image heigth and width from file in order to have a better scaling algorithm while formatting for paper.
Due to a bug in Xalan 2.4.1, it is now possible to
use saxon xslt transformer. An argument have
been added in the command line -x; of course, saxon.jar needs to
be in the classpath.
Manages hyperlinks in graphics while browsing HTML files. This feature is based on XML Spy graphic generation.
Enables to document attributes within sd:attributeGroupDocRef, sd:elemDocRef and sd:complexTypeDocRef.
Bug corrected
Removes usedIn row for inclusion and redefinition.
In the user interface, corrects the file choosers bugs.
Displays of attributes: all attribute groups are now displayed, with a link in HTML.
When an element uses an attributeGroup ref="", we cannot find it in the SchemaDocRef.
All displayed attributes are only those that are within global elements and complex types... not in included local declaration.
Features added:
Only needed Schemas are now output, regarding to new attribute docManage added to article.
Setting up software versioning.
Choice added to user interface in order to decide if the Schema definition itself need to be output.
Implementing a FrameMaker formatting output
Debug mode is removed from the user interface and must be passed as an argument to the java program call.
User interface and messages are now localized (english or french) depending on a language argument of the java program call.
Generated messages in output documents are now localized, regarding to the attribute sdLang.attribute added to article.
Bug corrected:
Redefines label on electronic output.
Bug while displaying objects using specific document object documented in HTML and paper output.
Improved:
Time for loading document and reorganize it.
 |  |  |
| 10. Limitations | 12. Document analysis extensions |
