GNU Software

https://www.gnu.org/software/
Admin
GNU Software refers to the collection of 100% free software packages that constitute the GNU...
Tokens:29,972,220
Snippets:381,153
Trust Score:10
Update:5 months ago
Show doc for...
Tokens:
Raw
### Example of screen setup

Source: https://www.gnu.org/software/grub/manual/grub-dev/grub-dev.html

Demonstrates how to initialize the video mode, with a fallback to a standard VGA mode if the initial attempt fails.

```APIDOC
## Example of screen setup

### Description
Example of setting up console viewport.

### Code Example
```c
grub_err_t rc;
/* Try to initialize video mode 1024 x 768 with direct RGB.  */
rc = grub_video_setup (1024, 768, GRUB_VIDEO_MODE_TYPE_RGB);
if (rc != GRUB_ERR_NONE)
{
  /* Fall back to standard VGA Index Color mode.  */
  rc = grub_video_setup (640, 480, GRUB_VIDEO_MODE_TYPE_INDEX);
  if (rc != GRUB_ERR_NONE)
  {
  /* Handle error.  */
  }
}
```
```

--------------------------------

### Native Install Setup

Source: https://www.gnu.org/software/hurd/microkernel/mach/gnumach/ports/xen.html

Environment variable and command to initiate the native installation process after starting the Hurd domain.

```bash
export TERM=mach
./native-install

```

--------------------------------

### Checkout Debian Installer Source Code

Source: https://www.gnu.org/software/hurd/community/gsoc/project_ideas/debian_installer.html

Use this command to get the source code of the Debian installer for Linux. This serves as a starting point to understand the build process.

```bash
svn co svn://svn.debian.org/d-i/trunk/installer/
```

--------------------------------

### Startup File Configuration Example

Source: https://www.gnu.org/software/proxyknife/manual/proxyknife.txt

Example of configuring proxy settings within a startup file using keyword=VALUE pairs. This allows for command-line argument reduction.

```ini
threads=20
```

--------------------------------

### Example of running a system image with QEMU

Source: https://www.gnu.org/software/hurd/community/weblogs.atom

Demonstrates a simplified command-line interaction for launching a Hurd system image using QEMU and setting up a custom environment.

```bash
$ qemu hurd-is-cool.img
$ login root
$ settrans cool /hurd/cool
$ ls cool
```

--------------------------------

### Reading Used Car Data with GET DATA

Source: https://www.gnu.org/software/pspp/manual/html_node/GET-DATA-_002fTYPE_003dTXT-_002fARRANGEMENT_003dFIXED.html

This example demonstrates how to read the 'cars.data' file using the GET DATA command with fixed arrangement. It specifies the file, starting case, and the column ranges and formats for each variable.

```spss-syntax
GET DATA /TYPE=TXT /FILE='cars.data' /ARRANGEMENT=FIXED /FIRSTCASE=2
        /VARIABLES=model 0-7 A
                   year 8-15 F
                   mileage 16-23 F
                   price 24-31 F
                   type 32-40 A
                   age 40-47 F.
```

--------------------------------

### Get nth CDR of a List

Source: https://www.gnu.org/software/emacs/manual/html_mono/eintr.html

The `nthcdr` function returns the result of applying `cdr` n times to a list. Example shows retrieving the list starting from the 4th element.

```emacs-lisp
(nthcdr 3 '(1 2 3 4 5 6 7))
```

--------------------------------

### Startup File Syntax Example

Source: https://www.gnu.org/software/proxyknife/manual/proxyknife.txt

Illustrates the basic syntax for creating a startup file for ProxyKnife, where each setting is on a new line in 'keyword=VALUE' format.

```ini
mytype=11
myhost=myproxy.com
myport=8080
myuser=userabc
mypass=pass12345
proxyknifeintype=1
proxyknifein=youth.bupt.edu.cn/proxy/
```

--------------------------------

### Example: Distributing Generated Man Pages

Source: https://www.gnu.org/software/automake/manual/automake.html

This setup demonstrates how to distribute a man page generated by `help2man` by including the generated file in the distribution. This avoids forcing users to install `help2man`.

```makefile
ంతరం
	$(program_transform_name) -t < $(srcdir)/foo.1 > $@

```

