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 "Nigel Owen (JIRA)" <ji...@apache.org> on 2010/08/07 16:15:16 UTC

[jira] Created: (DERBY-4763) The entity   isn't one of XML's predefined entities, if you want to use it in an XML document then you have to provide a DTD that declares what it means or use  

The entity &nbsp; isn't one of XML's predefined entities,  if you want to use it in an XML document then you have to provide a DTD that declares what it means or use &#160;
----------------------------------------------------------------------------------------------------------------------------------------------------------------------------

                 Key: DERBY-4763
                 URL: https://issues.apache.org/jira/browse/DERBY-4763
             Project: Derby
          Issue Type: Bug
          Components: Documentation
            Reporter: Nigel Owen


--- src/getstart/tgsrunningsysinfo.dita (revision 983219)
+++ src/getstart/tgsrunningsysinfo.dita (working copy)
@@ -20,7 +20,7 @@
 -->
 <task id="tgsrunningsysinfo" xml:lang="en-us">
 <title>Running sysinfo</title>
-<shortdesc>The <ph conref="../conrefs.dita#prod/productshortname"></ph>&nbsp;<codeph>sysinfo</codeph> tool
+<shortdesc>The <ph conref="../conrefs.dita#prod/productshortname"></ph>&#160;<codeph>sysinfo</codeph> tool
 displays information about your Java environment and your version of <ph conref="../conrefs.dita#prod/productshortname"></ph>.</shortdesc>
 <prolog><metadata>
 <keywords><indexterm><indexterm>Derby</indexterm>tools, sysinfo</indexterm>

-- 
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.


[jira] Commented: (DERBY-4763) The entity   isn't one of XML's predefined entities, if you want to use it in an XML document then you have to provide a DTD that declares what it means or use  

