.\" Automatically generated by Pandoc 2.17.1.1
.\"
.\" Define V font for inline verbatim, using C font in formats
.\" that render this, and otherwise B font.
.ie "\f[CB]x\f[]"x" \{\
. ftr V B
. ftr VI BI
. ftr VB B
. ftr VBI BI
.\}
.el \{\
. ftr V CR
. ftr VI CI
. ftr VB CB
. ftr VBI CBI
.\}
.TH "nala-search" "8" "09 Feb 2023" "0.12.2" "'Nala User Manual'"
.hy
.SH NAME
.PP
nala-search - Search package names and descriptions
.SH SYNOPSIS
.PP
\f[B]nala search\f[R] [\f[I]--options\f[R]] REGEX ...
.SH DESCRIPTION
.PP
Search package names and descriptions using a word, regex or glob
.PP
By default \f[B]search\f[R] will only use regex.
.PP
If you start your query with \f[I]g/\f[R], \f[B]search\f[R] will only
Glob.
.PP
\f[I]Note: You may need to quote the pattern so the shell doesn\[aq]t
glob first\f[R]
.PP
Examples:
.RS
.PP
Glob that will match \f[B]nala\f[R] and anything text after it:
.RS
.PP
\f[B]sudo nala search\f[R] \f[I]\[dq]g/nala*\[dq]\f[R]
.RE
.PP
A question mark in a glob will match any single character:
.RS
.PP
\f[B]sudo nala search\f[R] \f[I]\[dq]g/na?a\[dq]\f[R]
.PP
This would match \f[B]nala\f[R] or even \f[B]nada\f[R]
.RE
.RE
.PP
Regex works similar to globbing but is much more powerful.
.PP
For more information on Glob and Regex pattern matching:
.RS
.PP
\f[B]man\f[R] \f[I]glob.7\f[R]
.PP
\f[B]man\f[R] \f[I]regex.7\f[R]
.RE
.SH OPTIONS
.TP
\f[B]--full\f[R]
Print the full description of each package.
.TP
\f[B]-n\f[R], \f[B]--names\f[R]
Search only package names.
.RS
.PP
This is faster than searching names and descriptions.
.RE
.TP
\f[B]-i\f[R], \f[B]--installed\f[R]
List only packages that are installed.
.TP
\f[B]-N\f[R], \f[B]--nala-installed\f[R]
List only packages explicitly installed with \f[B]nala\f[R].
.TP
\f[B]-u\f[R], \f[B]--upgradable\f[R]
List only packages that are upgradable.
.TP
\f[B]-a\f[R], \f[B]--all-versions\f[R]
Show all versions of a package.
.TP
\f[B]-A\f[R], \f[B]--all-arches\f[R]
Show all architectures of a package.
.TP
\f[B]-V\f[R], \f[B]--virtual\f[R]
List only virtual packages.
.TP
\f[B]--debug\f[R]
Print helpful information for solving issues.
If you\[aq]re submitting a bug report try running the command again with
\f[I]--debug\f[R] and providing the output to the devs, it may be
helpful.
.TP
\f[B]-v\f[R], \f[B]--verbose\f[R]
Disable scrolling text and print extra information
.TP
\f[B]-h\f[R], \f[B]--help\f[R]
Shows this man page.
.SH COPYRIGHT
.PP
Copyright (C) 2021, 2022 Blake Lee