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 "Kristian Waagan (JIRA)" <ji...@apache.org> on 2010/11/17 13:01:13 UTC

[jira] Created: (DERBY-4906) HTML pages contain links to local content

HTML pages contain links to local content
-----------------------------------------

                 Key: DERBY-4906
                 URL: https://issues.apache.org/jira/browse/DERBY-4906
             Project: Derby
          Issue Type: Bug
          Components: Documentation, Web Site
    Affects Versions: 10.5.3.0, 10.4.2.0, 10.3.3.0, 10.2.2.0
            Reporter: Kristian Waagan


Some of the documentation published on the ASF web server contain links to local content.
For instance:
<link href="/Users/rh161140/derby/docs/10.4/out/reftemp/commonltr.css" type="text/css" rel="stylesheet" />

Two questions come to mind:
 a) How do we fix it?
 b) Why did it happen?

For (a), I say we can either redeploy the docs, or we can do a search and replace. The latter is clearly the easiest.

Regarding (b), I observe that the problem hasn't occurred for all docs builds. Are there weak spots in the instructions we can improve to make sure this won't happen again?

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


[jira] Commented: (DERBY-4906) HTML pages contain links to local content

Posted by "Kristian Waagan (JIRA)" <ji...@apache.org>.
    [ https://issues.apache.org/jira/browse/DERBY-4906?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12933005#action_12933005 ] 

Kristian Waagan commented on DERBY-4906:
----------------------------------------

Thanks, Kim.

Based on your information, I consider (b) to be fixed already.
I suppose that if we ever rebuild the docs for older versions (pre 10.6), we have to remember setting that property manually.

Or is it worth backporting the fix ?
I tried, and it work fine on 10.5 and 10.4.

> HTML pages contain links to local content
> -----------------------------------------
>
>                 Key: DERBY-4906
>                 URL: https://issues.apache.org/jira/browse/DERBY-4906
>             Project: Derby
>          Issue Type: Bug
>          Components: Documentation, Web Site
>    Affects Versions: 10.2.2.0, 10.3.3.0, 10.4.2.0, 10.5.3.0
>            Reporter: Kristian Waagan
>
> Some of the documentation published on the ASF web server contain links to local content.
> For instance:
> <link href="/Users/rh161140/derby/docs/10.4/out/reftemp/commonltr.css" type="text/css" rel="stylesheet" />
> Two questions come to mind:
>  a) How do we fix it?
>  b) Why did it happen?
> For (a), I say we can either redeploy the docs, or we can do a search and replace. The latter is clearly the easiest.
> Regarding (b), I observe that the problem hasn't occurred for all docs builds. Are there weak spots in the instructions we can improve to make sure this won't happen again?

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


[jira] Closed: (DERBY-4906) HTML pages contain links to local content

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

Kristian Waagan closed DERBY-4906.
----------------------------------

       Resolution: Fixed
    Fix Version/s: 10.2.2.0
                   10.3.3.0
                   10.4.2.0
                   10.5.3.0

Thanks, Lily.
I have now also fixed the css problem for the deployed 10.6 docs.
Closing issue.

> HTML pages contain links to local content
> -----------------------------------------
>
>                 Key: DERBY-4906
>                 URL: https://issues.apache.org/jira/browse/DERBY-4906
>             Project: Derby
>          Issue Type: Bug
>          Components: Documentation, Web Site
>    Affects Versions: 10.2.2.0, 10.3.3.0, 10.4.2.0, 10.5.3.0
>            Reporter: Kristian Waagan
>            Assignee: Kristian Waagan
>             Fix For: 10.5.3.0, 10.4.2.0, 10.3.3.0, 10.2.2.0
>
>
> Some of the documentation published on the ASF web server contain links to local content.
> For instance:
> <link href="/Users/rh161140/derby/docs/10.4/out/reftemp/commonltr.css" type="text/css" rel="stylesheet" />
> Two questions come to mind:
>  a) How do we fix it?
>  b) Why did it happen?
> For (a), I say we can either redeploy the docs, or we can do a search and replace. The latter is clearly the easiest.
> Regarding (b), I observe that the problem hasn't occurred for all docs builds. Are there weak spots in the instructions we can improve to make sure this won't happen again?

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


[jira] Updated: (DERBY-4906) HTML pages contain links to local content

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

Kristian Waagan updated DERBY-4906:
-----------------------------------

    Assignee: Kristian Waagan

I have now ported the fix all the way back to 10.2.
I have also corrected the links using search and replace (changes have not yet propagated to the web server).

When doing the above, I noticed that commonltr.css didn't exist in many of the deployments. It is included in the dev-docs (built by Hudson).
In any case, I copied it to all docs directories except 10.6 (missing write privilege).

> HTML pages contain links to local content
> -----------------------------------------
>
>                 Key: DERBY-4906
>                 URL: https://issues.apache.org/jira/browse/DERBY-4906
>             Project: Derby
>          Issue Type: Bug
>          Components: Documentation, Web Site
>    Affects Versions: 10.2.2.0, 10.3.3.0, 10.4.2.0, 10.5.3.0
>            Reporter: Kristian Waagan
>            Assignee: Kristian Waagan
>
> Some of the documentation published on the ASF web server contain links to local content.
> For instance:
> <link href="/Users/rh161140/derby/docs/10.4/out/reftemp/commonltr.css" type="text/css" rel="stylesheet" />
> Two questions come to mind:
>  a) How do we fix it?
>  b) Why did it happen?
> For (a), I say we can either redeploy the docs, or we can do a search and replace. The latter is clearly the easiest.
> Regarding (b), I observe that the problem hasn't occurred for all docs builds. Are there weak spots in the instructions we can improve to make sure this won't happen again?

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


