Commit 5600e660 authored by Jaromil's avatar Jaromil

Import from Debian jessie/main package udisks2-2.1.3

parents
David Zeuthen <zeuthen@gmail.com>
This diff is collapsed.
CODING STYLE
============
- Please follow the coding style already used (which is close to the
GNU style) - if adding new files please include the following mode
line for emacs and other editors:
-*- mode: C; c-file-style: "gnu"; indent-tabs-mode: nil; -*-
- Spaces, not tabs, are used.
- All external interfaces (network protocols, file formats, etc.)
should be documented in man pages or other documentation.
SOURCE CONTROL
==============
Anonymous checkouts:
$ git clone git://git.freedesktop.org/git/udisks
Checkouts for ssh account holders
$ git clone ssh://[username@]git.freedesktop.org/git/udisks
MAKING RELEASES
===============
Checklist for making a release:
- Pull translations from Transfix ("tx pull -a")
- Remember to add new po/*.po files and update po/LINGUAS
- Make sure that you pushed the POT file a couple of weeks before
this and that no new strings has been added
- Update the NEWS file
- Check that everything works
- Run 'make check'
- Run 'sudo ./integration-test' in src/tests
- Check that you have no uncommitted or unpushed changes
- Check there are no glaring TODO or FIXME
- Sanity-check all new API
- Ensure newly added API is marked properly with "Since: X.Y"
- Ensure that deprecated API is marked as such
- Do the actual release (see Makefile.am, do it manually if not davidz)
- run 'make publish'
- run 'make publish-docs'
- Tag the release: git tag -s -m X.Y.Z X.Y.Z
- Post-release actions:
- Bump the version in configure.in
- Commit message: Post-release version bump to X.Y.Z
- Prepare NEWS file - append " (unreleased)" to version number
- Commit message: Start writing NEWS for X.Y.Z
When doing the first micro release in a new minor series (for example
starting the 2.0.0, 2.1.0, 2.2.0 etc. series), do the following
- Update the date in man pages to "$MONTH $YEAR" e.g. "October 2012"
- At some point after the release, create the udisks-X-Y branch
- Perform the post-release actions above on the created branch
- This is for maintenance releases
- Do this when focus is on new feature development
- Then bump version on master to X.Y.90 (prereleases for X.Y+1.0)
- Add "Index of new symbols in X.Y+1" index to doc/udisks2-docs.xml
For maintenance releases, the rules are simple
- Work on the udisks-X-Y branch
- If possible, cherry-pick fixes from master ('git cherry-pick')
- Do not add (or backport) any new API or features
- Do not add, remove or change any translatable strings
- Do not add new dependencies
COMMITTING CODE
===============
- Commit messages should be of the form (the five lines between the
lines starting with ===)
=== begin example commit ===
Short explanation of the commit
Longer explanation explaining exactly what's changed, whether any
external or private interfaces changed, what bugs were fixed (with bug
tracker reference if applicable) and so forth. Be concise but not too brief.
=== end example commit ===
- Always add a brief description of the commit to the _first_ line of
the commit and terminate by two newlines (it will work without the
second newline, but that is not nice for the interfaces).
- First line (the brief description) must only be one sentence and
must start with a capital letter. Don't use a trailing period.
- The main description (the body) is normal prose and should use normal
punctuation and capital letters where appropriate. Normally, for patches
sent to a mailing list it's copied from there.
- When committing code on behalf of others use the --author option, e.g.
git commit -a --author "Joe Coder <joe@coder.org>"
- If submitting (or commiting) patch in Bugzilla prefix the first
line with "Bug <Number> — <Bug Title>" (the dash is U+2014 EM DASH,
not '-') and include the bug URL in the commit message. Example:
"Bug 24885 — LVM LVs now have NOPOLICY=0" and
http://bugs.freedesktop.org/show_bug.cgi?id=24885.
## Process this file with automake to produce Makefile.in
NULL =
SUBDIRS = data udisks src tools po doc
ACLOCAL_AMFLAGS = -I m4 ${ACLOCAL_FLAGS}
EXTRA_DIST = \
HACKING \
$(NULL)
DISTCHECK_CONFIGURE_FLAGS= \
--enable-gtk-doc \
--disable-introspection \
--with-udevdir=$$dc_install_base/$(udevdir) \
--with-systemdsystemunitdir=$$dc_install_base/$(systemdsystemunitdir) \
$(NULL)
sign : dist
gpg --armor --detach-sign --output udisks-$(VERSION).tar.bz2.sign udisks-$(VERSION).tar.bz2
publish : sign
scp udisks-$(VERSION).tar.bz2 udisks-$(VERSION).tar.bz2.sign "people.freedesktop.org:/srv/udisks.freedesktop.org/www/releases/"
publish-docs :
gtkdoc-rebase --html-dir doc/html --online
ssh "people.freedesktop.org" "mkdir -p /srv/udisks.freedesktop.org/www/docs/$(VERSION)"
scp doc/html/* "people.freedesktop.org:/srv/udisks.freedesktop.org/www/docs/$(VERSION)"
ssh "people.freedesktop.org" "rm -f /srv/udisks.freedesktop.org/www/docs/latest; ln -s $(VERSION) /srv/udisks.freedesktop.org/www/docs/latest"
# publish docs readable from http://udisks.freedesktop.org/docs/master/ (instead of latest)
#
# This is useful for work-in-progress when hacking on master and you want
# to easily share API ideas etc. with others without requiring them to
# build master themselves
publish-docs-master :
gtkdoc-rebase --html-dir doc/html --online
ssh "people.freedesktop.org" "rm -rf /srv/udisks.freedesktop.org/www/docs/master; mkdir -p /srv/udisks.freedesktop.org/www/docs/master"
scp doc/html/* "people.freedesktop.org:/srv/udisks.freedesktop.org/www/docs/master"
clean-local :
rm -f *~
This diff is collapsed.
This diff is collapsed.
OVERVIEW
========
The udisks project provides a daemon, tools and libraries to access
and manipulate disks and storage devices.
For API stability and intended audience of udisks, see the API
STABILITY and AUDIENCE section of the udisks(8) man page
(doc/man/udisks.xml in the tarball and git repository).
LICENSE
=======
See the COPYING file for the license. In a nutshell, the daemon and
tools are licensed under the GPLv2 (or later) and libraries are
licensed under LGPLv2 (or later).
I18N and L10N
=============
We're using Transifex for translations, see
https://www.transifex.net/projects/p/udisks/
for how to contribute.
RELEASES
========
Releases of udisks are available in compressed tarballs from
http://udisks.freedesktop.org/releases/
To verify the authenticity of the compressed tarball, use this command
$ gpg --verify udisks-$(VERSION).tar.bz2.sign udisks-$(VERSION).tar.bz2
gpg: Signature made Sat 10 Mar 2012 03:00:30 PM EST using RSA key ID 3418A891
gpg: Good signature from "David Zeuthen <zeuthen@gmail.com>"
gpg: aka "[jpeg image of size 5237]"
BUGS and DEVELOPMENT
====================
Please report bugs via the freedesktop.org bugzilla at
http://bugs.freedesktop.org/enter_bug.cgi?product=udisks
This diff is collapsed.
This diff is collapsed.
#! /bin/sh
# Wrapper for compilers which do not understand '-c -o'.
scriptversion=2012-10-14.11; # UTC
# Copyright (C) 1999-2013 Free Software Foundation, Inc.
# Written by Tom Tromey <tromey@cygnus.com>.
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; either version 2, or (at your option)
# any later version.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program. If not, see <http://www.gnu.org/licenses/>.
# As a special exception to the GNU General Public License, if you
# distribute this file as part of a program that contains a
# configuration script generated by Autoconf, you may include it under
# the same distribution terms that you use for the rest of that program.
# This file is maintained in Automake, please report
# bugs to <bug-automake@gnu.org> or send patches to
# <automake-patches@gnu.org>.
nl='
'
# We need space, tab and new line, in precisely that order. Quoting is
# there to prevent tools from complaining about whitespace usage.
IFS=" "" $nl"
file_conv=
# func_file_conv build_file lazy
# Convert a $build file to $host form and store it in $file
# Currently only supports Windows hosts. If the determined conversion
# type is listed in (the comma separated) LAZY, no conversion will
# take place.
func_file_conv ()
{
file=$1
case $file in
/ | /[!/]*) # absolute file, and not a UNC file
if test -z "$file_conv"; then
# lazily determine how to convert abs files
case `uname -s` in
MINGW*)
file_conv=mingw
;;
CYGWIN*)
file_conv=cygwin
;;
*)
file_conv=wine
;;
esac
fi
case $file_conv/,$2, in
*,$file_conv,*)
;;
mingw/*)
file=`cmd //C echo "$file " | sed -e 's/"\(.*\) " *$/\1/'`
;;
cygwin/*)
file=`cygpath -m "$file" || echo "$file"`
;;
wine/*)
file=`winepath -w "$file" || echo "$file"`
;;
esac
;;
esac
}
# func_cl_dashL linkdir
# Make cl look for libraries in LINKDIR
func_cl_dashL ()
{
func_file_conv "$1"
if test -z "$lib_path"; then
lib_path=$file
else
lib_path="$lib_path;$file"
fi
linker_opts="$linker_opts -LIBPATH:$file"
}
# func_cl_dashl library
# Do a library search-path lookup for cl
func_cl_dashl ()
{
lib=$1
found=no
save_IFS=$IFS
IFS=';'
for dir in $lib_path $LIB
do
IFS=$save_IFS
if $shared && test -f "$dir/$lib.dll.lib"; then
found=yes
lib=$dir/$lib.dll.lib
break
fi
if test -f "$dir/$lib.lib"; then
found=yes
lib=$dir/$lib.lib
break
fi
if test -f "$dir/lib$lib.a"; then
found=yes
lib=$dir/lib$lib.a
break
fi
done
IFS=$save_IFS
if test "$found" != yes; then
lib=$lib.lib
fi
}
# func_cl_wrapper cl arg...
# Adjust compile command to suit cl
func_cl_wrapper ()
{
# Assume a capable shell
lib_path=
shared=:
linker_opts=
for arg
do
if test -n "$eat"; then
eat=
else
case $1 in
-o)
# configure might choose to run compile as 'compile cc -o foo foo.c'.
eat=1
case $2 in
*.o | *.[oO][bB][jJ])
func_file_conv "$2"
set x "$@" -Fo"$file"
shift
;;
*)
func_file_conv "$2"
set x "$@" -Fe"$file"
shift
;;
esac
;;
-I)
eat=1
func_file_conv "$2" mingw
set x "$@" -I"$file"
shift
;;
-I*)
func_file_conv "${1#-I}" mingw
set x "$@" -I"$file"
shift
;;
-l)
eat=1
func_cl_dashl "$2"
set x "$@" "$lib"
shift
;;
-l*)
func_cl_dashl "${1#-l}"
set x "$@" "$lib"
shift
;;
-L)
eat=1
func_cl_dashL "$2"
;;
-L*)
func_cl_dashL "${1#-L}"
;;
-static)
shared=false
;;
-Wl,*)
arg=${1#-Wl,}
save_ifs="$IFS"; IFS=','
for flag in $arg; do
IFS="$save_ifs"
linker_opts="$linker_opts $flag"
done
IFS="$save_ifs"
;;
-Xlinker)
eat=1
linker_opts="$linker_opts $2"
;;
-*)
set x "$@" "$1"
shift
;;
*.cc | *.CC | *.cxx | *.CXX | *.[cC]++)
func_file_conv "$1"
set x "$@" -Tp"$file"
shift
;;
*.c | *.cpp | *.CPP | *.lib | *.LIB | *.Lib | *.OBJ | *.obj | *.[oO])
func_file_conv "$1" mingw
set x "$@" "$file"
shift
;;
*)
set x "$@" "$1"
shift
;;
esac
fi
shift
done
if test -n "$linker_opts"; then
linker_opts="-link$linker_opts"
fi
exec "$@" $linker_opts
exit 1
}
eat=
case $1 in
'')
echo "$0: No command. Try '$0 --help' for more information." 1>&2
exit 1;
;;
-h | --h*)
cat <<\EOF
Usage: compile [--help] [--version] PROGRAM [ARGS]
Wrapper for compilers which do not understand '-c -o'.
Remove '-o dest.o' from ARGS, run PROGRAM with the remaining
arguments, and rename the output as expected.
If you are trying to build a whole package this is not the
right script to run: please start by reading the file 'INSTALL'.
Report bugs to <bug-automake@gnu.org>.
EOF
exit $?
;;
-v | --v*)
echo "compile $scriptversion"
exit $?
;;
cl | *[/\\]cl | cl.exe | *[/\\]cl.exe )
func_cl_wrapper "$@" # Doesn't return...
;;
esac
ofile=
cfile=
for arg
do
if test -n "$eat"; then
eat=
else
case $1 in
-o)
# configure might choose to run compile as 'compile cc -o foo foo.c'.
# So we strip '-o arg' only if arg is an object.
eat=1
case $2 in
*.o | *.obj)
ofile=$2
;;
*)
set x "$@" -o "$2"
shift
;;
esac
;;
*.c)
cfile=$1
set x "$@" "$1"
shift
;;
*)
set x "$@" "$1"
shift
;;
esac
fi
shift
done
if test -z "$ofile" || test -z "$cfile"; then
# If no '-o' option was seen then we might have been invoked from a
# pattern rule where we don't need one. That is ok -- this is a
# normal compilation that the losing compiler can handle. If no
# '.c' file was seen then we are probably linking. That is also
# ok.
exec "$@"
fi
# Name of file we expect compiler to create.
cofile=`echo "$cfile" | sed 's|^.*[\\/]||; s|^[a-zA-Z]:||; s/\.c$/.o/'`
# Create the lock directory.
# Note: use '[/\\:.-]' here to ensure that we don't use the same name
# that we are using for the .o file. Also, base the name on the expected
# object file name, since that is what matters with a parallel build.
lockdir=`echo "$cofile" | sed -e 's|[/\\:.-]|_|g'`.d
while true; do
if mkdir "$lockdir" >/dev/null 2>&1; then
break
fi
sleep 1
done
# FIXME: race condition here if user kills between mkdir and trap.
trap "rmdir '$lockdir'; exit 1" 1 2 15
# Run the compile.
"$@"
ret=$?
if test -f "$cofile"; then
test "$cofile" = "$ofile" || mv "$cofile" "$ofile"
elif test -f "${cofile}bj"; then
test "${cofile}bj" = "$ofile" || mv "${cofile}bj" "$ofile"
fi
rmdir "$lockdir"
exit $ret
# Local Variables:
# mode: shell-script
# sh-indentation: 2
# eval: (add-hook 'write-file-hooks 'time-stamp)
# time-stamp-start: "scriptversion="
# time-stamp-format: "%:y-%02m-%02d.%02H"
# time-stamp-time-zone: "UTC"
# time-stamp-end: "; # UTC"
# End:
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
<?xml version="1.0" encoding="UTF-8"?> <!-- -*- XML -*- -->
<!DOCTYPE busconfig PUBLIC
"-//freedesktop//DTD D-BUS Bus Configuration 1.0//EN"
"http://www.freedesktop.org/standards/dbus/1.0/busconfig.dtd">
<busconfig>
<!-- Only root can own the service -->
<policy user="root">
<allow own="org.freedesktop.UDisks2"/>
</policy>
<!-- Anyone can send messages to the owner of org.freedesktop.UDisks2 -->
<policy context="default">
<allow send_destination="org.freedesktop.UDisks2"/>
</policy>