Austin Group Defect Tracker

Aardvark Mark IV


Viewing Issue Simple Details Jump to Notes ] Issue History ] Print ]
ID Category Severity Type Date Submitted Last Update
0001891 [Online Pubs] Base Definitions Editorial Omission 2024-12-12 03:31 2025-01-10 11:22
Reporter larryv View Status public  
Assigned To
Priority normal Resolution Accepted  
Status Applied  
Name Lawrence Velázquez
Organization
User Reference
URL see "Desired Action"
Section see "Desired Action"
Summary 0001891: Many function references lack "()" suffix
Description Many function references that have a "()" suffix in the PDF version lack it in the HTML version. I don't know if there's a rationale behind this, but it creates inconsistency between the PDF and HTML versions and between the references that drop "()" in the HTML version and those that retain it.

(It also bucks the typographical conventions, although I know those are not normative.)
Desired Action In https://pubs.opengroup.org/onlinepubs/9799919799/basedefs/V1_chap02.html#tag_02_01_01 [^] (2.1.1 Requirements), change:
See XSH confstr .
to:
See XSH confstr().


In https://pubs.opengroup.org/onlinepubs/9799919799/basedefs/V1_chap03.html#tag_03_141 [^] (3.141 File Descriptor), change:
(see sysconf )
to:
(see sysconf())


In https://pubs.opengroup.org/onlinepubs/9799919799/basedefs/V1_chap03.html#tag_03_181 [^] (3.181 Job Control), change:
(see for example setpgid )
to:
(see for example setpgid())


In https://pubs.opengroup.org/onlinepubs/9799919799/basedefs/V1_chap03.html#tag_03_386 [^] (3.386 Text Domain), change:
the bindtextdomain and gettext family of functions
to:
the bindtextdomain() and gettext family of functions


In https://pubs.opengroup.org/onlinepubs/9799919799/basedefs/V1_chap04.html#tag_04_11 [^] (4.11 File System Cache), change:
(see write )
to:
(see write())


In https://pubs.opengroup.org/onlinepubs/9799919799/basedefs/V1_chap04.html#tag_04_23 [^] (4.23 Treatment of Error Conditions for Mathematical Functions), change:
as implied by XSH feraiseexcept ,
to:
as implied by XSH feraiseexcept(),


In https://pubs.opengroup.org/onlinepubs/9799919799/basedefs/V1_chap04.html#tag_04_26_01 [^] (4 General Concepts - Footnotes), change:
(see XSH rename )
to:
(see XSH rename())


In https://pubs.opengroup.org/onlinepubs/9799919799/basedefs/V1_chap08.html#tag_08_01 [^] (8.1 Environment Variable Definition), change:
See getenv and XCU 2.13 Shell Execution Environment for methods of accessing these variables.
to:
See getenv() and XCU 2.13 Shell Execution Environment for methods of accessing these variables.
and change:
(see getenv )
to:
(see getenv())


In https://pubs.opengroup.org/onlinepubs/9799919799/basedefs/V1_chap08.html#tag_08_03 [^] (8.3 Other Environment Variables), change 2 instances of:
(see XSH tcgetwinsize )
to:
(see XSH tcgetwinsize())


In https://pubs.opengroup.org/onlinepubs/9799919799/basedefs/V1_chap11.html#tag_11_01_01 [^] (11.1.1 Opening a Terminal Device File), change:
Opening the subsidiary side of a pseudo-terminal; see XSH ptsname .
to:
Opening the subsidiary side of a pseudo-terminal; see XSH ptsname().


In https://pubs.opengroup.org/onlinepubs/9799919799/basedefs/aio.h.html [^] (<aio.h>), change:
XSH aio_cancel , aio_error , aio_fsync , aio_read , aio_return , aio_suspend , aio_write , fsync , lio_listio , lseek , read , write
to:
XSH aio_cancel(), aio_error(), aio_fsync(), aio_read(), aio_return(), aio_suspend(), aio_write(), fsync(), lio_listio(), lseek(), read(), write()


In https://pubs.opengroup.org/onlinepubs/9799919799/basedefs/arpa_inet.h.html [^] (<arpa/inet.h>), change:
XSH htonl , inet_addr , inet_ntop
to:
XSH htonl(), inet_addr(), inet_ntop()


In https://pubs.opengroup.org/onlinepubs/9799919799/basedefs/assert.h.html [^] (<assert.h>), change:
XSH assert
to:
XSH assert()


In https://pubs.opengroup.org/onlinepubs/9799919799/basedefs/complex.h.html [^] (<complex.h>), change:
XSH CMPLX , cabs , cacos , cacosh , carg , casin , casinh , catan , catanh , ccos , ccosh , cexp , cimag , clog , conj , cpow , cproj , creal , csin , csinh , csqrt , ctan , ctanh
to:
XSH CMPLX(), cabs(), cacos(), cacosh(), carg(), casin(), casinh(), catan(), catanh(), ccos(), ccosh(), cexp(), cimag(), clog(), conj(), cpow(), cproj(), creal(), csin(), csinh(), csqrt(), ctan(), ctanh()


In https://pubs.opengroup.org/onlinepubs/9799919799/basedefs/ctype.h.html [^] (<ctype.h>), change:
XSH 2.2 The Compilation Environment , isalnum , isalpha , isblank , iscntrl , isdigit , isgraph , islower , isprint , ispunct , isspace , isupper , isxdigit , mblen , mbstowcs , mbtowc , setlocale , tolower , toupper , wcstombs , wctomb
to:
XSH 2.2 The Compilation Environment , isalnum(), isalpha(), isblank(), iscntrl(), isdigit(), isgraph(), islower(), isprint(), ispunct(), isspace(), isupper(), isxdigit(), mblen(), mbstowcs(), mbtowc(), setlocale(), tolower(), toupper(), wcstombs(), wctomb()