[jira] Commented: (DERBY-4906) HTML pages contain links to local content

Posted by "Lily Wei (JIRA)" <ji...@apache.org>.
    [ https://issues.apache.org/jira/browse/DERBY-4906?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12933930#action_12933930 ] 

Lily Wei commented on DERBY-4906:
---------------------------------

Thanks, Kristian. The write privilege for 10.6 should be there now.

> HTML pages contain links to local content
> -----------------------------------------
>
>                 Key: DERBY-4906
>                 URL: https://issues.apache.org/jira/browse/DERBY-4906
>             Project: Derby
>          Issue Type: Bug
>          Components: Documentation, Web Site
>    Affects Versions: 10.2.2.0, 10.3.3.0, 10.4.2.0, 10.5.3.0
>            Reporter: Kristian Waagan
>            Assignee: Kristian Waagan
>
> Some of the documentation published on the ASF web server contain links to local content.
> For instance:
> <link href="/Users/rh161140/derby/docs/10.4/out/reftemp/commonltr.css" type="text/css" rel="stylesheet" />
> Two questions come to mind:
>  a) How do we fix it?
>  b) Why did it happen?
> For (a), I say we can either redeploy the docs, or we can do a search and replace. The latter is clearly the easiest.
> Regarding (b), I observe that the problem hasn't occurred for all docs builds. Are there weak spots in the instructions we can improve to make sure this won't happen again?

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


[jira] Commented: (DERBY-4906) HTML pages contain links to local content

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

Kim Haase commented on DERBY-4906:
----------------------------------

It might save some headaches if the fix were backported. You know best how far back would be necessary or useful. 

> HTML pages contain links to local content
> -----------------------------------------
>
>                 Key: DERBY-4906
>                 URL: https://issues.apache.org/jira/browse/DERBY-4906
>             Project: Derby
>          Issue Type: Bug
>          Components: Documentation, Web Site
>    Affects Versions: 10.2.2.0, 10.3.3.0, 10.4.2.0, 10.5.3.0
>            Reporter: Kristian Waagan
>
> Some of the documentation published on the ASF web server contain links to local content.
> For instance:
> <link href="/Users/rh161140/derby/docs/10.4/out/reftemp/commonltr.css" type="text/css" rel="stylesheet" />
> Two questions come to mind:
>  a) How do we fix it?
>  b) Why did it happen?
> For (a), I say we can either redeploy the docs, or we can do a search and replace. The latter is clearly the easiest.
> Regarding (b), I observe that the problem hasn't occurred for all docs builds. Are there weak spots in the instructions we can improve to make sure this won't happen again?

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


[jira] Commented: (DERBY-4906) HTML pages contain links to local content

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

Kim Haase commented on DERBY-4906:
----------------------------------

Yes, the missing css files were another problem fixed by DERBY-4349 -- thanks for fixing the build.xml files to include them.

> HTML pages contain links to local content
> -----------------------------------------
>
>                 Key: DERBY-4906
>                 URL: https://issues.apache.org/jira/browse/DERBY-4906
>             Project: Derby
>          Issue Type: Bug
>          Components: Documentation, Web Site
>    Affects Versions: 10.2.2.0, 10.3.3.0, 10.4.2.0, 10.5.3.0
>            Reporter: Kristian Waagan
>            Assignee: Kristian Waagan
>
> Some of the documentation published on the ASF web server contain links to local content.
> For instance:
> <link href="/Users/rh161140/derby/docs/10.4/out/reftemp/commonltr.css" type="text/css" rel="stylesheet" />
> Two questions come to mind:
>  a) How do we fix it?
>  b) Why did it happen?
> For (a), I say we can either redeploy the docs, or we can do a search and replace. The latter is clearly the easiest.
> Regarding (b), I observe that the problem hasn't occurred for all docs builds. Are there weak spots in the instructions we can improve to make sure this won't happen again?

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


[jira] Commented: (DERBY-4906) HTML pages contain links to local content

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

Kim Haase commented on DERBY-4906:
----------------------------------

To prevent the stylesheet from being shown as an absolute path, the docs.properties file needs to contain the following line:

args.csspath=

DERBY-4349 added this line to the docs.properties file in the trunk. Before that, a release manager had to remember to add it. This meant that many doc releases and the latest alpha docs contained an absolute pathname. 

It would be good to clean up those that still have this.

> HTML pages contain links to local content
> -----------------------------------------
>
>                 Key: DERBY-4906
>                 URL: https://issues.apache.org/jira/browse/DERBY-4906
>             Project: Derby
>          Issue Type: Bug
>          Components: Documentation, Web Site
>    Affects Versions: 10.2.2.0, 10.3.3.0, 10.4.2.0, 10.5.3.0
>            Reporter: Kristian Waagan
>
> Some of the documentation published on the ASF web server contain links to local content.
> For instance:
> <link href="/Users/rh161140/derby/docs/10.4/out/reftemp/commonltr.css" type="text/css" rel="stylesheet" />
> Two questions come to mind:
>  a) How do we fix it?
>  b) Why did it happen?
> For (a), I say we can either redeploy the docs, or we can do a search and replace. The latter is clearly the easiest.
> Regarding (b), I observe that the problem hasn't occurred for all docs builds. Are there weak spots in the instructions we can improve to make sure this won't happen again?

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