[infinispan-issues] [JBoss JIRA] (ISPN-1853) JMX documentation not packaged correctly

[Galder Zamarreño (JIRA)]

    [ https://issues.jboss.org/browse/ISPN-1853?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12665273#comment-12665273 ] 

Galder Zamarreño commented on ISPN-1853:
----------------------------------------

I've replicated the issue locally:

{code}[g at dhcp-144-239:~/Go/upstream/infinispan.git]% (master) fndany "*.html" | xargs ls -al | grep " 0 "
-rw-r--r--  1 g  staff        0 Feb  9 09:46 ./target/distribution/infinispan-5.9.0.ALPHA2/doc/5.9/apidocs/org/infinispan/affinity/KeyAffinityService.html
-rw-r--r--  1 g  staff        0 Feb  9 09:46 ./target/distribution/infinispan-5.9.0.ALPHA2/doc/5.9/apidocs/org/infinispan/affinity/
class-use/KeyAffinityServiceImpl.KeyGeneratorWorker.html
-rw-r--r--  1 g  staff        0 Feb  9 09:46 ./target/distribution/infinispan-5.9.0.ALPHA2/doc/5.9/apidocs/org/infinispan/affinity/
class-use/KeyGenerator.html
-rw-r--r--  1 g  staff        0 Feb  9 09:46 ./target/distribution/infinispan-5.9.0.ALPHA2/doc/5.9/apidocs/org/infinispan/affinity/
class-use/ListenerRegistration.html
-rw-r--r--  1 g  staff        0 Feb  9 09:46 ./target/distribution/infinispan-5.9.0.ALPHA2/doc/5.9/apidocs/org/infinispan/affinity/
class-use/RndKeyGenerator.html{code}

There're some errors earlier:

{code}mv: rename ./apidocs/allclasses-frame.html.tmp to ./apidocs/allclasses-frame.html: No such file or directory
mv: ./apidocs/allclasses-noframe.html.tmp: No such file or directory
mv: ./apidocs/constant-values.html.tmp: No such file or directory
mv: ./apidocs/deprecated-list.html.tmp: No such file or directory
mv: ./apidocs/help-doc.html.tmp: No such file or directory
mv: ./apidocs/index-all.html.tmp: No such file or directory
mv: rename ./apidocs/index.html.tmp to ./apidocs/index.html: No such file or directory
mv: rename ./apidocs/jmxComponents.html.tmp to ./apidocs/jmxComponents.html: No such file or directory
mv: rename ./apidocs/org/infinispan/AbstractDelegatingAdvancedCache.html.tmp to ./apidocs/org/infinispan/AbstractDelegatingAdvancedCache.html: No such file or directory
mv: rename ./apidocs/org/infinispan/AbstractDelegatingCache.html.tmp to ./apidocs/org/infinispan/AbstractDelegatingCache.html: 
No such file or directory
mv: rename ./apidocs/org/infinispan/AdvancedCache.html.tmp to ./apidocs/org/infinispan/AdvancedCache.html: 
No such file or directory
mv: rename ./apidocs/org/infinispan/affinity/class-use/KeyAffinityService.html.tmp to 
./apidocs/org/infinispan/affinity/class-use/KeyAffinityService.html: No such file or directory
mv: ./apidocs/org/infinispan/affinity/class-use/KeyAffinityServiceFactory.html.tmp: No such file or directory
mv: rename ./apidocs/org/infinispan/affinity/class-use/KeyAffinityServiceImpl.html.tmp to 
./apidocs/org/infinispan/affinity/class-use/KeyAffinityServiceImpl.html: No such file or directory
mv: ./apidocs/org/infinispan/affinity/class-use/KeyAffinityServiceImpl.KeyGeneratorWorker.html.tmp: No such file or directory
mv: ./apidocs/org/infinispan/affinity/class-use/KeyGenerator.html.tmp: No such file or directory
mv: ./apidocs/org/infinispan/affinity/class-use/ListenerRegistration.html.tmp: No such file or directory
mv: ./apidocs/org/infinispan/affinity/class-use/RndKeyGenerator.html.tmp: No such file or directory
mv: ./apidocs/org/infinispan/affinity/KeyAffinityService.html.tmp: No such file or directory
{code}

Seems like a problem with updateTracker.sh. Some of these I think are related to the fact that some HTML files do not have a tracker, and they don't produce an output, so they cannot be moved back. However, ./apidocs/org/infinispan/affinity/KeyAffinityService.html has a tracker:

{code}[g at dhcp-144-239:~/Go/upstream/infinispan.git]% (__temp_480C) grep UA-8601422-4 
target/site/apidocs/org/infinispan/affinity/KeyAffinityService.html 
-->                       <!-- Google Analytics --> <!-- <script type='text/javascript'> var gaJsHost = (("https:" == 
document.location.protocol) ? "https://ssl." : "http://www."); document.write(unescape("%3Cscript src='" + gaJsHost + "google-
analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E")); </script> <script type='text/javascript'> try { var pageTracker = 
_gat._getTracker("UA-8601422-4"); pageTracker._trackPageview(); } catch(err) {}</script></EM>{code}

So, dunno why the tracker update script had issues here.

Also, funnily enough there're mv errors about ./apidocs/org/infinispan/AdvancedCache.html. Javadoc generated fine the HTML:

{code}[g at dhcp-144-239:~/Go/upstream/infinispan.git]% (__temp_480C) grep UA-8601422-4 target/site/apidocs/org/infinispan/AdvancedCache.html 
-->                       <!-- Google Analytics --> <!-- <script type='text/javascript'> var gaJsHost = (("https:" == 
document.location.protocol) ? "https://ssl." : "http://www."); document.write(unescape("%3Cscript src='" + gaJsHost + "google-
analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E")); </script> <script type='text/javascript'> try { var pageTracker = 
_gat._getTracker("UA-8601422-4"); pageTracker._trackPageview(); } catch(err) {}</script></EM>
{code}

So, what about once it's been substituted? It's been substituted fine:

{code}[g at dhcp-144-239:~/Go/upstream/infinispan.git/target/distribution/infinispan-5.9.0.ALPHA2/doc/5.9/apidocs]% (__temp_480C) grep 
UA-8601422-2 org/infinispan/AdvancedCache.html
-->                       <!-- Google Analytics --> <!-- <script type='text/javascript'> var gaJsHost = (("https:" == 
document.location.protocol) ? "https://ssl." : "http://www."); document.write(unescape("%3Cscript src='" + gaJsHost + "google-
analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E")); </script> <script type='text/javascript'> try { var pageTracker = 
_gat._getTracker("UA-8601422-2"); pageTracker._trackPageview(); } catch(err) {}</script></EM>{code}
                
> JMX documentation not packaged correctly
> ----------------------------------------
>
>                 Key: ISPN-1853
>                 URL: https://issues.jboss.org/browse/ISPN-1853
>             Project: Infinispan
>          Issue Type: Bug
>          Components: JMX, reporting and management
>    Affects Versions: 5.1.1.FINAL
>            Reporter: Galder Zamarreño
>            Assignee: Galder Zamarreño
>             Fix For: 5.1.2.CR1, 5.1.2.FINAL, 5.2.0.ALPHA1
>
>
> http://docs.jboss.org/infinispan/5.1/apidocs/jmxComponents.html is empty.
> In the build, I have:
> {code}[g at dhcp-144-239:~/Go/upstream/old/infinispan-5.1.1.FINAL.git]% (master) fndany jmxComponents                                                                
> ./target/distribution/infinispan-5.1.1.FINAL/doc/5.1/apidocs/jmxComponents.html
> ./target/site/apidocs/jmxComponents.html{code}
> The first html file is empty and the second contains the right data. So, something goes wrong when building the distribution.

--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators: https://issues.jboss.org/secure/ContactAdministrators!default.jspa
For more information on JIRA, see: http://www.atlassian.com/software/jira