All of lore.kernel.org
 help / color / mirror / Atom feed
From: "Alejandro Colomar (man-pages)" <alx.manpages@gmail.com>
To: mtk.manpages@gmail.com
Cc: linux-man@vger.kernel.org
Subject: Re: [PATCH] Various pages: Use 'logical' puntuation method for parentheses
Date: Sun, 24 Jan 2021 17:06:21 +0100	[thread overview]
Message-ID: <ab080b59-8d3e-d3cf-3b70-ba2cf8fbae67@gmail.com> (raw)
In-Reply-To: <20210124151035.70536-5-alx.manpages@gmail.com>

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/

       reply	other threads:[~2021-01-24 16:07 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 ` Alejandro Colomar (man-pages) [this message]
2021-01-24 16:18   ` [PATCH] Various pages: Use 'logical' puntuation method for parentheses 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)

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=ab080b59-8d3e-d3cf-3b70-ba2cf8fbae67@gmail.com \
    --to=alx.manpages@gmail.com \
    --cc=linux-man@vger.kernel.org \
    --cc=mtk.manpages@gmail.com \
    /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 an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.