<html>
<head>
<base href="https://bugs.llvm.org/">
</head>
<body><table border="1" cellspacing="0" cellpadding="8">
<tr>
<th>Bug ID</th>
<td><a class="bz_bug_link
bz_status_NEW "
title="NEW - :manpage: directive uses direct url to llvm.org not relational one"
href="https://bugs.llvm.org/show_bug.cgi?id=42505">42505</a>
</td>
</tr>
<tr>
<th>Summary</th>
<td>:manpage: directive uses direct url to llvm.org not relational one
</td>
</tr>
<tr>
<th>Product</th>
<td>Documentation
</td>
</tr>
<tr>
<th>Version</th>
<td>trunk
</td>
</tr>
<tr>
<th>Hardware</th>
<td>All
</td>
</tr>
<tr>
<th>OS</th>
<td>All
</td>
</tr>
<tr>
<th>Status</th>
<td>NEW
</td>
</tr>
<tr>
<th>Severity</th>
<td>enhancement
</td>
</tr>
<tr>
<th>Priority</th>
<td>P
</td>
</tr>
<tr>
<th>Component</th>
<td>General docs
</td>
</tr>
<tr>
<th>Assignee</th>
<td>unassignedbugs@nondot.org
</td>
</tr>
<tr>
<th>Reporter</th>
<td>alexbrachetmialot@gmail.com
</td>
</tr>
<tr>
<th>CC</th>
<td>llvm-bugs@lists.llvm.org
</td>
</tr></table>
<p>
<div>
<pre>I want to preface this by saying I know very little about reStructuredText or
webpages and the structure of websites, please bear with me on my description
here. Also, if there were a severity level less than enhancement it would be
that.
When using the `:manpage:` directive in .rst files it creates links which are
relative to llvm.org not the local directory. For example, when you build the
docs, the links (most of them) the links are relative to docs/ so when you
click around you are seeing your documentation. But links created from
`:manpage:` are linked to llvm.org/docs/CommandGuide see here
<a href="https://github.com/llvm/llvm-project/blob/master/llvm/docs/conf.py#L281">https://github.com/llvm/llvm-project/blob/master/llvm/docs/conf.py#L281</a>.
This isn't just a very small inconvenience (emphasis on small) for those
building the docs locally, it means the documentation can never be hosted by
either someone other than llvm, or would be annoying if the documentation moves
from llvm.org/docs/CommandGuide/ to somewhere else on llvm.org.</pre>
</div>
</p>
<hr>
<span>You are receiving this mail because:</span>
<ul>
<li>You are on the CC list for the bug.</li>
</ul>
</body>
</html>