In https://pubs.opengroup.org/onlinepubs/9799919799/basedefs/devctl.h.html [^] (<devctl.h>), change:
XSH posix_devctl
to:
XSH posix_devctl()


In https://pubs.opengroup.org/onlinepubs/9799919799/basedefs/dirent.h.html [^] (<dirent.h>), change (twice):
the RATIONALE for posix_getdents .
to:
the RATIONALE for posix_getdents().
and change:
XSH alphasort , closedir , dirfd , fdopendir , posix_getdents , readdir , rewinddir , seekdir , telldir
to:
XSH alphasort(), closedir(), dirfd(), fdopendir(), posix_getdents(), readdir(), rewinddir(), seekdir(), telldir()


In https://pubs.opengroup.org/onlinepubs/9799919799/basedefs/dlfcn.h.html [^] (<dlfcn.h>), change:
XSH dladdr , dlclose , dlerror , dlopen , dlsym
to:
XSH dladdr(), dlclose(), dlerror(), dlopen(), dlsym()


In https://pubs.opengroup.org/onlinepubs/9799919799/basedefs/endian.h.html [^] (<endian.h>), change:
XSH be16toh , htonl , swab
to:
XSH be16toh(), htonl(), swab()


In https://pubs.opengroup.org/onlinepubs/9799919799/basedefs/fcntl.h.html [^] (<fcntl.h>), change:
See the FUTURE DIRECTIONS section for open .
to:
See the FUTURE DIRECTIONS section for open().
and change:
XSH creat , exec , fcntl , futimens , open , posix_fadvise , posix_fallocate , posix_madvise
to:
XSH creat(), exec(), fcntl(), futimens(), open(), posix_fadvise(), posix_fallocate(), posix_madvise()


In https://pubs.opengroup.org/onlinepubs/9799919799/basedefs/fenv.h.html [^] (<fenv.h>), change:
XSH feclearexcept , fegetenv , fegetexceptflag , fegetround , feholdexcept , feraiseexcept , fetestexcept , feupdateenv
to:
XSH feclearexcept(), fegetenv(), fegetexceptflag(), fegetround(), feholdexcept(), feraiseexcept(), fetestexcept(), feupdateenv()


In https://pubs.opengroup.org/onlinepubs/9799919799/basedefs/fmtmsg.h.html [^] (<fmtmsg.h>), change:
XSH fmtmsg
to:
XSH fmtmsg()


In https://pubs.opengroup.org/onlinepubs/9799919799/basedefs/fnmatch.h.html [^] (<fnmatch.h>), change:
XSH fnmatch
to:
XSH fnmatch()


In https://pubs.opengroup.org/onlinepubs/9799919799/basedefs/ftw.h.html [^] (<ftw.h>), change:
XSH nftw
to:
XSH nftw()


In https://pubs.opengroup.org/onlinepubs/9799919799/basedefs/glob.h.html [^] (<glob.h>), change:
XSH glob
to:
XSH glob()


In https://pubs.opengroup.org/onlinepubs/9799919799/basedefs/grp.h.html [^] (<grp.h>), change:
XSH endgrent , getgrgid , getgrnam
to:
XSH endgrent(), getgrgid(), getgrnam()


In https://pubs.opengroup.org/onlinepubs/9799919799/basedefs/iconv.h.html [^] (<iconv.h>), change:
XSH iconv , iconv_close , iconv_open
to:
XSH iconv(), iconv_close(), iconv_open()


In https://pubs.opengroup.org/onlinepubs/9799919799/basedefs/inttypes.h.html [^] (<inttypes.h>), change:
XSH 2.2 The Compilation Environment , imaxabs , imaxdiv , strtoimax , wcstoimax
to:
XSH 2.2 The Compilation Environment , imaxabs(), imaxdiv(), strtoimax(), wcstoimax()


In https://pubs.opengroup.org/onlinepubs/9799919799/basedefs/langinfo.h.html [^] (<langinfo.h>), change:
XSH nl_langinfo , localeconv , strfmon , strftime
to:
XSH nl_langinfo(), localeconv(), strfmon(), strftime()


In https://pubs.opengroup.org/onlinepubs/9799919799/basedefs/libintl.h.html [^] (<libintl.h>), change:
XSH gettext , bindtextdomain
to:
XSH gettext(), bindtextdomain()


In https://pubs.opengroup.org/onlinepubs/9799919799/basedefs/libgen.h.html [^] (<libgen.h>), change:
XSH basename , dirname
to:
XSH basename(), dirname()


In https://pubs.opengroup.org/onlinepubs/9799919799/basedefs/limits.h.html [^] (<limits.h>), change:
See XSH sysconf .
to:
See XSH sysconf().
and change:
XSH 2.2 The Compilation Environment , fpathconf , getrlimit , sysconf
to:
XSH 2.2 The Compilation Environment , fpathconf(), getrlimit(), sysconf()


In https://pubs.opengroup.org/onlinepubs/9799919799/basedefs/locale.h.html [^] (<locale.h>), change:
XSH duplocale , freelocale , getlocalename_l , localeconv , newlocale , setlocale , uselocale
to:
XSH duplocale(), freelocale(), getlocalename_l(), localeconv(), newlocale(), setlocale(), uselocale()


