vndb/manned
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Bunch of fixes

Browse source
This commit is contained in:
Yorhel 2022-01-10 20:05:09 +01:00
parent 997dd8728c
commit fa8e084879
4 changed files with 15 additions and 17 deletions
Download patch file Download diff file Expand all files Collapse all files

24
www/index.pl
View file

@ -380,7 +380,7 @@ TUWF::get '/info/about' => sub {
<dl>
<dt><code>/&lt;name>[.&lt;section>]</code> or <code>/man/&lt;name>[.&lt;section>]</code></dt><dd>
Will try to get the latest and most-close-to-upstream version of a man
page. That this will fetch the man page from any of the available
page. Note that this will fetch the man page from any of the available
systems, so may result in confusing scenarios for system-specific
documentation. I try to at least keep the selection algorithm stable and
deterministic, but can't provide any guarantees. Examples:<br>
@ -446,9 +446,8 @@ TUWF::get '/info/about' => sub {
For a particular version of a package (e.g. <a
href="/pkg/arch/core/coreutils/8.25-2">/pkg/arch/core/coreutils/8.25-2</a>).</dd>
</dl>
<p>Note that this site only indexes packages that actually have manual
pages; Linking to a package that doesn't have any will result in a 404
page.</p>
<p>This site only indexes packages that actually have manual pages,
linking to a package that doesn't have any will result in a 404 page.</p>
<h2 id="indexing">The indexing process</h2>
<p>
@ -535,9 +534,9 @@ TUWF::get '/info/about' => sub {
<br /><br />
The database schema is "documented" at <a
href="https://code.blicky.net/yorhel/manned/src/branch/master/sql/schema.sql">schema.sql</a>
in the git repo. Note that these dumps don't constitute a stable API and,
while this won't happen frequently, incompatible schema changes or Postgres
major version bumps will occassionally occur.
in the git repo. Keep in mind that these dumps don't constitute a stable
API and, while this won't happen frequently, incompatible schema changes
or Postgres major version bumps will occassionally occur.
</p>
<h2 id="other-systems">Other systems</h2>
@ -549,11 +548,10 @@ TUWF::get '/info/about' => sub {
binary package based approach, or are otherwise less easy to properly index.
<br /><br />
In general, systems that follow an entirely source-based distribution
approach can't be indexed without compiling everything. Since that is both
very resource-heavy and open to security issues, there are no plans to
include manuals from such systems at the moment. So unless someone comes
with a solution I hadn't thought of yet, there won't be any Gentoo manuals
here. :-(
approach can't be indexed without compiling everything. Since that is much
too resource-heavy, there are no plans to include manuals from such
systems at the moment. So unless someone comes with a solution I hadn't
thought of yet, there won't be any Gentoo manuals here. :-(
</p>
<h2 id="future-plans">Future plans</h2>
@ -1042,7 +1040,7 @@ TUWF::get qr{/pkg/([^/]+)/(.+)} => sub {
ul_ sub {
li_ sub {
# Only add the hash or locale to the URL if it's necessary to select the proper man page.
my $ext = $_->{needhash} ? '.'.shorthash_to_hex $_->{shorthash} : $_->{needlang} ? ".$_->{locale}" : '';
my $ext = $_->{needhash} ? '.'.shorthash_to_hex $_->{shorthash} : $_->{needlang} && length $_->{locale} ? ".$_->{locale}" : '';
a_ href => "/man$ext/$pkgpath/$sel->{version}/$_->{name}.$_->{section}", "$_->{name}($_->{section})";
b_ " $_->{locale}" if $_->{locale};
small_ " $_->{filename}";