--------------------------------

### Install Info File with install-info Handling

Source: https://www.gnu.org/software/make/manual/make.html

Example rule for installing an Info file, including logic to prefer a local file over one in srcdir and to run the 'install-info' program if available. This ensures proper integration with the Info documentation system.

```makefile
do-install-info: foo.info installdirs
        $(NORMAL_INSTALL)
# Prefer an info file in . to one in srcdir.
        if test -f foo.info; then d=.; \
         else d="$(srcdir)"; fi; \
        $(INSTALL_DATA) $$d/foo.info \
          "$(DESTDIR)$(infodir)/foo.info"
# Run install-info only if it exists.
# Use 'if' instead of just prepending '-' to the
# line so we notice real errors from install-info.
# Use '$(SHELL) -c' because some shells do not
```

--------------------------------

### Create GRUB boot floppy and install

Source: https://www.gnu.org/software/grub/manual/legacy/Installing-GRUB-using-grub_002dinstall.html

This example demonstrates creating a bootable floppy disk with a filesystem, mounting it, installing GRUB to it using a specified root directory, and then unmounting it. This is useful for creating GRUB boot media.

```bash
# `mke2fs /dev/fd0`
# `mount -t ext2 /dev/fd0 /mnt`
# `grub-install --root-directory=/mnt fd0`
# `umount /mnt`
```

--------------------------------

### GRUB Install on Windows Volume (GUID)

Source: https://www.gnu.org/software/grub/manual/grub

Installs GRUB on Windows using UNC paths for volumes identified by GUID.

```bash
\\?\Volume{<GUID>}
```

```bash
\\?\Volume{17f34d50-cf64-4b02-800e-51d79c3aa2ff}
```

--------------------------------

### Install Strip Target Example

Source: https://www.gnu.org/software/make/manual/html_node/Standard-Targets.html

This example shows how the 'install-strip' target can leverage the 'install' target by setting the INSTALL_PROGRAM variable to strip executables.

```makefile
install-strip:
        $(MAKE) INSTALL_PROGRAM='$(INSTALL_PROGRAM) -s' \
                install
```

--------------------------------

### Example Configuration in configure.in

Source: https://www.gnu.org/software/autoconf-archive/ax_python_embed.html

Demonstrates how to set up Python usage within an application's configure.in file using the provided macros.

```autoconf
  AX_PYTHON_DEFAULT( )
  AX_PYTHON_ENABLE( )             # Optional
  AX_PYTHON_WITH( )               # Optional
  AX_PYTHON_PATH( )               # or AX_PYTHON_INSIST( )
  # if $PYTHON is not defined, then the following do nothing.
  AX_PYTHON_VERSION_ENSURE( [2.2] )
  AX_PYTHON_CSPEC
  AX_PYTHON_LSPEC

```

--------------------------------

### Incorrect Installation Path Example

Source: https://www.gnu.org/software/autoconf/manual/html_node/Automatic-Rule-Rewriting.html

An example of the incorrect installation path that results from the Solaris make expansion issue with VPATH and macro prerequisites.

```makefile
install -m 644 \
  `test -f ../pkg/src/f.h || \
    echo ../pkg/src/ \
  `../pkg/src/f.h \
  /usr/local/include/../pkg/src/f.h;
```

--------------------------------

### ProxyKnife Startup File Configuration Examples

Source: https://www.gnu.org/software/proxyknife/manual/html_node/Examples-of-startup-file.html

These examples show various configuration options for the ProxyKnife startup file, including logging, input sources, and output destinations. Uncomment and modify these lines to suit your needs.

```shell
#logfilename=.
#logfilename=proxyknife.log
#Reference
#define IN_FILE 0
#define IN_HTTP 1
#The type of proxyknifein or the mode of Proxyknife. 0:file,1:http.
#proxyknifeintype=0
#File mode:
#proxyknifein=proxylist
#Read from stdin:
#proxyknifein=-
#In url mode, only these two sites are tested. Select one of them.
#proxyknifein=proxylist.kmip.net/list.html
#proxyknifein=youth.bupt.edu.cn/proxy/
#Print the result to this file with full path
#proxyknifeout=proxyout
#Customize the request
#checkreqin=msn.req
```

