Do you mean URLs for pages like this: https://www.gnu.org/software/guile/manual/html_node/Procedure-Index.html

-> yes, or https://practical-scheme.net/gauche/man/gauche-refe/index.html

And then URLs for individual symbols, e.g. https://www.gnu.org/software/guile/manual/html_node/Pairs.html#index-cons

-> yes, or https://practical-scheme.net/gauche/man/?p=

The individual symbol URLs are tricky. They often cannot be derived from the symbol name with a simple rule. It would be best to just have a lookup table manually mapping symbols to URLs. This lookup table could be auto-generated for implementations where we can get away with a simple rule.

-> yes, such as the Guile links. I know this only works in rare cases. But:

  1. if it works, it's a dead simple feature at least for some Scheme's, so why not use it where available; we'll have many such cases, where a feature only works for a few Schemes and if we only support the intersection of the features supported everywhere, our feature list will be quite small ;)
  2. for the cases where it does not work, we can use the fallback-search; admittedly also the fallback for that is not very good, but with some more effort we can hopefully come up with something better over time...


On 5/6/19 8:19 PM, Lassi Kortela wrote:

Thanks for keeping up the work! I didn't quite understand your request.

Do you mean URLs for pages like this: https://www.gnu.org/software/guile/manual/html_node/Procedure-Index.html

And then URLs for individual symbols, e.g. https://www.gnu.org/software/guile/manual/html_node/Pairs.html#index-cons

The individual symbol URLs are tricky. They often cannot be derived from the symbol name with a simple rule. It would be best to just have a lookup table manually mapping symbols to URLs. This lookup table could be auto-generated for implementations where we can get away with a simple rule.


On 06.05.2019 19.50, Frank Ruben wrote:

I'm still hacking together some primitive schemedoc-features end-to-end for some of the constellations described below, and two of the most simple to-add-features would be supporting URLs for a symbol index (below: 'scheme-index-url') and a query for a symbol (below: 'scheme-query-url') in the metadata files. These links would be defined per Scheme-implementation plus ideally one default for the cases where implementation-specific links are not defined.

The index-URL can simply be supported by the existing entry for documentation/web-url, the query-URL could be supported by something like documentation/query-url.

And to handle the generic entries not only for these, but also for other metadata items, we could add a file named e.g. generic.scm, that can be searched for fallback values.

OK?