aniani/vim
0
0
Fork 1
mirror of https://github.com/vim/vim.git synced 2025-11-13 22:54:27 -05:00
Code Activity

patch 9.0.0110: help tag generation picks up words in code examples

Browse Source 
Problem:    Help tag generation picks up words in code examples.
Solution:   Skip over examples. (Carlo Teubner, closes #10813)
This commit is contained in:
Carlo Teubner
2022-07-30 12:03:16 +01:00
committed by Bram Moolenaar
parent 1eead4cf1d
commit ddab3ce345
4 changed files with 45 additions and 10 deletions
Download Patch File Download Diff File Expand all files Collapse all files

32
runtime/doc/doctags.c
View File

@@ -21,6 +21,8 @@ main(int argc, char **argv)
char *p1, *p2;
char *p;
FILE *fd;
int len;
int in_example;
if (argc <= 1)
{
@@ -37,22 +39,28 @@ main(int argc, char **argv)
fprintf(stderr, "Unable to open %s for reading\n", argv[0]);
continue;
}
in_example = 0;
while (fgets(line, LINELEN, fd) != NULL)
{
p1 = strchr(line, '*'); /* find first '*' */
if (in_example)
{
// skip over example; non-blank in first column ends example
if (strchr(" \t\n\r", line[0]) != NULL)
continue;
in_example = 0;
}
p1 = strchr(line, '*'); // find first '*'
while (p1 != NULL)
{
p2 = strchr(p1 + 1, '*'); /* find second '*' */
if (p2 != NULL && p2 > p1 + 1) /* skip "*" and "**" */
p2 = strchr(p1 + 1, '*'); // find second '*'
if (p2 != NULL && p2 > p1 + 1) // skip "*" and "**"
{
for (p = p1 + 1; p < p2; ++p)
if (*p == ' ' || *p == '\t' || *p == '|')
break;
/*
* Only accept a *tag* when it consists of valid
* characters, there is white space before it and is
* followed by a white character or end-of-line.
*/
// Only accept a *tag* when it consists of valid
// characters, there is white space before it and is
// followed by a white character or end-of-line.
if (p == p2
&& (p1 == line || p1[-1] == ' ' || p1[-1] == '\t')
&& (strchr(" \t\n\r", p[1]) != NULL
@@ -63,18 +71,22 @@ main(int argc, char **argv)
printf("%s\t%s\t/*", p1, argv[0]);
while (*p1)
{
/* insert backslash before '\\' and '/' */
// insert backslash before '\\' and '/'
if (*p1 == '\\' || *p1 == '/')
putchar('\\');
putchar(*p1);
++p1;
}
printf("*\n");
p2 = strchr(p2 + 1, '*'); /* find next '*' */
p2 = strchr(p2 + 1, '*'); // find next '*'
}
}
p1 = p2;
}
len = strlen(line);
if ((len == 2 && strcmp(&line[len - 2], ">\n") == 0)
|| (len >= 3 && strcmp(&line[len - 3], " >\n") == 0))
in_example = 1;
}
fclose(fd);
}