LinuxCommandLibrary

install-info

Update or create Info directory file

SYNOPSIS

install-info [--dir-file DIRFILE] [--info-file INFOFILE] [--entry MENUENTRY] [--delete] [--section SECTION] [--help] [--version]

PARAMETERS

--dir-file DIRFILE
    Specify the Info directory file to update. Defaults to /usr/share/info/dir.

--info-file INFOFILE
    Specify the Info file to install or delete. This file contains the documentation to be indexed.

--entry MENUENTRY
    Specify the menu entry to be added to the Info directory file. This is the name that will appear in the Info menu.

--delete
    Delete the specified Info file and its menu entry from the Info directory file.

--section SECTION
    Specify the section to install the info file into.

--help
    Display help information and exit.

--version
    Display version information and exit.

DESCRIPTION

The install-info command updates the index file used by the standalone GNU Info program. It adds or removes entries pointing to Info files, allowing Info to quickly locate and display documentation. Info files typically contain information about GNU software packages.

install-info reads a special file, often named 'dir' (or specified via the --dir-file option), that contains a list of Info file names and menu entries. It then updates the specified Info directory file (often /usr/share/info/dir) by adding or removing entries that link the named Info files to the specified menu items. This allows Info to quickly locate and display the relevant documentation. If the dir file is not specified or present then the command deletes the manual page specified in the info file.

This tool is critical for maintaining a well-organized and easily searchable collection of software documentation accessible through the Info reader.

USAGE EXAMPLES

1. Installing an Info File:
install-info --dir-file /usr/share/info/dir --info-file mypackage.info --entry "My Package"

This command adds an entry named "My Package" to the /usr/share/info/dir file, pointing to the documentation located in mypackage.info.

2. Deleting an Info File:
install-info --dir-file /usr/share/info/dir --info-file mypackage.info --delete

This command removes the entry for mypackage.info from the /usr/share/info/dir file.

3. Installing an Info file with sections
install-info --dir-file /usr/share/info/dir --info-file mypackage.info --section PackageGroup --entry "My Package"

This command adds an entry named "My Package" inside PackageGroup to the /usr/share/info/dir file, pointing to the documentation located in mypackage.info.

SEE ALSO

info(1), makeinfo(1)

Copied to clipboard