--------------------------------

### Start example in Bayonne 1.0.x

Source: https://www.gnu.org/software/bayonne/examples.html

Starts a specific example script within a running Bayonne 1.0.x server. The script is identified by its number (e.g., 0). Output will appear in the Bayonne starting shell.

```bash
bayonne_control start 0 example
```

--------------------------------

### setup Method

Source: https://www.gnu.org/software/gnu-crypto/manual/api/gnu/crypto/prng/PBKDF2.html

Sets up the PBKDF2 object with the given attributes.

```APIDOC
## setup(Map attributes)

### Parameters
- **attributes** (Map) - A map of attributes to configure the PBKDF2 object.
```

--------------------------------

### Example of files installed in /usr/local/man/man1

Source: https://www.gnu.org/software/stow/manual/html_node/Introduction.html

This example shows a typical listing of man pages that might be installed in a directory before using a tool like Stow to manage them.

```text
a2p.1
ctags.1
emacs.1
etags.1
h2ph.1
perl.1
s2p.1

```

--------------------------------

### Creating and Mounting a Filesystem Image

Source: https://www.gnu.org/software/hurd/hurd/documentation/translators.html

This example demonstrates creating a filesystem image using `dd` and `mke2fs`, then mounting it with `settrans -c`. It also shows how to check translator status with `showtrans` and `ps Aux`, and how to modify options with `fsysopts`.

```bash
dd if=/dev/zero of=dummy.fs bs=1024k count=8; /sbin/mke2fs -E root_owner=$UID:0 dummy.fs
```

```bash
settrans -c dummy /hurd/ext2fs `pwd`/dummy.fs
```

```bash
ls dummy
```

```bash
ps Aux
```

```bash
fsysopts
```

```bash
settrans -g
```

--------------------------------

### SIP Witch Startup Log Example

Source: https://www.gnu.org/software/sipwitch/sipwitch-config.html

Example output from the SIP Witch daemon upon startup, showing loaded configuration and initialized services.

```text
 haakon@gnuru:~$ sipw -x9 -f
 sipwitch: loaded config from /home/haakon/.sipwitchrc
 sipwitch: new realm Home
 sipwitch: media proxy configured for 38 ports
 sipwitch: scanning config from /home/haakon/.sipwitch
 sipwitch: adding user haakon
 sipwitch: adding user david
 sipwitch: scanning users and groups
 sipwitch: startup
 sipwitch: starting registry; mapping 200 entries
 sipwitch: starting cdr thread
 sipwitch: starting sip stack; 200 maps and 2 threads at priority 1
 sipwitch: starting event thread 1
 sipwitch: starting event thread 2
 sipwitch: starting media proxy
 sipwitch: starting background thread
 sipwitch: starting media thread
 sipwitch: starting event dispatcher
 sipwitch: starting signal handler
 sipwitch: logfile: server starting 2011-06-07 23:00:18

```

--------------------------------

### Debian Installer Preseed Configuration Example

Source: https://www.gnu.org/software/hurd/open_issues/nightly_builds_deb_packages.html

This is an example of a preseed configuration used for Debian installer, specifying network mirror, suite, console, locale, keymap, and a URL for the preseed file. It's used to automate the installation process.

```shell
-append 'auto=true mirror/suite=sid console=com0 priority=critical
  locale=en_US keymap=us
  url=http://10.0.2.1//d-i-preseed-cfg/debian_sid_daily_hurd_lxde_preseed.cfg
  video=vesa:ywrap,mtrr vga=788 -- quiet'
```

--------------------------------

### Get Start Integer Value

Source: https://www.gnu.org/software/kawa/api/gnu/lists/Range.IntRange.html

Retrieves the starting integer value of the range.

```java
public int getStartInt()
```

--------------------------------

### setup

Source: https://www.gnu.org/software/gnu-crypto/manual/api/gnu/crypto/mode/ECB.html

The initialisation phase of the concrete mode implementation.

```APIDOC
## setup

### Description
The initialisation phase of the concrete mode implementation.

### Method
public void setup()

### Implements
BaseMode
```

--------------------------------

### Basic Installation Steps