In https://pubs.opengroup.org/onlinepubs/9799919799/basedefs/math.h.html [^] (<math.h>), change:
XSH 2.2 The Compilation Environment , acos , acosh , asin , asinh , atan , atan2 , atanh , cbrt , ceil , copysign , cos , cosh , erf , erfc , exp , exp2 , expm1 , fabs , fdim , floor , fma , fmax , fmin , fmod , fpclassify , frexp , hypot , ilogb , isfinite , isgreater , isinf , isnan , isnormal , isunordered , j0 , ldexp , lgamma , llrint , llround , log , log10 , log1p , log2 , logb , lrint , lround , modf , nan , nearbyint , nextafter , pow , remainder , remquo , rint , round , scalbln , signbit , sin , sinh , sqrt , tan , tanh , tgamma , trunc , y0
to:
XSH 2.2 The Compilation Environment , acos(), acosh(), asin(), asinh(), atan(), atan2(), atanh(), cbrt(), ceil(), copysign(), cos(), cosh(), erf(), erfc(), exp(), exp2(), expm1(), fabs(), fdim(), floor(), fma(), fmax(), fmin(), fmod(), fpclassify(), frexp(), hypot(), ilogb(), isfinite(), isgreater(), isinf(), isnan(), isnormal(), isunordered(), j0(), ldexp(), lgamma(), llrint(), llround(), log(), log10(), log1p(), log2(), logb(), lrint(), lround(), modf(), nan(), nearbyint(), nextafter(), pow(), remainder(), remquo(), rint(), round(), scalbln(), signbit(), sin(), sinh(), sqrt(), tan(), tanh(), tgamma(), trunc(), y0()


In https://pubs.opengroup.org/onlinepubs/9799919799/basedefs/monetary.h.html [^] (<monetary.h>), change:
XSH strfmon
to:
XSH strfmon()


In https://pubs.opengroup.org/onlinepubs/9799919799/basedefs/mqueue.h.html [^] (<mqueue.h>), change:
XSH mq_close , mq_getattr , mq_notify , mq_open , mq_receive , mq_send , mq_setattr , mq_unlink
to:
XSH mq_close(), mq_getattr(), mq_notify(), mq_open(), mq_receive(), mq_send(), mq_setattr(), mq_unlink()


In https://pubs.opengroup.org/onlinepubs/9799919799/basedefs/ndbm.h.html [^] (<ndbm.h>), change:
XSH dbm_clearerr
to:
XSH dbm_clearerr()

In https://pubs.opengroup.org/onlinepubs/9799919799/basedefs/net_if.h.html [^] (<net/if.h>), change:
XSH if_freenameindex , if_indextoname , if_nameindex , if_nametoindex
to:
XSH if_freenameindex(), if_indextoname(), if_nameindex(), if_nametoindex()


In https://pubs.opengroup.org/onlinepubs/9799919799/basedefs/netdb.h.html [^] (<netdb.h>), change:
(see XSH freeaddrinfo )
to:
(see XSH freeaddrinfo())
and change:
XSH bind , endhostent , endnetent , endprotoent , endservent , freeaddrinfo , gai_strerror , getnameinfo
to:
XSH bind(), endhostent(), endnetent(), endprotoent(), endservent(), freeaddrinfo(), gai_strerror(), getnameinfo()


In https://pubs.opengroup.org/onlinepubs/9799919799/basedefs/netinet_in.h.html [^] (<netinet/in.h>), change:
XSH bind , connect , getsockopt , htonl , sendmsg , sendto , setsockopt
to:
XSH bind(), connect(), getsockopt(), htonl(), sendmsg(), sendto(), setsockopt()


In https://pubs.opengroup.org/onlinepubs/9799919799/basedefs/netinet_tcp.h.html [^] (<netinet/tcp.h>), change:
XSH getsockopt , setsockopt
to:
XSH getsockopt(), setsockopt()


In https://pubs.opengroup.org/onlinepubs/9799919799/basedefs/nl_types.h.html [^] (<nl_types.h>), change:
XSH catclose , catgets , catopen , nl_langinfo
to:
XSH catclose(), catgets(), catopen(), nl_langinfo()


In https://pubs.opengroup.org/onlinepubs/9799919799/basedefs/poll.h.html [^] (<poll.h>), change:
XSH confstr , poll
to:
XSH confstr(), poll()


In https://pubs.opengroup.org/onlinepubs/9799919799/basedefs/pthread.h.html [^] (<pthread.h>), change:
XSH pthread_atfork , pthread_attr_destroy , pthread_attr_getdetachstate , pthread_attr_getguardsize , pthread_attr_getinheritsched , pthread_attr_getschedparam , pthread_attr_getschedpolicy , pthread_attr_getscope , pthread_attr_getstack , pthread_attr_getstacksize , pthread_barrier_destroy , pthread_barrier_wait , pthread_barrierattr_destroy , pthread_barrierattr_getpshared , pthread_cancel , pthread_cleanup_pop , pthread_cond_broadcast , pthread_cond_clockwait , pthread_cond_destroy , pthread_condattr_destroy , pthread_condattr_getclock , pthread_condattr_getpshared , pthread_create , pthread_detach , pthread_equal , pthread_exit , pthread_getcpuclockid , pthread_getschedparam , pthread_getspecific , pthread_join , pthread_key_create , pthread_key_delete , pthread_mutex_clocklock , pthread_mutex_consistent , pthread_mutex_destroy , pthread_mutex_getprioceiling , pthread_mutex_lock , pthread_mutexattr_destroy , pthread_mutexattr_getprioceiling , pthread_mutexattr_getprotocol , pthread_mutexattr_getpshared , pthread_mutexattr_getrobust , pthread_mutexattr_gettype , pthread_once , pthread_rwlock_clockrdlock , pthread_rwlock_clockwrlock , pthread_rwlock_destroy , pthread_rwlock_rdlock , pthread_rwlock_trywrlock , pthread_rwlock_unlock , pthread_rwlockattr_destroy , pthread_rwlockattr_getpshared , pthread_self , pthread_setcancelstate , pthread_setschedprio , pthread_spin_destroy , pthread_spin_lock , pthread_spin_unlock
to:
XSH pthread_atfork(), pthread_attr_destroy(), pthread_attr_getdetachstate(), pthread_attr_getguardsize(), pthread_attr_getinheritsched(), pthread_attr_getschedparam(), pthread_attr_getschedpolicy(), pthread_attr_getscope(), pthread_attr_getstack(), pthread_attr_getstacksize(), pthread_barrier_destroy(), pthread_barrier_wait(), pthread_barrierattr_destroy(), pthread_barrierattr_getpshared(), pthread_cancel(), pthread_cleanup_pop(), pthread_cond_broadcast(), pthread_cond_clockwait(), pthread_cond_destroy(), pthread_condattr_destroy(), pthread_condattr_getclock(), pthread_condattr_getpshared(), pthread_create(), pthread_detach(), pthread_equal(), pthread_exit(), pthread_getcpuclockid(), pthread_getschedparam(), pthread_getspecific(), pthread_join(), pthread_key_create(), pthread_key_delete(), pthread_mutex_clocklock(), pthread_mutex_consistent(), pthread_mutex_destroy(), pthread_mutex_getprioceiling(), pthread_mutex_lock(), pthread_mutexattr_destroy(), pthread_mutexattr_getprioceiling(), pthread_mutexattr_getprotocol(), pthread_mutexattr_getpshared(), pthread_mutexattr_getrobust(), pthread_mutexattr_gettype(), pthread_once(), pthread_rwlock_clockrdlock(), pthread_rwlock_clockwrlock(), pthread_rwlock_destroy(), pthread_rwlock_rdlock(), pthread_rwlock_trywrlock(), pthread_rwlock_unlock(), pthread_rwlockattr_destroy(), pthread_rwlockattr_getpshared(), pthread_self(), pthread_setcancelstate(), pthread_setschedprio(), pthread_spin_destroy(), pthread_spin_lock(), pthread_spin_unlock()


In https://pubs.opengroup.org/onlinepubs/9799919799/basedefs/pwd.h.html [^] (<pwd.h>), change:
XSH endpwent , getpwnam , getpwuid
to:
XSH endpwent(), getpwnam(), getpwuid()


In https://pubs.opengroup.org/onlinepubs/9799919799/basedefs/regex.h.html [^] (<regex.h>), change:
XSH regcomp
to:
XSH regcomp()


In https://pubs.opengroup.org/onlinepubs/9799919799/basedefs/sched.h.html [^] (<sched.h>), change:
XSH sched_get_priority_max , sched_getparam , sched_getscheduler , sched_rr_get_interval , sched_setparam , sched_setscheduler , sched_yield
to:
XSH sched_get_priority_max(), sched_getparam(), sched_getscheduler(), sched_rr_get_interval(), sched_setparam(), sched_setscheduler(), sched_yield()


In https://pubs.opengroup.org/onlinepubs/9799919799/basedefs/search.h.html [^] (<search.h>), change:
XSH hcreate , insque , lsearch , tdelete
to:
XSH hcreate(), insque(), lsearch(), tdelete()


In https://pubs.opengroup.org/onlinepubs/9799919799/basedefs/semaphore.h.html [^] (<semaphore.h>), change:
XSH sem_clockwait , sem_close , sem_destroy , sem_getvalue , sem_init , sem_open , sem_post , sem_trywait , sem_unlink
to:
XSH sem_clockwait(), sem_close(), sem_destroy(), sem_getvalue(), sem_init(), sem_open(), sem_post(), sem_trywait(), sem_unlink()


In https://pubs.opengroup.org/onlinepubs/9799919799/basedefs/setjmp.h.html [^] (<setjmp.h>), change:
XSH 2.2 The Compilation Environment , longjmp , setjmp , siglongjmp , sigsetjmp
to:
XSH 2.2 The Compilation Environment , longjmp(), setjmp(), siglongjmp(), sigsetjmp()


In https://pubs.opengroup.org/onlinepubs/9799919799/basedefs/signal.h.html [^] (<signal.h>), change:
See sigaction .
to:
See sigaction().
and change:
XSH 2.2 The Compilation Environment , alarm , kill , killpg , psiginfo , pthread_kill , pthread_sigmask , raise , sig2str , sigaction , sigaddset , sigaltstack , sigdelset , sigemptyset , sigfillset , sigismember , signal , sigpending , sigqueue , sigsuspend , sigtimedwait , sigwait , timer_create , wait , waitid
to:
XSH 2.2 The Compilation Environment , alarm(), kill(), killpg(), psiginfo(), pthread_kill(), pthread_sigmask(), raise(), sig2str(), sigaction(), sigaddset(), sigaltstack(), sigdelset(), sigemptyset(), sigfillset(), sigismember(), signal(), sigpending(), sigqueue(), sigsuspend(), sigtimedwait(), sigwait(), timer_create(), wait(), waitid()


