The trivial-open-browser Reference Manual

This is the trivial-open-browser Reference Manual, version 1.0, generated automatically by Declt version 4.0 beta 2 "William Riker" on Fri May 15 13:08:46 2026 GMT+0.

Table of Contents


1 Introduction


2 Systems

The main system appears first, followed by any subsystem dependency.


2.1 trivial-open-browser

Open the browser to a URL, on any system.

Maintainer

Ralph Schleicher <>

Author

Fernando Borretti <>

Home Page

https://github.com/ralph-schleicher/trivial-open-browser

License

MIT

Version

1.0

Dependencies
  • trivial-features (system).
  • uiop (system).
Source

trivial-open-browser.asd.

Child Component

trivial-open-browser.lisp (file).


3 Files

Files are sorted by type and then listed depth-first from the systems components trees.


3.1 Lisp


3.1.1 trivial-open-browser/trivial-open-browser.asd

Source

trivial-open-browser.asd.

Parent Component

trivial-open-browser (system).

ASDF Systems

trivial-open-browser.


3.1.2 trivial-open-browser/trivial-open-browser.lisp

Source

trivial-open-browser.asd.

Parent Component

trivial-open-browser (system).

Packages

trivial-open-browser.

Public Interface

4 Packages

Packages are listed by definition order.


4.1 trivial-open-browser

Open a file or URL.

Source

trivial-open-browser.lisp.

Use List

common-lisp.

Public Interface

5 Definitions

Definitions are sorted by export status, category, package, and then by lexicographic order.


5.1 Public Interface


5.1.1 Special variables

Special Variable: *browser-function*

The function that gets called with the file name or URL as argument. Default is the ‘open-browser-through-shell’ function, which see.

Package

trivial-open-browser.

Source

trivial-open-browser.lisp.

Special Variable: *browser-program*

The shell command to open a file or URL.

Value has to be a string or ‘nil’. Default is ‘start’ for Windows, ‘open’ for Darwin/macOS, and ‘xdg-open’ otherwise.

Package

trivial-open-browser.

Source

trivial-open-browser.lisp.


5.1.2 Ordinary functions

Function: open-browser (location)

Open a file or URL.

Argument LOCATION can be a file name or URL (a string). If LOCATION is a file name containing spaces, it must not be quoted.

Affected by the ‘*browser-function*’ special variable.

Package

trivial-open-browser.

Source

trivial-open-browser.lisp.

Function: open-browser-through-shell (location)

Run a shell command to open a file or URL.

Argument LOCATION can be a file name or URL (a string). If LOCATION is a file name containing spaces, it must not be quoted.

Return value is the exit code of the shell command, or ‘nil’ if ‘*browser-program*’ is ‘nil’. Please note that there is no guarantee that the file or URL is actually opened when the exit code indicates success.

Affected by the ‘*browser-program*’ special variable.

Package

trivial-open-browser.

Source

trivial-open-browser.lisp.


Appendix A Indexes


A.1 Concepts