Source: https://www.gnu.org/software/gengetopt/gengetopt.html

Standard procedure for building and installing Gengetopt from source code. Requires root privileges for 'make install' unless a custom prefix is specified.

```bash
cd <source code main directory>
./configure
make
make install
```

--------------------------------

### PSQL GET DATA Example

Source: https://www.gnu.org/software/pspp/manual/html_node/GET-DATA-_002fTYPE_003dPSQL.html

Provides a concrete example of the GET DATA command for importing data from a Postgres database. Ensure the connection string and SQL query are valid for your database.

```text
GET DATA /TYPE=PSQL
     /CONNECT='host=example.com port=5432 dbname=product user=fred passwd=xxxx'
     /SQL='select * from manufacturer'.
```

--------------------------------

### Install Ball and Paddle Package

Source: https://www.gnu.org/software/gsrc/gsrc.html

Example of installing a specific package named 'ballandpaddle'.

```bash
      $ make -C pkg/gnu/ballandpaddle install
```

--------------------------------

### Boot GNU System in QEMU (i686)

Source: https://www.gnu.org/software/gnuboot/events/fsf40/qemu/0002-manual-Document-how-to-use-GNU-Boot-with-QEMU.patch

This example shows the expected output after successfully booting a 32-bit GNU system in QEMU. It displays the login prompt, indicating the system is ready for user authentication.

```text
This is the GNU system.  Welcome.
guix-i686-linux login: _
```

--------------------------------

### QEMU Boot Output Example

Source: https://www.gnu.org/software/gnuboot/events/fsf40/qemu/0002-manual-Document-how-to-use-GNU-Boot-with-QEMU.patch

Example of the expected output after booting a GNU system in QEMU. It shows the login prompt.

```text
This is the GNU system.  Welcome.
guix-x86_64-linux login: _
```

--------------------------------

### Configure.ac for Installable libltdl

Source: https://www.gnu.org/software/libtool/manual/html_node/Distributing-libltdl.html

Example of how to embed an installable libltdl in your package using LT_INIT. Replace 'installable' with 'convenience' for the convenience variant.

```autoconf
LT_INIT([installable])
```

--------------------------------

### HURD IPC Virtual Copy Test Setup (Bash)

Source: https://www.gnu.org/software/hurd/open_issues/performance/ipc_virtual_copy.html

This command sequence is used to test I/O throughput by copying data from /dev/zero to /dev/null. It starts the `dd` process in the background, sends a SIGINFO signal after a delay to get a status update, and then terminates the process.

```bash
dd if=/dev/zero of=/dev/null bs=4k & p=$! && sleep 10 && kill -s INFO $p && sleep 1 && kill $p
```

```bash
dd if=/dev/zero of=/dev/null bs=4k & p=$! && sleep 10 && kill -s INFO $p && sleep 1 && kill $p
```

```bash
dd if=/dev/zero of=/dev/null bs=256k & p=$! && sleep 10 && kill -s INFO $p && sleep 1 && kill $p
```

```bash
dd if=/dev/zero of=/dev/null bs=256k & p=$! && sleep 10 && kill -s INFO $p && sleep 1 && kill $p
```

--------------------------------

### BasePad.setup() Method

Source: https://www.gnu.org/software/gnu-crypto/manual/api/gnu/crypto/pad/BasePad.html

An abstract method for subclasses to perform any additional checks or resource setup required before initialization.

```APIDOC
### setup
```java
public abstract void **setup**()
```
    
If any additional checks or resource setup must be done by the subclass, then this is the hook for it. This method will be called before the `init(int)` method returns.          
```

--------------------------------

### Example Configuration Files for --config-prefix

Source: https://www.gnu.org/software/gnuastro/manual/gnuastro.html

Demonstrates how to use --config-prefix to manage different configuration files with distinct option prefixes, preventing overwrites of common options.

```bash
cat nc-a.conf
a_tilesize=20,20
```

```bash
cat nc-b.conf
b_tilesize=40,40
```

--------------------------------

### Locate Tags Starting with 'set' or 'get'

Source: https://www.gnu.org/software/global/globaldoc_toc.html

