<?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>5772</bug_id>
          
          <creation_ts>2014-01-30 12:31:57 +0000</creation_ts>
          <short_desc>Add easily obtainable permalinks to the variables in the documentation</short_desc>
          <delta_ts>2014-06-25 12:22:53 +0000</delta_ts>
          <reporter_accessible>1</reporter_accessible>
          <cclist_accessible>1</cclist_accessible>
          <classification_id>9</classification_id>
          <classification>Documentation</classification>
          <product>Reference</product>
          <component>handbook</component>
          <version>unspecified</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>25 June 2014: RESOLVED</status_whiteboard>
          <keywords></keywords>
          <priority>Low</priority>
          <bug_severity>enhancement</bug_severity>
          <target_milestone>Future</target_milestone>
          
          
          <everconfirmed>1</everconfirmed>
          <reporter name="Laszlo Papp">lpapp</reporter>
          <assigned_to name="Scott Rifenbark">srifenbark</assigned_to>
          <cc>bluelightning</cc>
    
    <cc>jefro</cc>
    
    <cc>jessica.zhang</cc>
    
    <cc>mhalstead</cc>
    
    <cc>poky.doc.watcher</cc>
    
    <cc>poky.watcher</cc>
    
    <cc>ross.burton</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>40091</commentid>
    <comment_count>0</comment_count>
    <who name="Laszlo Papp">lpapp</who>
    <bug_when>2014-01-30 12:31:57 +0000</bug_when>
    <thetext>It is currently not possible to easily get permalinks for variables like this if one just opens up the reference documentation:

http://www.yoctoproject.org/docs/current/ref-manual/ref-manual.html#var-RM_OLD_IMAGE

It would be nice to get permalinks easily so that I can share it with others without guessing the url based on an existing link and/or gut feelings.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>40149</commentid>
    <comment_count>1</comment_count>
    <who name="Ross Burton">ross.burton</who>
    <bug_when>2014-01-31 22:12:04 +0000</bug_when>
    <thetext>http://doccookbook.sourceforge.net/html/en/dbc.html.permalinks.html looks like it should do the job.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>43487</commentid>
    <comment_count>2</comment_count>
    <who name="Scott Rifenbark">srifenbark</who>
    <bug_when>2014-05-22 08:42:54 +0000</bug_when>
    <thetext>Hi, 

I have been trying to implement this one and am running into some technical issues that I am having to go outside to &quot;expert&quot; circles from which to solicit help.  There seems to be a issue with creating the permalinks for section names.  I can do it for chapters and other items in the XML files but section names are currently giving me issues.  

I am seeking help in the docbook-apps mailing list, etc. to see if someone can help figure it out.

Scott</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>43811</commentid>
    <comment_count>3</comment_count>
    <who name="Scott Rifenbark">srifenbark</who>
    <bug_when>2014-06-06 14:26:37 +0000</bug_when>
    <thetext>Hi, 

I have solved the technical issues surrounding the permalinks for sections and chapters.  These versions of the manuals now have permalinks for all the chapters and section titles.  

http://www.yoctoproject.org/docs/1.7/adt-manual/adt-manual.html
http://www.yoctoproject.org/docs/1.7/bsp-guide/bsp-guide.html
http://www.yoctoproject.org/docs/1.7/dev-manual/dev-manual.html
http://www.yoctoproject.org/docs/1.7/kernel-dev/kernel-dev.html
http://www.yoctoproject.org/docs/1.7/profile-manual/profile-manual.html
http://www.yoctoproject.org/docs/1.7/ref-manual/ref-manual.html
http://www.yoctoproject.org/docs/1.7/yocto-project-qs/yocto-project-qs.html

The mega-manual also has permalinks:

http://www.yoctoproject.org/docs/1.7/mega-manual/mega-manual.html

The BitBake manual also now has permalinks:

http://www.yoctoproject.org/docs/1.7/bitbake-user-manual/bitbake-user-manual.html

For the moment, I am now trying to solve the technical problem stopping me from creating permalinks on individual glossary terms.  So, still in research/design mode for the bug.  However, you can see section permalinks here.

Thanks, 
Scott</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>44169</commentid>
    <comment_count>4</comment_count>
    <who name="Scott Rifenbark">srifenbark</who>
    <bug_when>2014-06-25 06:23:28 +0000</bug_when>
    <thetext>Hi, 

The final piece of this solution is complete.  All docs have permalinks for each section heading.  And, the Bitbake User Manual and YP Reference Manual additionally have permalinks for each variable description in the respective glossaries.

Marking the bug RESOLVED and putting the doc flag to &quot;Done&quot;.

Scott</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>44171</commentid>
    <comment_count>5</comment_count>
    <who name="Paul Eggleton">bluelightning</who>
    <bug_when>2014-06-25 09:32:11 +0000</bug_when>
    <thetext>So whilst this is a very useful addition, I think the permalink markers are a little distracting - would it be possible to tweak the stylesheet such that they only show up on hovering over the item, or perhaps make them less visible by making them grey instead of black?</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>44172</commentid>
    <comment_count>6</comment_count>
    <who name="Ross Burton">ross.burton</who>
    <bug_when>2014-06-25 09:40:07 +0000</bug_when>
    <thetext>What Paul said - appearing in grey on hover sounds like a great compromise.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>44173</commentid>
    <comment_count>7</comment_count>
    <who name="Scott Rifenbark">srifenbark</who>
    <bug_when>2014-06-25 09:43:11 +0000</bug_when>
    <thetext>I am not going to bother re-opening this.  I will look into fixing how these display.  

Thanks, 
Scott</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>44178</commentid>
    <comment_count>8</comment_count>
    <who name="Scott Rifenbark">srifenbark</who>
    <bug_when>2014-06-25 11:38:23 +0000</bug_when>
    <thetext>Hi, 

Here is just the BB manual with some different styles for the permalinks.  Let me know what you think.

http://www.yoctoproject.org/docs/1.7/bitbake-user-manual/bitbake-user-manual.html

Thanks, 
Scott</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>44179</commentid>
    <comment_count>9</comment_count>
    <who name="Ross Burton">ross.burton</who>
    <bug_when>2014-06-25 11:41:19 +0000</bug_when>
    <thetext>Would it be possible to hide the anchor entirely when the title/reference isn&apos;t hovered, and then show it in a mid-grey?  Oh, and add some left padding so it doesn&apos;t sit right up to the text.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>44180</commentid>
    <comment_count>10</comment_count>
    <who name="Laszlo Papp">lpapp</who>
    <bug_when>2014-06-25 11:42:21 +0000</bug_when>
    <thetext>Works for me.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>44181</commentid>
    <comment_count>11</comment_count>
    <who name="Scott Rifenbark">srifenbark</who>
    <bug_when>2014-06-25 12:22:53 +0000</bug_when>
    <thetext>Ross - I don&apos;t want to hide it entirely.  It is barely visible right now.  If you hide it completely then you don&apos;t know they are there unless you accidentally hover over it.

I also don&apos;t think we need space in there.

I am just leaving these as they are for now.

Scott</thetext>
  </long_desc>
      
      

    </bug>

</bugzilla>