BSP source re-organization status

[Sebastian Huber]

On 23/04/18 08:19, Chris Johns wrote:
> On 23/04/2018 15:42, Sebastian Huber wrote:
>> On 23/04/18 07:37, Sebastian Huber wrote:
>>> On 23/04/18 03:08, Chris Johns wrote:
>>>> On 20/04/2018 23:23, Sebastian Huber wrote:
>>>>> PS: How can I use brackets { and } in a :file:`...{...}...` directive?
>>>>>
>>>> Found and tested:
>>>>
>>>>    :file:`c/src/lib/libbsp/${{CPU}}/${{BSP}}/startup/bspstart.c`
>>>>
>>>> worked.
>>> No, this doesn't work:
>>>
>>> <p>The BSPs are all under the <a class="reference external"
>>> href="https://git.rtems.org/rtems/tree/bsps">bsps</a>
>>> directory.  The structure in this source subtree is:</p>
>>> <ul class="simple">
>>> <li><code class="file docutils literal"><span
>>> class="pre">bsps/shared</span></code></li>
>>> <li><code class="file docutils literal"><span
>>> class="pre">bsps/$</span><em><span class="pre">{RTEMS_CPU</span></em><span
>>> class="pre">}/shared</span></code></li>
>>> <li><code class="file docutils literal"><span
>>> class="pre">bsps/$</span><em><span class="pre">{RTEMS_CPU</span></em><span
>>> class="pre">}/$</span><em><span class="pre">{RTEMS_BSP_FAMILY</span></em><span
>>> class="pre">}</span></code></li>
>>> </ul>
>>>
>>> Please note the generation of "<em><span class="pre">...</em>" blocks.
>>>
> I get the same output and it looks OK. I had not checked the HTML.

The problem is that the closing } is not in the <em> tags. This looks odd.

>
> Do you have a different style sheet that is showing something different?
>
>>  From the sphinx documentation:
>>
>> "|:file:|
>>
>>     The name of a file or directory. Within the contents, you can use
>>     curly braces to indicate a “variable” part, for example:
>>
>>     ... is installed in :file:`/usr/lib/python2.{x}/site-packages` ...
>>
>>     In the built documentation, the |x| will be displayed differently to
>>     indicate that it is to be replaced by the Python minor version."
> I am sorry I do not know what else you can do.

I use now ``...``. The :file:`...{x}...` style is useless. It is hard to 
see in the HTML output and in the PDF output there is nothing to see at all.

-- 
Sebastian Huber, embedded brains GmbH

Address : Dornierstr. 4, D-82178 Puchheim, Germany
Phone   : +49 89 189 47 41-16
Fax     : +49 89 189 47 41-09
E-Mail  : sebastian.huber at embedded-brains.de
PGP     : Public key available on request.

Diese Nachricht ist keine geschäftliche Mitteilung im Sinne des EHUG.