Use a regular expression with the 'perl tag' command to locate tags whose names start with 'set' or 'get'. This allows for pattern-based tag searching.

```vimscript
:perl tag qw(^[sg]et)
```

--------------------------------

### gnu.crypto.pad.PKCS7.setup()

Source: https://www.gnu.org/software/gnu-crypto/manual/api/index-all.html

Initializes the PKCS#7 padding scheme.

```APIDOC
## gnu.crypto.pad.PKCS7.setup()

### Description
Initializes the PKCS#7 padding scheme.

### Method
Method in class gnu.crypto.pad.PKCS7
```

--------------------------------

### Default Header Installation in Automake

Source: https://www.gnu.org/software/automake/manual/html_node/Alternative.html

By default, an installable file specified in a subdirectory will have its directory name stripped before installation. This example shows a header file being installed as $(includedir)/stdio.h.

```automake
include_HEADERS = inc/stdio.h
```

--------------------------------

### Get Start Position

Source: https://www.gnu.org/software/kawa/api/gnu/lists/SubSequence.html

Returns the starting position of the subsequence. This method overrides the implementation in AbstractSequence.

```java
public int startPos()
```

--------------------------------

### gnu.crypto.pad.PKCS1_V1_5.setup()

Source: https://www.gnu.org/software/gnu-crypto/manual/api/index-all.html

Initializes the PKCS#1 v1.5 padding scheme.

```APIDOC
## gnu.crypto.pad.PKCS1_V1_5.setup()

### Description
Initializes the PKCS#1 v1.5 padding scheme.

### Method
Method in class gnu.crypto.pad.PKCS1_V1_5
```

--------------------------------

### Get Line Start Offset

Source: https://www.gnu.org/software/kawa/api/gnu/jemacs/swt/SwtBuffer.html

Calculates the starting offset of a given line within the buffer.

```java
public int lineStartOffset(int offset)
```

--------------------------------

### Example Manual Configuration

Source: https://www.gnu.org/software/texinfo/manual/texinfo/html_node/HTML-Xref-Configuration.html

Example configuration showing how to define base URLs and specific paths for different cross-reference types (mono, chapter, section, node).

```config
G = https://www.gnu.org
GS = ${G}/software
hello mono    ${GS}/hello/manual/hello.html
hello chapter ${GS}/hello/manual/html_chapter/
hello section ${GS}/hello/manual/html_section/
hello node    ${GS}/hello/manual/html_node/

```

--------------------------------

### Configure All Custom Installation Directories

Source: https://www.gnu.org/software/gnuastro/manual/html_node/Installation-directory.html

This comprehensive example sets multiple environment variables to point to custom installation directories for executables, libraries, man pages, headers, info files, and dynamic libraries. Replace '/YOUR-HOME-DIR' with your actual home directory path.

```bash
export PATH="/YOUR-HOME-DIR/.local/bin:$PATH"
export LDFLAGS="-L/YOUR-HOME-DIR/.local/lib $LDFLAGS"
export MANPATH="/YOUR-HOME-DIR/.local/share/man/:$MANPATH"
export CPPFLAGS="-I/YOUR-HOME-DIR/.local/include $CPPFLAGS"
export INFOPATH="/YOUR-HOME-DIR/.local/share/info/:$INFOPATH"
export LD_LIBRARY_PATH="/YOUR-HOME-DIR/.local/lib:$LD_LIBRARY_PATH"
```

--------------------------------

### Get Shortdoc Function Examples

Source: https://www.gnu.org/software/emacs/manual/html_node/elisp/Documentation-Groups.html

The `shortdoc-function-examples` function retrieves all shortdoc examples for a given function, returning an alist of groups and their associated example strings.

```emacs-lisp
(shortdoc-function-examples function)
```

--------------------------------

### setup Method

Source: https://www.gnu.org/software/gnu-crypto/manual/api/gnu/crypto/pad/PKCS1_V1_5.html

Hook for subclasses to perform additional checks or resource setup. Called before BasePad.init(int) returns.

```APIDOC
## setup Method

### Description
If any additional checks or resource setup must be done by the subclass, then this is the hook for it. This method will be called before the `BasePad.init(int)` method returns.

### Signature
```java
public void setup()
```

### Implements
`setup` in class `BasePad`
```