In https://pubs.opengroup.org/onlinepubs/9799919799/basedefs/spawn.h.html [^] (<spawn.h>), change:
XSH posix_spawn , posix_spawn_file_actions_addclose , posix_spawn_file_actions_adddup2 , posix_spawn_file_actions_destroy , posix_spawnattr_destroy , posix_spawnattr_getflags , posix_spawnattr_getpgroup , posix_spawnattr_getschedparam , posix_spawnattr_getschedpolicy , posix_spawnattr_getsigdefault , posix_spawnattr_getsigmask
to:
XSH posix_spawn(), posix_spawn_file_actions_addclose(), posix_spawn_file_actions_adddup2(), posix_spawn_file_actions_destroy(), posix_spawnattr_destroy(), posix_spawnattr_getflags(), posix_spawnattr_getpgroup(), posix_spawnattr_getschedparam(), posix_spawnattr_getschedpolicy(), posix_spawnattr_getsigdefault(), posix_spawnattr_getsigmask()


In https://pubs.opengroup.org/onlinepubs/9799919799/basedefs/stdarg.h.html [^] (<stdarg.h>), change:
XSH exec , fprintf
to:
XSH exec(), fprintf()


In https://pubs.opengroup.org/onlinepubs/9799919799/basedefs/stdatomic.h.html [^] (<stdatomic.h>), change:
XSH atomic_compare_exchange_strong , atomic_exchange , atomic_fetch_add , atomic_flag_clear , atomic_flag_test_and_set , atomic_init , atomic_is_lock_free , atomic_load , atomic_signal_fence , atomic_store , kill_dependency .
to:
XSH atomic_compare_exchange_strong(), atomic_exchange(), atomic_fetch_add(), atomic_flag_clear(), atomic_flag_test_and_set(), atomic_init(), atomic_is_lock_free(), atomic_load(), atomic_signal_fence(), atomic_store(), kill_dependency().


In https://pubs.opengroup.org/onlinepubs/9799919799/basedefs/stddef.h.html [^] (<stddef.h>), change:
XSH confstr
to:
XSH confstr()


In https://pubs.opengroup.org/onlinepubs/9799919799/basedefs/stdio.h.html [^] (<stdio.h>), change:
XSH 2.2 The Compilation Environment , clearerr , ctermid , fclose , fdopen , feof , ferror , fflush , fgetc , fgetpos , fgets , fileno , flockfile , fmemopen , fopen , fprintf , fputc , fputs , fread , freopen , fscanf , fseek , fsetpos , ftell , fwrite , getc , getchar , getc_unlocked , getdelim , getopt , open_memstream , pclose , perror , popen , putc , putchar , puts , remove , rename , rewind , setbuf , setvbuf , stdin , system , tmpfile , tmpnam , ungetc , vfprintf , vfscanf
to:
XSH 2.2 The Compilation Environment , clearerr(), ctermid(), fclose(), fdopen(), feof(), ferror(), fflush(), fgetc(), fgetpos(), fgets(), fileno(), flockfile(), fmemopen(), fopen(), fprintf(), fputc(), fputs(), fread(), freopen(), fscanf(), fseek(), fsetpos(), ftell(), fwrite(), getc(), getchar(), getc_unlocked(), getdelim(), getopt(), open_memstream(), pclose(), perror(), popen(), putc(), putchar(), puts(), remove(), rename(), rewind(), setbuf(), setvbuf(), stdin(), system(), tmpfile(), tmpnam(), ungetc(), vfprintf(), vfscanf()


In https://pubs.opengroup.org/onlinepubs/9799919799/basedefs/stdlib.h.html [^] (<stdlib.h>), change:
XSH 2.2 The Compilation Environment , _Exit , a64l , abort , abs , atexit , atof , atoi , atol , bsearch , calloc , div , drand48 , exit , free , getenv , getsubopt , grantpt , initstate , labs , ldiv , malloc , mblen , mbstowcs , mbtowc , mkdtemp , posix_memalign , posix_openpt , ptsname , putenv , qsort , rand , realloc , realpath , setenv , setkey , strtod , strtol , strtoul , system , unlockpt , unsetenv , waitid , wcstombs , wctomb
to:
XSH 2.2 The Compilation Environment , _Exit(), a64l(), abort(), abs(), atexit(), atof(), atoi(), atol(), bsearch(), calloc(), div(), drand48(), exit(), free(), getenv(), getsubopt(), grantpt(), initstate(), labs(), ldiv(), malloc(), mblen(), mbstowcs(), mbtowc(), mkdtemp(), posix_memalign(), posix_openpt(), ptsname(), putenv(), qsort(), rand(), realloc(), realpath(), setenv(), setkey(), strtod(), strtol(), strtoul(), system(), unlockpt(), unsetenv(), waitid(), wcstombs(), wctomb()


In https://pubs.opengroup.org/onlinepubs/9799919799/basedefs/string.h.html [^] (<string.h>), change:
XSH 2.2 The Compilation Environment , memccpy , memchr , memcmp , memcpy , memmem , memmove , memset , strcat , strchr , strcmp , strcoll , strcpy , strcspn , strdup , strerror , strlcat , strlen , strncat , strncmp , strncpy , strpbrk , strrchr , strsignal , strspn , strstr , strtok , strxfrm
to:
XSH 2.2 The Compilation Environment , memccpy(), memchr(), memcmp(), memcpy(), memmem(), memmove(), memset(), strcat(), strchr(), strcmp(), strcoll(), strcpy(), strcspn(), strdup(), strerror(), strlcat(), strlen(), strncat(), strncmp(), strncpy(), strpbrk(), strrchr(), strsignal(), strspn(), strstr(), strtok(), strxfrm()


In https://pubs.opengroup.org/onlinepubs/9799919799/basedefs/strings.h.html [^] (<strings.h>), change:
XSH ffs , strcasecmp
to:
XSH ffs(), strcasecmp()


In https://pubs.opengroup.org/onlinepubs/9799919799/basedefs/sys_ipc.h.html [^] (<sys/ipc.h>), change:
XSH ftok
to:
XSH ftok()


In https://pubs.opengroup.org/onlinepubs/9799919799/basedefs/sys_mman.h.html [^] (<sys/mman.h>), change:
XSH mlock , mlockall , mmap , mprotect , msync , munmap , posix_madvise , posix_mem_offset , posix_typed_mem_get_info , posix_typed_mem_open , shm_open , shm_unlink
to:
XSH mlock(), mlockall(), mmap(), mprotect(), msync(), munmap(), posix_madvise(), posix_mem_offset(), posix_typed_mem_get_info(), posix_typed_mem_open(), shm_open(), shm_unlink()


In https://pubs.opengroup.org/onlinepubs/9799919799/basedefs/sys_msg.h.html [^] (<sys/msg.h>), change:
XSH msgctl , msgget , msgrcv , msgsnd
to:
XSH msgctl(), msgget(), msgrcv(), msgsnd()


In https://pubs.opengroup.org/onlinepubs/9799919799/basedefs/sys_resource.h.html [^] (<sys/resource.h>), change:
XSH getpriority , getrlimit , getrusage
to:
XSH getpriority(), getrlimit(), getrusage()


In https://pubs.opengroup.org/onlinepubs/9799919799/basedefs/sys_select.h.html [^] (<sys/select.h>), change:
XSH pselect
to:
XSH pselect()


In https://pubs.opengroup.org/onlinepubs/9799919799/basedefs/sys_sem.h.html [^] (<sys/sem.h>), change:
XSH semctl , semget , semop
to:
XSH semctl(), semget(), semop()


In https://pubs.opengroup.org/onlinepubs/9799919799/basedefs/sys_shm.h.html [^] (<sys/shm.h>), change:
XSH shmat , shmctl , shmdt , shmget
to:
XSH shmat(), shmctl(), shmdt(), shmget()


In https://pubs.opengroup.org/onlinepubs/9799919799/basedefs/sys_socket.h.html [^] (<sys/socket.h>), change:
XSH accept , bind , connect , getpeername , getsockname , getsockopt , listen , recv , recvfrom , recvmsg , send , sendmsg , sendto , setsockopt , shutdown , sockatmark , socket , socketpair
to:
XSH accept(), bind(), connect(), getpeername(), getsockname(), getsockopt(), listen(), recv(), recvfrom(), recvmsg(), send(), sendmsg(), sendto(), setsockopt(), shutdown(), sockatmark(), socket(), socketpair()


In https://pubs.opengroup.org/onlinepubs/9799919799/basedefs/sys_stat.h.html [^] (<sys/stat.h>), change:
XSH chmod , fchmod , fstat , fstatat , futimens , mkdir , mkfifo , mknod , umask
to:
XSH chmod(), fchmod(), fstat(), fstatat(), futimens(), mkdir(), mkfifo(), mknod(), umask()


In https://pubs.opengroup.org/onlinepubs/9799919799/basedefs/sys_statvfs.h.html [^] (<sys/statvfs.h>), change:
XSH fstatvfs
to:
XSH fstatvfs()


In https://pubs.opengroup.org/onlinepubs/9799919799/basedefs/sys_time.h.html [^] (<sys/time.h>), change:
XSH futimens , pselect
to:
XSH futimens(), pselect()


In https://pubs.opengroup.org/onlinepubs/9799919799/basedefs/sys_times.h.html [^] (<sys/times.h>), change:
XSH times
to:
XSH times()


In https://pubs.opengroup.org/onlinepubs/9799919799/basedefs/sys_types.h.html [^] (<sys/types.h>), change:
XSH confstr
to:
XSH confstr()


In https://pubs.opengroup.org/onlinepubs/9799919799/basedefs/sys_uio.h.html [^] (<sys/uio.h>), change:
XSH read , readv , write , writev
to:
XSH read(), readv(), write(), writev()


In https://pubs.opengroup.org/onlinepubs/9799919799/basedefs/sys_un.h.html [^] (<sys/un.h>), change:
XSH bind , socket , socketpair
to:
XSH bind(), socket(), socketpair()


In https://pubs.opengroup.org/onlinepubs/9799919799/basedefs/sys_utsname.h.html [^] (<sys/utsname.h>), change:
XSH uname
to:
XSH uname()


In https://pubs.opengroup.org/onlinepubs/9799919799/basedefs/sys_wait.h.html [^] (<sys/wait.h>), change:
XSH wait , waitid
to:
XSH wait(), waitid()


In https://pubs.opengroup.org/onlinepubs/9799919799/basedefs/syslog.h.html [^] (<syslog.h>), change:
XSH closelog
to:
XSH closelog()


In https://pubs.opengroup.org/onlinepubs/9799919799/basedefs/termios.h.html [^] (<termios.h>), change:
XSH cfgetispeed , cfgetospeed , cfsetispeed , cfsetospeed , confstr , tcdrain , tcflow , tcflush , tcgetattr , tcgetsid , tcgetwinsize , tcsendbreak , tcsetattr , tcsetwinsize
to:
XSH cfgetispeed(), cfgetospeed(), cfsetispeed(), cfsetospeed(), confstr(), tcdrain(), tcflow(), tcflush(), tcgetattr(), tcgetsid(), tcgetwinsize(), tcsendbreak(), tcsetattr(), tcsetwinsize()


In https://pubs.opengroup.org/onlinepubs/9799919799/basedefs/tgmath.h.html [^] (<tgmath.h>), change:
XSH cabs , fabs , modf
to:
XSH cabs(), fabs(), modf()


