You are viewing a plain text version of this content. The canonical link for it is here.
Posted to derby-dev@db.apache.org by "Andrew McIntyre (JIRA)" <de...@db.apache.org> on 2006/02/08 09:24:57 UTC

[jira] Created: (DERBY-936) Main branch docs display version as 10.1, should be 10.2.

Main branch docs display version as 10.1, should be 10.2.
---------------------------------------------------------

         Key: DERBY-936
         URL: http://issues.apache.org/jira/browse/DERBY-936
     Project: Derby
        Type: Improvement
  Components: Documentation  
    Versions: 10.0.2.0    
    Reporter: Andrew McIntyre


Currently the output for the PDF and HTML Book formats of the manuals on the main branch display the version 10.1. Documentation changes have been committed which make the main branch of the documentation no longer proper for 10.1, so the version the main branch of the documentation displays should be 10.2.

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators:
   http://issues.apache.org/jira/secure/Administrators.jspa
-
For more information on JIRA, see:
   http://www.atlassian.com/software/jira


Re: [jira] Commented: (DERBY-936) Main branch docs display version as 10.1, should be 10.2.

Posted by Laura Stewart <sc...@gmail.com>.
Daniel John Debrunner commented on DERBY-936:
---------------------------------------------

Does dita have the concept of a variable, so the version could be
stored in one place, rather than each file?

*** (LS) Yes, DITA has the concept of variables.  They are called
"conrefs".  Each book has a file that contains the conrefs for that
book. For example, the conrefs file for the Developers Guide is
devconrefs.dita.

For example, the product name "Derby" has a conref and is envoked with
these tags:
<ph conref="devconrefs.dita#prod/productshortname"></ph>

-- 
Laura Stewart

[jira] Commented: (DERBY-936) Main branch docs display version as 10.1, should be 10.2.

