.\" Man page generated from reStructuredText
.\" by the Docutils 0.23 manpage writer.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "FISH_DARCS_PROMPT" "1" "Oct 12, 2026" "4.9" "fish-shell"
.SH NAME
fish_darcs_prompt \- output Darcs information for use in a prompt
.SH SYNOPSIS
.nf
\fBfish_darcs_prompt\fP
.fi
.sp
.INDENT 0.0
.INDENT 3.5
.sp
.EX
function fish_prompt
     printf \(aq%s\(aq $PWD (fish_darcs_prompt) \(aq $ \(aq
end
.EE
.UNINDENT
.UNINDENT
.SH DESCRIPTION
.sp
The \fBfish_darcs_prompt\fP function displays information about the current Darcs repository, if any.
.sp
Darcs \%<https://\:darcs\:.net/> must be installed.
.sp
The prompt always shows the VCS name (configurable via \fB$fish_prompt_darcs_name\fP, default \fBdarcs\fP) as there are no branches/channels; it can be unset to remove it entirely. If the repository has unrecorded changes, status counts are shown for each change type:
.INDENT 0.0
.IP \(bu 2
\fB$fish_color_darcs_normal\fP, default \fBgreen\fP (the prompt label color)
.IP \(bu 2
\fB$fish_color_darcs_rebasing\fP, default \fByellow\fP (used when a rebase is in progress)
.UNINDENT
.sp
To match Darcs’s logo green:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
set fish_color_darcs_normal 72ff01
.EE
.UNINDENT
.UNINDENT
.sp
The Darcs status symbols:
.INDENT 0.0
.IP \(bu 2
\fB$fish_prompt_darcs_status_added\fP, default \fB+\fP
.IP \(bu 2
\fB$fish_prompt_darcs_status_modified\fP, default \fB*\fP
.IP \(bu 2
\fB$fish_prompt_darcs_status_removed\fP, default \fB\-\fP
.IP \(bu 2
\fB$fish_prompt_darcs_status_moved\fP, default \fB→\fP
.IP \(bu 2
\fB$fish_prompt_darcs_status_untracked\fP, default \fB…\fP
.IP \(bu 2
\fB$fish_prompt_darcs_status_conflict\fP, default \fB!\fP
.UNINDENT
.sp
Colors for these symbols can be set with the corresponding variables (\fB$fish_color_darcs_added\fP & so on), which are unset by default so the terminal’s foreground color is used.
.sp
\fB$fish_prompt_darcs_status_order\fP can be used to change the order the status symbols appear in. It defaults to \fBadded removed modified moved conflict untracked\fP\&.
.sp
See also fish_vcs_prompt \%<>, which will call all supported version control prompt functions, including Git, Mercurial, & Darcs.
.SH EXAMPLE
.sp
A simple prompt that displays darcs info:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
function fish_prompt
    ...
    printf \(aq%s %s$\(aq $PWD (fish_darcs_prompt)
end
.EE
.UNINDENT
.UNINDENT
.SH Copyright
fish-shell developers
.\" End of generated man page.