From: "Michael Kerrisk (man-pages)" <mtk.manpages@gmail.com>
To: "Alejandro Colomar (man-pages)" <alx.manpages@gmail.com>
Cc: mtk.manpages@gmail.com, linux-man@vger.kernel.org
Subject: Re: [PATCH] Various pages: Use 'logical' puntuation method for parentheses
Date: Sun, 24 Jan 2021 17:18:29 +0100 [thread overview]
Message-ID: <c9453042-2af2-4ec5-3269-5ef322a26b19@gmail.com> (raw)
In-Reply-To: <ab080b59-8d3e-d3cf-3b70-ba2cf8fbae67@gmail.com>
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/
next prev parent reply other threads:[~2021-01-24 16:19 UTC|newest]
Thread overview: 5+ messages / expand[flat|nested] mbox.gz Atom feed top
[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) [this message]
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)
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=c9453042-2af2-4ec5-3269-5ef322a26b19@gmail.com \
--to=mtk.manpages@gmail.com \
--cc=alx.manpages@gmail.com \
--cc=linux-man@vger.kernel.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox