[Pkg-kde-commits] rev 1101 - in branches/kde-3.4.0/packages/kdebase/debian: . man patches
Christopher Martin
chrsmrtn-guest@costa.debian.org
Mon, 23 May 2005 20:36:59 +0000
Author: chrsmrtn-guest
Date: 2005-05-23 20:36:58 +0000 (Mon, 23 May 2005)
New Revision: 1101
Added:
branches/kde-3.4.0/packages/kdebase/debian/kdebase-bin.links
branches/kde-3.4.0/packages/kdebase/debian/kdebase-bin.manpages
branches/kde-3.4.0/packages/kdebase/debian/man/kdesu.1
branches/kde-3.4.0/packages/kdebase/debian/man/kdialog.1
branches/kde-3.4.0/packages/kdebase/debian/patches/23_startkde_kpersonalizer.diff
Modified:
branches/kde-3.4.0/packages/kdebase/debian/changelog
branches/kde-3.4.0/packages/kdebase/debian/control
Log:
Add a patch to prevent ksmserver from failing if kpersonalizer
is not present.
Add two manpages: kdialog (from a bug report) and a new kdesu, which
also serves to describe kdesud.
Modified: branches/kde-3.4.0/packages/kdebase/debian/changelog
===================================================================
--- branches/kde-3.4.0/packages/kdebase/debian/changelog 2005-05-23 20:27:42 UTC (rev 1100)
+++ branches/kde-3.4.0/packages/kdebase/debian/changelog 2005-05-23 20:36:58 UTC (rev 1101)
@@ -49,9 +49,12 @@
available through the Debian menu system. Trivial patch borrowed from
Kubuntu. (Closes: #246280)
- * Make ksmserver Recommend kpersonalizer, since it is required when
+ * Make ksmserver Recommend kpersonalizer, since it is used when
running KDE for the first time. (Closes: #309803)
+ * Add manpages for kdialog (thanks to Bastian Kleineidam for tracking it
+ down) and my own manpage for kdesu/kdesud. (Closes: #239945)
+
+++ Changes by Adeodato Simó:
* After clearing up some issues with multiple de.po files being sent for
Modified: branches/kde-3.4.0/packages/kdebase/debian/control
===================================================================
--- branches/kde-3.4.0/packages/kdebase/debian/control 2005-05-23 20:27:42 UTC (rev 1100)
+++ branches/kde-3.4.0/packages/kdebase/debian/control 2005-05-23 20:36:58 UTC (rev 1101)
@@ -411,8 +411,8 @@
from the console.
.
If you are running KDE for the first time for a certain user,
- kpersonalizer is required to help with setup. If it is not present,
- KDE will not start successfully.
+ kpersonalizer is used to help with setup. If it is not present,
+ KDE will start, but many good defaults will not be set.
.
This package is part of KDE, and a component of the KDE base module.
See the 'kde' and 'kdebase' packages for more information.
Added: branches/kde-3.4.0/packages/kdebase/debian/kdebase-bin.links
===================================================================
--- branches/kde-3.4.0/packages/kdebase/debian/kdebase-bin.links 2005-05-23 20:27:42 UTC (rev 1100)
+++ branches/kde-3.4.0/packages/kdebase/debian/kdebase-bin.links 2005-05-23 20:36:58 UTC (rev 1101)
@@ -0,0 +1 @@
+usr/share/man/man1/kdesu.1.gz usr/share/man/man1/kdesud.1.gz
Added: branches/kde-3.4.0/packages/kdebase/debian/kdebase-bin.manpages
===================================================================
--- branches/kde-3.4.0/packages/kdebase/debian/kdebase-bin.manpages 2005-05-23 20:27:42 UTC (rev 1100)
+++ branches/kde-3.4.0/packages/kdebase/debian/kdebase-bin.manpages 2005-05-23 20:36:58 UTC (rev 1101)
@@ -0,0 +1,2 @@
+debian/man/kdesu.1
+debian/man/kdialog.1
Added: branches/kde-3.4.0/packages/kdebase/debian/man/kdesu.1
===================================================================
--- branches/kde-3.4.0/packages/kdebase/debian/man/kdesu.1 2005-05-23 20:27:42 UTC (rev 1100)
+++ branches/kde-3.4.0/packages/kdebase/debian/man/kdesu.1 2005-05-23 20:36:58 UTC (rev 1101)
@@ -0,0 +1,90 @@
+.TH KDESU 1 "May 2005" "K Desktop Environment" "Runs a program with elevated privileges."
+.SH NAME
+kdesu \- Runs a program with elevated privileges.
+.SH SYNOPSIS
+\fBkdesu\fR [Qt\-options] [KDE\-options] [kdesu options] command
+.SH DESCRIPTION
+Runs a program with elevated privileges.
+.PP
+KDE su is a graphical front end to the Unix \fBsu\fR utility. It allows you to run programs as another user by entering their password. It is not a SUID root program, but runs unprivileged. The system program \fBsu\fR is used for acquiring special privileges.
+.PP
+\fBkdesu\fR has the ability to store passwords for the convenience of users. The passwords are NOT written to disk, but stored in memory using a special program, \fBkdesud\fR. This is only done if the user specifies that the password be remembered. In this case, passwords are stored in memory for a certain period of time before being removed. \fBkdesud\fR runs in such a way that only the user who entered the password originally can use it, though no one, not even the user who originally entered the password, can retrieve the password that is stored by \fBkdesud\fR. Through these measures, users can avoid having to repeatedly enter root passwords or other passwords, without a significant risk to overall system security.
+.SH OPTIONS
+.SS Generic options:
+.TP
+.B --help
+Show help about options
+.TP
+.B --help-qt
+Show Qt specific options
+.TP
+.B --help-kde
+Show KDE specific options
+.TP
+.B --help-all
+Show all options
+.TP
+.B --author
+Show author information
+.TP
+.B -v, --version
+Show version information
+.TP
+.B --license
+Show license information
+.SS
+.SS kdesu Options:
+.TP
+.TP
+.B -c <command>
+Specifies the command to run
+.TP
+.B -f <file>
+Run command under target uid if <file> is not writable
+.TP
+.B -u <user>
+Specifies the target uid [default is root]
+.TP
+.B -n
+Do not keep password
+.TP
+.B -s
+Stop the daemon (forgets all passwords)
+.TP
+.B -t
+Enable terminal output (no password keeping)
+.TP
+.B -p <prio>
+Set priority value: 0 <= prio <= 100, 0 is lowest [default is 50]
+.TP
+.B -r
+Use realtime scheduling
+.TP
+.B --nonewdcop
+Let command use existing dcopserver
+.TP
+.B -i <icon name>
+Specify icon to use in the password dialog
+.TP
+.B -d
+Do not show the command to be run in the dialog
+.SS
+.SS Arguments:
+.TP
+.B command
+Specifies the command to run
+
+.SH SEE ALSO
+Full user documentation is available through the KDE Help Center. You can also enter the URL
+.BR help:/kdesu/
+directly into konqueror or you can run
+.BR "`khelpcenter help:/kdesu/'"
+from the command-line.
+.br
+.SH AUTHORS
+.br
+Geert Jansen <jansen@kde.org>
+.br
+Pietro Iglio <iglio@fub.it>
+.PP
+This manual page was written by Christopher Martin <chrsmrtn@freeshell.org> for Debian GNU/Linux, but may be used by others. It borrows from an earlier manpage by Karolina Lindqvist <pgd\-karolinali@algonet.se>.
Added: branches/kde-3.4.0/packages/kdebase/debian/man/kdialog.1
===================================================================
--- branches/kde-3.4.0/packages/kdebase/debian/man/kdialog.1 2005-05-23 20:27:42 UTC (rev 1100)
+++ branches/kde-3.4.0/packages/kdebase/debian/man/kdialog.1 2005-05-23 20:36:58 UTC (rev 1101)
@@ -0,0 +1,209 @@
+.TH KDIALOG "1" "December 2002" "KDE" "KDE Application"
+.SH NAME
+kdialog \- Show KDE dialog boxes from shell scripts
+.SH SYNOPSIS
+.B kdialog
+[\fIQt-options\fR] [\fIKDE-options\fR] [\fIoptions\fR] [\fIarg\fR]
+.SH DESCRIPTION
+This manual page documents briefly the
+.B kdialog
+KDE Application.
+This manual page was written for the Debian GNU/Linux distribution
+because the original program does not have a manual page.
+.PP
+.B kdialog
+allows to display dialog boxes from shell scripts.
+The syntax is very much inspired from the
+.B dialog
+command
+(which shows text mode dialogs).
+.SH OPTIONS
+.TP
+.BI \-\-yesno " text"
+Question message box with yes/no buttons
+.TP
+.BI \-\-yesnocancel " text"
+Question message box with yes/no/cancel buttons
+.TP
+.BI \-\-warningyesno " text"
+Warning message box with yes/no buttons
+.TP
+.BI \-\-warningcontinuecancel " text"
+Warning message box with continue/cancel buttons
+.TP
+.BI \-\-warningyesnocancel " text"
+Warning message box with yes/no/cancel buttons
+.TP
+.BI \-\-sorry " text"
+\&'Sorry' message box
+.TP
+.BI \-\-error " text"
+\&'Error' message box
+.TP
+.BI \-\-msgbox " text"
+Message Box dialog
+.TP
+.BI \-\-inputbox " text init"
+Input Box dialog
+.TP
+.BI \-\-password " text"
+Password dialog
+.TP
+.RI \fB\-\-textbox\fP \ file " [" width "] [" height ]
+Text Box dialog
+.TP
+.RI \fB\-\-menu\fP \ text " [" "tag item" "] [" "tag item" "] ..."
+Menu dialog
+.TP
+.RI \fB\-\-checklist\fP \ text " [" "tag item status" "] ..."
+Check List dialog
+.TP
+.RI \fB\-\-radiolist\fP " text" " [" "tag item status" "] ..."
+Radio List dialog
+.TP
+.BI \-\-title " text"
+Dialog title
+.TP
+.B \-\-separate\-output
+Return list items on separate lines (for checklist option)
+.SS "Arguments:"
+.TP
+arg
+Arguments - depending on main option
+.SS "Generic options:"
+.TP
+.B \-\-help
+Show help about options
+.TP
+.B \-\-help\-qt
+Show Qt specific options
+.TP
+.B \-\-help\-kde
+Show KDE specific options
+.TP
+.B \-\-help\-all
+Show all options
+.TP
+.B \-\-author
+Show author information
+.TP
+\fB\-v\fR, \fB\-\-version\fR
+Show version information
+.TP
+.B \-\-license
+Show license information
+.TP
+.B \-\-
+End of options
+.SS "Qt options:"
+.TP
+.BI \-\-display \ displayname
+Use the X-server display \fIdisplayname\fP.
+.TP
+.BI \-\-session \ sessionId
+Restore the application for the given \fIsessionId\fP.
+.TP
+.B \-\-cmap
+Causes the application to install a private color
+map on an 8-bit display.
+.TP
+.BI \-\-ncols \ count
+Limits the number of colors allocated in the color
+cube on an 8-bit display, if the application is
+using the QApplication::ManyColor color
+specification.
+.TP
+.B \-\-nograb
+tells Qt to never grab the mouse or the keyboard.
+.TP
+.B \-\-dograb
+running under a debugger can cause an implicit
+.B \-nograb, use \fB\-dograb\fR to override.
+.TP
+.B \-\-sync
+switches to synchronous mode for debugging.
+.TP
+.BI "\-\-fn\fR, \fP\-\-font" \ fontname
+defines the application font.
+.TP
+.BI "-\-bg\fR, \fB\-\-background" \ color
+sets the default background color and an
+application palette (light and dark shades are
+calculated).
+.TP
+.BI "\-\-fg\fR, \fB\-\-foreground" \ color
+sets the default foreground color.
+.TP
+.BI \-\-btn\fR, \fB\-\-button \ color
+sets the default button color.
+.TP
+.BI \-\-name \ name
+sets the application name.
+.TP
+.BI \-\-title \ title
+sets the application title (caption).
+.TP
+.B \-\-visual TrueColor
+forces the application to use a TrueColor visual on
+an 8-bit display.
+.TP
+.BI \-\-inputstyle \ inputstyle
+sets XIM (X Input Method) input style. Possible
+values are
+.BR onthespot ", " overthespot ", " offthespot and root .
+.TP
+.BI \-\-im " XIM-server"
+set XIM server.
+.TP
+.B \-\-noxim
+disable XIM.
+.TP
+.B \-\-reverse
+mirrors the whole layout of widgets.
+.SS "KDE options:"
+.TP
+.BI \-\-caption \ caption
+Use \fIcaption\fP as name in the titlebar.
+.TP
+.BI \-\-icon \ icon
+Use \fIicon\fP as the application icon.
+.TP
+.BI \-\-miniicon \ icon
+Use \fIicon\fP as the icon in the titlebar.
+.TP
+.BI \-\-config \ filename
+Use alternative configuration file.
+.TP
+.BI \-\-dcopserver \ server
+Use the DCOP Server specified by \fIserver\fP.
+.TP
+.B \-\-nocrashhandler
+Disable crash handler, to get core dumps.
+.TP
+.B \-\-waitforwm
+Waits for a WM_NET compatible windowmanager.
+.TP
+.BI \-\-style \ style
+sets the application GUI style.
+.TP
+.BI \-\-geometry \ geometry
+sets the client geometry of the main widget.
+.SH AUTHOR
+KDialog was written by
+.nh
+.ad l
+David Faure <faure@kde.org>,
+Nick Thompson,
+Nick Thompson,
+Matthias Hölzer <hoelzer@kde.org> and
+David Gümbel <david.guembel@gmx.net>.
+.br
+.hy
+Please use http://bugs.kde.org to report bugs, do not mail the authors directly.
+.br
+This manual page was prepared by
+.nh
+.ad l
+Karolina Lindqvist <pgd\-karolinali@algonet.se>
+.hy
+for the Debian GNU/Linux system (but may be used by others).
Added: branches/kde-3.4.0/packages/kdebase/debian/patches/23_startkde_kpersonalizer.diff
===================================================================
--- branches/kde-3.4.0/packages/kdebase/debian/patches/23_startkde_kpersonalizer.diff 2005-05-23 20:27:42 UTC (rev 1100)
+++ branches/kde-3.4.0/packages/kdebase/debian/patches/23_startkde_kpersonalizer.diff 2005-05-23 20:36:58 UTC (rev 1101)
@@ -0,0 +1,35 @@
+--- kde.orig/startkde
++++ kde.patched/startkde
+@@ -181,17 +181,21 @@
+
+ # run KPersonalizer before the session, if this is the first login
+ if kreadconfig --file kpersonalizerrc --group General --key FirstLogin --default true --type bool; then
+- # start only dcopserver, don't start whole kdeinit (takes too long)
+- echo 'startkde: Running kpersonalizer...' 1>&2
+- dcopserver
+- kwin --lock &
+- kpersonalizer --before-session
+- # handle kpersonalizer restarts (language change)
+- while test $? -eq 1; do
+- kpersonalizer --r --before-session
+- done
+- dcopquit kwin
+- dcopserver_shutdown --wait
++ if [ ! -x /usr/bin/kpersonalizer ]; then
++ echo 'startkde: kpersonalizer not found! Please install to properly configure your user.' 1>&2
++ else
++ # start only dcopserver, don't start whole kdeinit (takes too long)
++ echo 'startkde: Running kpersonalizer...' 1>&2
++ dcopserver
++ kwin --lock &
++ kpersonalizer --before-session
++ # handle kpersonalizer restarts (language change)
++ while test $? -eq 1; do
++ kpersonalizer --r --before-session
++ done
++ dcopquit kwin
++ dcopserver_shutdown --wait
++ fi
+ fi
+
+ # the splashscreen and progress indicator