From 3b3d7d069d10d53336dbada1c67f739e3492b218 Mon Sep 17 00:00:00 2001 From: Jan Engelhardt Date: Thu, 8 May 2014 01:28:46 +0200 Subject: [PATCH] doc: balance C indirections in function prototypes Shift the asterisks in the documentation's prototypes such that they are consistent among each other. Use the right side to match what is used in source code. Addendum to commit v209~82. --- man/sd_bus_message_get_cookie.xml | 8 ++-- man/sd_bus_request_name.xml | 4 +- man/sd_event_add_time.xml | 4 +- man/sd_get_seats.xml | 8 ++-- man/sd_id128_get_machine.xml | 4 +- man/sd_id128_randomize.xml | 2 +- man/sd_id128_to_string.xml | 4 +- man/sd_is_fifo.xml | 2 +- man/sd_journal_add_match.xml | 10 ++--- man/sd_journal_get_catalog.xml | 6 +-- man/sd_journal_get_cursor.xml | 8 ++-- man/sd_journal_get_cutoff_realtime_usec.xml | 12 +++--- man/sd_journal_get_data.xml | 26 +++++------ man/sd_journal_get_fd.xml | 14 +++--- man/sd_journal_get_realtime_usec.xml | 10 ++--- man/sd_journal_get_usage.xml | 4 +- man/sd_journal_next.xml | 12 +++--- man/sd_journal_open.xml | 16 +++---- man/sd_journal_print.xml | 8 ++-- man/sd_journal_query_unique.xml | 16 +++---- man/sd_journal_seek_head.xml | 12 +++--- man/sd_journal_stream_fd.xml | 2 +- man/sd_login_monitor_new.xml | 18 ++++---- man/sd_pid_get_session.xml | 24 +++++------ man/sd_seat_get_active.xml | 20 ++++----- man/sd_session_is_active.xml | 48 ++++++++++----------- man/sd_uid_get_state.xml | 8 ++-- 27 files changed, 155 insertions(+), 155 deletions(-) diff --git a/man/sd_bus_message_get_cookie.xml b/man/sd_bus_message_get_cookie.xml index 5e2526321..c761e5636 100644 --- a/man/sd_bus_message_get_cookie.xml +++ b/man/sd_bus_message_get_cookie.xml @@ -54,14 +54,14 @@ int sd_bus_message_get_cookie - sd_bus_message* message - uint64_t* cookie + sd_bus_message *message + uint64_t *cookie int sd_bus_message_get_reply_cookie - sd_bus_message* message - uint64_t* cookie + sd_bus_message *message + uint64_t *cookie diff --git a/man/sd_bus_request_name.xml b/man/sd_bus_request_name.xml index 9003f9fc3..e3a9266e4 100644 --- a/man/sd_bus_request_name.xml +++ b/man/sd_bus_request_name.xml @@ -54,14 +54,14 @@ int sd_bus_request_name - sd_bus* bus + sd_bus *bus const char *name uint64_t flags int sd_bus_release_name - sd_bus* bus + sd_bus *bus const char *name diff --git a/man/sd_event_add_time.xml b/man/sd_event_add_time.xml index 983e48656..dc2578438 100644 --- a/man/sd_event_add_time.xml +++ b/man/sd_event_add_time.xml @@ -65,13 +65,13 @@ along with systemd; If not, see . uint64_t usec uint64_t accuracy sd_event_time_handler_t handler - void* userdata + void *userdata int sd_event_source_get_time sd_event_source *source - usec_t* usec + usec_t *usec diff --git a/man/sd_get_seats.xml b/man/sd_get_seats.xml index 0fc82431c..a49dde80c 100644 --- a/man/sd_get_seats.xml +++ b/man/sd_get_seats.xml @@ -56,22 +56,22 @@ int sd_get_seats - char*** seats + char ***seats int sd_get_sessions - char*** sessions + char ***sessions int sd_get_uids - uid_t** users + uid_t **users int sd_get_machine_names - char*** machines + char ***machines diff --git a/man/sd_id128_get_machine.xml b/man/sd_id128_get_machine.xml index cce3979f8..164fcb73a 100644 --- a/man/sd_id128_get_machine.xml +++ b/man/sd_id128_get_machine.xml @@ -54,12 +54,12 @@ int sd_id128_get_machine - sd_id128_t* ret + sd_id128_t *ret int sd_id128_get_boot - sd_id128_t* ret + sd_id128_t *ret diff --git a/man/sd_id128_randomize.xml b/man/sd_id128_randomize.xml index 7e8c64635..e345004ea 100644 --- a/man/sd_id128_randomize.xml +++ b/man/sd_id128_randomize.xml @@ -53,7 +53,7 @@ int sd_id128_randomize - sd_id128_t* ret + sd_id128_t *ret diff --git a/man/sd_id128_to_string.xml b/man/sd_id128_to_string.xml index 72a67dc42..23e2bed5e 100644 --- a/man/sd_id128_to_string.xml +++ b/man/sd_id128_to_string.xml @@ -53,13 +53,13 @@ #include <systemd/sd-id128.h> - char* sd_id128_to_string + char *sd_id128_to_string sd_id128_t id, char s[33] int sd_id128_from_string - const char* s, sd_id128_t* ret + const char *s, sd_id128_t *ret diff --git a/man/sd_is_fifo.xml b/man/sd_is_fifo.xml index bb851d163..17ecca833 100644 --- a/man/sd_is_fifo.xml +++ b/man/sd_is_fifo.xml @@ -85,7 +85,7 @@ int fd int type int listening - const char* path + const char *path size_t length diff --git a/man/sd_journal_add_match.xml b/man/sd_journal_add_match.xml index d776b14eb..2daca1629 100644 --- a/man/sd_journal_add_match.xml +++ b/man/sd_journal_add_match.xml @@ -56,24 +56,24 @@ int sd_journal_add_match - sd_journal* j - const void* data + sd_journal *j + const void *data size_t size int sd_journal_add_disjunction - sd_journal* j + sd_journal *j int sd_journal_add_conjunction - sd_journal* j + sd_journal *j void sd_journal_flush_matches - sd_journal* j + sd_journal *j diff --git a/man/sd_journal_get_catalog.xml b/man/sd_journal_get_catalog.xml index 2495648c8..f84815022 100644 --- a/man/sd_journal_get_catalog.xml +++ b/man/sd_journal_get_catalog.xml @@ -54,14 +54,14 @@ int sd_journal_get_catalog - sd_journal* j - char** ret + sd_journal *j + char **ret int sd_journal_get_catalog_for_message_id sd_id128_t id - char** ret + char **ret diff --git a/man/sd_journal_get_cursor.xml b/man/sd_journal_get_cursor.xml index 4410d6e3c..015c14011 100644 --- a/man/sd_journal_get_cursor.xml +++ b/man/sd_journal_get_cursor.xml @@ -54,14 +54,14 @@ int sd_journal_get_cursor - sd_journal* j - char ** cursor + sd_journal *j + char **cursor int sd_journal_test_cursor - sd_journal* j - const char * cursor + sd_journal *j + const char *cursor diff --git a/man/sd_journal_get_cutoff_realtime_usec.xml b/man/sd_journal_get_cutoff_realtime_usec.xml index d32ab01fb..6df4b26e6 100644 --- a/man/sd_journal_get_cutoff_realtime_usec.xml +++ b/man/sd_journal_get_cutoff_realtime_usec.xml @@ -54,17 +54,17 @@ int sd_journal_get_cutoff_realtime_usec - sd_journal* j - uint64_t* from - uint64_t* to + sd_journal *j + uint64_t *from + uint64_t *to int sd_journal_get_cutoff_monotonic_usec - sd_journal* j + sd_journal *j sd_id128_t boot_id - uint64_t* from - uint64_t* to + uint64_t *from + uint64_t *to diff --git a/man/sd_journal_get_data.xml b/man/sd_journal_get_data.xml index c01db4eb9..343b680bc 100644 --- a/man/sd_journal_get_data.xml +++ b/man/sd_journal_get_data.xml @@ -58,41 +58,41 @@ int sd_journal_get_data - sd_journal* j - const char* field - const void** data - size_t* length + sd_journal *j + const char *field + const void **data + size_t *length int sd_journal_enumerate_data - sd_journal* j - const void** data - size_t* length + sd_journal *j + const void **data + size_t *length void sd_journal_restart_data - sd_journal* j + sd_journal *j SD_JOURNAL_FOREACH_DATA - sd_journal* j - const void* data + sd_journal *j + const void *data size_t length int sd_journal_set_data_threshold - sd_journal* j + sd_journal *j size_t sz int sd_journal_get_data_threshold - sd_journal* j - size_t* sz + sd_journal *j + size_t *sz diff --git a/man/sd_journal_get_fd.xml b/man/sd_journal_get_fd.xml index 16aeea2dc..809f00b9f 100644 --- a/man/sd_journal_get_fd.xml +++ b/man/sd_journal_get_fd.xml @@ -62,34 +62,34 @@ int sd_journal_get_fd - sd_journal* j + sd_journal *j int sd_journal_get_events - sd_journal* j + sd_journal *j int sd_journal_get_timeout - sd_journal* j - uint64_t* timeout_usec + sd_journal *j + uint64_t *timeout_usec int sd_journal_process - sd_journal* j + sd_journal *j int sd_journal_wait - sd_journal* j + sd_journal *j uint64_t timeout_usec int sd_journal_reliable_fd - sd_journal* j + sd_journal *j diff --git a/man/sd_journal_get_realtime_usec.xml b/man/sd_journal_get_realtime_usec.xml index a9e6f076d..0912c56de 100644 --- a/man/sd_journal_get_realtime_usec.xml +++ b/man/sd_journal_get_realtime_usec.xml @@ -54,15 +54,15 @@ int sd_journal_get_realtime_usec - sd_journal* j - uint64_t* usec + sd_journal *j + uint64_t *usec int sd_journal_get_monotonic_usec - sd_journal* j - uint64_t* usec - sd_id128_t* boot_id + sd_journal *j + uint64_t *usec + sd_id128_t *boot_id diff --git a/man/sd_journal_get_usage.xml b/man/sd_journal_get_usage.xml index e677b5f05..5119fba23 100644 --- a/man/sd_journal_get_usage.xml +++ b/man/sd_journal_get_usage.xml @@ -53,8 +53,8 @@ int sd_journal_get_usage - sd_journal* j - uint64_t* bytes + sd_journal *j + uint64_t *bytes diff --git a/man/sd_journal_next.xml b/man/sd_journal_next.xml index d3a7183c6..0216d6e08 100644 --- a/man/sd_journal_next.xml +++ b/man/sd_journal_next.xml @@ -58,34 +58,34 @@ int sd_journal_next - sd_journal* j + sd_journal *j int sd_journal_previous - sd_journal* j + sd_journal *j int sd_journal_next_skip - sd_journal* j + sd_journal *j uint64_t skip int sd_journal_previous_skip - sd_journal* j + sd_journal *j uint64_t skip SD_JOURNAL_FOREACH - sd_journal* j + sd_journal *j SD_JOURNAL_FOREACH_BACKWARDS - sd_journal* j + sd_journal *j diff --git a/man/sd_journal_open.xml b/man/sd_journal_open.xml index 3fc0d0c58..3d8a23ddf 100644 --- a/man/sd_journal_open.xml +++ b/man/sd_journal_open.xml @@ -62,34 +62,34 @@ int sd_journal_open - sd_journal** ret + sd_journal **ret int flags int sd_journal_open_directory - sd_journal** ret - const char* path + sd_journal **ret + const char *path int flags int sd_journal_open_files - sd_journal** ret - const char** paths + sd_journal **ret + const char **paths int flags int sd_journal_open_container - sd_journal** ret - const char* machine + sd_journal **ret + const char *machine int flags void sd_journal_close - sd_journal* j + sd_journal *j diff --git a/man/sd_journal_print.xml b/man/sd_journal_print.xml index c6f204b8c..b636bcff1 100644 --- a/man/sd_journal_print.xml +++ b/man/sd_journal_print.xml @@ -59,20 +59,20 @@ int sd_journal_print int priority - const char* format + const char *format ... int sd_journal_printv int priority - const char* format + const char *format va_list ap int sd_journal_send - const char* format + const char *format ... @@ -84,7 +84,7 @@ int sd_journal_perror - const char* message + const char *message diff --git a/man/sd_journal_query_unique.xml b/man/sd_journal_query_unique.xml index 6f489bb5b..250c7a9ff 100644 --- a/man/sd_journal_query_unique.xml +++ b/man/sd_journal_query_unique.xml @@ -56,26 +56,26 @@ int sd_journal_query_unique - sd_journal* j - const char* field + sd_journal *j + const char *field int sd_journal_enumerate_unique - sd_journal* j - const void** data - size_t* length + sd_journal *j + const void **data + size_t *length void sd_journal_restart_unique - sd_journal* j + sd_journal *j SD_JOURNAL_FOREACH_UNIQUE - sd_journal* j - const void* data + sd_journal *j + const void *data size_t length diff --git a/man/sd_journal_seek_head.xml b/man/sd_journal_seek_head.xml index 9ee14e476..284479a1d 100644 --- a/man/sd_journal_seek_head.xml +++ b/man/sd_journal_seek_head.xml @@ -58,31 +58,31 @@ int sd_journal_seek_head - sd_journal* j + sd_journal *j int sd_journal_seek_tail - sd_journal* j + sd_journal *j int sd_journal_seek_monotonic_usec - sd_journal* j + sd_journal *j sd_id128_t boot_id uint64_t usec int sd_journal_seek_realtime_usec - sd_journal* j + sd_journal *j uint64_t usec int sd_journal_seek_cursor - sd_journal* j - const char * cursor + sd_journal *j + const char *cursor diff --git a/man/sd_journal_stream_fd.xml b/man/sd_journal_stream_fd.xml index e7bd661a7..2cfaa87e9 100644 --- a/man/sd_journal_stream_fd.xml +++ b/man/sd_journal_stream_fd.xml @@ -53,7 +53,7 @@ int sd_journal_stream_fd - const char* identifier + const char *identifier int priority int level_prefix diff --git a/man/sd_login_monitor_new.xml b/man/sd_login_monitor_new.xml index aca708722..4d9e76d14 100644 --- a/man/sd_login_monitor_new.xml +++ b/man/sd_login_monitor_new.xml @@ -59,34 +59,34 @@ int sd_login_monitor_new - const char* category - sd_login_monitor** ret + const char *category + sd_login_monitor **ret - sd_login_monitor* sd_login_monitor_unref - sd_login_monitor* m + sd_login_monitor *sd_login_monitor_unref + sd_login_monitor *m int sd_login_monitor_flush - sd_login_monitor* m + sd_login_monitor *m int sd_login_monitor_get_fd - sd_login_monitor* m + sd_login_monitor *m int sd_login_monitor_get_events - sd_login_monitor* m + sd_login_monitor *m int sd_login_monitor_get_timeout - sd_login_monitor* m - uint64_t* timeout_usec + sd_login_monitor *m + uint64_t *timeout_usec diff --git a/man/sd_pid_get_session.xml b/man/sd_pid_get_session.xml index a8266e020..933138da1 100644 --- a/man/sd_pid_get_session.xml +++ b/man/sd_pid_get_session.xml @@ -67,73 +67,73 @@ int sd_pid_get_session pid_t pid - char** session + char **session int sd_pid_get_unit pid_t pid - char** unit + char **unit int sd_pid_get_user_unit pid_t pid - char** unit + char **unit int sd_pid_get_owner_uid pid_t pid - uid_t* uid + uid_t *uid int sd_pid_get_machine_name pid_t pid - char** name + char **name int sd_pid_get_slice pid_t pid - char** slice + char **slice int sd_peer_get_session int fd - char** session + char **session int sd_peer_get_unit int fd - char** unit + char **unit int sd_peer_get_user_unit int fd - char** unit + char **unit int sd_peer_get_owner_uid int fd - uid_t* uid + uid_t *uid int sd_peer_get_machine_name int fd - char** name + char **name int sd_peer_get_slice int fd - char** slice + char **slice diff --git a/man/sd_seat_get_active.xml b/man/sd_seat_get_active.xml index f2550dd5c..ba6cfeb66 100644 --- a/man/sd_seat_get_active.xml +++ b/man/sd_seat_get_active.xml @@ -57,32 +57,32 @@ int sd_seat_get_active - const char* seat - char** session - uid_t* uid + const char *seat + char **session + uid_t *uid int sd_seat_get_sessions - const char* seat - char*** sessions - uid_t** uid - unsigned int* n_uids + const char *seat + char ***sessions + uid_t **uid + unsigned int *n_uids int sd_seat_can_multi_session - const char* seat + const char *seat int sd_seat_can_tty - const char* seat + const char *seat int sd_seat_can_graphical - const char* seat + const char *seat diff --git a/man/sd_session_is_active.xml b/man/sd_session_is_active.xml index 31a611996..407354ae7 100644 --- a/man/sd_session_is_active.xml +++ b/man/sd_session_is_active.xml @@ -65,78 +65,78 @@ int sd_session_is_active - const char* session + const char *session int sd_session_is_remote - const char* session + const char *session int sd_session_get_state - const char* session - char** state + const char *session + char **state int sd_session_get_uid - const char* session - uid_t* uid + const char *session + uid_t *uid int sd_session_get_seat - const char* session - char** seat + const char *session + char **seat int sd_session_get_service - const char* session - char** service + const char *session + char **service int sd_session_get_type - const char* session - char** type + const char *session + char **type int sd_session_get_class - const char* session - char** class + const char *session + char **class int sd_session_get_display - const char* session - char** display + const char *session + char **display int sd_session_get_remote_host - const char* session - char** remote_host + const char *session + char **remote_host int sd_session_get_remote_user - const char* session - char** remote_user + const char *session + char **remote_user int sd_session_get_tty - const char* session - char** tty + const char *session + char **tty int sd_session_get_vt - const char* session - unsigned int* vt + const char *session + unsigned int *vt diff --git a/man/sd_uid_get_state.xml b/man/sd_uid_get_state.xml index f2899eed6..01ad0abfc 100644 --- a/man/sd_uid_get_state.xml +++ b/man/sd_uid_get_state.xml @@ -57,28 +57,28 @@ int sd_uid_get_state uid_t uid - char** state + char **state int sd_uid_is_on_seat uid_t uid int require_active - const char* seat + const char *seat int sd_uid_get_sessions uid_t uid int require_active - char*** sessions + char ***sessions int sd_uid_get_seats uid_t uid int require_active - char*** seats + char ***seats -- 2.30.2