<?xml version="1.0" encoding="UTF-8" standalone="yes" ?>
<!DOCTYPE bugzilla SYSTEM "https://bugzilla.yoctoproject.org/page.cgi?id=bugzilla.dtd">

<bugzilla version="5.0.6"
          urlbase="https://bugzilla.yoctoproject.org/"
          
          maintainer="it-coreprojects-helpdesk@linuxfoundation.org"
>

    <bug>
          <bug_id>7089</bug_id>
          
          <creation_ts>2014-12-18 16:43:31 +0000</creation_ts>
          <short_desc>URL field incomplete in section  4.2.2.1.3.1</short_desc>
          <delta_ts>2015-01-23 21:59:13 +0000</delta_ts>
          <reporter_accessible>1</reporter_accessible>
          <cclist_accessible>1</cclist_accessible>
          <classification_id>9</classification_id>
          <classification>Documentation</classification>
          <product>ADT Manual</product>
          <component>SDK</component>
          <version>1.7</version>
          <rep_platform>x86</rep_platform>
          <op_sys>Multiple</op_sys>
          <bug_status>RESOLVED</bug_status>
          <resolution>FIXED</resolution>
          
          
          <bug_file_loc></bug_file_loc>
          <status_whiteboard>23 January 2015: IN PROGRESS REVIEW</status_whiteboard>
          <keywords></keywords>
          <priority>Medium</priority>
          <bug_severity>normal</bug_severity>
          <target_milestone>1.7.2</target_milestone>
          
          
          <everconfirmed>1</everconfirmed>
          <reporter name="Jan-Simon Moeller">dl9pf</reporter>
          <assigned_to name="Scott Rifenbark">srifenbark</assigned_to>
          <cc>poky.doc.watcher</cc>
    
    <cc>poky.watcher</cc>
    
    <cc>richard.purdie</cc>
    
    <cc>sgw</cc>
    
    <cc>srifenbark</cc>
          
          
          <cf_os>---</cf_os>
          <cf_regression_type>---</cf_regression_type>
          
          <cf_docchange>Done (doc changes complete)</cf_docchange>

      

      

      

          <comment_sort_order>oldest_to_newest</comment_sort_order>  
          <long_desc isprivate="0" >
    <commentid>47621</commentid>
    <comment_count>0</comment_count>
    <who name="Jan-Simon Moeller">dl9pf</who>
    <bug_when>2014-12-18 16:43:31 +0000</bug_when>
    <thetext>4.2.2.1.3.1. Installing the Pre-built Plug-in from the Yocto Project Eclipse Update Site¶

To install the Eclipse Yocto Plug-in from the update site, follow these steps:

    Start up the Eclipse IDE.

    In Eclipse, select &quot;Install New Software&quot; from the &quot;Help&quot; menu.

    Click &quot;Add...&quot; in the &quot;Work with:&quot; area.

    Enter /releases/eclipse-plugin//kepler in the URL field and provide a 

         ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

This does not work as it expands to file:///releases/eclipse-plugin//kepler</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>47622</commentid>
    <comment_count>1</comment_count>
    <who name="Jan-Simon Moeller">dl9pf</who>
    <bug_when>2014-12-18 16:46:24 +0000</bug_when>
    <thetext>Direct link
http://www.yoctoproject.org/docs/1.7.1/dev-manual/dev-manual.html#new-software</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>47915</commentid>
    <comment_count>2</comment_count>
    <who name="Scott Rifenbark">srifenbark</who>
    <bug_when>2015-01-14 23:21:51 +0000</bug_when>
    <thetext>Hi, 

This error you found is a result of bug 7134, which has to do with broken ENTITY variable expansion.  Here is the string from the XML source file responsible for printing out that path in the HTML manual:

   &amp;ECLIPSE_DL_PLUGIN_URL;/kepler

Note that the string has the ENTITY variable ECLIPSE_DL_PLUGIN_URL.  To further complicate matters, the ENTITY EXLIPSE_DL_PLUGIN_URL variable is further defined using two additional ENTITY variables:

   &amp;YOCTO_DL_URL;/releases/eclipse-plugin/&amp;DISTRO;

So, in a nutshell, for the proper path to be expanded in the HTML version of the document, three ENTITY variables must resolve.  Proper expansion of the pathname would be as follows:

   http://downloads.yoctoproject.org/releases/eclipse-plugin/1.7/kepler

However, bug 7134 is not expanding these three ENTITY variables so you are seeing this:

   /releases/eclipse-plugin//kepler

So, for right now, the XML is correct in the manuals.  We are waiting on resolution of bug 7134 to make these issues go away. 

Stay tuned. 

Thanks, 
Scott</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>48269</commentid>
    <comment_count>3</comment_count>
    <who name="Scott Rifenbark">srifenbark</who>
    <bug_when>2015-01-23 21:59:13 +0000</bug_when>
    <thetext>Hi, 

The work-around for bug 7134 is in place now and I can generate manuals whose ENTITY variables properly resolve.  I have re-published the Yocto Project 1.7.1 and 1.7 versions of the manuals to the website with proper expansions.  To see the updated version for the section reported here, click on that link in Comment 1.

Thanks, 
Scott</thetext>
  </long_desc>
      
      

    </bug>

</bugzilla>