Issue Details (XML | Word | Printable)

Key: DERBY-58
Type: Bug Bug
Status: Closed Closed
Resolution: Fixed
Priority: Major Major
Assignee: Jean T. Anderson
Reporter: John Sisson
Votes: 0
Watchers: 0
Operations

If you were logged in you would be able to see more operations.
Derby

dblook options doco incorrect

Created: 08/Nov/04 02:32 AM   Updated: 09/Jun/05 03:18 AM
Return to search
Component/s: Documentation
Affects Version/s: 10.1.1.0
Fix Version/s: 10.1.1.0

Time Tracking:
Not Specified

File Attachments:
  Size
Zip Archive Licensed for inclusion in ASF works derby58.zip 2005-06-09 01:40 AM Jeff Levitt 2 kB

Resolution Date: 09/Jun/05 03:18 AM


 Description  « Hide
The dblook options dococumentation is incorrect on page http://incubator.apache.org/derby/manuals/tools/tools108.html.

* In the doco, the option below the '-t' option is 'dblook'. This seems to be a formatting error, as the text for the option describes it as a statement delimiter.

* The dblook code has a -td option that is not documented and looks like it should replace the 'dblook' option shown in the previous point.


 All   Comments   Work Log   Change History   Subversion Commits      Sort Order: Ascending order - Click to sort in descending order
Jean T. Anderson made changes - 09/Nov/04 12:42 AM
Field Original Value New Value
Assignee Jean T. Anderson [ jta ]
Jean T. Anderson added a comment - 09/Nov/04 12:43 AM
The 'dblook' option is a typo; it should be '-td'.

Repository Revision Date User Message
ASF #56996 Tue Nov 09 04:13:22 UTC 2004 jta Fixed some doc bugs (DERBY-9, DERBY-41, and DERBY-58).
Added more mail list links to the miscellaneous integration page (papers/misc.xml).
Fixed typo on the site navigation page for manuals (manuals/index.xml).
As a page gets modified, I'm migrating the forrest dtd it uses from 1.3 to 2.0.
Files Changed
MODIFY /incubator/derby/site/trunk/build/site/manuals/reference/sqlj43.html
MODIFY /incubator/derby/site/trunk/src/documentation/content/xdocs/manuals/develop/develop157.ihtml
MODIFY /incubator/derby/site/trunk/build/site/manuals/index.html
MODIFY /incubator/derby/site/trunk/build/site/manuals/reference/sqlj232.html
MODIFY /incubator/derby/site/trunk/src/documentation/content/xdocs/manuals/reference/sqlj232.ihtml
MODIFY /incubator/derby/site/trunk/build/site/manuals/develop/develop157.html
MODIFY /incubator/derby/site/trunk/src/documentation/content/xdocs/manuals/index.xml
MODIFY /incubator/derby/site/trunk/src/documentation/content/xdocs/manuals/reference/sqlj43.ihtml
MODIFY /incubator/derby/site/trunk/src/documentation/content/xdocs/manuals/reference/sqlj148.ihtml
MODIFY /incubator/derby/site/trunk/src/documentation/content/xdocs/manuals/develop/develop109.ihtml
MODIFY /incubator/derby/site/trunk/src/documentation/content/xdocs/manuals/tools/tools108.ihtml
MODIFY /incubator/derby/site/trunk/src/documentation/content/xdocs/papers/misc.xml
MODIFY /incubator/derby/site/trunk/build/site/manuals/tools/tools108.html
MODIFY /incubator/derby/site/trunk/build/site/papers/misc.html
MODIFY /incubator/derby/site/trunk/build/site/manuals/reference/sqlj148.html

Jean T. Anderson added a comment - 10/Nov/04 05:03 AM
Fixed in svn revision 56996:
incubator/derby/site/trunk/build/site/manuals/tools/tools108.html
incubator/derby/site/trunk/src/documentation/content/xdocs/manuals/tools/tools108.ihtml

Jean T. Anderson made changes - 10/Nov/04 05:03 AM
Resolution Fixed [ 1 ]
Status Open [ 1 ] Resolved [ 5 ]
Jean T. Anderson added a comment - 06/Jun/05 01:24 AM
Change sets the affects/fix versions.

Jean T. Anderson made changes - 06/Jun/05 01:24 AM
Affects Version/s 10.2.0.0 [ 11187 ]
Fix Version/s 10.0.2.1 [ 10991 ]
Description The dblook options dococumentation is incorrect on page http://incubator.apache.org/derby/manuals/tools/tools108.html.

* In the doco, the option below the '-t' option is 'dblook'. This seems to be a formatting error, as the text for the option describes it as a statement delimiter.

* The dblook code has a -td option that is not documented and looks like it should replace the 'dblook' option shown in the previous point.
The dblook options dococumentation is incorrect on page http://incubator.apache.org/derby/manuals/tools/tools108.html.

* In the doco, the option below the '-t' option is 'dblook'. This seems to be a formatting error, as the text for the option describes it as a statement delimiter.

* The dblook code has a -td option that is not documented and looks like it should replace the 'dblook' option shown in the previous point.
Environment
Jean T. Anderson made changes - 06/Jun/05 01:27 AM
Status Resolved [ 5 ] Closed [ 6 ]
Jean T. Anderson added a comment - 06/Jun/05 01:36 AM
Needs to be fixed in the DITA docs. The 'dblook' option should be '-td' in
derby/docs/trunk/src/tools/rtoolsdblookoptions.dita

For reference, this page in the 10.0 docs is now correct:
http://incubator.apache.org/derby/docs/10.0/manuals/tools/tools108.html

Jean T. Anderson made changes - 06/Jun/05 01:36 AM
Resolution Fixed [ 1 ]
Status Closed [ 6 ] Reopened [ 4 ]
Jean T. Anderson added a comment - 06/Jun/05 01:39 AM
Was previously fixed for the 10.0 docs in released version 10.0.2.1.
Setting fix version for the DITA docs to 10.2.0.0.

Jean T. Anderson made changes - 06/Jun/05 01:39 AM
Fix Version/s 10.2.0.0 [ 11187 ]
Affects Version/s 10.2.0.0 [ 11187 ]
Fix Version/s 10.0.2.1 [ 10991 ]
Affects Version/s 10.1.0.0 [ 10993 ]
Repository Revision Date User Message
ASF #189615 Wed Jun 08 18:13:02 UTC 2005 jta DERBY-58: Committed Jeff Levitt's patch that corrects a dblook option in
the tools guide.
Files Changed
MODIFY /incubator/derby/docs/trunk/src/tools/rtoolsdblookoptions.dita

Jeff Levitt added a comment - 09/Jun/05 01:40 AM
This patch changes the dblook option as described to "-td". HTML output file included in the zip file for review. This JIRA issue is slated for fix in 10.2.0.0, but it is so minor that it took seconds to create the patch, and it could probably be moved to be a 10.1.0.0 fix.

Jeff Levitt made changes - 09/Jun/05 01:40 AM
Attachment derby58.zip [ 12310604 ]
Jean T. Anderson added a comment - 09/Jun/05 03:18 AM
Reviewed and committed, revision 189615, Jeff's patch that fixes a dblook option in the Tools guide. Changed file:
M src/tools/rtoolsdblookoptions.dita

Jean T. Anderson made changes - 09/Jun/05 03:18 AM
Fix Version/s 10.2.0.0 [ 11187 ]
Status Reopened [ 4 ] Closed [ 6 ]
Resolution Fixed [ 1 ]
Fix Version/s 10.1.0.0 [ 10993 ]