--------------------------------

### Install guile-dbd-mysql from Source

Source: https://www.gnu.org/software/artanis/manual/html_node/For-hardcore-users.html

Install the guile-dbd-mysql plugin for database connectivity. This is optional and used for examples in the manual.

```bash
cd guile-dbi-guile-dbi-2.1.8/guile-dbd-mysql && ./autogen.sh --no-configure && ./configure && make
sudo make install
```

--------------------------------

### Starting Emacs with a Specific Font

Source: https://www.gnu.org/software/emacs/manual/html_node/emacs/Defining-Fontsets.html

Example of how to start Emacs from the command line specifying a particular font.

```bash
emacs -fn "*courier-medium-r-normal--14-140-*-iso8859-1"
```

--------------------------------

### PKCS1_V1_5 Setup Method

Source: https://www.gnu.org/software/gnu-crypto/manual/api/gnu/crypto/pad/PKCS1_V1_5.html

Allows subclasses to perform additional checks or resource setup. This method is called before BasePad.init(int) returns.

```java
public void setup()

```

--------------------------------

### Get overlay start position

Source: https://www.gnu.org/software/emacs/manual/html_node/elisp/Managing-Overlays.html

Retrieve the starting buffer position of an overlay using `overlay-start`.

```Emacs Lisp
(overlay-start overlay)
```

--------------------------------

### User Build Process with Autoconf

Source: https://www.gnu.org/software/guile/manual/html_node/A-Sample-Guile-Main-Program.html

This sequence demonstrates how a user would typically build the example program after obtaining the source files, by running `./configure` and then `make`.

```shell
$ ls
Makefile.in 	configure*	configure.ac	simple-guile.c
$ ./configure
checking for gcc... ccache gcc
checking whether the C compiler works... yes
checking for C compiler default output file name... a.out
checking for suffix of executables... 
checking whether we are cross compiling... no
checking for suffix of object files... o
checking whether we are using the GNU C compiler... yes
checking whether ccache gcc accepts -g... yes
checking for ccache gcc option to accept ISO C89... none needed
checking for pkg-config... /usr/bin/pkg-config
checking pkg-config is at least version 0.9.0... yes
checking for GUILE... yes
configure: creating ./config.status
config.status: creating Makefile
$ make
[...]
$ ./simple-guile
guile> (+ 1 2 3)
6
guile> (getpwnam "jimb")
#("jimb" "83Z7d75W2tyJQ" 4008 10 "Jim Blandy" "/u/jimb"
  "/usr/local/bin/bash")
guile> (exit)
$

```

--------------------------------

### Creating a TCP Server Example

Source: https://www.gnu.org/software/mit-scheme/documentation/stable/mit-scheme-ref/TCP-Sockets.html

This example demonstrates setting up a simple TCP server that listens for connections and echoes received data.

```scheme
;; A simple TCP server
(define (echo-server port)
  (let ((server-socket (tcp-listen port)))
    (let loop ((client-socket (tcp-accept server-socket)))
      (let ((line (tcp-receive client-socket)))
        (if (eof-object? line)
            (tcp-close client-socket)
            (begin
              (display "Received: ")
              (display line)
              (newline)
              (tcp-send client-socket (string-append "Echo: " line))
              (loop client-socket)))
      (tcp-close server-socket)))))

(echo-server 12345)
```

--------------------------------

### Score File Date Matching Example

Source: https://www.gnu.org/software/emacs/manual/html_mono/gnus.html

Example of a score file demonstrating date matching using relative age in days. Articles less than a week old get a score increase, older articles get a decrease, and articles older than two weeks get a cumulative decrease.

```emacs-lisp
(("date"
  (7 10 nil <)
  (7 -10 nil >)
  (14 -10 nil >)))
```

--------------------------------

### Startup File: HTTP Proxy with Authentication

Source: https://www.gnu.org/software/proxyknife/manual/proxyknife.txt

Configure the startup file to use an authenticated HTTP proxy for checking other proxies. This example specifies the proxy details, authentication credentials, and the site to check.