Posted by "Kim Haase (JIRA)" <ji...@apache.org>.
    [ https://issues.apache.org/jira/browse/DERBY-4763?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12896551#action_12896551 ] 

Kim Haase commented on DERBY-4763:
----------------------------------

Thanks for pointing this out. We have been recommending the use of a very old version of the DITA toolkit (1.1.2.1), and it does not seem to generate this warning, although it generates many others. If you are using the latest version and are successfully producing output, we're very interested in hearing about it. In past years we had problems with more recent versions, and no one has found the time to test a new Toolkit version in a while.

There have in the past been some problems generating correct output with &#160; if the user's LANG environment variable was not set quite right. (See DERBY-4547 for some history on this.) This is no longer a major issue, since we tell people how to set the variable on the http://db.apache.org/derby/manuals/dita.html page. This may be the time to switch from &nbsp; to &#160; if someone has the time to make this fix to the documentation.

> The entity &nbsp; isn't one of XML's predefined entities,  if you want to use it in an XML document then you have to provide a DTD that declares what it means or use &#160;
> ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------
>
>                 Key: DERBY-4763
>                 URL: https://issues.apache.org/jira/browse/DERBY-4763
>             Project: Derby
>          Issue Type: Bug
>          Components: Documentation
>            Reporter: Nigel Owen
>   Original Estimate: 0.08h
>  Remaining Estimate: 0.08h
>
> Not sure if this is an issue, and I note that nbsp is used in the following files as well. But I get the following warnings when doing a " ant pdf.getstart " and following the instructions at http://db.apache.org/derby/manuals/dita.html. Though I have got the latest Dita toolkit
>  [pipeline] tgsrunningdblook.dita Line 23:The entity "nbsp" was referenced, but not declared.
>  [pipeline] cwwdactivities.dita Line 33:The entity "nbsp" was referenced, but not declared.
>  [pipeline] twwdactivity1.dita Line 23:The entity "nbsp" was referenced, but not declared.
>  [pipeline] tgsrunningij.dita Line 23:The entity "nbsp" was referenced, but not declared.
>  [pipeline] twwdactivity1_Setup.dita Line 68:The entity "nbsp" was referenced, but not declared.
>  [pipeline] tgssetupverify.dita Line 52:The entity "nbsp" was referenced, but not declared.
> I altered it in tgsrunningsysinfo.dita to what I think it should be.
> --- src/getstart/tgsrunningsysinfo.dita (revision 983219)
> +++ src/getstart/tgsrunningsysinfo.dita (working copy)
> @@ -20,7 +20,7 @@
>  -->
>  <task id="tgsrunningsysinfo" xml:lang="en-us">
>  <title>Running sysinfo</title>
> -<shortdesc>The <ph conref="../conrefs.dita#prod/productshortname"></ph>&nbsp;<codeph>sysinfo</codeph> tool
> +<shortdesc>The <ph conref="../conrefs.dita#prod/productshortname"></ph>&#160;<codeph>sysinfo</codeph> tool
>  displays information about your Java environment and your version of <ph conref="../conrefs.dita#prod/productshortname"></ph>.</shortdesc>
>  <prolog><metadata>
>  <keywords><indexterm><indexterm>Derby</indexterm>tools, sysinfo</indexterm>

-- 
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.


[jira] Commented: (DERBY-4763) The entity   isn't one of XML's predefined entities, if you want to use it in an XML document then you have to provide a DTD that declares what it means or use  

Posted by "Kim Haase (JIRA)" <ji...@apache.org>.
    [ https://issues.apache.org/jira/browse/DERBY-4763?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12897271#action_12897271 ] 

Kim Haase commented on DERBY-4763:
----------------------------------

Thanks for testing the docs with the latest toolkit! Let us know if you run into any other incompatibilities.

Table links have been an issue for some time -- if the new toolkit doesn't solve that problem, it's not a regression.

I'm not sure what you mean by "address links"?

> The entity &nbsp; isn't one of XML's predefined entities,  if you want to use it in an XML document then you have to provide a DTD that declares what it means or use &#160;
> ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------
>
>                 Key: DERBY-4763
>                 URL: https://issues.apache.org/jira/browse/DERBY-4763
>             Project: Derby
>          Issue Type: Bug
>          Components: Documentation
>            Reporter: Nigel Owen
>   Original Estimate: 0.08h
>  Remaining Estimate: 0.08h
>
> Not sure if this is an issue, and I note that nbsp is used in the following files as well. But I get the following warnings when doing a " ant pdf.getstart " and following the instructions at http://db.apache.org/derby/manuals/dita.html. Though I have got the latest Dita toolkit
>  [pipeline] tgsrunningdblook.dita Line 23:The entity "nbsp" was referenced, but not declared.
>  [pipeline] cwwdactivities.dita Line 33:The entity "nbsp" was referenced, but not declared.
>  [pipeline] twwdactivity1.dita Line 23:The entity "nbsp" was referenced, but not declared.
>  [pipeline] tgsrunningij.dita Line 23:The entity "nbsp" was referenced, but not declared.
>  [pipeline] twwdactivity1_Setup.dita Line 68:The entity "nbsp" was referenced, but not declared.
>  [pipeline] tgssetupverify.dita Line 52:The entity "nbsp" was referenced, but not declared.
> I altered it in tgsrunningsysinfo.dita to what I think it should be.
> --- src/getstart/tgsrunningsysinfo.dita (revision 983219)
> +++ src/getstart/tgsrunningsysinfo.dita (working copy)
> @@ -20,7 +20,7 @@
>  -->
>  <task id="tgsrunningsysinfo" xml:lang="en-us">
>  <title>Running sysinfo</title>
> -<shortdesc>The <ph conref="../conrefs.dita#prod/productshortname"></ph>&nbsp;<codeph>sysinfo</codeph> tool
> +<shortdesc>The <ph conref="../conrefs.dita#prod/productshortname"></ph>&#160;<codeph>sysinfo</codeph> tool
>  displays information about your Java environment and your version of <ph conref="../conrefs.dita#prod/productshortname"></ph>.</shortdesc>
>  <prolog><metadata>
>  <keywords><indexterm><indexterm>Derby</indexterm>tools, sysinfo</indexterm>

-- 
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.


[jira] Commented: (DERBY-4763) The entity   isn't one of XML's predefined entities, if you want to use it in an XML document then you have to provide a DTD that declares what it means or use  

Posted by "Nigel Owen (JIRA)" <ji...@apache.org>.
    [ https://issues.apache.org/jira/browse/DERBY-4763?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12897229#action_12897229 ] 

Nigel Owen commented on DERBY-4763:
-----------------------------------

I was  looking at this to get a better understanding of DITA, I learn better when I am trying to fix a problem :) so I will look at porting this to the latest toolkit, it should be pretty simple, there is just an issue with table links I think but it does build. 

Will let you know when I have it working completely under the latest toolkit (you can let me know if you still want it then) this may be awhile as work lately is pretty busy.
 
And my LANG variable is fine :) 

$ echo $LANG
en_US.UTF-8



> The entity &nbsp; isn't one of XML's predefined entities,  if you want to use it in an XML document then you have to provide a DTD that declares what it means or use &#160;
> ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------
>
>                 Key: DERBY-4763
>                 URL: https://issues.apache.org/jira/browse/DERBY-4763
>             Project: Derby
>          Issue Type: Bug
>          Components: Documentation
>            Reporter: Nigel Owen
>   Original Estimate: 0.08h
>  Remaining Estimate: 0.08h
>
> Not sure if this is an issue, and I note that nbsp is used in the following files as well. But I get the following warnings when doing a " ant pdf.getstart " and following the instructions at http://db.apache.org/derby/manuals/dita.html. Though I have got the latest Dita toolkit
>  [pipeline] tgsrunningdblook.dita Line 23:The entity "nbsp" was referenced, but not declared.
>  [pipeline] cwwdactivities.dita Line 33:The entity "nbsp" was referenced, but not declared.
>  [pipeline] twwdactivity1.dita Line 23:The entity "nbsp" was referenced, but not declared.
>  [pipeline] tgsrunningij.dita Line 23:The entity "nbsp" was referenced, but not declared.
>  [pipeline] twwdactivity1_Setup.dita Line 68:The entity "nbsp" was referenced, but not declared.
>  [pipeline] tgssetupverify.dita Line 52:The entity "nbsp" was referenced, but not declared.
> I altered it in tgsrunningsysinfo.dita to what I think it should be.
> --- src/getstart/tgsrunningsysinfo.dita (revision 983219)
> +++ src/getstart/tgsrunningsysinfo.dita (working copy)
> @@ -20,7 +20,7 @@
>  -->
>  <task id="tgsrunningsysinfo" xml:lang="en-us">
>  <title>Running sysinfo</title>
> -<shortdesc>The <ph conref="../conrefs.dita#prod/productshortname"></ph>&nbsp;<codeph>sysinfo</codeph> tool
> +<shortdesc>The <ph conref="../conrefs.dita#prod/productshortname"></ph>&#160;<codeph>sysinfo</codeph> tool
>  displays information about your Java environment and your version of <ph conref="../conrefs.dita#prod/productshortname"></ph>.</shortdesc>
>  <prolog><metadata>
>  <keywords><indexterm><indexterm>Derby</indexterm>tools, sysinfo</indexterm>

-- 
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.


[jira] Updated: (DERBY-4763) The entity   isn't one of XML's predefined entities, if you want to use it in an XML document then you have to provide a DTD that declares what it means or use  

Posted by "Nigel Owen (JIRA)" <ji...@apache.org>.
     [ https://issues.apache.org/jira/browse/DERBY-4763?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Nigel Owen updated DERBY-4763:
------------------------------

    Description: 
Not sure if this is an issue, and I note that nbsp is used in the following files as well. But I get the following warnings when doing a " ant pdf.getstart " and following the instructions at http://db.apache.org/derby/manuals/dita.html. Though I have got the latest Dita toolkit

 [pipeline] tgsrunningdblook.dita Line 23:The entity "nbsp" was referenced, but not declared.
 [pipeline] cwwdactivities.dita Line 33:The entity "nbsp" was referenced, but not declared.
 [pipeline] twwdactivity1.dita Line 23:The entity "nbsp" was referenced, but not declared.
 [pipeline] tgsrunningij.dita Line 23:The entity "nbsp" was referenced, but not declared.
 [pipeline] twwdactivity1_Setup.dita Line 68:The entity "nbsp" was referenced, but not declared.
 [pipeline] tgssetupverify.dita Line 52:The entity "nbsp" was referenced, but not declared.

I altered it in tgsrunningsysinfo.dita to what I think it should be.

--- src/getstart/tgsrunningsysinfo.dita (revision 983219)
+++ src/getstart/tgsrunningsysinfo.dita (working copy)
@@ -20,7 +20,7 @@
 -->
 <task id="tgsrunningsysinfo" xml:lang="en-us">
 <title>Running sysinfo</title>
-<shortdesc>The <ph conref="../conrefs.dita#prod/productshortname"></ph>&nbsp;<codeph>sysinfo</codeph> tool
+<shortdesc>The <ph conref="../conrefs.dita#prod/productshortname"></ph>&#160;<codeph>sysinfo</codeph> tool
 displays information about your Java environment and your version of <ph conref="../conrefs.dita#prod/productshortname"></ph>.</shortdesc>
 <prolog><metadata>
 <keywords><indexterm><indexterm>Derby</indexterm>tools, sysinfo</indexterm>

  was:
--- src/getstart/tgsrunningsysinfo.dita (revision 983219)
+++ src/getstart/tgsrunningsysinfo.dita (working copy)
@@ -20,7 +20,7 @@
 -->
 <task id="tgsrunningsysinfo" xml:lang="en-us">
 <title>Running sysinfo</title>
-<shortdesc>The <ph conref="../conrefs.dita#prod/productshortname"></ph>&nbsp;<codeph>sysinfo</codeph> tool
+<shortdesc>The <ph conref="../conrefs.dita#prod/productshortname"></ph>&#160;<codeph>sysinfo</codeph> tool
 displays information about your Java environment and your version of <ph conref="../conrefs.dita#prod/productshortname"></ph>.</shortdesc>
 <prolog><metadata>
 <keywords><indexterm><indexterm>Derby</indexterm>tools, sysinfo</indexterm>


> The entity &nbsp; isn't one of XML's predefined entities,  if you want to use it in an XML document then you have to provide a DTD that declares what it means or use &#160;
> ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------
>
>                 Key: DERBY-4763
>                 URL: https://issues.apache.org/jira/browse/DERBY-4763
>             Project: Derby
>          Issue Type: Bug
>          Components: Documentation
>            Reporter: Nigel Owen
>   Original Estimate: 0.08h
>  Remaining Estimate: 0.08h
>
> Not sure if this is an issue, and I note that nbsp is used in the following files as well. But I get the following warnings when doing a " ant pdf.getstart " and following the instructions at http://db.apache.org/derby/manuals/dita.html. Though I have got the latest Dita toolkit
>  [pipeline] tgsrunningdblook.dita Line 23:The entity "nbsp" was referenced, but not declared.
>  [pipeline] cwwdactivities.dita Line 33:The entity "nbsp" was referenced, but not declared.
>  [pipeline] twwdactivity1.dita Line 23:The entity "nbsp" was referenced, but not declared.
>  [pipeline] tgsrunningij.dita Line 23:The entity "nbsp" was referenced, but not declared.
>  [pipeline] twwdactivity1_Setup.dita Line 68:The entity "nbsp" was referenced, but not declared.
>  [pipeline] tgssetupverify.dita Line 52:The entity "nbsp" was referenced, but not declared.
> I altered it in tgsrunningsysinfo.dita to what I think it should be.
> --- src/getstart/tgsrunningsysinfo.dita (revision 983219)
> +++ src/getstart/tgsrunningsysinfo.dita (working copy)
> @@ -20,7 +20,7 @@
>  -->
>  <task id="tgsrunningsysinfo" xml:lang="en-us">
>  <title>Running sysinfo</title>
> -<shortdesc>The <ph conref="../conrefs.dita#prod/productshortname"></ph>&nbsp;<codeph>sysinfo</codeph> tool
> +<shortdesc>The <ph conref="../conrefs.dita#prod/productshortname"></ph>&#160;<codeph>sysinfo</codeph> tool
>  displays information about your Java environment and your version of <ph conref="../conrefs.dita#prod/productshortname"></ph>.</shortdesc>
>  <prolog><metadata>
>  <keywords><indexterm><indexterm>Derby</indexterm>tools, sysinfo</indexterm>

-- 
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.


[jira] Issue Comment Edited: (DERBY-4763) The entity   isn't one of XML's predefined entities, if you want to use it in an XML document then you have to provide a DTD that declares what it means or use  

Posted by "Nigel Owen (JIRA)" <ji...@apache.org>.
    [ https://issues.apache.org/jira/browse/DERBY-4763?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12897229#action_12897229 ] 

Nigel Owen edited comment on DERBY-4763 at 8/11/10 8:20 AM:
------------------------------------------------------------

I was  looking at this to get a better understanding of DITA, I learn better when I am trying to fix a problem :) so I will look at porting this to the latest toolkit, it should be pretty simple, there is just an issue with table links I think but it does build. 

Will let you know when I have it working completely under the latest toolkit (you can let me know if you still want it then) this may be awhile as work lately is pretty busy.
 
And my LANG variable is fine :) 

$ echo $LANG
en_US.UTF-8

and on a linux system I just ran the command below on the src directory to search and replace and it seems to build fine, though the output pdf files are missing the address links.

 find . -name \*.dita -exec sed -i -e 's/&nbsp;/\&\#160\;/g'  {} \;

      was (Author: owenn):
    I was  looking at this to get a better understanding of DITA, I learn better when I am trying to fix a problem :) so I will look at porting this to the latest toolkit, it should be pretty simple, there is just an issue with table links I think but it does build. 

