NetworkManager/clients/tui/nmt-utils.c
Thomas Haller 3b69f02164 all: unify format of our Copyright source code comments
```bash

readarray -d '' FILES < <(
  git ls-files -z \
    ':(exclude)po' \
    ':(exclude)shared/c-rbtree' \
    ':(exclude)shared/c-list' \
    ':(exclude)shared/c-siphash' \
    ':(exclude)shared/c-stdaux' \
    ':(exclude)shared/n-acd' \
    ':(exclude)shared/n-dhcp4' \
    ':(exclude)src/systemd/src' \
    ':(exclude)shared/systemd/src' \
    ':(exclude)m4' \
    ':(exclude)COPYING*'
  )

sed \
  -e 's/^\(--\|#\| \*\) *\(([cC]) *\)\?Copyright \+\(\(([cC])\) \+\)\?\(\(20\|19\)[0-9][0-9]\) *[-–] *\(\(20\|19\)[0-9][0-9]\) \+\([^ ].*\)$/\1 C1pyright#\5 - \7#\9/' \
  -e 's/^\(--\|#\| \*\) *\(([cC]) *\)\?Copyright \+\(\(([cC])\) \+\)\?\(\(20\|19\)[0-9][0-9]\) *[,] *\(\(20\|19\)[0-9][0-9]\) \+\([^ ].*\)$/\1 C2pyright#\5, \7#\9/' \
  -e 's/^\(--\|#\| \*\) *\(([cC]) *\)\?Copyright \+\(\(([cC])\) \+\)\?\(\(20\|19\)[0-9][0-9]\) \+\([^ ].*\)$/\1 C3pyright#\5#\7/' \
  -e 's/^Copyright \(\(20\|19\)[0-9][0-9]\) \+\([^ ].*\)$/C4pyright#\1#\3/' \
  -i \
  "${FILES[@]}"

echo ">>> untouched Copyright lines"
git grep Copyright "${FILES[@]}"

echo ">>> Copyright lines with unusual extra"
git grep '\<C[0-9]pyright#' "${FILES[@]}" | grep -i reserved

sed \
  -e 's/\<C[0-9]pyright#\([^#]*\)#\(.*\)$/Copyright (C) \1 \2/' \
  -i \
  "${FILES[@]}"

```

https://gitlab.freedesktop.org/NetworkManager/NetworkManager/merge_requests/298
2019-10-02 17:03:52 +02:00

136 lines
3.2 KiB
C

// SPDX-License-Identifier: GPL-2.0+
/*
* Copyright (C) 2013 Red Hat, Inc.
*/
/**
* SECTION:nmt-utils
* @short_description: Miscellaneous nmtui-specific utilities
*/
#include "nm-default.h"
#include "nmt-utils.h"
/**
* NmtSyncOp:
*
* A helper object used when synchronously waiting for an asynchronous
* operation to complete.
*
* The caller first does:
*
* |[
* NmtSyncOp op;
*
* nmt_sync_op_init (&op);
* ]|
*
* It then passes the op as the user_data to the async operation's
* callback function, and then calls nmt_sync_op_wait_boolean() or
* nmt_sync_op_wait_pointer() to wait for the result.
*
* When the async callback is invoked, it should call
* nmt_sync_op_complete_boolean() or nmt_sync_op_complete_pointer() to
* return a result or an error to the caller.
*
* There is no free/clear function; any memory that needs to be freed
* will have been returned to the caller from
* nmt_sync_op_wait_boolean() or nmt_sync_op_wait_pointer(), so there
* is nothing left that needs to be freed.
*/
typedef struct {
gpointer result;
GError *error;
gpointer complete;
} NmtSyncOpReal;
/**
* nmt_sync_op_init:
* @op: pointer to a stack-allocated #NmtSyncOp
*
* Initializes @op before use.
*/
void
nmt_sync_op_init (NmtSyncOp *op)
{
memset (op, 0, sizeof (*op));
}
/**
* nmt_sync_op_wait_boolean:
* @op: the #NmtSyncOp
* @error: return location for a #GError
*
* This runs the main loop until @op's operation returns, and then
* returns the result or error.
*
* Returns: the result of the operation.
*/
gboolean
nmt_sync_op_wait_boolean (NmtSyncOp *op,
GError **error)
{
return GPOINTER_TO_UINT (nmt_sync_op_wait_pointer (op, error));
}
/**
* nmt_sync_op_complete_boolean:
* @op: the #NmtSyncOp
* @result: the result of the operation
* @error: (allow-none): the error, or %NULL
*
* Completes @op and returns @result and/or @error to the caller.
*/
void
nmt_sync_op_complete_boolean (NmtSyncOp *op,
gboolean result,
GError *error)
{
nmt_sync_op_complete_pointer (op, GUINT_TO_POINTER (result), error);
}
/**
* nmt_sync_op_wait_pointer:
* @op: the #NmtSyncOp
* @error: return location for a #GError
*
* This runs the main loop until @op's operation returns, and then
* returns the result or error.
*
* Returns: the result of the operation.
*/
gpointer
nmt_sync_op_wait_pointer (NmtSyncOp *op,
GError **error)
{
NmtSyncOpReal *real = (NmtSyncOpReal *)op;
while (!real->complete)
g_main_context_iteration (NULL, TRUE);
if (real->error)
g_propagate_error (error, real->error);
return real->result;
}
/**
* nmt_sync_op_complete_pointer:
* @op: the #NmtSyncOp
* @result: the result of the operation
* @error: (allow-none): the error, or %NULL
*
* Completes @op and returns @result and/or @error to the caller.
*/
void
nmt_sync_op_complete_pointer (NmtSyncOp *op,
gpointer result,
GError *error)
{
NmtSyncOpReal *real = (NmtSyncOpReal *)op;
real->result = result;
real->error = error ? g_error_copy (error) : NULL;
real->complete = GUINT_TO_POINTER (TRUE);
}