```ini
#Check http,socks5,socks4 proxies with customized request: msn.req.
#Check is done via a tcp tunnel(http proxy).
mytype=11
myhost=www.myhttptunnel.com
myport=8080
myuser=abc
mypass=123
httptestmethod=1
checksite=messenger.hotmail.com:1863
checkreqin=msn.req
key=VER 0 MSNP8 CVR0
proxyknifeintype=1
proxyknifein=youth.bupt.edu.cn/proxy/
```

--------------------------------

### Configure Installation Prefix

Source: https://www.gnu.org/software/gsrc/manual/html_node/Initial-setup.html

Run the top-level configure script before building. Specify the installation directory using the --prefix option. For example, to install under /gnu.

```shell
$ ./configure --prefix=/gnu
checking for a BSD-compatible install... /usr/bin/install -c
checking whether build environment is sane... yes
checking for a thread-safe mkdir -p... /usr/bin/mkdir -p
checking for gawk... gawk
checking whether make sets $(MAKE)... yes
checking whether make supports nested variables... yes
checking for recsel... /usr/bin/recsel
checking for recfmt... /usr/bin/recfmt
checking that generated files are newer than configure... done
config.status: creating ./config.status
config.status: creating gsrc
config.status: creating config.mk
config.status: creating setup.sh
config.status: creating GNUmakefile
config.status: creating doc/Makefile

```

--------------------------------

### Hurd Hostmux and Package Installation

Source: https://www.gnu.org/software/hurd/community/weblogs/ArneBab.atom

Example of setting up a hostmux for FTP access and installing Debian packages on the Hurd.

```bash
settrans -a ftp: /hurd/hostmux /hurd/ftpfs /
dpkg -i ftp://ftp.gnu.org/â€¦/*.deb
```

--------------------------------

### gnu.crypto.mode.ECB.setup()

Source: https://www.gnu.org/software/gnu-crypto/manual/api/index-all.html

Initializes the ECB mode.

```APIDOC
## gnu.crypto.mode.ECB.setup()

### Description
Initializes the ECB mode.

### Method
Method in class gnu.crypto.mode.ECB
```

--------------------------------

### Start GNU APL with Options

Source: https://www.gnu.org/software/apl/apl.html

Example of starting GNU APL with a specific command-line option, such as '-id 1001'.

```bash
$ apl -id 1001

```

--------------------------------

### Configure and Make Project

Source: https://www.gnu.org/software/swbis/README

Standard procedure for configuring and building the project. Refer to the INSTALL file for more detailed instructions.

```bash
./configure && make
```

--------------------------------

### GRUB Command Example

Source: https://www.gnu.org/software/grub/manual/legacy/Naming-convention.html

Demonstrates using a device specification within a GRUB command, such as setting the root device.

```text
root (fd0)
```

```text
unhide (hd0,2)
```

--------------------------------

### Install AUCTeX with use-package

Source: https://www.gnu.org/software/auctex/manual/auctex/Installation.html

This configuration snippet for `use-package` users automatically installs the AUCTeX package when Emacs starts.

```emacs-lisp
(use-package tex
  :ensure auctex)
```

--------------------------------

### Debian Installer Preseed URL Example

Source: https://www.gnu.org/software/hurd/open_issues/nightly_builds_deb_packages.html

This URL points to a daily build preseed configuration file for Debian installer. It's used to automate the installation process by providing answers to installer questions.

```shell
url=http://10.0.2.1//d-i-preseed-cfg/debian_sid_daily_hurd_lxde_preseed.cfg
```

--------------------------------

### GRUB Configuration Example

Source: https://www.gnu.org/software/gnuboot/manual/gnuboot.html

This is an example of the /etc/default/grub configuration file. It shows various options for customizing GRUB's behavior, including timeout, command line parameters, and graphical settings.

