'\" t
.\"     Title: \fBkate\fR
.\"    Author: Lauri Watts <lauri@kde.org>
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\"      Date: 2018-03-18
.\"    Manual: Kate User's Manual
.\"    Source: KDE Applications Applications 18.04
.\"  Language: English
.\"
.TH "\FBKATE\FR" "1" "2018\-03\-18" "KDE Applications Applications" "Kate User's Manual"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
kate \- Advanced text editor by KDE
.SH "SYNOPSIS"
.HP \w'\fBkate\fR\ 'u
\fBkate\fR [\fB\-s, \-\-start\fR\fI
name\fR] [\fB\-\-startanon\fR] [\fB\-n, \-\-new\fR] [\fB\-b, \-\-block\fR] [\fB\-p, \-\-pid\fR\fI
pid\fR] [\fB\-e, \-\-encoding\fR\fI
name\fR] [\fB\-l, \-\-line\fR\fI
line\fR] [\fB\-c, \-\-column\fR\fI column\fR] [\fB\-i, \-\-stdin\fR] [\fB\-\-tempfile\fR] [\fB\fIfile\fR\fR]
.SH "DESCRIPTION"
.PP
Kate
is the
KDE
Advanced Text Editor\&.
.PP
Kate
also provides the editor part for various applications, under the name
KWrite\&.
.PP
Some of
Kate\*(Aqs many features include configurable syntax highlighting for languages ranging from C and C++ to
HTML
to bash scripts, the ability to create and maintain projects, a multiple document interface (MDI), and a self\-contained terminal emulator\&.
.PP
But
Kate
is more than a programmer\*(Aqs editor\&. Its ability to open several files at once makes it ideal for editing
UNIX\(rg\*(Aqs many configuration files\&. This document was written in
Kate\&.
.SH "OPTIONS"
.PP
\fB\-s\fR, \fB\-\-start\fR \fIname\fR
.RS 4
Start
Kate
with a given session\&.
.RE
.PP
\fB\-\-startanon\fR
.RS 4
Start
Kate
with a new anonymous session, implies
\fB\-n\fR\&.
.RE
.PP
\fB\-n\fR, \fB\-\-new\fR
.RS 4
Force start of a new
Kate
instance (is ignored if
\fBstart\fR
is used and another
Kate
instance already has the given session opened), forced if no parameters and no URLs are given at all\&.
.RE
.PP
\fB\-b\fR, \fB\-\-block\fR
.RS 4
If using an already running
Kate
instance, block until it exits, if URLs given to open\&.
.RE
.PP
\fB\-p, \-\-pid\fR \fI pid\fR
.RS 4
Only try to reuse kate instance with this
\fIpid\fR
(is ignored if
\fBstart\fR
is used and another
Kate
instance already has the given session opened)\&.
.RE
.PP
\fB\-e, \-\-encoding\fR \fI name\fR
.RS 4
Set encoding for the file to open
.sp
You can use this to force a file opened in utf\-8 format, for instance\&. (The command
\fBiconv \-l\fR
provides a list of encodings, which may be helpful to you\&.)
.RE
.PP
\fB\-l, \-\-line\fR \fI line\fR
.RS 4
Navigate to this line
.RE
.PP
\fB\-c, \-\-column\fR \fI column\fR
.RS 4
Navigate to this column
.RE
.PP
\fB\-i, \-\-stdin\fR
.RS 4
Read the contents of
stdin
.RE
.PP
\fB\-\-tempfile\fR
.RS 4
The files/URLs opened by the application will be deleted after use
.RE
.PP
\fB\fIfile\fR\fR
.RS 4
File to open
.RE
.SH "SEE ALSO"
.RS 4
More detailed user documentation is available from \m[blue]\fBhelp:/kate\fR\m[]
(either enter this URL into Konqueror, or run
\fB\fBkhelpcenter\fR\fR\fB
\fR\fB\fIhelp:/kate\fR\fR)\&.
.RE
.RS 4
kf5options(7)
.RE
.RS 4
qt5options(7)
.RE
.RS 4
There is also further information available at the \m[blue]\fBKate website\fR\m[]\&\s-2\u[1]\d\s+2\&.
.RE
.SH "EXAMPLES"
.PP
To open a file named
source\&.cpp
at column 15, line 25, in an existing
Kate
window, you could use:
.sp
.if n \{\
.RS 4
.\}
.nf
\fB\fBkate\fR\fR\fB \fR\fB\fB\-c 15\fR\fR\fB \fR\fB\fB\-l 25\fR\fR\fB \fR\fBsource\&.cpp\fR
.fi
.if n \{\
.RE
.\}
.PP
If you have an active internet connection, you can take advantage of
KDE\*(Aqs network transparency to open a file from an ftp site\&. If you do not have write permission on the remote server, the file will be opened read only and you will be prompted for a local filename to save to if you make changes\&. If you do have write permission, changes will be saved transparently over the network\&.
.sp
.if n \{\
.RS 4
.\}
.nf
\fB\fBkate\fR\fR\fB \fR\fB\fB\fIftp://ftp\&.kde\&.org/pub/kde/README\fR\fR\fR
.fi
.if n \{\
.RE
.\}
.SH "AUTHORS"
.PP
The maintainer of
Kate
is
Christoph Cullmann
<cullmann@kde\&.org>\&. A comprehensive list of authors and contributors is available in the complete user manual mentioned above\&.
.SH "AUTHOR"
.PP
\fBLauri Watts\fR <\&lauri@kde\&.org\&>
.RS 4
Author.
.RE
.SH "NOTES"
.IP " 1." 4
Kate website
.RS 4
\%http://kate-editor.org/
.RE