Search configuration - Githubissues

Grinnz / perldoc-browser

Perldoc Browser

https://perldoc.perl.org

Artistic License 2.0

55 stars 21 forks source link

Search configuration #34

Open Grinnz opened 4 years ago

Grinnz commented 4 years ago

Some aspects of search should be configurable, which can be provided behind a minimal icon to display the options.

Disable auto redirect of function/variable/document names
Limit to specific result type

matthewpersico commented 3 years ago

Default to a specific version of Perl. Local to the machine, not the user, so that I can set it one way at work and another way at home.

matthewpersico commented 3 years ago

Although this may be more of a config for the site https://perldoc.perl.org/ than the software...

Grinnz commented 3 years ago

It's unclear what "defaulting" to a version of Perl would mean. The "latest" URLs must always be the latest stable release to contain the expected content from links and web searches (not to mention that the new Fastly cache requires that each page must return the same content for all users). All other pages are the version of Perl they specify.

Grinnz commented 3 years ago

Perhaps the search configuration could specify which Perl version it is to search, and such a setting could be persisted as could the others. But it could be surprising in various instances. Will think on it.

matthewpersico commented 3 years ago

My bad. I was unclear. By “default” I mean I pick a version and you drop a cookie such that the next time I come back, I am in that version’s set of pages.

Grinnz commented 3 years ago

But what does that mean, to come back to the site? The site can be entered by URL or from another page's link. If you go to a URL without a version, it must be the latest Perl for the reasons I mentioned, and if you go to a URL with a version well it should be that version.

matthewpersico commented 3 years ago

And if I go to a url without a version AND I have a cookie with a particular version set, redirect to that version.

KES777 commented 1 year ago

It would be good feature. Today tried to search for PERL5DB variable, but got https://perldoc.perl.org/perl5db

Actually was looking for: https://perldoc.perl.org/perlrun#PERL5DB or https://perldoc.perl.org/perldebguts#Writing-Your-Own-Debugger

PS. Are there something perlenv? To get the list of all perl related environment variables.

Grinnz commented 1 year ago

The linked seciton of perlrun is the list of all perl related environment variables (though many will be relevant to modules rather than core itself, and will be documented in the appropriate module).