Will let you know when I have it working completely under the latest toolkit (you can let me know if you still want it then) this may be awhile as work lately is pretty busy.
 
And my LANG variable is fine :) 

$ echo $LANG
en_US.UTF-8


  
> The entity &nbsp; isn't one of XML's predefined entities,  if you want to use it in an XML document then you have to provide a DTD that declares what it means or use &#160;
> ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------
>
>                 Key: DERBY-4763
>                 URL: https://issues.apache.org/jira/browse/DERBY-4763
>             Project: Derby
>          Issue Type: Bug
>          Components: Documentation
>            Reporter: Nigel Owen
>   Original Estimate: 0.08h
>  Remaining Estimate: 0.08h
>
> Not sure if this is an issue, and I note that nbsp is used in the following files as well. But I get the following warnings when doing a " ant pdf.getstart " and following the instructions at http://db.apache.org/derby/manuals/dita.html. Though I have got the latest Dita toolkit
>  [pipeline] tgsrunningdblook.dita Line 23:The entity "nbsp" was referenced, but not declared.
>  [pipeline] cwwdactivities.dita Line 33:The entity "nbsp" was referenced, but not declared.
>  [pipeline] twwdactivity1.dita Line 23:The entity "nbsp" was referenced, but not declared.
>  [pipeline] tgsrunningij.dita Line 23:The entity "nbsp" was referenced, but not declared.
>  [pipeline] twwdactivity1_Setup.dita Line 68:The entity "nbsp" was referenced, but not declared.
>  [pipeline] tgssetupverify.dita Line 52:The entity "nbsp" was referenced, but not declared.
> I altered it in tgsrunningsysinfo.dita to what I think it should be.
> --- src/getstart/tgsrunningsysinfo.dita (revision 983219)
> +++ src/getstart/tgsrunningsysinfo.dita (working copy)
> @@ -20,7 +20,7 @@
>  -->
>  <task id="tgsrunningsysinfo" xml:lang="en-us">
>  <title>Running sysinfo</title>
> -<shortdesc>The <ph conref="../conrefs.dita#prod/productshortname"></ph>&nbsp;<codeph>sysinfo</codeph> tool
> +<shortdesc>The <ph conref="../conrefs.dita#prod/productshortname"></ph>&#160;<codeph>sysinfo</codeph> tool
>  displays information about your Java environment and your version of <ph conref="../conrefs.dita#prod/productshortname"></ph>.</shortdesc>
>  <prolog><metadata>
>  <keywords><indexterm><indexterm>Derby</indexterm>tools, sysinfo</indexterm>

-- 
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.