In https://pubs.opengroup.org/onlinepubs/9799919799/basedefs/threads.h.html [^] (<threads.h>), change:
XSH 2.9 Threads , call_once , cnd_broadcast , cnd_destroy , cnd_timedwait , mtx_destroy , mtx_lock , sysconf , thrd_create , thrd_current , thrd_detach , thrd_equal , thrd_exit , thrd_join , thrd_sleep , thrd_yield , tss_create , tss_delete , tss_get
to:
XSH 2.9 Threads , call_once(), cnd_broadcast(), cnd_destroy(), cnd_timedwait(), mtx_destroy(), mtx_lock(), sysconf(), thrd_create(), thrd_current(), thrd_detach(), thrd_equal(), thrd_exit(), thrd_join(), thrd_sleep(), thrd_yield(), tss_create(), tss_delete(), tss_get()


In https://pubs.opengroup.org/onlinepubs/9799919799/basedefs/time.h.html [^] (<time.h>), change:
When tm_isdst is passed to the mktime() function, it specifies how mktime() is to handle DST when calculating the time since the Epoch value; see mktime .
to:
When tm_isdst is passed to the mktime() function, it specifies how mktime() is to handle DST when calculating the time since the Epoch value; see mktime().
and change:
XSH 2.2 The Compilation Environment , asctime , clock , clock_getcpuclockid , clock_getres , clock_nanosleep , ctime , difftime , futimens , getdate , gmtime , localtime , mktime , mq_receive , mq_send , nanosleep , pthread_getcpuclockid , pthread_mutex_clocklock , pthread_rwlock_clockrdlock , pthread_rwlock_clockwrlock , sem_clockwait , strftime , strptime , sysconf , time , timer_create , timer_delete , timer_getoverrun , timespec_get , tzset
to:
XSH 2.2 The Compilation Environment , asctime(), clock(), clock_getcpuclockid(), clock_getres(), clock_nanosleep(), ctime(), difftime(), futimens(), getdate(), gmtime(), localtime(), mktime(), mq_receive(), mq_send(), nanosleep(), pthread_getcpuclockid(), pthread_mutex_clocklock(), pthread_rwlock_clockrdlock(), pthread_rwlock_clockwrlock(), sem_clockwait(), strftime(), strptime(), sysconf(), time(), timer_create(), timer_delete(), timer_getoverrun(), timespec_get(), tzset()


In https://pubs.opengroup.org/onlinepubs/9799919799/basedefs/uchar.h.html [^] (<uchar.h>), change:
XSH c16rtomb , mbrtoc16
to:
XSH c16rtomb(), mbrtoc16()


In https://pubs.opengroup.org/onlinepubs/9799919799/basedefs/unistd.h.html [^] (<unistd.h>), change:
XSH access , alarm , chown , close , confstr , crypt , ctermid , dup , _Exit , encrypt , exec , fchdir , fchown , fdatasync , fork , fpathconf , fsync , ftruncate , getcwd , getentropy , getegid , geteuid , getgid , getgroups , gethostid , gethostname , getlogin , getopt , getpgid , getpgrp , getpid , getppid , getresgid , getresuid , getsid , getuid , isatty , lchown , link , lockf , lseek , nice , pause , pipe , read , readlink , rmdir , setegid , seteuid , setgid , setpgid , setregid , setresgid , setresuid , setreuid , setsid , setuid , sleep , swab , symlink , sync , sysconf , tcgetpgrp , tcsetpgrp , truncate , ttyname , unlink , write
to:
XSH access(), alarm(), chown(), close(), confstr(), crypt(), ctermid(), dup(), _Exit(), encrypt(), exec(), fchdir(), fchown(), fdatasync(), fork(), fpathconf(), fsync(), ftruncate(), getcwd(), getentropy(), getegid(), geteuid(), getgid(), getgroups(), gethostid(), gethostname(), getlogin(), getopt(), getpgid(), getpgrp(), getpid(), getppid(), getresgid(), getresuid(), getsid(), getuid(), isatty(), lchown(), link(), lockf(), lseek(), nice(), pause(), pipe(), read(), readlink(), rmdir(), setegid(), seteuid(), setgid(), setpgid(), setregid(), setresgid(), setresuid(), setreuid(), setsid(), setuid(), sleep(), swab(), symlink(), sync(), sysconf(), tcgetpgrp(), tcsetpgrp(), truncate(), ttyname(), unlink(), write()


In https://pubs.opengroup.org/onlinepubs/9799919799/basedefs/utmpx.h.html [^] (<utmpx.h>), change:
XSH endutxent
to:
XSH endutxent()


