putty-source/utils/utils.h

/*
 * Internal header to the utils subdirectory, for definitions shared
 * between the library implementations but not intended to be exposed
 * further than that.
 */

void dputs(const char *);

char *dupvprintf_inner(char *buf, size_t oldlen, size_t *sizeptr,
                       const char *fmt, va_list ap);

const char *host_strchr_internal(const char *s, const char *set, bool first);
New library-style 'utils' subdirectories. Now that the new CMake build system is encouraging us to lay out the code like a set of libraries, it seems like a good idea to make them look more _like_ libraries, by putting things into separate modules as far as possible. This fixes several previous annoyances in which you had to link against some object in order to get a function you needed, but that object also contained other functions you didn't need which included link-time symbol references you didn't want to have to deal with. The usual offender was subsidiary supporting programs including misc.c for some innocuous function and then finding they had to deal with the requirements of buildinfo(). This big reorganisation introduces three new subdirectories called 'utils', one at the top level and one in each platform subdir. In each case, the directory contains basically the same files that were previously placed in the 'utils' build-time library, except that the ones that were extremely miscellaneous (misc.c, utils.c, uxmisc.c, winmisc.c, winmiscs.c, winutils.c) have been split up into much smaller pieces. 2021-04-17 14:22:20 +00:00			`/*`
			`* Internal header to the utils subdirectory, for definitions shared`
			`* between the library implementations but not intended to be exposed`
			`* further than that.`
			`*/`

			`void dputs(const char *);`

			`char dupvprintf_inner(char buf, size_t oldlen, size_t *sizeptr,`
			`const char *fmt, va_list ap);`

			`const char host_strchr_internal(const char s, const char *set, bool first);`