From 05044004157556f2c41e35b3823688a984722d15 Mon Sep 17 00:00:00 2001 From: Bruno Haible Date: Thu, 14 Mar 2019 09:49:24 +0100 Subject: [PATCH] all: Update URLs to msdn.microsoft.com. * lib/stat-w32.c et al.: Update URLs after most of msdn.microsoft.com was moved to docs.microsoft.com. --- ChangeLog | 6 +++ doc/acl-resources.txt | 6 +-- doc/ld-output-def.texi | 3 +- doc/windows-stat-timespec.texi | 2 +- lib/clean-temp.c | 2 +- lib/ctime.c | 2 +- lib/getprogname.c | 2 +- lib/gettimeofday.c | 6 +-- lib/localename.c | 4 +- lib/localtime.c | 2 +- lib/mktime.c | 2 +- lib/msvc-inval.h | 4 +- lib/pathmax.h | 2 +- lib/stat-time.h | 2 +- lib/stat-w32.c | 68 +++++++++++++++++----------------- lib/stat.c | 16 ++++---- lib/strftime-fixes.c | 2 +- lib/sys_socket.in.h | 2 +- lib/tmpfile.c | 2 +- lib/tzset.c | 6 +-- lib/utime.c | 14 +++---- lib/utimecmp.c | 2 +- lib/utimens.c | 8 ++-- lib/vasnprintf.c | 2 +- lib/wcsftime.c | 2 +- m4/gethostname.m4 | 4 +- tests/nap.h | 2 +- tests/test-utimens-common.h | 2 +- 28 files changed, 92 insertions(+), 85 deletions(-) diff --git a/ChangeLog b/ChangeLog index 3a44133d9a..9aa05c76d5 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,9 @@ +2019-03-14 Bruno Haible + + all: Update URLs to msdn.microsoft.com. + * lib/stat-w32.c et al.: Update URLs after most of msdn.microsoft.com + was moved to docs.microsoft.com. + 2019-03-13 Bruno Haible gnulib-tool: Clarify the coding style. diff --git a/doc/acl-resources.txt b/doc/acl-resources.txt index 28fd61882b..9140e85493 100644 --- a/doc/acl-resources.txt +++ b/doc/acl-resources.txt @@ -511,9 +511,9 @@ Native Windows ACLs Introduction: https://helgeklein.com/blog/2009/03/permissions-a-primer-or-dacl-sacl-owner-sid-and-ace-explained/ Manual pages: - https://msdn.microsoft.com/en-us/library/aa374872.aspx - https://msdn.microsoft.com/en-us/library/aa446659.aspx - https://msdn.microsoft.com/en-us/library/aa374931.aspx + https://docs.microsoft.com/en-us/windows/desktop/SecAuthZ/access-control-lists + https://docs.microsoft.com/en-us/windows/desktop/SecAuthZ/getting-information-from-an-acl + https://docs.microsoft.com/en-us/windows/desktop/api/winnt/ns-winnt-_acl https://en.wikipedia.org/wiki/Cacls Library: ? diff --git a/doc/ld-output-def.texi b/doc/ld-output-def.texi index 34e197a26a..9c1ae88255 100644 --- a/doc/ld-output-def.texi +++ b/doc/ld-output-def.texi @@ -15,7 +15,8 @@ The variants we have considered include: @itemize @bullet @item Use DUMPBIN /EXPORTS. -This is explained in @url{https://support.microsoft.com/kb/131313/en-us}. +This is explained in +@url{https://docs.microsoft.com/en-us/cpp/build/reference/dash-exports}. The tool does not generate DEF files directly, so its output needs to be post processed manually: @smallexample diff --git a/doc/windows-stat-timespec.texi b/doc/windows-stat-timespec.texi index 8aebafc222..ccd029e262 100644 --- a/doc/windows-stat-timespec.texi +++ b/doc/windows-stat-timespec.texi @@ -10,4 +10,4 @@ of files. Note: On some types of file systems, the timestamp resolution is limited by the file system. For example, on FAT file systems, @code{st_mtim} only has a resolution of 2 seconds. For more details, see -@url{https://msdn.microsoft.com/en-us/library/ms724290.aspx}. +@url{https://docs.microsoft.com/en-us/windows/desktop/SysInfo/file-times}. diff --git a/lib/clean-temp.c b/lib/clean-temp.c index e2ae3f2700..c8d9bb7c97 100644 --- a/lib/clean-temp.c +++ b/lib/clean-temp.c @@ -580,7 +580,7 @@ supports_delete_on_close () OSVERSIONINFO v; /* According to - + this structure must be initialized as follows: */ v.dwOSVersionInfoSize = sizeof (OSVERSIONINFO); diff --git a/lib/ctime.c b/lib/ctime.c index 064e347c99..1ec210d8bf 100644 --- a/lib/ctime.c +++ b/lib/ctime.c @@ -31,7 +31,7 @@ rpl_ctime (const time_t *tp) /* Rectify the value of the environment variable TZ. There are four possible kinds of such values: - Traditional US time zone names, e.g. "PST8PDT". Syntax: see - + - Time zone names based on geography, that contain one or more slashes, e.g. "Europe/Moscow". - Time zone names based on geography, without slashes, e.g. diff --git a/lib/getprogname.c b/lib/getprogname.c index 1f264a17c1..a12b8b17de 100644 --- a/lib/getprogname.c +++ b/lib/getprogname.c @@ -70,7 +70,7 @@ getprogname (void) p = "?"; return last_component (p); # elif HAVE_DECL___ARGV /* mingw, MSVC */ - /* https://msdn.microsoft.com/en-us/library/dn727674.aspx */ + /* https://docs.microsoft.com/en-us/cpp/c-runtime-library/argc-argv-wargv */ const char *p = __argv && __argv[0] ? __argv[0] : "?"; return last_component (p); # elif HAVE_VAR___PROGNAME /* OpenBSD, Android, QNX */ diff --git a/lib/gettimeofday.c b/lib/gettimeofday.c index 9c6d1707d9..378c736aa4 100644 --- a/lib/gettimeofday.c +++ b/lib/gettimeofday.c @@ -72,10 +72,10 @@ gettimeofday (struct timeval *restrict tv, void *restrict tz) /* On native Windows, there are two ways to get the current time: GetSystemTimeAsFileTime - + or GetSystemTimePreciseAsFileTime - . + . GetSystemTimeAsFileTime produces values that jump by increments of 15.627 milliseconds (!) on average. Whereas GetSystemTimePreciseAsFileTime values usually jump by 1 or 2 @@ -92,7 +92,7 @@ gettimeofday (struct timeval *restrict tv, void *restrict tz) GetSystemTimeAsFileTime (¤t_time); /* Convert from FILETIME to 'struct timeval'. */ - /* FILETIME: */ + /* FILETIME: */ ULONGLONG since_1601 = ((ULONGLONG) current_time.dwHighDateTime << 32) | (ULONGLONG) current_time.dwLowDateTime; diff --git a/lib/localename.c b/lib/localename.c index 857a76d729..1cb0a90f0d 100644 --- a/lib/localename.c +++ b/lib/localename.c @@ -2296,8 +2296,8 @@ gl_locale_name_from_win32_LANGID (LANGID langid) } return "wen"; case LANG_SOTHO: - /* calls - it "Sesotho sa Leboa"; according to + /* + calls it "Sesotho sa Leboa"; according to it's the same as Northern Sotho. */ diff --git a/lib/localtime.c b/lib/localtime.c index 8ff1d07f7d..49a7d49b28 100644 --- a/lib/localtime.c +++ b/lib/localtime.c @@ -34,7 +34,7 @@ rpl_localtime (const time_t *tp) /* Rectify the value of the environment variable TZ. There are four possible kinds of such values: - Traditional US time zone names, e.g. "PST8PDT". Syntax: see - + - Time zone names based on geography, that contain one or more slashes, e.g. "Europe/Moscow". - Time zone names based on geography, without slashes, e.g. diff --git a/lib/mktime.c b/lib/mktime.c index af43a6950d..57efee9b25 100644 --- a/lib/mktime.c +++ b/lib/mktime.c @@ -72,7 +72,7 @@ my_tzset (void) /* Rectify the value of the environment variable TZ. There are four possible kinds of such values: - Traditional US time zone names, e.g. "PST8PDT". Syntax: see - + - Time zone names based on geography, that contain one or more slashes, e.g. "Europe/Moscow". - Time zone names based on geography, without slashes, e.g. diff --git a/lib/msvc-inval.h b/lib/msvc-inval.h index 6d26596815..c45299d305 100644 --- a/lib/msvc-inval.h +++ b/lib/msvc-inval.h @@ -95,7 +95,7 @@ extern void gl_msvc_inval_ensure_handler (void); /* Gnulib can define its own status codes, as described in the page "Raising Software Exceptions" on microsoft.com - . + . Our status codes are composed of - 0xE0000000, mandatory for all user-defined status codes, - 0x474E550, a API identifier ("GNU"), @@ -106,7 +106,7 @@ extern void gl_msvc_inval_ensure_handler (void); # if defined _MSC_VER /* A compiler that supports __try/__except, as described in the page "try-except statement" on microsoft.com - . + . With __try/__except, we can use the multithread-safe exception handling. */ # ifdef __cplusplus diff --git a/lib/pathmax.h b/lib/pathmax.h index 232f6d8fc7..9c3b8f8441 100644 --- a/lib/pathmax.h +++ b/lib/pathmax.h @@ -68,7 +68,7 @@ # if defined _WIN32 && ! defined __CYGWIN__ /* The page "Naming Files, Paths, and Namespaces" on msdn.microsoft.com, section "Maximum Path Length Limitation", - + explains that the maximum size of a filename, including the terminating NUL byte, is 260 = 3 + 256 + 1. This is the same value as diff --git a/lib/stat-time.h b/lib/stat-time.h index d4f1f96104..38a1f55a6c 100644 --- a/lib/stat-time.h +++ b/lib/stat-time.h @@ -171,7 +171,7 @@ get_stat_birthtime (struct stat const *st _GL_UNUSED) #elif defined _WIN32 && ! defined __CYGWIN__ /* Native Windows platforms (but not Cygwin) put the "file creation time" in st_ctime (!). See - . */ + . */ # if _GL_WINDOWS_STAT_TIMESPEC t = st->st_ctim; # else diff --git a/lib/stat-w32.c b/lib/stat-w32.c index ffa99429d9..60fe5f6e87 100644 --- a/lib/stat-w32.c +++ b/lib/stat-w32.c @@ -80,7 +80,7 @@ struct timespec _gl_convert_FILETIME_to_timespec (const FILETIME *ft) { struct timespec result; - /* FILETIME: */ + /* FILETIME: */ unsigned long long since_1601 = ((unsigned long long) ft->dwHighDateTime << 32) | (unsigned long long) ft->dwLowDateTime; @@ -104,7 +104,7 @@ _gl_convert_FILETIME_to_timespec (const FILETIME *ft) time_t _gl_convert_FILETIME_to_POSIX (const FILETIME *ft) { - /* FILETIME: */ + /* FILETIME: */ unsigned long long since_1601 = ((unsigned long long) ft->dwHighDateTime << 32) | (unsigned long long) ft->dwLowDateTime; @@ -128,7 +128,7 @@ int _gl_fstat_by_handle (HANDLE h, const char *path, struct stat *buf) { /* GetFileType - */ + */ DWORD type = GetFileType (h); if (type == FILE_TYPE_DISK) { @@ -137,16 +137,16 @@ _gl_fstat_by_handle (HANDLE h, const char *path, struct stat *buf) /* st_mode can be determined through GetFileAttributesEx - - + + or through GetFileInformationByHandle - - + + or through GetFileInformationByHandleEx with argument FileBasicInfo - - + + The latter requires -D_WIN32_WINNT=_WIN32_WINNT_VISTA or higher. */ BY_HANDLE_FILE_INFORMATION info; if (! GetFileInformationByHandle (h, &info)) @@ -162,12 +162,12 @@ _gl_fstat_by_handle (HANDLE h, const char *path, struct stat *buf) #if _GL_WINDOWS_STAT_INODES /* st_ino can be determined through GetFileInformationByHandle - - + + as 64 bits, or through GetFileInformationByHandleEx with argument FileIdInfo - - + + as 128 bits. The latter requires -D_WIN32_WINNT=_WIN32_WINNT_WIN8 or higher. */ /* Experiments show that GetFileInformationByHandleEx does not provide @@ -238,11 +238,11 @@ _gl_fstat_by_handle (HANDLE h, const char *path, struct stat *buf) If the file name is already known, use it. Otherwise, for non-empty files, it can be determined through GetFinalPathNameByHandle - + or through GetFileInformationByHandleEx with argument FileNameInfo - - + + Both require -D_WIN32_WINNT=_WIN32_WINNT_VISTA or higher. */ if (info.nFileSizeHigh > 0 || info.nFileSizeLow > 0) { @@ -277,12 +277,12 @@ _gl_fstat_by_handle (HANDLE h, const char *path, struct stat *buf) /* st_nlink can be determined through GetFileInformationByHandle - - + + or through GetFileInformationByHandleEx with argument FileStandardInfo - - + + The latter requires -D_WIN32_WINNT=_WIN32_WINNT_VISTA or higher. */ buf->st_nlink = (info.nNumberOfLinks > SHRT_MAX ? SHRT_MAX : info.nNumberOfLinks); @@ -295,19 +295,19 @@ _gl_fstat_by_handle (HANDLE h, const char *path, struct stat *buf) /* st_size can be determined through GetFileSizeEx - + or through GetFileAttributesEx - - + + or through GetFileInformationByHandle - - + + or through GetFileInformationByHandleEx with argument FileStandardInfo - - + + The latter requires -D_WIN32_WINNT=_WIN32_WINNT_VISTA or higher. */ if (sizeof (buf->st_size) <= 4) /* Range check already done above. */ @@ -317,19 +317,19 @@ _gl_fstat_by_handle (HANDLE h, const char *path, struct stat *buf) /* st_atime, st_mtime, st_ctime can be determined through GetFileTime - + or through GetFileAttributesEx - - + + or through GetFileInformationByHandle - - + + or through GetFileInformationByHandleEx with argument FileBasicInfo - - + + The latter requires -D_WIN32_WINNT=_WIN32_WINNT_VISTA or higher. */ #if _GL_WINDOWS_STAT_TIMESPEC buf->st_atim = _gl_convert_FILETIME_to_timespec (&info.ftLastAccessTime); diff --git a/lib/stat.c b/lib/stat.c index e4fc2cb930..1c28aa4529 100644 --- a/lib/stat.c +++ b/lib/stat.c @@ -111,7 +111,7 @@ rpl_stat (char const *name, struct stat *buf) */ /* XXX Should we convert to wchar_t* and prepend '\\?\', in order to work around length limitations - ? */ + ? */ /* POSIX specifies: "More than two leading characters shall be treated as @@ -194,8 +194,8 @@ rpl_stat (char const *name, struct stat *buf) /* Open a handle to the file. CreateFile - - */ + + */ HANDLE h = CreateFile (rname, FILE_READ_ATTRIBUTES, @@ -236,13 +236,13 @@ rpl_stat (char const *name, struct stat *buf) /* Get the details about the directory entry. This can be done through FindFirstFile - - + + or through FindFirstFileEx with argument FindExInfoBasic - - - */ + + + */ WIN32_FIND_DATA info; HANDLE h = FindFirstFile (rname, &info); if (h == INVALID_HANDLE_VALUE) diff --git a/lib/strftime-fixes.c b/lib/strftime-fixes.c index 7f49b1160a..f959e7bba2 100644 --- a/lib/strftime-fixes.c +++ b/lib/strftime-fixes.c @@ -31,7 +31,7 @@ rpl_strftime (char *buf, size_t bufsize, const char *format, const struct tm *tp /* Rectify the value of the environment variable TZ. There are four possible kinds of such values: - Traditional US time zone names, e.g. "PST8PDT". Syntax: see - + - Time zone names based on geography, that contain one or more slashes, e.g. "Europe/Moscow". - Time zone names based on geography, without slashes, e.g. diff --git a/lib/sys_socket.in.h b/lib/sys_socket.in.h index be19572350..19ee961744 100644 --- a/lib/sys_socket.in.h +++ b/lib/sys_socket.in.h @@ -169,7 +169,7 @@ struct sockaddr_storage code may not run on older Windows releases then. My Windows 2000 box was not able to run the code, for example. The situation is slightly confusing because - + suggests that getaddrinfo should be available on all Windows releases. */ diff --git a/lib/tmpfile.c b/lib/tmpfile.c index 60ea8d6a7f..cc263e2502 100644 --- a/lib/tmpfile.c +++ b/lib/tmpfile.c @@ -67,7 +67,7 @@ supports_delete_on_close () OSVERSIONINFO v; /* According to - + this structure must be initialized as follows: */ v.dwOSVersionInfoSize = sizeof (OSVERSIONINFO); diff --git a/lib/tzset.c b/lib/tzset.c index 998df7b13d..ea70686046 100644 --- a/lib/tzset.c +++ b/lib/tzset.c @@ -44,7 +44,7 @@ tzset (void) /* Rectify the value of the environment variable TZ. There are four possible kinds of such values: - Traditional US time zone names, e.g. "PST8PDT". Syntax: see - + - Time zone names based on geography, that contain one or more slashes, e.g. "Europe/Moscow". - Time zone names based on geography, without slashes, e.g. @@ -68,8 +68,8 @@ tzset (void) _putenv ("TZ="); /* On native Windows, tzset() is deprecated. Use _tzset() instead. See - https://msdn.microsoft.com/en-us/library/ms235451.aspx - https://msdn.microsoft.com/en-us/library/90s5c885.aspx */ + + */ _tzset (); #elif HAVE_TZSET tzset (); diff --git a/lib/utime.c b/lib/utime.c index 88973e139d..6d29045eda 100644 --- a/lib/utime.c +++ b/lib/utime.c @@ -83,8 +83,8 @@ _gl_utimens_windows (const char *name, struct timespec ts[2]) /* Open a handle to the file. CreateFile - - */ + + */ HANDLE handle = CreateFile (rname, FILE_READ_ATTRIBUTES | FILE_WRITE_ATTRIBUTES, @@ -105,7 +105,7 @@ _gl_utimens_windows (const char *name, struct timespec ts[2]) if (check_dir) { /* GetFileAttributes - */ + */ DWORD attributes = GetFileAttributes (rname); if (attributes == INVALID_FILE_ATTRIBUTES) { @@ -125,18 +125,18 @@ _gl_utimens_windows (const char *name, struct timespec ts[2]) { /* Use SetFileTime(). See - - */ + + */ FILETIME last_access_time; FILETIME last_write_time; if (ts == NULL) { /* GetSystemTimeAsFileTime is the same as GetSystemTime followed by SystemTimeToFileTime. - . + . It would be overkill to use GetSystemTimePreciseAsFileTime - . */ + . */ FILETIME current_time; GetSystemTimeAsFileTime (¤t_time); last_access_time = current_time; diff --git a/lib/utimecmp.c b/lib/utimecmp.c index f23aa599d2..b976b6a9bb 100644 --- a/lib/utimecmp.c +++ b/lib/utimecmp.c @@ -49,7 +49,7 @@ enum { SYSCALL_RESOLUTION = 1 }; #elif defined _WIN32 && ! defined __CYGWIN__ /* On native Windows, file times have 100 ns resolution. See - */ + */ enum { SYSCALL_RESOLUTION = 100 }; #elif ((HAVE_FUTIMESAT || HAVE_WORKING_UTIMES) \ && (defined HAVE_STRUCT_STAT_ST_ATIM_TV_NSEC \ diff --git a/lib/utimens.c b/lib/utimens.c index 34689bcd65..c9b65ef4c2 100644 --- a/lib/utimens.c +++ b/lib/utimens.c @@ -288,8 +288,8 @@ fdutimens (int fd, char const *file, struct timespec const timespec[2]) #ifdef USE_SETFILETIME /* On native Windows, use SetFileTime(). See - - */ + + */ if (0 <= fd) { HANDLE handle; @@ -307,10 +307,10 @@ fdutimens (int fd, char const *file, struct timespec const timespec[2]) if (ts == NULL || ts[0].tv_nsec == UTIME_NOW || ts[1].tv_nsec == UTIME_NOW) { /* GetSystemTimeAsFileTime - . + . It would be overkill to use GetSystemTimePreciseAsFileTime - . */ + . */ GetSystemTimeAsFileTime (¤t_time); } diff --git a/lib/vasnprintf.c b/lib/vasnprintf.c index b14a95962b..1d849eeab8 100644 --- a/lib/vasnprintf.c +++ b/lib/vasnprintf.c @@ -4917,7 +4917,7 @@ VASNPRINTF (DCHAR_T *resultbuf, size_t *lengthp, Windows Vista, the use of %n in format strings by default crashes the program. See and - + So we should avoid %n in this situation. */ fbp[1] = '\0'; # endif diff --git a/lib/wcsftime.c b/lib/wcsftime.c index 16dac941e2..810b52a4fa 100644 --- a/lib/wcsftime.c +++ b/lib/wcsftime.c @@ -32,7 +32,7 @@ rpl_wcsftime (wchar_t *buf, size_t bufsize, const wchar_t *format, const struct /* Rectify the value of the environment variable TZ. There are four possible kinds of such values: - Traditional US time zone names, e.g. "PST8PDT". Syntax: see - + - Time zone names based on geography, that contain one or more slashes, e.g. "Europe/Moscow". - Time zone names based on geography, without slashes, e.g. diff --git a/m4/gethostname.m4 b/m4/gethostname.m4 index 0414f8e51e..f0643776d6 100644 --- a/m4/gethostname.m4 +++ b/m4/gethostname.m4 @@ -1,4 +1,4 @@ -# gethostname.m4 serial 13 +# gethostname.m4 serial 14 dnl Copyright (C) 2002, 2008-2019 Free Software Foundation, Inc. dnl This file is free software; the Free Software Foundation dnl gives unlimited permission to copy and/or distribute it, @@ -48,7 +48,7 @@ AC_DEFUN([gl_PREREQ_HOST_NAME_MAX], [ dnl - On most Unix systems, use MAXHOSTNAMELEN from instead. dnl - On Solaris, Cygwin, BeOS, use MAXHOSTNAMELEN from instead. dnl - On mingw, use 256, because - dnl says: + dnl says: dnl "if a buffer of 256 bytes is passed in the name parameter and dnl the namelen parameter is set to 256, the buffer size will always dnl be adequate." diff --git a/tests/nap.h b/tests/nap.h index 2eb3d46b05..739f0a4357 100644 --- a/tests/nap.h +++ b/tests/nap.h @@ -67,7 +67,7 @@ nap_get_stat (struct stat *st, int do_write) #if defined _WIN32 || defined __CYGWIN__ /* On Windows, the modification times are not changed until NAP_FD is closed. See - https://msdn.microsoft.com/en-us/library/windows/desktop/aa365747(v=vs.85).aspx */ + */ close (nap_fd); nap_fd = open (TEMPFILE, O_RDWR, 0600); ASSERT (nap_fd != -1); diff --git a/tests/test-utimens-common.h b/tests/test-utimens-common.h index ba3562136c..b6d480dffe 100644 --- a/tests/test-utimens-common.h +++ b/tests/test-utimens-common.h @@ -53,7 +53,7 @@ enum { /* Skip ctime tests on native Windows, since it is either a copy of mtime or birth time (depending on the file system), rather than a properly tracked change time. See - . */ + . */ # define check_ctime 0 # else # define check_ctime 1 -- 2.39.5