In https://pubs.opengroup.org/onlinepubs/9799919799/basedefs/wchar.h.html [^] (<wchar.h>), change:
XSH 2.2 The Compilation Environment , btowc , confstr , fgetwc , fgetws , fputwc , fputws , fwide , fwprintf , fwscanf , getwc , getwchar , iswalnum , iswalpha , iswcntrl , iswctype , iswdigit , iswgraph , iswlower , iswprint , iswpunct , iswspace , iswupper , iswxdigit , mbrlen , mbrtowc , mbsinit , mbsrtowcs , open_memstream , putwc , putwchar , towlower , towupper , ungetwc , vfwprintf , vfwscanf , wcrtomb , wcscasecmp , wcscat , wcschr , wcscmp , wcscoll , wcscpy , wcscspn , wcsdup , wcsftime , wcslcat , wcslen , wcsncat , wcsncmp , wcsncpy , wcspbrk , wcsrchr , wcsrtombs , wcsspn , wcsstr , wcstod , wcstok , wcstol , wcstoul , wcswidth , wcsxfrm , wctob , wctype , wcwidth , wmemchr , wmemcmp , wmemcpy , wmemmove , wmemset
to:
XSH 2.2 The Compilation Environment , btowc(), confstr(), fgetwc(), fgetws(), fputwc(), fputws(), fwide(), fwprintf(), fwscanf(), getwc(), getwchar(), iswalnum(), iswalpha(), iswcntrl(), iswctype(), iswdigit(), iswgraph(), iswlower(), iswprint(), iswpunct(), iswspace(), iswupper(), iswxdigit(), mbrlen(), mbrtowc(), mbsinit(), mbsrtowcs(), open_memstream(), putwc(), putwchar(), towlower(), towupper(), ungetwc(), vfwprintf(), vfwscanf(), wcrtomb(), wcscasecmp(), wcscat(), wcschr(), wcscmp(), wcscoll(), wcscpy(), wcscspn(), wcsdup(), wcsftime(), wcslcat(), wcslen(), wcsncat(), wcsncmp(), wcsncpy(), wcspbrk(), wcsrchr(), wcsrtombs(), wcsspn(), wcsstr(), wcstod(), wcstok(), wcstol(), wcstoul(), wcswidth(), wcsxfrm(), wctob(), wctype(), wcwidth(), wmemchr(), wmemcmp(), wmemcpy(), wmemmove(), wmemset()


In https://pubs.opengroup.org/onlinepubs/9799919799/basedefs/wctype.h.html [^] (<wctype.h>), change:
XSH 2.2 The Compilation Environment , iswalnum , iswalpha , iswblank , iswcntrl , iswctype , iswdigit , iswgraph , iswlower , iswprint , iswpunct , iswspace , iswupper , iswxdigit , setlocale , towctrans , towlower , towupper , wctrans , wctype
to:
XSH 2.2 The Compilation Environment , iswalnum(), iswalpha(), iswblank(), iswcntrl(), iswctype(), iswdigit(), iswgraph(), iswlower(), iswprint(), iswpunct(), iswspace(), iswupper(), iswxdigit(), setlocale(), towctrans(), towlower(), towupper(), wctrans(), wctype()


In https://pubs.opengroup.org/onlinepubs/9799919799/basedefs/wordexp.h.html [^] (<wordexp.h>), change:
XSH wordexp
to:
XSH wordexp()
Tags No tags attached.
Attached Files

- Relationships

-  Notes
(0006997)
wakely (reporter)
2024-12-12 11:25

'()' is a nonsensical suffix anyway, saying something like "a call to open()" implies calling it with no arguments, which is not valid. In the C++ standard we've been trying to fix cases like this and refer to "a call to `open`" when we mean to refer to it by name (using monospace font for the name). If we say "a call to `open()`" that really should mean calling that function with an empty argument list.

I realise that might be too big a change for POSIX.
(0006999)
geoffclare (manager)
2024-12-12 14:24

This is not something that changed recently. All four Issue 7 HTML editions, going back to 2008, were the same.

It is also not something that can be changed on a case-by-case basis, being a result of the way the troff-to-HTML translator handles cross-references.
(0007002)
dwheeler (reporter)
2024-12-12 15:31

This typographical convention may appear odd to some readers, but it's clearly documented, so there's nothing *wrong* here. Under "Typographical Conventions" https://pubs.opengroup.org/onlinepubs/9799919799/frontmatter/typographics.html [^]

It says:

C-Language Function | system()

It's unfortunate that the HTML translator changes this. I wish the translator did't do this, I think it's a minor bug. That said, there's even an out for this within POSIX: "The typographical conventions listed here are for ease of reading only. Editorial inconsistencies in the use of typography are unintentional and have no normative meaning in POSIX.1-2024."

I find the suffix () helpful, but if people want to remove them from a future version of POSIX, well, they can file that recommendation :-).
(0007006)
larryv (reporter)
2024-12-13 00:38

Note: 0006999:
It is also not something that can be changed on a case-by-case basis, being a result of the way the troff-to-HTML translator handles cross-references.
Hm, so in the HTML edition the function links without "()" are generated from cross-references, while the ones with "()" aren't? I did notice that most (if not all) of the former are linked in the PDF too, while most (if not all) of the latter are not linked in the PDF.

In any case, if this technical limitation is insurmountable, that's disappointing but ultimately not all that important. Feel free to close.
(0007035)
agadmin (administrator)
2025-01-04 07:12
edited on: 2025-01-07 10:50

We have deployed an update today to change the xref handling for functions. The online specification has been refreshed including the download bundles.


- Issue History
Date Modified Username Field Change
2024-12-12 03:31 larryv New Issue
2024-12-12 03:31 larryv Name => Lawrence Velázquez
2024-12-12 03:31 larryv URL => see "Desired Action"
2024-12-12 03:31 larryv Section => see "Desired Action"
2024-12-12 11:25 wakely Note Added: 0006997
2024-12-12 14:24 geoffclare Note Added: 0006999
2024-12-12 15:31 dwheeler Note Added: 0007002
2024-12-12 15:31 dwheeler Note Added: 0007003
2024-12-12 15:35 dwheeler Note Deleted: 0007003
2024-12-13 00:38 larryv Note Added: 0007006
2025-01-04 07:12 agadmin Note Added: 0007035
2025-01-04 07:12 agadmin Desired Action Updated
2025-01-07 10:50 geoffclare Note Edited: 0007035
2025-01-10 11:22 agadmin Status New => Applied
2025-01-10 11:22 agadmin Resolution Open => Accepted


Mantis 1.1.6[^]
Copyright © 2000 - 2008 Mantis Group
Powered by Mantis Bugtracker