```shell
# If you change this file, run 'update-grub' afterwards to update
# /boot/grub/grub.cfg.
# For full documentation of the options in this file, see:
#   info -f grub -n 'Simple configuration'

GRUB_DEFAULT=0
GRUB_TIMEOUT_STYLE=hidden
GRUB_TIMEOUT=1
GRUB_DISTRIBUTOR=`lsb_release -i -s 2> /dev/null || echo Debian`
GRUB_CMDLINE_LINUX_DEFAULT="quiet splash"
GRUB_CMDLINE_LINUX=""

# Uncomment to enable BadRAM filtering, modify to suit your needs
# This works with Linux-Libre (no patch required) and with any kernel that obtains
# the memory map information from GRUB (GNU Mach, kernel of FreeBSD ...)
#GRUB_BADRAM="0x01234567,0xfefefefe,0x89abcdef,0xefefefef"

# Uncomment to disable graphical terminal (grub-pc only)
#GRUB_TERMINAL=console

# The resolution used on graphical terminal
# note that you can use only modes which your graphic card supports via VBE
# you can see them in real GRUB with the command `vbeinfo'
#GRUB_GFXMODE=640x480

# Uncomment if you don't want GRUB to pass "root=UUID=xxx" parameter to Linux
#GRUB_DISABLE_LINUX_UUID=true

# Uncomment to disable generation of recovery mode menu entries
#GRUB_DISABLE_RECOVERY="true"

# Uncomment to get a beep at grub start
#GRUB_INIT_TUNE="480 440 1"

```

--------------------------------

### Creating a hard link during installation with install-exec-hook

Source: https://www.gnu.org/software/automake/manual/html_node/Extending.html

The 'install-exec-hook' target allows executing custom commands after program installation. This example creates a hard link to the installed program.

```makefile
install-exec-hook:
	ln $(DESTDIR)$(bindir)/program$(EXEEXT) \
	   $(DESTDIR)$(bindir)/proglink$(EXEEXT)
```

--------------------------------

### Prepare QEMU Disk Image

Source: https://www.gnu.org/software/hurd/hurd/running/qemu/image_for_l4.html

Create a QEMU environment by setting up directories, copying and decompressing the demodisk image, and mounting it. Copy the compiled kernel and servers into the mounted image's boot directory.

```bash
mkdir qemu
mkdir qemu/image
cd qemu
cp ~/pistachio-ia32-0.4-demodisk.bin.bz2 .
bunzip2 pistachio-ia32-0.4-demodisk.bin.bz2
mount -o loop pistachio-ia32-0.4-demodisk.bin image
cd image/boot
cp /l4/boot/* .
cd grub
```

--------------------------------

### Hello World Translator Example

Source: https://www.gnu.org/software/hurd/hurd/documentation/translator_primer.html

Demonstrates the creation, setup, and removal of a simple 'Hello World' translator. Shows how to use `settrans` to associate a translator with a file and `fsysopts` to configure translator options.

```shell
$ touch hello
$ cat hello  
$ settrans hello /hurd/hello  
$ cat hello  
"Hello World!"

$ fsysopts hello
/hurd/hello --contents='Hello World!
'
$ fsysopts hello --contents='Hello GNU!
> '
$ cat hello
Hello GNU!

$ settrans -g hello  
$ cat hello  


```

--------------------------------

### Diff3 Usage Example

Source: https://www.gnu.org/software/trans-coord/manual/cvs/html_node/Error-messages.html

This example shows the expected usage format for the diff3 command when encountering installation issues with rcsmerge.

```bash
Usage:	diff3 [-exEX3 [-i | -m] [-L label1 -L label3]] file1 file2 file3
```

```bash
Only one of [exEX3] allowed
```

--------------------------------

### Configuration C++ Example

Source: https://www.gnu.org/software/mifluz/doc/mifluz.html

Shows how to initialize and use the Configuration class to read settings from a file, set defaults, add new configurations, and access values.

```cpp
#include <Configuration.h>

Configuration config;

ConfigDefault config_defaults = {
  { "verbose", "true" },
  { 0, 0 }
};

config.Defaults(config_defaults);

config.Read("/spare2/myconfig") ;

config.Add("sync", "false");

if(config["sync"]) ...
if(config.Value("rate") < 50) ...
if(config.Boolean("sync")) ...

```

--------------------------------

### LPC Get Operations

Source: https://www.gnu.org/software/artanis/manual/html_node/LPC.html

These examples demonstrate how to retrieve a value associated with a key from LPC using either 'get' or 'ref'.

```scheme
(:lpc rc 'get <key>)
```

```scheme
(:lpc rc 'ref <key>)
```
Tokens:
Raw