From 3b3d7d069d10d53336dbada1c67f739e3492b218 Mon Sep 17 00:00:00 2001 From: Jan Engelhardt Date: Thu, 8 May 2014 01:28:46 +0200 Subject: 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(-) (limited to 'man') diff --git a/man/sd_bus_message_get_cookie.xml b/man/sd_bus_message_get_cookie.xml index 5e2526321e..c761e5636f 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 9003f9fc32..e3a9266e47 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 983e486562..dc25784388 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 0fc82431cf..a49dde80c8 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 cce3979f85..164fcb73a5 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 7e8c646353..e345004eae 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 72a67dc427..23e2bed5e3 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 bb851d1638..17ecca8336 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 d776b14ebe..2daca1629c 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 2495648c89..f84815022f 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 4410d6e3c0..015c14011e 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 d32ab01fbd..6df4b26e6f 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 c01db4eb93..343b680bcb 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 16aeea2dc7..809f00b9f3 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 a9e6f076de..0912c56dea 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 e677b5f056..5119fba230 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 d3a7183c66..0216d6e089 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 3fc0d0c585..3d8a23ddfc 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 c6f204b8c6..b636bcff17 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 6f489bb5b4..250c7a9ff8 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 9ee14e476e..284479a1df 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 e7bd661a7a..2cfaa87e9a 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 aca7087222..4d9e76d144 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 a8266e0206..933138da16 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 f2550dd5c5..ba6cfeb669 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 31a611996e..407354ae7f 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 f2899eed63..01ad0abfce 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 -- cgit v1.2.3