* Re: [PATCH] Various pages: Use 'logical' puntuation method for parentheses [not found] <20210124151035.70536-5-alx.manpages@gmail.com> @ 2021-01-24 16:06 ` Alejandro Colomar (man-pages) 2021-01-24 16:18 ` Michael Kerrisk (man-pages) 0 siblings, 1 reply; 5+ messages in thread From: Alejandro Colomar (man-pages) @ 2021-01-24 16:06 UTC (permalink / raw) To: mtk.manpages; +Cc: linux-man On 1/24/21 4:10 PM, Alejandro Colomar wrote: > This fix places periods after the closing parenthesis. > This is normative in various European languages, > and avoids confusion. > > See "Hart's Rules", > and the "Oxford Dictionary for Writers and Editors". > See also the spanish "Diccionario Panhispanico de Dudas" > entry about parentheses. > > > Script: > > $ find man? -type f \ > |xargs sed -iE '/(etc\.\)|\.\.\.|\.\)\.|\(\.\)| ack\.| ed\.| dec\.|Copyright)/!s/\.\)/)./'; > > Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>> --- > > Hi Michael, > > I thoroughly reviewed this one, and didn't see any weird things. > I don't have a copy of Hart's Rules, or the Oxford dict.; > I followed the Spanish rules for parentheses, which I guess will be the same: > <https://www.rae.es/dpd/par%C3%A9ntesis>. > You can practice a bit of Spanish reading that ;). > > Cheers, > > Alex Hi Michael, This patch is too large for vger (395 KiB); what should I do? Split it into <100K chunks? (I think the limit for vger is 100 KiB). Forward a sample of it to linux-man@? Thanks, Alex > > > man1/getent.1 | 6 +- > man1/intro.1 | 2 +- > man1/ldd.1 | 6 +- > man1/time.1 | 16 ++-- > man2/_exit.2 | 2 +- > man2/_syscall.2 | 2 +- > man2/access.2 | 6 +- > man2/adjtimex.2 | 2 +- > man2/alloc_hugepages.2 | 2 +- > man2/bind.2 | 2 +- > man2/bpf.2 | 6 +- > man2/brk.2 | 2 +- > man2/capget.2 | 2 +- > man2/chdir.2 | 2 +- > man2/chmod.2 | 8 +- > man2/chown.2 | 6 +- > man2/chroot.2 | 2 +- > man2/clock_getres.2 | 2 +- > man2/clock_nanosleep.2 | 6 +- > man2/clone.2 | 36 ++++----- > man2/close.2 | 6 +- > man2/connect.2 | 6 +- > man2/delete_module.2 | 2 +- > man2/epoll_create.2 | 2 +- > man2/epoll_ctl.2 | 2 +- > man2/eventfd.2 | 2 +- > man2/execve.2 | 14 ++-- > man2/execveat.2 | 2 +- > man2/fallocate.2 | 4 +- > man2/fanotify_mark.2 | 2 +- > man2/fcntl.2 | 42 +++++------ > man2/flock.2 | 4 +- > man2/fork.2 | 8 +- > man2/fsync.2 | 2 +- > man2/futex.2 | 28 +++---- > man2/get_mempolicy.2 | 2 +- > man2/getcpu.2 | 6 +- > man2/getdomainname.2 | 2 +- > man2/getgroups.2 | 2 +- > man2/gethostname.2 | 4 +- > man2/getitimer.2 | 6 +- > man2/getpagesize.2 | 2 +- > man2/getpid.2 | 4 +- > man2/getpriority.2 | 4 +- > man2/getrlimit.2 | 4 +- > man2/getrusage.2 | 6 +- > man2/gettid.2 | 2 +- > man2/gettimeofday.2 | 8 +- > man2/getxattr.2 | 4 +- > man2/init_module.2 | 2 +- > man2/inotify_rm_watch.2 | 2 +- > man2/intro.2 | 2 +- > man2/ioctl_console.2 | 60 +++++++-------- > man2/ioctl_iflags.2 | 4 +- > man2/ioctl_tty.2 | 8 +- > man2/ioctl_userfaultfd.2 | 16 ++-- > man2/keyctl.2 | 12 +-- > man2/kill.2 | 2 +- > man2/link.2 | 6 +- > man2/listxattr.2 | 2 +- > man2/lseek.2 | 4 +- > man2/madvise.2 | 14 ++-- > man2/mbind.2 | 2 +- > man2/memfd_create.2 | 8 +- > man2/mincore.2 | 4 +- > man2/mkdir.2 | 2 +- > man2/mknod.2 | 4 +- > man2/mlock.2 | 6 +- > man2/mmap.2 | 14 ++-- > man2/mmap2.2 | 2 +- > man2/mount.2 | 22 +++--- > man2/mprotect.2 | 6 +- > man2/msgctl.2 | 4 +- > man2/msgget.2 | 4 +- > man2/msgop.2 | 4 +- > man2/msync.2 | 4 +- > man2/nice.2 | 4 +- > man2/open.2 | 16 ++-- > man2/open_by_handle_at.2 | 10 +-- > man2/openat2.2 | 10 +-- > man2/perf_event_open.2 | 2 +- > man2/personality.2 | 2 +- > man2/pipe.2 | 4 +- > man2/pivot_root.2 | 6 +- > man2/poll.2 | 4 +- > man2/posix_fadvise.2 | 4 +- > man2/prctl.2 | 18 ++--- > man2/process_vm_readv.2 | 4 +- > man2/ptrace.2 | 74 +++++++++---------- > man2/quotactl.2 | 2 +- > man2/read.2 | 2 +- > man2/readlink.2 | 4 +- > man2/readv.2 | 6 +- > man2/reboot.2 | 2 +- > man2/recv.2 | 2 +- > man2/recvmmsg.2 | 4 +- > man2/removexattr.2 | 2 +- > man2/rename.2 | 8 +- > man2/request_key.2 | 2 +- > man2/rt_sigqueueinfo.2 | 4 +- > man2/sched_setaffinity.2 | 4 +- > man2/sched_setscheduler.2 | 2 +- > man2/seccomp.2 | 20 ++--- > man2/select.2 | 12 +-- > man2/select_tut.2 | 6 +- > man2/semctl.2 | 8 +- > man2/semget.2 | 4 +- > man2/semop.2 | 2 +- > man2/send.2 | 8 +- > man2/sendfile.2 | 2 +- > man2/sendmmsg.2 | 2 +- > man2/seteuid.2 | 2 +- > man2/setfsuid.2 | 2 +- > man2/setns.2 | 4 +- > man2/setpgid.2 | 8 +- > man2/setxattr.2 | 4 +- > man2/shmctl.2 | 8 +- > man2/shmget.2 | 2 +- > man2/shmop.2 | 4 +- > man2/sigaction.2 | 10 +-- > man2/sigaltstack.2 | 4 +- > man2/signal.2 | 4 +- > man2/signalfd.2 | 6 +- > man2/sigreturn.2 | 4 +- > man2/sigwaitinfo.2 | 6 +- > man2/spu_create.2 | 2 +- > man2/stat.2 | 14 ++-- > man2/statfs.2 | 2 +- > man2/statx.2 | 14 ++-- > man2/subpage_prot.2 | 2 +- > man2/swapon.2 | 2 +- > man2/symlink.2 | 2 +- > man2/sync_file_range.2 | 2 +- > man2/syscalls.2 | 16 ++-- > man2/syslog.2 | 2 +- > man2/time.2 | 2 +- > man2/timer_create.2 | 2 +- > man2/timer_getoverrun.2 | 2 +- > man2/timer_settime.2 | 2 +- > man2/timerfd_create.2 | 10 +-- > man2/tkill.2 | 4 +- > man2/truncate.2 | 4 +- > man2/umask.2 | 2 +- > man2/unlink.2 | 8 +- > man2/unshare.2 | 2 +- > man2/uselib.2 | 2 +- > man2/utimensat.2 | 4 +- > man2/vfork.2 | 6 +- > man2/vm86.2 | 2 +- > man2/wait.2 | 12 +-- > man2/wait4.2 | 2 +- > man2/write.2 | 6 +- > man3/CPU_SET.3 | 2 +- > man3/adjtime.3 | 2 +- > man3/aio_cancel.3 | 4 +- > man3/aio_error.3 | 2 +- > man3/aio_fsync.3 | 2 +- > man3/aio_read.3 | 2 +- > man3/aio_return.3 | 2 +- > man3/aio_suspend.3 | 4 +- > man3/aio_write.3 | 2 +- > man3/alloca.3 | 2 +- > man3/argz_add.3 | 2 +- > man3/backtrace.3 | 2 +- > man3/basename.3 | 2 +- > man3/bindresvport.3 | 2 +- > man3/bzero.3 | 2 +- > man3/catopen.3 | 2 +- > man3/ceil.3 | 2 +- > man3/circleq.3 | 2 +- > man3/clock_getcpuclockid.3 | 2 +- > man3/cpow.3 | 2 +- > man3/csqrt.3 | 2 +- > man3/daemon.3 | 2 +- > man3/dbopen.3 | 16 ++-- > man3/dl_iterate_phdr.3 | 2 +- > man3/dlopen.3 | 10 +-- > man3/dlsym.3 | 2 +- > man3/encrypt.3 | 2 +- > man3/envz_add.3 | 4 +- > man3/errno.3 | 4 +- > man3/exec.3 | 4 +- > man3/exit.3 | 2 +- > man3/ferror.3 | 2 +- > man3/fexecve.3 | 4 +- > man3/flockfile.3 | 2 +- > man3/floor.3 | 2 +- > man3/fmtmsg.3 | 2 +- > man3/fopen.3 | 4 +- > man3/fopencookie.3 | 2 +- > man3/fpathconf.3 | 2 +- > man3/fpclassify.3 | 2 +- > man3/ftime.3 | 2 +- > man3/fts.3 | 4 +- > man3/ftw.3 | 14 ++-- > man3/getaddrinfo.3 | 2 +- > man3/getauxval.3 | 2 +- > man3/getcwd.3 | 4 +- > man3/getentropy.3 | 2 +- > man3/getfsent.3 | 2 +- > man3/getgrent.3 | 2 +- > man3/getgrnam.3 | 4 +- > man3/gethostbyname.3 | 2 +- > man3/gethostid.3 | 4 +- > man3/getifaddrs.3 | 2 +- > man3/getlogin.3 | 6 +- > man3/getnameinfo.3 | 4 +- > man3/getnetent_r.3 | 4 +- > man3/getopt.3 | 12 +-- > man3/getprotoent_r.3 | 4 +- > man3/getpwent.3 | 2 +- > man3/getpwnam.3 | 4 +- > man3/getrpcent_r.3 | 4 +- > man3/getservent_r.3 | 4 +- > man3/getsubopt.3 | 2 +- > man3/getumask.3 | 2 +- > man3/getutent.3 | 2 +- > man3/glob.3 | 2 +- > man3/hsearch.3 | 6 +- > man3/inet_net_pton.3 | 2 +- > man3/intro.3 | 2 +- > man3/killpg.3 | 2 +- > man3/lio_listio.3 | 2 +- > man3/list.3 | 2 +- > man3/makecontext.3 | 2 +- > man3/mallinfo.3 | 2 +- > man3/malloc_get_state.3 | 2 +- > man3/malloc_stats.3 | 2 +- > man3/mallopt.3 | 16 ++-- > man3/memcpy.3 | 2 +- > man3/mq_notify.3 | 4 +- > man3/mq_open.3 | 6 +- > man3/nl_langinfo.3 | 12 +-- > man3/perror.3 | 2 +- > man3/posix_spawn.3 | 2 +- > man3/printf.3 | 24 +++--- > man3/pthread_attr_setaffinity_np.3 | 2 +- > man3/pthread_attr_setguardsize.3 | 4 +- > man3/pthread_attr_setstack.3 | 2 +- > man3/pthread_cancel.3 | 8 +- > man3/pthread_cleanup_push.3 | 4 +- > man3/pthread_detach.3 | 2 +- > man3/pthread_kill_other_threads_np.3 | 2 +- > man3/pthread_setaffinity_np.3 | 4 +- > man3/pthread_setcancelstate.3 | 2 +- > man3/pthread_setschedprio.3 | 2 +- > man3/pthread_sigqueue.3 | 2 +- > man3/pthread_spin_init.3 | 2 +- > man3/ptsname.3 | 2 +- > man3/putenv.3 | 2 +- > man3/rand.3 | 4 +- > man3/random_r.3 | 2 +- > man3/readdir.3 | 2 +- > man3/realpath.3 | 6 +- > man3/regex.3 | 2 +- > man3/rint.3 | 2 +- > man3/round.3 | 2 +- > man3/scanf.3 | 6 +- > man3/sem_getvalue.3 | 2 +- > man3/sem_init.3 | 2 +- > man3/sem_open.3 | 4 +- > man3/setaliasent.3 | 2 +- > man3/setbuf.3 | 2 +- > man3/setjmp.3 | 2 +- > man3/shm_open.3 | 2 +- > man3/sigqueue.3 | 2 +- > man3/sigset.3 | 2 +- > man3/sigvec.3 | 2 +- > man3/slist.3 | 2 +- > man3/stailq.3 | 2 +- > man3/statvfs.3 | 2 +- > man3/stdin.3 | 8 +- > man3/stdio_ext.3 | 4 +- > man3/strcat.3 | 2 +- > man3/strcmp.3 | 2 +- > man3/strcoll.3 | 2 +- > man3/strcpy.3 | 4 +- > man3/strerror.3 | 2 +- > man3/strfmon.3 | 4 +- > man3/strftime.3 | 100 ++++++++++++------------- > man3/strptime.3 | 8 +- > man3/strtok.3 | 2 +- > man3/strtol.3 | 4 +- > man3/strtoul.3 | 4 +- > man3/swab.3 | 2 +- > man3/sysconf.3 | 6 +- > man3/syslog.3 | 8 +- > man3/system.3 | 8 +- > man3/tailq.3 | 2 +- > man3/termios.3 | 18 ++--- > man3/tmpnam.3 | 2 +- > man3/tsearch.3 | 8 +- > man3/ualarm.3 | 2 +- > man3/ulimit.3 | 4 +- > man3/usleep.3 | 2 +- > man3/wordexp.3 | 2 +- > man3/wprintf.3 | 4 +- > man3/y0.3 | 4 +- > man4/cciss.4 | 4 +- > man4/console_codes.4 | 10 +-- > man4/fd.4 | 2 +- > man4/initrd.4 | 10 +-- > man4/mouse.4 | 2 +- > man4/null.4 | 2 +- > man4/random.4 | 2 +- > man4/rtc.4 | 4 +- > man4/smartpqi.4 | 2 +- > man4/st.4 | 10 +-- > man4/vcs.4 | 2 +- > man5/core.5 | 12 +-- > man5/dir_colors.5 | 8 +- > man5/elf.5 | 2 +- > man5/host.conf.5 | 2 +- > man5/passwd.5 | 4 +- > man5/proc.5 | 106 +++++++++++++-------------- > man5/resolv.conf.5 | 2 +- > man5/services.5 | 2 +- > man5/slabinfo.5 | 2 +- > man5/sysfs.5 | 4 +- > man5/termcap.5 | 2 +- > man5/tzfile.5 | 6 +- > man7/bootparam.7 | 26 +++---- > man7/capabilities.7 | 30 ++++---- > man7/cgroup_namespaces.7 | 4 +- > man7/cgroups.7 | 36 ++++----- > man7/charsets.7 | 4 +- > man7/cpuset.7 | 6 +- > man7/credentials.7 | 2 +- > man7/environ.7 | 2 +- > man7/epoll.7 | 10 +-- > man7/fanotify.7 | 2 +- > man7/feature_test_macros.7 | 10 +-- > man7/glob.7 | 14 ++-- > man7/hier.7 | 4 +- > man7/hostname.7 | 2 +- > man7/inode.7 | 10 +-- > man7/inotify.7 | 12 +-- > man7/ip.7 | 4 +- > man7/keyrings.7 | 10 +-- > man7/libc.7 | 2 +- > man7/locale.7 | 8 +- > man7/mailaddr.7 | 4 +- > man7/man-pages.7 | 12 +-- > man7/man.7 | 4 +- > man7/math_error.7 | 2 +- > man7/mount_namespaces.7 | 16 ++-- > man7/mq_overview.7 | 4 +- > man7/namespaces.7 | 6 +- > man7/numa.7 | 2 +- > man7/path_resolution.7 | 8 +- > man7/persistent-keyring.7 | 4 +- > man7/pid_namespaces.7 | 4 +- > man7/pipe.7 | 4 +- > man7/pthreads.7 | 12 +-- > man7/pty.7 | 6 +- > man7/random.7 | 2 +- > man7/regex.7 | 2 +- > man7/rtld-audit.7 | 4 +- > man7/sched.7 | 8 +- > man7/sem_overview.7 | 2 +- > man7/session-keyring.7 | 8 +- > man7/shm_overview.7 | 2 +- > man7/sigevent.7 | 2 +- > man7/signal-safety.7 | 2 +- > man7/signal.7 | 14 ++-- > man7/sock_diag.7 | 2 +- > man7/socket.7 | 4 +- > man7/standards.7 | 2 +- > man7/symlink.7 | 20 ++--- > man7/tcp.7 | 10 +-- > man7/termio.7 | 2 +- > man7/time.7 | 2 +- > man7/time_namespaces.7 | 2 +- > man7/unix.7 | 10 +-- > man7/user-keyring.7 | 2 +- > man7/user-session-keyring.7 | 2 +- > man7/user_namespaces.7 | 8 +- > man8/ld.so.8 | 20 ++--- > man8/ldconfig.8 | 2 +- > man8/zdump.8 | 2 +- > 380 files changed, 1113 insertions(+), 1113 deletions(-) > > diff --git a/man1/getent.1 b/man1/getent.1 [...] -- Alejandro Colomar Linux man-pages comaintainer; https://www.kernel.org/doc/man-pages/ http://www.alejandro-colomar.es/ ^ permalink raw reply [flat|nested] 5+ messages in thread
* Re: [PATCH] Various pages: Use 'logical' puntuation method for parentheses 2021-01-24 16:06 ` [PATCH] Various pages: Use 'logical' puntuation method for parentheses Alejandro Colomar (man-pages) @ 2021-01-24 16:18 ` Michael Kerrisk (man-pages) 2021-01-24 16:35 ` Alejandro Colomar (man-pages) 0 siblings, 1 reply; 5+ messages in thread From: Michael Kerrisk (man-pages) @ 2021-01-24 16:18 UTC (permalink / raw) To: Alejandro Colomar (man-pages); +Cc: mtk.manpages, linux-man Hi Alex, On 1/24/21 5:06 PM, Alejandro Colomar (man-pages) wrote: > On 1/24/21 4:10 PM, Alejandro Colomar wrote: >> This fix places periods after the closing parenthesis. >> This is normative in various European languages, >> and avoids confusion. >> >> See "Hart's Rules", >> and the "Oxford Dictionary for Writers and Editors". >> See also the spanish "Diccionario Panhispanico de Dudas" >> entry about parentheses. >> >> >> Script: >> >> $ find man? -type f \ >> |xargs sed -iE '/(etc\.\)|\.\.\.|\.\)\.|\(\.\)| ack\.| ed\.| dec\.|Copyright)/!s/\.\)/)./'; >> >> Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>> --- >> >> Hi Michael, >> >> I thoroughly reviewed this one, and didn't see any weird things. >> I don't have a copy of Hart's Rules, or the Oxford dict.; >> I followed the Spanish rules for parentheses, which I guess will be the same: >> <https://www.rae.es/dpd/par%C3%A9ntesis>. >> You can practice a bit of Spanish reading that ;). >> >> Cheers, >> >> Alex > > Hi Michael, > > This patch is too large for vger (395 KiB); > what should I do? > > Split it into <100K chunks? (I think the limit for vger is 100 KiB). > Forward a sample of it to linux-man@? Nothing yet. The patch is wrong. In English, the Lofgical Style pertains only to quotes. In English, punctuation goes inside parentheses when a full sentence is involved. (Thus, this sentence is correctly punctuated.) It's news to me that Spanish is different! Thanks, Michael >> >> man1/getent.1 | 6 +- >> man1/intro.1 | 2 +- >> man1/ldd.1 | 6 +- >> man1/time.1 | 16 ++-- >> man2/_exit.2 | 2 +- >> man2/_syscall.2 | 2 +- >> man2/access.2 | 6 +- >> man2/adjtimex.2 | 2 +- >> man2/alloc_hugepages.2 | 2 +- >> man2/bind.2 | 2 +- >> man2/bpf.2 | 6 +- >> man2/brk.2 | 2 +- >> man2/capget.2 | 2 +- >> man2/chdir.2 | 2 +- >> man2/chmod.2 | 8 +- >> man2/chown.2 | 6 +- >> man2/chroot.2 | 2 +- >> man2/clock_getres.2 | 2 +- >> man2/clock_nanosleep.2 | 6 +- >> man2/clone.2 | 36 ++++----- >> man2/close.2 | 6 +- >> man2/connect.2 | 6 +- >> man2/delete_module.2 | 2 +- >> man2/epoll_create.2 | 2 +- >> man2/epoll_ctl.2 | 2 +- >> man2/eventfd.2 | 2 +- >> man2/execve.2 | 14 ++-- >> man2/execveat.2 | 2 +- >> man2/fallocate.2 | 4 +- >> man2/fanotify_mark.2 | 2 +- >> man2/fcntl.2 | 42 +++++------ >> man2/flock.2 | 4 +- >> man2/fork.2 | 8 +- >> man2/fsync.2 | 2 +- >> man2/futex.2 | 28 +++---- >> man2/get_mempolicy.2 | 2 +- >> man2/getcpu.2 | 6 +- >> man2/getdomainname.2 | 2 +- >> man2/getgroups.2 | 2 +- >> man2/gethostname.2 | 4 +- >> man2/getitimer.2 | 6 +- >> man2/getpagesize.2 | 2 +- >> man2/getpid.2 | 4 +- >> man2/getpriority.2 | 4 +- >> man2/getrlimit.2 | 4 +- >> man2/getrusage.2 | 6 +- >> man2/gettid.2 | 2 +- >> man2/gettimeofday.2 | 8 +- >> man2/getxattr.2 | 4 +- >> man2/init_module.2 | 2 +- >> man2/inotify_rm_watch.2 | 2 +- >> man2/intro.2 | 2 +- >> man2/ioctl_console.2 | 60 +++++++-------- >> man2/ioctl_iflags.2 | 4 +- >> man2/ioctl_tty.2 | 8 +- >> man2/ioctl_userfaultfd.2 | 16 ++-- >> man2/keyctl.2 | 12 +-- >> man2/kill.2 | 2 +- >> man2/link.2 | 6 +- >> man2/listxattr.2 | 2 +- >> man2/lseek.2 | 4 +- >> man2/madvise.2 | 14 ++-- >> man2/mbind.2 | 2 +- >> man2/memfd_create.2 | 8 +- >> man2/mincore.2 | 4 +- >> man2/mkdir.2 | 2 +- >> man2/mknod.2 | 4 +- >> man2/mlock.2 | 6 +- >> man2/mmap.2 | 14 ++-- >> man2/mmap2.2 | 2 +- >> man2/mount.2 | 22 +++--- >> man2/mprotect.2 | 6 +- >> man2/msgctl.2 | 4 +- >> man2/msgget.2 | 4 +- >> man2/msgop.2 | 4 +- >> man2/msync.2 | 4 +- >> man2/nice.2 | 4 +- >> man2/open.2 | 16 ++-- >> man2/open_by_handle_at.2 | 10 +-- >> man2/openat2.2 | 10 +-- >> man2/perf_event_open.2 | 2 +- >> man2/personality.2 | 2 +- >> man2/pipe.2 | 4 +- >> man2/pivot_root.2 | 6 +- >> man2/poll.2 | 4 +- >> man2/posix_fadvise.2 | 4 +- >> man2/prctl.2 | 18 ++--- >> man2/process_vm_readv.2 | 4 +- >> man2/ptrace.2 | 74 +++++++++---------- >> man2/quotactl.2 | 2 +- >> man2/read.2 | 2 +- >> man2/readlink.2 | 4 +- >> man2/readv.2 | 6 +- >> man2/reboot.2 | 2 +- >> man2/recv.2 | 2 +- >> man2/recvmmsg.2 | 4 +- >> man2/removexattr.2 | 2 +- >> man2/rename.2 | 8 +- >> man2/request_key.2 | 2 +- >> man2/rt_sigqueueinfo.2 | 4 +- >> man2/sched_setaffinity.2 | 4 +- >> man2/sched_setscheduler.2 | 2 +- >> man2/seccomp.2 | 20 ++--- >> man2/select.2 | 12 +-- >> man2/select_tut.2 | 6 +- >> man2/semctl.2 | 8 +- >> man2/semget.2 | 4 +- >> man2/semop.2 | 2 +- >> man2/send.2 | 8 +- >> man2/sendfile.2 | 2 +- >> man2/sendmmsg.2 | 2 +- >> man2/seteuid.2 | 2 +- >> man2/setfsuid.2 | 2 +- >> man2/setns.2 | 4 +- >> man2/setpgid.2 | 8 +- >> man2/setxattr.2 | 4 +- >> man2/shmctl.2 | 8 +- >> man2/shmget.2 | 2 +- >> man2/shmop.2 | 4 +- >> man2/sigaction.2 | 10 +-- >> man2/sigaltstack.2 | 4 +- >> man2/signal.2 | 4 +- >> man2/signalfd.2 | 6 +- >> man2/sigreturn.2 | 4 +- >> man2/sigwaitinfo.2 | 6 +- >> man2/spu_create.2 | 2 +- >> man2/stat.2 | 14 ++-- >> man2/statfs.2 | 2 +- >> man2/statx.2 | 14 ++-- >> man2/subpage_prot.2 | 2 +- >> man2/swapon.2 | 2 +- >> man2/symlink.2 | 2 +- >> man2/sync_file_range.2 | 2 +- >> man2/syscalls.2 | 16 ++-- >> man2/syslog.2 | 2 +- >> man2/time.2 | 2 +- >> man2/timer_create.2 | 2 +- >> man2/timer_getoverrun.2 | 2 +- >> man2/timer_settime.2 | 2 +- >> man2/timerfd_create.2 | 10 +-- >> man2/tkill.2 | 4 +- >> man2/truncate.2 | 4 +- >> man2/umask.2 | 2 +- >> man2/unlink.2 | 8 +- >> man2/unshare.2 | 2 +- >> man2/uselib.2 | 2 +- >> man2/utimensat.2 | 4 +- >> man2/vfork.2 | 6 +- >> man2/vm86.2 | 2 +- >> man2/wait.2 | 12 +-- >> man2/wait4.2 | 2 +- >> man2/write.2 | 6 +- >> man3/CPU_SET.3 | 2 +- >> man3/adjtime.3 | 2 +- >> man3/aio_cancel.3 | 4 +- >> man3/aio_error.3 | 2 +- >> man3/aio_fsync.3 | 2 +- >> man3/aio_read.3 | 2 +- >> man3/aio_return.3 | 2 +- >> man3/aio_suspend.3 | 4 +- >> man3/aio_write.3 | 2 +- >> man3/alloca.3 | 2 +- >> man3/argz_add.3 | 2 +- >> man3/backtrace.3 | 2 +- >> man3/basename.3 | 2 +- >> man3/bindresvport.3 | 2 +- >> man3/bzero.3 | 2 +- >> man3/catopen.3 | 2 +- >> man3/ceil.3 | 2 +- >> man3/circleq.3 | 2 +- >> man3/clock_getcpuclockid.3 | 2 +- >> man3/cpow.3 | 2 +- >> man3/csqrt.3 | 2 +- >> man3/daemon.3 | 2 +- >> man3/dbopen.3 | 16 ++-- >> man3/dl_iterate_phdr.3 | 2 +- >> man3/dlopen.3 | 10 +-- >> man3/dlsym.3 | 2 +- >> man3/encrypt.3 | 2 +- >> man3/envz_add.3 | 4 +- >> man3/errno.3 | 4 +- >> man3/exec.3 | 4 +- >> man3/exit.3 | 2 +- >> man3/ferror.3 | 2 +- >> man3/fexecve.3 | 4 +- >> man3/flockfile.3 | 2 +- >> man3/floor.3 | 2 +- >> man3/fmtmsg.3 | 2 +- >> man3/fopen.3 | 4 +- >> man3/fopencookie.3 | 2 +- >> man3/fpathconf.3 | 2 +- >> man3/fpclassify.3 | 2 +- >> man3/ftime.3 | 2 +- >> man3/fts.3 | 4 +- >> man3/ftw.3 | 14 ++-- >> man3/getaddrinfo.3 | 2 +- >> man3/getauxval.3 | 2 +- >> man3/getcwd.3 | 4 +- >> man3/getentropy.3 | 2 +- >> man3/getfsent.3 | 2 +- >> man3/getgrent.3 | 2 +- >> man3/getgrnam.3 | 4 +- >> man3/gethostbyname.3 | 2 +- >> man3/gethostid.3 | 4 +- >> man3/getifaddrs.3 | 2 +- >> man3/getlogin.3 | 6 +- >> man3/getnameinfo.3 | 4 +- >> man3/getnetent_r.3 | 4 +- >> man3/getopt.3 | 12 +-- >> man3/getprotoent_r.3 | 4 +- >> man3/getpwent.3 | 2 +- >> man3/getpwnam.3 | 4 +- >> man3/getrpcent_r.3 | 4 +- >> man3/getservent_r.3 | 4 +- >> man3/getsubopt.3 | 2 +- >> man3/getumask.3 | 2 +- >> man3/getutent.3 | 2 +- >> man3/glob.3 | 2 +- >> man3/hsearch.3 | 6 +- >> man3/inet_net_pton.3 | 2 +- >> man3/intro.3 | 2 +- >> man3/killpg.3 | 2 +- >> man3/lio_listio.3 | 2 +- >> man3/list.3 | 2 +- >> man3/makecontext.3 | 2 +- >> man3/mallinfo.3 | 2 +- >> man3/malloc_get_state.3 | 2 +- >> man3/malloc_stats.3 | 2 +- >> man3/mallopt.3 | 16 ++-- >> man3/memcpy.3 | 2 +- >> man3/mq_notify.3 | 4 +- >> man3/mq_open.3 | 6 +- >> man3/nl_langinfo.3 | 12 +-- >> man3/perror.3 | 2 +- >> man3/posix_spawn.3 | 2 +- >> man3/printf.3 | 24 +++--- >> man3/pthread_attr_setaffinity_np.3 | 2 +- >> man3/pthread_attr_setguardsize.3 | 4 +- >> man3/pthread_attr_setstack.3 | 2 +- >> man3/pthread_cancel.3 | 8 +- >> man3/pthread_cleanup_push.3 | 4 +- >> man3/pthread_detach.3 | 2 +- >> man3/pthread_kill_other_threads_np.3 | 2 +- >> man3/pthread_setaffinity_np.3 | 4 +- >> man3/pthread_setcancelstate.3 | 2 +- >> man3/pthread_setschedprio.3 | 2 +- >> man3/pthread_sigqueue.3 | 2 +- >> man3/pthread_spin_init.3 | 2 +- >> man3/ptsname.3 | 2 +- >> man3/putenv.3 | 2 +- >> man3/rand.3 | 4 +- >> man3/random_r.3 | 2 +- >> man3/readdir.3 | 2 +- >> man3/realpath.3 | 6 +- >> man3/regex.3 | 2 +- >> man3/rint.3 | 2 +- >> man3/round.3 | 2 +- >> man3/scanf.3 | 6 +- >> man3/sem_getvalue.3 | 2 +- >> man3/sem_init.3 | 2 +- >> man3/sem_open.3 | 4 +- >> man3/setaliasent.3 | 2 +- >> man3/setbuf.3 | 2 +- >> man3/setjmp.3 | 2 +- >> man3/shm_open.3 | 2 +- >> man3/sigqueue.3 | 2 +- >> man3/sigset.3 | 2 +- >> man3/sigvec.3 | 2 +- >> man3/slist.3 | 2 +- >> man3/stailq.3 | 2 +- >> man3/statvfs.3 | 2 +- >> man3/stdin.3 | 8 +- >> man3/stdio_ext.3 | 4 +- >> man3/strcat.3 | 2 +- >> man3/strcmp.3 | 2 +- >> man3/strcoll.3 | 2 +- >> man3/strcpy.3 | 4 +- >> man3/strerror.3 | 2 +- >> man3/strfmon.3 | 4 +- >> man3/strftime.3 | 100 ++++++++++++------------- >> man3/strptime.3 | 8 +- >> man3/strtok.3 | 2 +- >> man3/strtol.3 | 4 +- >> man3/strtoul.3 | 4 +- >> man3/swab.3 | 2 +- >> man3/sysconf.3 | 6 +- >> man3/syslog.3 | 8 +- >> man3/system.3 | 8 +- >> man3/tailq.3 | 2 +- >> man3/termios.3 | 18 ++--- >> man3/tmpnam.3 | 2 +- >> man3/tsearch.3 | 8 +- >> man3/ualarm.3 | 2 +- >> man3/ulimit.3 | 4 +- >> man3/usleep.3 | 2 +- >> man3/wordexp.3 | 2 +- >> man3/wprintf.3 | 4 +- >> man3/y0.3 | 4 +- >> man4/cciss.4 | 4 +- >> man4/console_codes.4 | 10 +-- >> man4/fd.4 | 2 +- >> man4/initrd.4 | 10 +-- >> man4/mouse.4 | 2 +- >> man4/null.4 | 2 +- >> man4/random.4 | 2 +- >> man4/rtc.4 | 4 +- >> man4/smartpqi.4 | 2 +- >> man4/st.4 | 10 +-- >> man4/vcs.4 | 2 +- >> man5/core.5 | 12 +-- >> man5/dir_colors.5 | 8 +- >> man5/elf.5 | 2 +- >> man5/host.conf.5 | 2 +- >> man5/passwd.5 | 4 +- >> man5/proc.5 | 106 +++++++++++++-------------- >> man5/resolv.conf.5 | 2 +- >> man5/services.5 | 2 +- >> man5/slabinfo.5 | 2 +- >> man5/sysfs.5 | 4 +- >> man5/termcap.5 | 2 +- >> man5/tzfile.5 | 6 +- >> man7/bootparam.7 | 26 +++---- >> man7/capabilities.7 | 30 ++++---- >> man7/cgroup_namespaces.7 | 4 +- >> man7/cgroups.7 | 36 ++++----- >> man7/charsets.7 | 4 +- >> man7/cpuset.7 | 6 +- >> man7/credentials.7 | 2 +- >> man7/environ.7 | 2 +- >> man7/epoll.7 | 10 +-- >> man7/fanotify.7 | 2 +- >> man7/feature_test_macros.7 | 10 +-- >> man7/glob.7 | 14 ++-- >> man7/hier.7 | 4 +- >> man7/hostname.7 | 2 +- >> man7/inode.7 | 10 +-- >> man7/inotify.7 | 12 +-- >> man7/ip.7 | 4 +- >> man7/keyrings.7 | 10 +-- >> man7/libc.7 | 2 +- >> man7/locale.7 | 8 +- >> man7/mailaddr.7 | 4 +- >> man7/man-pages.7 | 12 +-- >> man7/man.7 | 4 +- >> man7/math_error.7 | 2 +- >> man7/mount_namespaces.7 | 16 ++-- >> man7/mq_overview.7 | 4 +- >> man7/namespaces.7 | 6 +- >> man7/numa.7 | 2 +- >> man7/path_resolution.7 | 8 +- >> man7/persistent-keyring.7 | 4 +- >> man7/pid_namespaces.7 | 4 +- >> man7/pipe.7 | 4 +- >> man7/pthreads.7 | 12 +-- >> man7/pty.7 | 6 +- >> man7/random.7 | 2 +- >> man7/regex.7 | 2 +- >> man7/rtld-audit.7 | 4 +- >> man7/sched.7 | 8 +- >> man7/sem_overview.7 | 2 +- >> man7/session-keyring.7 | 8 +- >> man7/shm_overview.7 | 2 +- >> man7/sigevent.7 | 2 +- >> man7/signal-safety.7 | 2 +- >> man7/signal.7 | 14 ++-- >> man7/sock_diag.7 | 2 +- >> man7/socket.7 | 4 +- >> man7/standards.7 | 2 +- >> man7/symlink.7 | 20 ++--- >> man7/tcp.7 | 10 +-- >> man7/termio.7 | 2 +- >> man7/time.7 | 2 +- >> man7/time_namespaces.7 | 2 +- >> man7/unix.7 | 10 +-- >> man7/user-keyring.7 | 2 +- >> man7/user-session-keyring.7 | 2 +- >> man7/user_namespaces.7 | 8 +- >> man8/ld.so.8 | 20 ++--- >> man8/ldconfig.8 | 2 +- >> man8/zdump.8 | 2 +- >> 380 files changed, 1113 insertions(+), 1113 deletions(-) >> >> diff --git a/man1/getent.1 b/man1/getent.1 > > [...] > > -- Michael Kerrisk Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/ Linux/UNIX System Programming Training: http://man7.org/training/ ^ permalink raw reply [flat|nested] 5+ messages in thread
* Re: [PATCH] Various pages: Use 'logical' puntuation method for parentheses 2021-01-24 16:18 ` Michael Kerrisk (man-pages) @ 2021-01-24 16:35 ` Alejandro Colomar (man-pages) 2021-01-25 7:47 ` Michael Kerrisk (man-pages) 0 siblings, 1 reply; 5+ messages in thread From: Alejandro Colomar (man-pages) @ 2021-01-24 16:35 UTC (permalink / raw) To: Michael Kerrisk (man-pages); +Cc: linux-man On 1/24/21 5:18 PM, Michael Kerrisk (man-pages) wrote: > Hi Alex, > > On 1/24/21 5:06 PM, Alejandro Colomar (man-pages) wrote: >> On 1/24/21 4:10 PM, Alejandro Colomar wrote: >>> This fix places periods after the closing parenthesis. >>> This is normative in various European languages, >>> and avoids confusion. >>> >>> See "Hart's Rules", >>> and the "Oxford Dictionary for Writers and Editors". >>> See also the spanish "Diccionario Panhispanico de Dudas" >>> entry about parentheses. >>> >>> >>> Script: >>> >>> $ find man? -type f \ >>> |xargs sed -iE '/(etc\.\)|\.\.\.|\.\)\.|\(\.\)| ack\.| ed\.| dec\.|Copyright)/!s/\.\)/)./'; >>> >>> Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>> --- >>> >>> Hi Michael, >>> >>> I thoroughly reviewed this one, and didn't see any weird things. >>> I don't have a copy of Hart's Rules, or the Oxford dict.; >>> I followed the Spanish rules for parentheses, which I guess will be the same: >>> <https://www.rae.es/dpd/par%C3%A9ntesis>. >>> You can practice a bit of Spanish reading that ;). >>> >>> Cheers, >>> >>> Alex >> >> Hi Michael, >> >> This patch is too large for vger (395 KiB); >> what should I do? >> >> Split it into <100K chunks? (I think the limit for vger is 100 KiB). >> Forward a sample of it to linux-man@? > > Nothing yet. The patch is wrong. In English, the Lofgical Style pertains only > to quotes. > > In English, punctuation goes inside parentheses when a > full sentence is involved. (Thus, this sentence is correctly > punctuated.) It's news to me that Spanish is different! > > Thanks, > > Michael > Hi Michael, Hummm! The illogical English-speaking people are... illogical! :-P That surprised me of American a month ago, and now about British. So I'm not surprised that you're surprised. It's logical to be surprised. What is illogical is that the British use the logical style for quotations, but not for parentheses. So, we'll have to live with it. Cheers, Alex -- Alejandro Colomar Linux man-pages comaintainer; https://www.kernel.org/doc/man-pages/ http://www.alejandro-colomar.es/ ^ permalink raw reply [flat|nested] 5+ messages in thread
* Re: [PATCH] Various pages: Use 'logical' puntuation method for parentheses 2021-01-24 16:35 ` Alejandro Colomar (man-pages) @ 2021-01-25 7:47 ` Michael Kerrisk (man-pages) 2021-01-25 11:48 ` Alejandro Colomar (man-pages) 0 siblings, 1 reply; 5+ messages in thread From: Michael Kerrisk (man-pages) @ 2021-01-25 7:47 UTC (permalink / raw) To: Alejandro Colomar (man-pages); +Cc: mtk.manpages, linux-man Hi Alex, On 1/24/21 5:35 PM, Alejandro Colomar (man-pages) wrote: > On 1/24/21 5:18 PM, Michael Kerrisk (man-pages) wrote: >> Hi Alex, >> >> On 1/24/21 5:06 PM, Alejandro Colomar (man-pages) wrote: >>> On 1/24/21 4:10 PM, Alejandro Colomar wrote: >>>> This fix places periods after the closing parenthesis. >>>> This is normative in various European languages, >>>> and avoids confusion. >>>> >>>> See "Hart's Rules", >>>> and the "Oxford Dictionary for Writers and Editors". >>>> See also the spanish "Diccionario Panhispanico de Dudas" >>>> entry about parentheses. >>>> >>>> >>>> Script: >>>> >>>> $ find man? -type f \ >>>> |xargs sed -iE '/(etc\.\)|\.\.\.|\.\)\.|\(\.\)| ack\.| ed\.| dec\.|Copyright)/!s/\.\)/)./'; >>>> >>>> Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>> --- >>>> >>>> Hi Michael, >>>> >>>> I thoroughly reviewed this one, and didn't see any weird things. >>>> I don't have a copy of Hart's Rules, or the Oxford dict.; >>>> I followed the Spanish rules for parentheses, which I guess will be the same: >>>> <https://www.rae.es/dpd/par%C3%A9ntesis>. >>>> You can practice a bit of Spanish reading that ;). >>>> >>>> Cheers, >>>> >>>> Alex >>> >>> Hi Michael, >>> >>> This patch is too large for vger (395 KiB); >>> what should I do? >>> >>> Split it into <100K chunks? (I think the limit for vger is 100 KiB). >>> Forward a sample of it to linux-man@? >> >> Nothing yet. The patch is wrong. In English, the Lofgical Style pertains only >> to quotes. >> >> In English, punctuation goes inside parentheses when a >> full sentence is involved. (Thus, this sentence is correctly >> punctuated.) It's news to me that Spanish is different! >> >> Thanks, >> >> Michael >> > > Hi Michael, > > Hummm! The illogical English-speaking people are... illogical! :-P > > That surprised me of American a month ago, and now about British. > So I'm not surprised that you're surprised. It's logical to be > surprised. What is illogical is that the British use the logical style > for quotations, but not for parentheses. > > So, we'll have to live with it. Yeah, sorry. I misunderstood some of your earlier comments. Otherwise, I could have saved you some effort. By the way, I think the English system is logical :-). A complete sentence includes a period at the end. If that sentence is inside parentheses, then the period also belongs inside the parentheses. This is actually consistent with the "logical" system for quotes, where the reason that in the logical system the period is being placed outside the quotes is that the period belongs not to the phrase that is being quoted, but is terminating the sentence as a whole. With respect to parentheses, German is like English: https://www.duden.de/sprachwissen/rechtschreibregeln/klammern French seems to be the same: https://www.la-ponctuation.com/parentheses.html http://www.cce.umontreal.ca/capsules/3073.htm http://bdl.oqlf.gouv.qc.ca/bdl/gabarit_bdl.asp?id=3357 I am not sure about Italian (I do not speak any Italian). Some sites seem to suggest it is like English: https://lagrammaticaitaliana.wordpress.com/2019/08/07/le-parentesi/ Suppose that you have a parenthetical piece that contains two complete sentences.[1] Where should the final period be placed? (Here is an example. In my opinion, the final period logically belongs inside the parentheses.) Quizás los hispanohablantes no son lógicos? Cheers, Michael [1] Yes, having multiple sentences inside patentheses is generally frowned on, stylistically. But it is not "wrong".) -- Michael Kerrisk Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/ Linux/UNIX System Programming Training: http://man7.org/training/ ^ permalink raw reply [flat|nested] 5+ messages in thread
* Re: [PATCH] Various pages: Use 'logical' puntuation method for parentheses 2021-01-25 7:47 ` Michael Kerrisk (man-pages) @ 2021-01-25 11:48 ` Alejandro Colomar (man-pages) 0 siblings, 0 replies; 5+ messages in thread From: Alejandro Colomar (man-pages) @ 2021-01-25 11:48 UTC (permalink / raw) To: Michael Kerrisk (man-pages); +Cc: linux-man Hi Michael, On 1/25/21 8:47 AM, Michael Kerrisk (man-pages) wrote: [...] > > Yeah, sorry. I misunderstood some of your earlier comments. > Otherwise, I could have saved you some effort. > > By the way, I think the English system is logical :-). A complete > sentence includes a period at the end. If that sentence is inside > parentheses, then the period also belongs inside the parentheses. > This is actually consistent with the "logical" system for quotes, > where the reason that in the logical system the period is being > placed outside the quotes is that the period belongs not to the > phrase that is being quoted, but is terminating the sentence > as a whole. > > With respect to parentheses, German is like English: > https://www.duden.de/sprachwissen/rechtschreibregeln/klammern > > French seems to be the same: > https://www.la-ponctuation.com/parentheses.html > http://www.cce.umontreal.ca/capsules/3073.htm > http://bdl.oqlf.gouv.qc.ca/bdl/gabarit_bdl.asp?id=3357 > > I am not sure about Italian (I do not speak any Italian). > Some sites seem to suggest it is like English: > https://lagrammaticaitaliana.wordpress.com/2019/08/07/le-parentesi/ > > Suppose that you have a parenthetical piece that contains > two complete sentences.[1] Where should the final period > be placed? (Here is an example. In my opinion, the final > period logically belongs inside the parentheses.) Yes, it makes sense to me. > > Quizás los hispanohablantes no son lógicos? Supongo que después de tantos años usando estructuras ilógicas me había acostumbrado. Ils sont fous, ces Espagnols! :) > > Cheers, > > Michael > > [1] Yes, having multiple sentences inside patentheses is > generally frowned on, stylistically. But it is not "wrong".) > Cheers, Alex -- Alejandro Colomar Linux man-pages comaintainer; https://www.kernel.org/doc/man-pages/ http://www.alejandro-colomar.es/ ^ permalink raw reply [flat|nested] 5+ messages in thread
end of thread, other threads:[~2021-01-26 20:06 UTC | newest]
Thread overview: 5+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
[not found] <20210124151035.70536-5-alx.manpages@gmail.com>
2021-01-24 16:06 ` [PATCH] Various pages: Use 'logical' puntuation method for parentheses Alejandro Colomar (man-pages)
2021-01-24 16:18 ` Michael Kerrisk (man-pages)
2021-01-24 16:35 ` Alejandro Colomar (man-pages)
2021-01-25 7:47 ` Michael Kerrisk (man-pages)
2021-01-25 11:48 ` Alejandro Colomar (man-pages)
This is a public inbox, see mirroring instructions for how to clone and mirror all data and code used for this inbox