Posted by "Rick Hillegas (JIRA)" <de...@db.apache.org>.
    [ http://issues.apache.org/jira/browse/DERBY-936?page=comments#action_12423342 ] 
            
Rick Hillegas commented on DERBY-936:
-------------------------------------

The derby-936_v02.diff patch touches the following files:

M      src\tools\rtoolsijpropref35032.dita
M      src\tools\rtoolsijpropref12236.dita
M      src\tools\rtoolsijcomref1003067.dita
M      src\tools\rtoolsijproprefuser.dita
M      src\tools\rtoolsijpropref28146.dita
M      src\tools\rtoolssysinfo1002629.dita
M      src\tools\rtoolsijpropref38481.dita
M      src\tools\ttoolsij97656.dita
M      src\tools\rtoolsijpropref41073.dita
M      src\tools\ttoolsij30600.dita
M      src\tools\rtoolsijpropref25589.dita
M      src\tools\toolsconrefs.dita
M      src\tools\rtoolsijpropref10135.dita
M      src\workingwithderby\twwdIntro.dita
A      src\workingwithderby\wwdconrefs.dita
M      src\workingwithderby\twwdactivity1.dita
M      src\workingwithderby\twwdactivity2.dita
M      src\tuning\tunconrefs.dita
M      src\adminguide\adminconrefs.dita
M      src\pt_BR\adminguide\adminconrefs.dita
M      src\pt_BR\ref\refconrefs.dita
M      src\pt_BR\getstart\gsconrefs.dita
M      src\pt_BR\getstart\getstartderby.ditamap
M      src\devguide\derbydev.ditamap
M      src\devguide\cdevupgrades.dita
M      src\devguide\devconrefs.dita
M      src\devguide\cdevcsecure36595.dita
M      src\devguide\tdevupgradesoft.dita
M      src\ref\refconrefs.dita
M      src\getstart\gsconrefs.dita
M      src\getstart\getstartderby.ditamap

> Main branch docs display version as 10.1, should be 10.2.
> ---------------------------------------------------------
>
>                 Key: DERBY-936
>                 URL: http://issues.apache.org/jira/browse/DERBY-936
>             Project: Derby
>          Issue Type: Improvement
>          Components: Documentation
>    Affects Versions: 10.0.2.0
>            Reporter: Andrew McIntyre
>         Assigned To: Rick Hillegas
>            Priority: Blocker
>             Fix For: 10.2.0.0
>
>         Attachments: derby-936_v02.diff, derby936.diff, htmloutput.tar.gz
>
>
> Currently the output for the PDF and HTML Book formats of the manuals on the main branch display the version 10.1. Documentation changes have been committed which make the main branch of the documentation no longer proper for 10.1, so the version the main branch of the documentation displays should be 10.2.

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators: http://issues.apache.org/jira/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira

        

[jira] Updated: (DERBY-936) Main branch docs display version as 10.1, should be 10.2.

Posted by "Kathey Marsden (JIRA)" <de...@db.apache.org>.
     [ http://issues.apache.org/jira/browse/DERBY-936?page=all ]

Kathey Marsden updated DERBY-936:
---------------------------------

    Derby Info:   (was: [Patch Available])

Unchecking patch available for this issue.  It looks like there was an issue with the patch on Andrew's review and Jeff is no longer assigned to the issue.  This is a blocker for 10.2 so we probably don't want it to look like it is taken care of.


> Main branch docs display version as 10.1, should be 10.2.
> ---------------------------------------------------------
>
>                 Key: DERBY-936
>                 URL: http://issues.apache.org/jira/browse/DERBY-936
>             Project: Derby
>          Issue Type: Improvement
>          Components: Documentation
>    Affects Versions: 10.0.2.0
>            Reporter: Andrew McIntyre
>            Priority: Blocker
>             Fix For: 10.2.0.0
>
>         Attachments: derby936.diff
>
>
> Currently the output for the PDF and HTML Book formats of the manuals on the main branch display the version 10.1. Documentation changes have been committed which make the main branch of the documentation no longer proper for 10.1, so the version the main branch of the documentation displays should be 10.2.

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators: http://issues.apache.org/jira/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira

        

[jira] Updated: (DERBY-936) Main branch docs display version as 10.1, should be 10.2.

Posted by "Andrew McIntyre (JIRA)" <de...@db.apache.org>.
     [ http://issues.apache.org/jira/browse/DERBY-936?page=all ]

Andrew McIntyre updated DERBY-936:
----------------------------------

    Other Info:   (was: [Patch available])
    Derby Info: [Patch Available]

> Main branch docs display version as 10.1, should be 10.2.
> ---------------------------------------------------------
>
>          Key: DERBY-936
>          URL: http://issues.apache.org/jira/browse/DERBY-936
>      Project: Derby
>         Type: Improvement
>   Components: Documentation
>     Versions: 10.0.2.0
>     Reporter: Andrew McIntyre
>  Attachments: derby936.diff
>
> Currently the output for the PDF and HTML Book formats of the manuals on the main branch display the version 10.1. Documentation changes have been committed which make the main branch of the documentation no longer proper for 10.1, so the version the main branch of the documentation displays should be 10.2.

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators:
   http://issues.apache.org/jira/secure/Administrators.jspa
-
For more information on JIRA, see:
   http://www.atlassian.com/software/jira


Re: [jira] Commented: (DERBY-936) Main branch docs display version as 10.1, should be 10.2.

Posted by Jeff Levitt <de...@mylevita.com>.
OK, thanks Andrew.  We'll try again after some of
those issues settle down later on.

--- "Andrew McIntyre (JIRA)" <de...@db.apache.org>
wrote:

>     [
>
http://issues.apache.org/jira/browse/DERBY-936?page=comments#action_12367613
> ] 
> 
> Andrew McIntyre commented on DERBY-936:
> ---------------------------------------
> 
> Hi Jeff, it looks like we can't do a straight
> search-and-replace here. Even in the first few diffs
> I see places where if 10.1 is changed to 10.2, the
> text may no longer be correct. In some cases, the
> functionality in question is still under development
> for 10.2. I think we should revisit this issue at a
> later date.
> 
> > Main branch docs display version as 10.1, should
> be 10.2.
> >
>
---------------------------------------------------------
> >
> >          Key: DERBY-936
> >          URL:
> http://issues.apache.org/jira/browse/DERBY-936
> >      Project: Derby
> >         Type: Improvement
> >   Components: Documentation
> >     Versions: 10.0.2.0
> >     Reporter: Andrew McIntyre
> >  Attachments: derby936.diff
> >
> > Currently the output for the PDF and HTML Book
> formats of the manuals on the main branch display
> the version 10.1. Documentation changes have been
> committed which make the main branch of the
> documentation no longer proper for 10.1, so the
> version the main branch of the documentation
> displays should be 10.2.
> 
> -- 
> This message is automatically generated by JIRA.
> -
> If you think it was sent incorrectly contact one of
> the administrators:
>   
>
http://issues.apache.org/jira/secure/Administrators.jspa
> -
> For more information on JIRA, see:
>    http://www.atlassian.com/software/jira
> 
> 


[jira] Commented: (DERBY-936) Main branch docs display version as 10.1, should be 10.2.

Posted by "Andrew McIntyre (JIRA)" <de...@db.apache.org>.
    [ http://issues.apache.org/jira/browse/DERBY-936?page=comments#action_12367613 ] 

Andrew McIntyre commented on DERBY-936:
---------------------------------------

Hi Jeff, it looks like we can't do a straight search-and-replace here. Even in the first few diffs I see places where if 10.1 is changed to 10.2, the text may no longer be correct. In some cases, the functionality in question is still under development for 10.2. I think we should revisit this issue at a later date.

> Main branch docs display version as 10.1, should be 10.2.
> ---------------------------------------------------------
>
>          Key: DERBY-936
>          URL: http://issues.apache.org/jira/browse/DERBY-936
>      Project: Derby
>         Type: Improvement
>   Components: Documentation
>     Versions: 10.0.2.0
>     Reporter: Andrew McIntyre
>  Attachments: derby936.diff
>
> Currently the output for the PDF and HTML Book formats of the manuals on the main branch display the version 10.1. Documentation changes have been committed which make the main branch of the documentation no longer proper for 10.1, so the version the main branch of the documentation displays should be 10.2.

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators:
   http://issues.apache.org/jira/secure/Administrators.jspa
-
For more information on JIRA, see:
   http://www.atlassian.com/software/jira


[jira] Commented: (DERBY-936) Main branch docs display version as 10.1, should be 10.2.

Posted by "Daniel John Debrunner (JIRA)" <de...@db.apache.org>.
    [ http://issues.apache.org/jira/browse/DERBY-936?page=comments#action_12423359 ] 
            
Daniel John Debrunner commented on DERBY-936:
---------------------------------------------

Does dita have the concept of a variable, so the version could be stored in one place, rather than each file?

> Main branch docs display version as 10.1, should be 10.2.
> ---------------------------------------------------------
>
>                 Key: DERBY-936
>                 URL: http://issues.apache.org/jira/browse/DERBY-936
>             Project: Derby
>          Issue Type: Improvement
>          Components: Documentation
>    Affects Versions: 10.0.2.0
>            Reporter: Andrew McIntyre
>         Assigned To: Rick Hillegas
>            Priority: Blocker
>             Fix For: 10.2.0.0
>
>         Attachments: derby-936_v02.diff, derby936.diff, htmloutput.tar.gz
>
>
> Currently the output for the PDF and HTML Book formats of the manuals on the main branch display the version 10.1. Documentation changes have been committed which make the main branch of the documentation no longer proper for 10.1, so the version the main branch of the documentation displays should be 10.2.

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators: http://issues.apache.org/jira/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira

        

[jira] Updated: (DERBY-936) Main branch docs display version as 10.1, should be 10.2.

Posted by "Jeff Levitt (JIRA)" <de...@db.apache.org>.
     [ http://issues.apache.org/jira/browse/DERBY-936?page=all ]

Jeff Levitt updated DERBY-936:
------------------------------

    Other Info: [Patch available]

> Main branch docs display version as 10.1, should be 10.2.
> ---------------------------------------------------------
>
>          Key: DERBY-936
>          URL: http://issues.apache.org/jira/browse/DERBY-936
>      Project: Derby
>         Type: Improvement
>   Components: Documentation
>     Versions: 10.0.2.0
>     Reporter: Andrew McIntyre
>  Attachments: derby936.diff
>
> Currently the output for the PDF and HTML Book formats of the manuals on the main branch display the version 10.1. Documentation changes have been committed which make the main branch of the documentation no longer proper for 10.1, so the version the main branch of the documentation displays should be 10.2.

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators:
   http://issues.apache.org/jira/secure/Administrators.jspa
-
For more information on JIRA, see:
   http://www.atlassian.com/software/jira


[jira] Commented: (DERBY-936) Main branch docs display version as 10.1, should be 10.2.

Posted by "Andrew McIntyre (JIRA)" <de...@db.apache.org>.
    [ http://issues.apache.org/jira/browse/DERBY-936?page=comments#action_12423488 ] 
            
Andrew McIntyre commented on DERBY-936:
---------------------------------------

The edits in the _v2 patch all look good to me. +1 to commit.

conref references are just URLs. Since the reference is replaced at build time with the content of the referred-to URL, it is safe to use a relative path for the URL. 

This means that we could remove the various *conref.dita and keep one file for these, perhaps at the src level. References to this file would look like <ph conref="../conrefs.dita#topic"></ph> in the DITA source.

That's outside the scope of this issue, but it seems like a good idea, so I'll file a separate JIRA issue for it.



> Main branch docs display version as 10.1, should be 10.2.
> ---------------------------------------------------------
>
>                 Key: DERBY-936
>                 URL: http://issues.apache.org/jira/browse/DERBY-936
>             Project: Derby
>          Issue Type: Improvement
>          Components: Documentation
>    Affects Versions: 10.0.2.0
>            Reporter: Andrew McIntyre
>         Assigned To: Rick Hillegas
>            Priority: Blocker
>             Fix For: 10.2.0.0
>
>         Attachments: derby-936_v02.diff, derby936.diff, htmloutput.tar.gz
>
>
> Currently the output for the PDF and HTML Book formats of the manuals on the main branch display the version 10.1. Documentation changes have been committed which make the main branch of the documentation no longer proper for 10.1, so the version the main branch of the documentation displays should be 10.2.

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators: http://issues.apache.org/jira/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira

        

[jira] Updated: (DERBY-936) Main branch docs display version as 10.1, should be 10.2.

Posted by "Rick Hillegas (JIRA)" <de...@db.apache.org>.
     [ http://issues.apache.org/jira/browse/DERBY-936?page=all ]

Rick Hillegas updated DERBY-936:
--------------------------------

    Priority: Blocker  (was: Major)

> Main branch docs display version as 10.1, should be 10.2.
> ---------------------------------------------------------
>
>          Key: DERBY-936
>          URL: http://issues.apache.org/jira/browse/DERBY-936
>      Project: Derby
>         Type: Improvement

>   Components: Documentation
>     Versions: 10.0.2.0
>     Reporter: Andrew McIntyre
>     Priority: Blocker
>  Attachments: derby936.diff
>
> Currently the output for the PDF and HTML Book formats of the manuals on the main branch display the version 10.1. Documentation changes have been committed which make the main branch of the documentation no longer proper for 10.1, so the version the main branch of the documentation displays should be 10.2.

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators:
   http://issues.apache.org/jira/secure/Administrators.jspa
-
For more information on JIRA, see:
   http://www.atlassian.com/software/jira


[jira] Assigned: (DERBY-936) Main branch docs display version as 10.1, should be 10.2.

Posted by "Rick Hillegas (JIRA)" <de...@db.apache.org>.
     [ http://issues.apache.org/jira/browse/DERBY-936?page=all ]

Rick Hillegas reassigned DERBY-936:
-----------------------------------

    Assignee: Rick Hillegas

> Main branch docs display version as 10.1, should be 10.2.
> ---------------------------------------------------------
>
>                 Key: DERBY-936
>                 URL: http://issues.apache.org/jira/browse/DERBY-936
>             Project: Derby
>          Issue Type: Improvement
>          Components: Documentation
>    Affects Versions: 10.0.2.0
>            Reporter: Andrew McIntyre
>         Assigned To: Rick Hillegas
>            Priority: Blocker
>             Fix For: 10.2.0.0
>
>         Attachments: derby936.diff
>
>
> Currently the output for the PDF and HTML Book formats of the manuals on the main branch display the version 10.1. Documentation changes have been committed which make the main branch of the documentation no longer proper for 10.1, so the version the main branch of the documentation displays should be 10.2.

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators: http://issues.apache.org/jira/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira

        

[jira] Commented: (DERBY-936) Main branch docs display version as 10.1, should be 10.2.

Posted by "Andrew McIntyre (JIRA)" <de...@db.apache.org>.
    [ http://issues.apache.org/jira/browse/DERBY-936?page=comments#action_12420444 ] 

Andrew McIntyre commented on DERBY-936:
---------------------------------------

I would say  this is a definite must-fix for 10.2.  The docs need to say they are the correct version. A simple search-and-replace will not work, as noted earlier in the issue. Whoever actually takes this on will need to consider each instance of '10.1' individually. 

> Main branch docs display version as 10.1, should be 10.2.
> ---------------------------------------------------------
>
>          Key: DERBY-936
>          URL: http://issues.apache.org/jira/browse/DERBY-936
>      Project: Derby
>         Type: Improvement

>   Components: Documentation
>     Versions: 10.0.2.0
>     Reporter: Andrew McIntyre
>     Priority: Blocker
>      Fix For: 10.2.0.0
>  Attachments: derby936.diff
>
> Currently the output for the PDF and HTML Book formats of the manuals on the main branch display the version 10.1. Documentation changes have been committed which make the main branch of the documentation no longer proper for 10.1, so the version the main branch of the documentation displays should be 10.2.

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators:
   http://issues.apache.org/jira/secure/Administrators.jspa
-
For more information on JIRA, see:
   http://www.atlassian.com/software/jira


[jira] Closed: (DERBY-936) Main branch docs display version as 10.1, should be 10.2.

Posted by "Rick Hillegas (JIRA)" <de...@db.apache.org>.
     [ http://issues.apache.org/jira/browse/DERBY-936?page=all ]

Rick Hillegas closed DERBY-936.
-------------------------------

    Resolution: Fixed

> Main branch docs display version as 10.1, should be 10.2.
> ---------------------------------------------------------
>
>                 Key: DERBY-936
>                 URL: http://issues.apache.org/jira/browse/DERBY-936
>             Project: Derby
>          Issue Type: Improvement
>          Components: Documentation
>    Affects Versions: 10.0.2.0
>            Reporter: Andrew McIntyre
>         Assigned To: Rick Hillegas
>            Priority: Blocker
>             Fix For: 10.2.0.0
>
>         Attachments: derby-936_v02.diff, derby936.diff, htmloutput.tar.gz
>
>
> Currently the output for the PDF and HTML Book formats of the manuals on the main branch display the version 10.1. Documentation changes have been committed which make the main branch of the documentation no longer proper for 10.1, so the version the main branch of the documentation displays should be 10.2.

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators: http://issues.apache.org/jira/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira

        

[jira] Commented: (DERBY-936) Main branch docs display version as 10.1, should be 10.2.

Posted by "Rick Hillegas (JIRA)" <de...@db.apache.org>.
    [ http://issues.apache.org/jira/browse/DERBY-936?page=comments#action_12423640 ] 
            
Rick Hillegas commented on DERBY-936:
-------------------------------------

Thanks for the quick review, Andrew. Committed at subversion revision 425729.

> Main branch docs display version as 10.1, should be 10.2.
> ---------------------------------------------------------
>
>                 Key: DERBY-936
>                 URL: http://issues.apache.org/jira/browse/DERBY-936
>             Project: Derby
>          Issue Type: Improvement
>          Components: Documentation
>    Affects Versions: 10.0.2.0
>            Reporter: Andrew McIntyre
>         Assigned To: Rick Hillegas
>            Priority: Blocker
>             Fix For: 10.2.0.0
>
>         Attachments: derby-936_v02.diff, derby936.diff, htmloutput.tar.gz
>
>
> Currently the output for the PDF and HTML Book formats of the manuals on the main branch display the version 10.1. Documentation changes have been committed which make the main branch of the documentation no longer proper for 10.1, so the version the main branch of the documentation displays should be 10.2.

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators: http://issues.apache.org/jira/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira

        

[jira] Updated: (DERBY-936) Main branch docs display version as 10.1, should be 10.2.

Posted by "Jeff Levitt (JIRA)" <de...@db.apache.org>.
     [ http://issues.apache.org/jira/browse/DERBY-936?page=all ]

Jeff Levitt updated DERBY-936:
------------------------------

    Attachment: derby936.diff

This patch is a simple search and replace of Version 10.1 in the docs and replacesit with 10.2.  Subsequent output html and PDF's will have version 10.2 displayed.

> Main branch docs display version as 10.1, should be 10.2.
> ---------------------------------------------------------
>
>          Key: DERBY-936
>          URL: http://issues.apache.org/jira/browse/DERBY-936
>      Project: Derby
>         Type: Improvement
>   Components: Documentation
>     Versions: 10.0.2.0
>     Reporter: Andrew McIntyre
>  Attachments: derby936.diff
>
> Currently the output for the PDF and HTML Book formats of the manuals on the main branch display the version 10.1. Documentation changes have been committed which make the main branch of the documentation no longer proper for 10.1, so the version the main branch of the documentation displays should be 10.2.

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators:
   http://issues.apache.org/jira/secure/Administrators.jspa
-
For more information on JIRA, see:
   http://www.atlassian.com/software/jira


[jira] Updated: (DERBY-936) Main branch docs display version as 10.1, should be 10.2.

Posted by "Rick Hillegas (JIRA)" <de...@db.apache.org>.
     [ http://issues.apache.org/jira/browse/DERBY-936?page=all ]

Rick Hillegas updated DERBY-936:
--------------------------------

    Fix Version: 10.2.0.0

Hi Jeff and Andrew,

What's the status of this issue? It would seem we need to fix this for 10.2.

> Main branch docs display version as 10.1, should be 10.2.
> ---------------------------------------------------------
>
>          Key: DERBY-936
>          URL: http://issues.apache.org/jira/browse/DERBY-936
>      Project: Derby
>         Type: Improvement

>   Components: Documentation
>     Versions: 10.0.2.0
>     Reporter: Andrew McIntyre
>     Priority: Blocker
>      Fix For: 10.2.0.0
>  Attachments: derby936.diff
>
> Currently the output for the PDF and HTML Book formats of the manuals on the main branch display the version 10.1. Documentation changes have been committed which make the main branch of the documentation no longer proper for 10.1, so the version the main branch of the documentation displays should be 10.2.

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators:
   http://issues.apache.org/jira/secure/Administrators.jspa
-
For more information on JIRA, see:
   http://www.atlassian.com/software/jira


[jira] Updated: (DERBY-936) Main branch docs display version as 10.1, should be 10.2.

Posted by "Rick Hillegas (JIRA)" <de...@db.apache.org>.
     [ http://issues.apache.org/jira/browse/DERBY-936?page=all ]

Rick Hillegas updated DERBY-936:
--------------------------------

    Attachment: derby-936_v02.diff
                htmloutput.tar.gz

Attaching patch derby-936_v02.diff and corresponding html output for all the documents, htmloutput.tar.gz. The patch makes the following changes:

1) Parameterizes most of the version references so that, in the future, we will only have to update the parameter declarations in the *conrefs files.

2) Hard-codes a 10.2 in the soft upgrade description in the Developer's Guide. This is because this page lists various catalog-changing features and the releases which introduced them. I'm punting on this one and leaving this as a reference which we'll have to think about for the next feature release.

3) Creates a parameter declaration file for the Working with Derby Guide so that version numbers can be substituted in that guide too.

4) I agonized a little about parameterizing the version references in the sysinfo example in the Tools Guide. In the end, I decided to parameterize these too. I don't have strong religion about this.

> Main branch docs display version as 10.1, should be 10.2.
> ---------------------------------------------------------
>
>                 Key: DERBY-936
>                 URL: http://issues.apache.org/jira/browse/DERBY-936
>             Project: Derby
>          Issue Type: Improvement
>          Components: Documentation
>    Affects Versions: 10.0.2.0
>            Reporter: Andrew McIntyre
>         Assigned To: Rick Hillegas
>            Priority: Blocker
>             Fix For: 10.2.0.0
>
>         Attachments: derby-936_v02.diff, derby936.diff, htmloutput.tar.gz
>
>
> Currently the output for the PDF and HTML Book formats of the manuals on the main branch display the version 10.1. Documentation changes have been committed which make the main branch of the documentation no longer proper for 10.1, so the version the main branch of the documentation displays should be 10.2.

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators: http://issues.apache.org/jira/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira

        

[jira] Commented: (DERBY-936) Main branch docs display version as 10.1, should be 10.2.

Posted by "Rick Hillegas (JIRA)" <de...@db.apache.org>.
    [ http://issues.apache.org/jira/browse/DERBY-936?page=comments#action_12423377 ] 
            
Rick Hillegas commented on DERBY-936:
-------------------------------------

I don't know the answer to Dan's question. Hopefully the tech writers can field this one.

It would be appealing if the documents shared a common file of parameters. Again, maybe the tech writers can help us understand why each document has its own file of parameters and why common parameters are duplicated across these files.


> Main branch docs display version as 10.1, should be 10.2.
> ---------------------------------------------------------
>
>                 Key: DERBY-936
>                 URL: http://issues.apache.org/jira/browse/DERBY-936
>             Project: Derby
>          Issue Type: Improvement
>          Components: Documentation
>    Affects Versions: 10.0.2.0
>            Reporter: Andrew McIntyre
>         Assigned To: Rick Hillegas
>            Priority: Blocker
>             Fix For: 10.2.0.0
>
>         Attachments: derby-936_v02.diff, derby936.diff, htmloutput.tar.gz
>
>
> Currently the output for the PDF and HTML Book formats of the manuals on the main branch display the version 10.1. Documentation changes have been committed which make the main branch of the documentation no longer proper for 10.1, so the version the main branch of the documentation displays should be 10.2.

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators: http://issues.apache.org/jira/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira