[Pkg-privacy-commits] [libgsecuredelete] 44/168: Fix typos in docs and correct a little some parts.
Ulrike Uhlig
u-guest at moszumanska.debian.org
Thu Jul 7 20:06:37 UTC 2016
This is an automated email from the git hooks/post-receive script.
u-guest pushed a commit to branch master
in repository libgsecuredelete.
commit 381d96c1fa8245238b080f30223f1ec7b8d7ce88
Author: Colomban Wendling <ban at herbesfolles.org>
Date: Fri Dec 18 01:13:21 2009 +0100
Fix typos in docs and correct a little some parts.
---
gsecuredelete/async-operation.vala | 13 +++++++------
gsecuredelete/delete-operation.vala | 20 +++++++++++---------
gsecuredelete/swap-operation.vala | 8 ++++----
gsecuredelete/utils.vala | 2 +-
4 files changed, 23 insertions(+), 20 deletions(-)
diff --git a/gsecuredelete/async-operation.vala b/gsecuredelete/async-operation.vala
index f724b0e..8c1d6c5 100644
--- a/gsecuredelete/async-operation.vala
+++ b/gsecuredelete/async-operation.vala
@@ -48,7 +48,7 @@ namespace Gsd
* as less efforts as possible.
*
* To subclass this class, the only thing you need to implement is the
- * argument builder, that gives the arguments of the spawned command; but you
+ * argument builder, that gives the arguments of the spawned command; and you
* need to set the AsyncOperation::path property to the command to spawn in
* your constructor too (hence it is not required, it is slightly better to
* set it since it must be set before calling run() or run_sync() - or getting
@@ -92,12 +92,12 @@ namespace Gsd
* if (success) {
* stdout.printf ("success!\n");
* } else {
- * stderr.printf ("failure: %s\n", error.message);
+ * stderr.printf ("failure: %s\n", error);
* }
* });
* // and the progress callback
* foo.progress.connect ((progress) => {
- * stdout.printf ("%.0f%%", progress * 100);
+ * stdout.printf ("\r%.0f%%", progress * 100);
* });
* foo.run ();
*
@@ -184,7 +184,8 @@ namespace Gsd
protected abstract List<string> build_args ()
throws AsyncOperationError;
- /* converts the args built by build_args() to the expected format */
+ /* converts the args built by build_args() to the expected format, and add
+ * the command itself */
private string?[] do_build_args ()
throws AsyncOperationError
{
@@ -220,7 +221,7 @@ namespace Gsd
/* returns the value at which the progress is full. When the progress reach
* this value, it will be considered to be at 100% (This has no impact
- * other than reporting the current progress)
+ * other than reporting the current progress state).
*/
protected virtual uint get_max_progress ()
{
@@ -327,7 +328,7 @@ namespace Gsd
* to use the parent's one.
* @spawn_flags: %SpawnFlags. You may only use the SEARCH_PATH and
* CHILD_INHERITS_STDIN flags, others may conflict.
- * @watch_interval: time (in milliseconds) between two check for subprocess
+ * @watch_interval: time (in milliseconds) between two check for subprocess'
* status. A too short value may use too much CPU and a too
* big may be less responsive.
*
diff --git a/gsecuredelete/delete-operation.vala b/gsecuredelete/delete-operation.vala
index 0f414f7..1e1b808 100644
--- a/gsecuredelete/delete-operation.vala
+++ b/gsecuredelete/delete-operation.vala
@@ -31,7 +31,9 @@ namespace Gsd
private uint n_files = 0;
/* properties */
- /* list of files */
+ /** paths:
+ * List of all files to wipe.
+ */
public List<string> paths {
get {
return this._paths;
@@ -55,14 +57,14 @@ namespace Gsd
}
/** remove_path:
- * @path: a path already added you don't want to remove.
+ * @path: a path already added you want to remove from the list.
*
- * Removes a path from the list of paths to remove.
+ * Removes a path from the list of paths to wipe.
* <warning>
- * This is NOT a filter for files not to remove! It only remove a path
- * previously added with add_path() from the list of paths to remove, it
- * does not prevent removing of a path if the directory containing it is
- * in the list of paths to remove.
+ * This is NOT a filter for files not to wipe! It only remove a path
+ * previously added with add_path() from the list of paths to wipe, it
+ * does not prevent wiping of a path if the directory containing it is
+ * in the list of paths to wipe.
* </warning>
*/
public void remove_path (string path)
@@ -81,7 +83,7 @@ namespace Gsd
}
}
- /* builds the command's arguments (argv) */
+ /* builds the command's argument vector */
protected override List<string> build_args ()
throws AsyncOperationError
{
@@ -105,7 +107,7 @@ namespace Gsd
protected override void cleanup ()
{
- /* empty the paths' list not to try to remove them again at next call */
+ /* empty the path list not to try to wipe them again at next call */
this._paths = null;
}
diff --git a/gsecuredelete/swap-operation.vala b/gsecuredelete/swap-operation.vala
index d4a9c28..24067a1 100644
--- a/gsecuredelete/swap-operation.vala
+++ b/gsecuredelete/swap-operation.vala
@@ -36,8 +36,8 @@ namespace Gsd
/**
* Whether to throw an error if the swap is detected as being currently
* used.
- * This may be useful because doing the operation on a in-use swap may crash
- * the system.
+ * This may be useful because doing the operation on an in-use swap device
+ * may crash the system.
*/
public bool check_device {
get;
@@ -50,7 +50,7 @@ namespace Gsd
this.path = Config.SSWAP_PATH;
}
- /* check whether a swap device is currently in use by the system or not.
+ /* checks whether a swap device is currently in use by the system or not.
* TODO: For now we parse /proc/swaps to know it.. is this portable and/or
* the correct way to proceed? */
private bool swap_is_in_use (string swapdev)
@@ -92,7 +92,7 @@ namespace Gsd
if (this.device == null) {
throw new AsyncOperationError.ARGS_ERROR ("Missing device to wipe");
}
- /* no really clean to throw AsyncOperationError.SUBCLASS_ERROR, but
+ /* not really clean to throw AsyncOperationError.SUBCLASS_ERROR, but
* there's no clean way to do that.. */
if (this.check_device && this.swap_is_in_use (this.device)) {
throw new AsyncOperationError.SUBCLASS_ERROR ("The swap device \"%s\" is in use",
diff --git a/gsecuredelete/utils.vala b/gsecuredelete/utils.vala
index 68dd687..cf85f3c 100644
--- a/gsecuredelete/utils.vala
+++ b/gsecuredelete/utils.vala
@@ -147,7 +147,7 @@ namespace Gsd
*
* Counts the number of occurrence of a given byte in a file descriptor.
* This function is non-blocking and returns 0 if there is no data in the
- * buffer rather than blocking waiting for data to read.
+ * buffer rather than blocking waiting for data.
*
* Returns: the number of occurrences of @byte in @fd.
*/
--
Alioth's /usr/local/bin/git-commit-notice on /srv/git.debian.org/git/pkg-privacy/packages/libgsecuredelete.git
More information about the Pkg-privacy-commits
mailing list