[thirdparty/cups.git] / cgi-bin / makedocset.c

/*
 * Xcode documentation set generator.
 *
 * Copyright 2007-2012 by Apple Inc.
 * Copyright 1997-2007 by Easy Software Products.
 *
 * Licensed under Apache License v2.0.  See the file "LICENSE" for more information.
 *
 * Usage:
 *
 *   makedocset directory *.tokens
 */

/*
 * Include necessary headers...
 */

#include "cgi-private.h"
#include <errno.h>


/*
 * Local structures...
 */

typedef struct _cups_html_s		/**** Help file ****/
{
  char		*path;			/* Path to help file */
  char		*title;			/* Title of help file */
} _cups_html_t;

typedef struct _cups_section_s		/**** Help section ****/
{
  char		*name;			/* Section name */
  cups_array_t	*files;			/* Files in this section */
} _cups_section_t;


/*
 * Local functions...
 */

static int	compare_html(_cups_html_t *a, _cups_html_t *b);
static int	compare_sections(_cups_section_t *a, _cups_section_t *b);
static int	compare_sections_files(_cups_section_t *a, _cups_section_t *b);
static void	write_index(const char *path, help_index_t *hi);
static void	write_info(const char *path, const char *revision);
static void	write_nodes(const char *path, help_index_t *hi);


/*
 * 'main()' - Test the help index code.
 */

int					/* O - Exit status */
main(int  argc,				/* I - Number of command-line args */
     char *argv[])			/* I - Command-line arguments */
{
  int		i;			/* Looping var */
  char		path[1024],		/* Path to documentation */
		line[1024];		/* Line from file */
  help_index_t	*hi;			/* Help index */
  cups_file_t	*tokens,		/* Tokens.xml file */
		*fp;			/* Current file */


  if (argc < 4)
  {
    puts("Usage: makedocset directory revision *.tokens");
    return (1);
  }

 /*
  * Index the help documents...
  */

  snprintf(path, sizeof(path), "%s/Contents/Resources/Documentation", argv[1]);
  if ((hi = helpLoadIndex(NULL, path)) == NULL)
  {
    fputs("makedocset: Unable to index help files!\n", stderr);
    return (1);
  }

  snprintf(path, sizeof(path), "%s/Contents/Resources/Documentation/index.html",
           argv[1]);
  write_index(path, hi);

  snprintf(path, sizeof(path), "%s/Contents/Resources/Nodes.xml", argv[1]);
  write_nodes(path, hi);

 /*
  * Write the Info.plist file...
  */

  snprintf(path, sizeof(path), "%s/Contents/Info.plist", argv[1]);
  write_info(path, argv[2]);

 /*
  * Merge the Tokens.xml files...
  */

  snprintf(path, sizeof(path), "%s/Contents/Resources/Tokens.xml", argv[1]);
  if ((tokens = cupsFileOpen(path, "w")) == NULL)
  {
    fprintf(stderr, "makedocset: Unable to create \"%s\": %s\n", path,
	    strerror(errno));
    return (1);
  }

  cupsFilePuts(tokens, "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n");
  cupsFilePuts(tokens, "<Tokens version=\"1.0\">\n");

  for (i = 3; i < argc; i ++)
  {
    if ((fp = cupsFileOpen(argv[i], "r")) == NULL)
    {
      fprintf(stderr, "makedocset: Unable to open \"%s\": %s\n", argv[i],
	      strerror(errno));
      return (1);
    }

    if (!cupsFileGets(fp, line, sizeof(line)) || strncmp(line, "<?xml ", 6) ||
        !cupsFileGets(fp, line, sizeof(line)) || strncmp(line, "<Tokens ", 8))
    {
      fprintf(stderr, "makedocset: Bad Tokens.xml file \"%s\"!\n", argv[i]);
      return (1);
    }

    while (cupsFileGets(fp, line, sizeof(line)))
    {
      if (strcmp(line, "</Tokens>"))
        cupsFilePrintf(tokens, "%s\n", line);
    }

    cupsFileClose(fp);
  }

  cupsFilePuts(tokens, "</Tokens>\n");

  cupsFileClose(tokens);

 /*
  * Return with no errors...
  */

  return (0);
}


/*
 * 'compare_html()' - Compare the titles of two HTML files.
 */

static int				/* O - Result of comparison */
compare_html(_cups_html_t *a,		/* I - First file */
             _cups_html_t *b)		/* I - Second file */
{
  return (_cups_strcasecmp(a->title, b->title));
}


/*
 * 'compare_sections()' - Compare the names of two help sections.
 */

static int				/* O - Result of comparison */
compare_sections(_cups_section_t *a,	/* I - First section */
                 _cups_section_t *b)	/* I - Second section */
{
  return (_cups_strcasecmp(a->name, b->name));
}


/*
 * 'compare_sections_files()' - Compare the number of files and section names.
 */

static int				/* O - Result of comparison */
compare_sections_files(
    _cups_section_t *a,			/* I - First section */
    _cups_section_t *b)			/* I - Second section */
{
  int	ret = cupsArrayCount(b->files) - cupsArrayCount(a->files);

  if (ret)
    return (ret);
  else
    return (_cups_strcasecmp(a->name, b->name));
}


/*
 * 'write_index()' - Write an index file for the CUPS help.
 */

static void
write_index(const char   *path,		/* I - File to write */
            help_index_t *hi)		/* I - Index of files */
{
  cups_file_t		*fp;		/* Output file */
  help_node_t		*node;		/* Current help node */
  _cups_section_t	*section,	/* Current section */
			key;		/* Section search key */
  _cups_html_t		*html;		/* Current HTML file */
  cups_array_t		*sections,	/* Sections in index */
			*sections_files,/* Sections sorted by size */
			*columns[3];	/* Columns in final HTML file */
  int			column,		/* Current column */
			lines[3],	/* Number of lines in each column */
			min_column,	/* Smallest column */
			min_lines;	/* Smallest number of lines */


 /*
  * Build an array of sections and their files.
  */

  sections = cupsArrayNew((cups_array_func_t)compare_sections, NULL);

  for (node = (help_node_t *)cupsArrayFirst(hi->nodes);
       node;
       node = (help_node_t *)cupsArrayNext(hi->nodes))
  {
    if (node->anchor)
      continue;

    key.name = node->section ? node->section : "Miscellaneous";
    if ((section = (_cups_section_t *)cupsArrayFind(sections, &key)) == NULL)
    {
      section        = (_cups_section_t *)calloc(1, sizeof(_cups_section_t));
      section->name  = key.name;
      section->files = cupsArrayNew((cups_array_func_t)compare_html, NULL);

      cupsArrayAdd(sections, section);
    }

    html = (_cups_html_t *)calloc(1, sizeof(_cups_html_t));
    html->path  = node->filename;
    html->title = node->text;

    cupsArrayAdd(section->files, html);
  }

 /*
  * Build a sorted list of sections based on the number of files in each section
  * and the section name...
  */

  sections_files = cupsArrayNew((cups_array_func_t)compare_sections_files,
                                NULL);
  for (section = (_cups_section_t *)cupsArrayFirst(sections);
       section;
       section = (_cups_section_t *)cupsArrayNext(sections))
    cupsArrayAdd(sections_files, section);

 /*
  * Then build three columns to hold everything, trying to balance the number of
  * lines in each column...
  */

  for (column = 0; column < 3; column ++)
  {
    columns[column] = cupsArrayNew((cups_array_func_t)compare_sections, NULL);
    lines[column]   = 0;
  }

  for (section = (_cups_section_t *)cupsArrayFirst(sections_files);
       section;
       section = (_cups_section_t *)cupsArrayNext(sections_files))
  {
    for (min_column = 0, min_lines = lines[0], column = 1;
         column < 3;
	 column ++)
    {
      if (lines[column] < min_lines)
      {
        min_column = column;
        min_lines  = lines[column];
      }
    }

    cupsArrayAdd(columns[min_column], section);
    lines[min_column] += cupsArrayCount(section->files) + 2;
  }

 /*
  * Write the HTML file...
  */

  if ((fp = cupsFileOpen(path, "w")) == NULL)
  {
    fprintf(stderr, "makedocset: Unable to create %s: %s\n", path,
            strerror(errno));
    exit(1);
  }

  cupsFilePuts(fp, "<!DOCTYPE HTML PUBLIC \"-//W3C//DTD HTML 4.01 "
                   "Transitional//EN\" "
		   "\"http://www.w3.org/TR/html4/loose.dtd\">\n"
		   "<html>\n"
		   "<head>\n"
		   "<title>CUPS Documentation</title>\n"
		   "<link rel='stylesheet' type='text/css' "
		   "href='cups-printable.css'>\n"
		   "</head>\n"
		   "<body>\n"
		   "<h1 class='title'>CUPS Documentation</h1>\n"
		   "<table width='100%' summary=''>\n"
		   "<tr>\n");

  for (column = 0; column < 3; column ++)
  {
    if (column)
      cupsFilePuts(fp, "<td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</td>\n");

    cupsFilePuts(fp, "<td valign='top' width='33%'>");
    for (section = (_cups_section_t *)cupsArrayFirst(columns[column]);
         section;
	 section = (_cups_section_t *)cupsArrayNext(columns[column]))
    {
      cupsFilePrintf(fp, "<h2 class='title'>%s</h2>\n", section->name);
      for (html = (_cups_html_t *)cupsArrayFirst(section->files);
           html;
	   html = (_cups_html_t *)cupsArrayNext(section->files))
	cupsFilePrintf(fp, "<p class='compact'><a href='%s'>%s</a></p>\n",
	               html->path, html->title);
    }
    cupsFilePuts(fp, "</td>\n");
  }
  cupsFilePuts(fp, "</tr>\n"
                   "</table>\n"
		   "</body>\n"
		   "</html>\n");
  cupsFileClose(fp);
}


/*
 * 'write_info()' - Write the Info.plist file.
 */

static void
write_info(const char *path,		/* I - File to write */
           const char *revision)	/* I - Subversion revision number */
{
  cups_file_t	*fp;			/* File */


  if ((fp = cupsFileOpen(path, "w")) == NULL)
  {
    fprintf(stderr, "makedocset: Unable to create %s: %s\n", path,
            strerror(errno));
    exit(1);
  }

  cupsFilePrintf(fp, "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n"
		     "<!DOCTYPE plist PUBLIC \"-//Apple//DTD PLIST 1.0//EN\" "
		     "\"http://www.apple.com/DTDs/PropertyList-1.0.dtd\">\n"
		     "<plist version=\"1.0\">\n"
		     "<dict>\n"
		     "\t<key>CFBundleIdentifier</key>\n"
		     "\t<string>org.cups.docset</string>\n"
		     "\t<key>CFBundleName</key>\n"
		     "\t<string>CUPS Documentation</string>\n"
		     "\t<key>CFBundleVersion</key>\n"
		     "\t<string>%d.%d.%s</string>\n"
		     "\t<key>CFBundleShortVersionString</key>\n"
		     "\t<string>%d.%d.%d</string>\n"
		     "\t<key>DocSetFeedName</key>\n"
		     "\t<string>cups.org</string>\n"
		     "\t<key>DocSetFeedURL</key>\n"
		     "\t<string>http://www.cups.org/org.cups.docset.atom"
		     "</string>\n"
		     "\t<key>DocSetPublisherIdentifier</key>\n"
		     "\t<string>org.cups</string>\n"
		     "\t<key>DocSetPublisherName</key>\n"
		     "\t<string>CUPS</string>\n"
		     "</dict>\n"
		     "</plist>\n",
		     CUPS_VERSION_MAJOR, CUPS_VERSION_MINOR, revision,
		     CUPS_VERSION_MAJOR, CUPS_VERSION_MINOR, CUPS_VERSION_PATCH);

  cupsFileClose(fp);
}


/*
 * 'write_nodes()' - Write the Nodes.xml file.
 */

static void
write_nodes(const char   *path,		/* I - File to write */
            help_index_t *hi)		/* I - Index of files */
{
  cups_file_t	*fp;			/* Output file */
  int		id;			/* Current node ID */
  help_node_t	*node;			/* Current help node */
  int		subnodes;		/* Currently in Subnodes for file? */
  int		needclose;		/* Need to close the current node? */


  if ((fp = cupsFileOpen(path, "w")) == NULL)
  {
    fprintf(stderr, "makedocset: Unable to create %s: %s\n", path,
            strerror(errno));
    exit(1);
  }

  cupsFilePuts(fp, "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n"
		   "<DocSetNodes version=\"1.0\">\n"
		   "<TOC>\n"
		   "<Node id=\"0\">\n"
		   "<Name>CUPS Documentation</Name>\n"
		   "<Path>Documentation/index.html</Path>\n"
		   "</Node>\n");

  for (node = (help_node_t *)cupsArrayFirst(hi->nodes), id = 1, subnodes = 0,
           needclose = 0;
       node;
       node = (help_node_t *)cupsArrayNext(hi->nodes), id ++)
  {
    if (node->anchor)
    {
      if (!subnodes)
      {
        cupsFilePuts(fp, "<Subnodes>\n");
	subnodes = 1;
      }

      cupsFilePrintf(fp, "<Node id=\"%d\">\n"
                         "<Path>Documentation/%s</Path>\n"
			 "<Anchor>%s</Anchor>\n"
			 "<Name>%s</Name>\n"
			 "</Node>\n", id, node->filename, node->anchor,
		     node->text);
    }
    else
    {
      if (subnodes)
      {
        cupsFilePuts(fp, "</Subnodes>\n");
	subnodes = 0;
      }

      if (needclose)
        cupsFilePuts(fp, "</Node>\n");

      cupsFilePrintf(fp, "<Node id=\"%d\">\n"
                         "<Path>Documentation/%s</Path>\n"
			 "<Name>%s</Name>\n", id, node->filename, node->text);
      needclose = 1;
    }
  }

  if (subnodes)
    cupsFilePuts(fp, "</Subnodes>\n");

  if (needclose)
    cupsFilePuts(fp, "</Node>\n");

  cupsFilePuts(fp, "</TOC>\n"
		   "</DocSetNodes>\n");

  cupsFileClose(fp);
}
Commit	Line	Data
f11a948a	1	/*
503b54c9	2	* Xcode documentation set generator.
f11a948a	3	*
503b54c9 MS	4	* Copyright 2007-2012 by Apple Inc.
503b54c9 MS	5	* Copyright 1997-2007 by Easy Software Products.
f11a948a	6	*
e3101897	7	* Licensed under Apache License v2.0. See the file "LICENSE" for more information.
f11a948a MS	8	*
	9	* Usage:
	10	*
	11	* makedocset directory *.tokens
f11a948a MS	12	*/
	13
	14	/*
	15	* Include necessary headers...
	16	*/
	17
a29fd7dd	18	#include "cgi-private.h"
f11a948a MS	19	#include <errno.h>
	20
	21
	22	/*
	23	* Local structures...
	24	*/
	25
	26	typedef struct _cups_html_s /** Help file **/
	27	{
	28	char path; / Path to help file */
	29	char title; / Title of help file */
	30	} _cups_html_t;
	31
	32	typedef struct _cups_section_s /** Help section **/
	33	{
	34	char name; / Section name */
	35	cups_array_t files; / Files in this section */
	36	} _cups_section_t;
	37
	38
	39	/*
	40	* Local functions...
	41	*/
	42
	43	static int compare_html(_cups_html_t a, _cups_html_t b);
	44	static int compare_sections(_cups_section_t a, _cups_section_t b);
	45	static int compare_sections_files(_cups_section_t a, _cups_section_t b);
	46	static void write_index(const char path, help_index_t hi);
	47	static void write_info(const char path, const char revision);
	48	static void write_nodes(const char path, help_index_t hi);
	49
	50
	51	/*
	52	* 'main()' - Test the help index code.
	53	*/
	54
	55	int /* O - Exit status */
	56	main(int argc, /* I - Number of command-line args */
	57	char argv[]) / I - Command-line arguments */
	58	{
	59	int i; /* Looping var */
	60	char path[1024], /* Path to documentation */
	61	line[1024]; /* Line from file */
	62	help_index_t hi; / Help index */
	63	cups_file_t tokens, / Tokens.xml file */
	64	fp; / Current file */
	65
	66
	67	if (argc < 4)
	68	{
	69	puts("Usage: makedocset directory revision *.tokens");
	70	return (1);
	71	}
	72
	73	/*
	74	* Index the help documents...
	75	*/
	76
	77	snprintf(path, sizeof(path), "%s/Contents/Resources/Documentation", argv[1]);
	78	if ((hi = helpLoadIndex(NULL, path)) == NULL)
	79	{
	80	fputs("makedocset: Unable to index help files!\n", stderr);
	81	return (1);
	82	}
83
84	snprintf(path, sizeof(path), "%s/Contents/Resources/Documentation/index.html",
85	argv[1]);
86	write_index(path, hi);
87
88	snprintf(path, sizeof(path), "%s/Contents/Resources/Nodes.xml", argv[1]);
89	write_nodes(path, hi);
90
91	/*
92	* Write the Info.plist file...
93	*/
94
95	snprintf(path, sizeof(path), "%s/Contents/Info.plist", argv[1]);
96	write_info(path, argv[2]);
97
98	/*
99	* Merge the Tokens.xml files...
100	*/
101
102	snprintf(path, sizeof(path), "%s/Contents/Resources/Tokens.xml", argv[1]);
103	if ((tokens = cupsFileOpen(path, "w")) == NULL)
104	{
105	fprintf(stderr, "makedocset: Unable to create \"%s\": %s\n", path,
106	strerror(errno));
107	return (1);
108	}
109
110	cupsFilePuts(tokens, "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n");
111	cupsFilePuts(tokens, "<Tokens version=\"1.0\">\n");
112
113	for (i = 3; i < argc; i ++)
114	{
115	if ((fp = cupsFileOpen(argv[i], "r")) == NULL)
116	{
117	fprintf(stderr, "makedocset: Unable to open \"%s\": %s\n", argv[i],
118	strerror(errno));
119	return (1);
120	}
121
122	if (!cupsFileGets(fp, line, sizeof(line)) \|\| strncmp(line, "<?xml ", 6) \|\|
123	!cupsFileGets(fp, line, sizeof(line)) \|\| strncmp(line, "<Tokens ", 8))
124	{
125	fprintf(stderr, "makedocset: Bad Tokens.xml file \"%s\"!\n", argv[i]);
126	return (1);
127	}
128
129	while (cupsFileGets(fp, line, sizeof(line)))
130	{
131	if (strcmp(line, "</Tokens>"))
132	cupsFilePrintf(tokens, "%s\n", line);
133	}
134
135	cupsFileClose(fp);
136	}
137
138	cupsFilePuts(tokens, "</Tokens>\n");
139
140	cupsFileClose(tokens);
141
142	/*
143	* Return with no errors...
144	*/
145
146	return (0);
147	}
148
149
150	/*
151	* 'compare_html()' - Compare the titles of two HTML files.
152	*/
153
154	static int /* O - Result of comparison */
155	compare_html(_cups_html_t a, / I - First file */
156	_cups_html_t b) / I - Second file */
157	{
88f9aafc	158	return (_cups_strcasecmp(a->title, b->title));
f11a948a MS	159	}
	160
	161
	162	/*
	163	* 'compare_sections()' - Compare the names of two help sections.
	164	*/
	165
	166	static int /* O - Result of comparison */
	167	compare_sections(_cups_section_t a, / I - First section */
	168	_cups_section_t b) / I - Second section */
	169	{
88f9aafc	170	return (_cups_strcasecmp(a->name, b->name));
f11a948a MS	171	}
	172
	173
	174	/*
	175	* 'compare_sections_files()' - Compare the number of files and section names.
	176	*/
	177
	178	static int /* O - Result of comparison */
	179	compare_sections_files(
	180	_cups_section_t a, / I - First section */
	181	_cups_section_t b) / I - Second section */
	182	{
	183	int ret = cupsArrayCount(b->files) - cupsArrayCount(a->files);
	184
	185	if (ret)
	186	return (ret);
	187	else
88f9aafc	188	return (_cups_strcasecmp(a->name, b->name));
f11a948a MS	189	}
	190
	191
	192	/*
	193	* 'write_index()' - Write an index file for the CUPS help.
	194	*/
	195
	196	static void
	197	write_index(const char path, / I - File to write */
	198	help_index_t hi) / I - Index of files */
	199	{
	200	cups_file_t fp; / Output file */
	201	help_node_t node; / Current help node */
	202	_cups_section_t section, / Current section */
	203	key; /* Section search key */
	204	_cups_html_t html; / Current HTML file */
	205	cups_array_t sections, / Sections in index */
	206	sections_files,/ Sections sorted by size */
	207	columns[3]; / Columns in final HTML file */
	208	int column, /* Current column */
	209	lines[3], /* Number of lines in each column */
	210	min_column, /* Smallest column */
	211	min_lines; /* Smallest number of lines */
	212
	213
	214	/*
	215	* Build an array of sections and their files.
	216	*/
	217
	218	sections = cupsArrayNew((cups_array_func_t)compare_sections, NULL);
	219
	220	for (node = (help_node_t *)cupsArrayFirst(hi->nodes);
	221	node;
	222	node = (help_node_t *)cupsArrayNext(hi->nodes))
	223	{
	224	if (node->anchor)
	225	continue;
	226
	227	key.name = node->section ? node->section : "Miscellaneous";
	228	if ((section = (_cups_section_t *)cupsArrayFind(sections, &key)) == NULL)
	229	{
	230	section = (_cups_section_t *)calloc(1, sizeof(_cups_section_t));
	231	section->name = key.name;
	232	section->files = cupsArrayNew((cups_array_func_t)compare_html, NULL);
	233
	234	cupsArrayAdd(sections, section);
	235	}
	236
	237	html = (_cups_html_t *)calloc(1, sizeof(_cups_html_t));
	238	html->path = node->filename;
	239	html->title = node->text;
	240
	241	cupsArrayAdd(section->files, html);
	242	}
	243
	244	/*
	245	* Build a sorted list of sections based on the number of files in each section
	246	* and the section name...
	247	*/
	248
	249	sections_files = cupsArrayNew((cups_array_func_t)compare_sections_files,
	250	NULL);
	251	for (section = (_cups_section_t *)cupsArrayFirst(sections);
	252	section;
253	section = (_cups_section_t *)cupsArrayNext(sections))
254	cupsArrayAdd(sections_files, section);
255
256	/*
257	* Then build three columns to hold everything, trying to balance the number of
258	* lines in each column...
259	*/
260
261	for (column = 0; column < 3; column ++)
262	{
263	columns[column] = cupsArrayNew((cups_array_func_t)compare_sections, NULL);
264	lines[column] = 0;
265	}
266
267	for (section = (_cups_section_t *)cupsArrayFirst(sections_files);
268	section;
269	section = (_cups_section_t *)cupsArrayNext(sections_files))
270	{
271	for (min_column = 0, min_lines = lines[0], column = 1;
272	column < 3;
273	column ++)
274	{
275	if (lines[column] < min_lines)
276	{
277	min_column = column;
278	min_lines = lines[column];
279	}
280	}
281
282	cupsArrayAdd(columns[min_column], section);
283	lines[min_column] += cupsArrayCount(section->files) + 2;
284	}
285
286	/*
287	* Write the HTML file...
288	*/
289
290	if ((fp = cupsFileOpen(path, "w")) == NULL)
291	{
292	fprintf(stderr, "makedocset: Unable to create %s: %s\n", path,
293	strerror(errno));
294	exit(1);
295	}
296
297	cupsFilePuts(fp, "<!DOCTYPE HTML PUBLIC \"-//W3C//DTD HTML 4.01 "
298	"Transitional//EN\" "
299	"\"http://www.w3.org/TR/html4/loose.dtd\">\n"
300	"<html>\n"
301	"<head>\n"
302	"<title>CUPS Documentation</title>\n"
303	"<link rel='stylesheet' type='text/css' "
178cb736	304	"href='cups-printable.css'>\n"
f11a948a MS	305	"</head>\n"
f11a948a MS	306	"<body>\n"
178cb736	307	"<h1 class='title'>CUPS Documentation</h1>\n"
f11a948a MS	308	"<table width='100%' summary=''>\n"
	309	"<tr>\n");
	310
	311	for (column = 0; column < 3; column ++)
	312	{
	313	if (column)
	314	cupsFilePuts(fp, "<td>     </td>\n");
	315
	316	cupsFilePuts(fp, "<td valign='top' width='33%'>");
	317	for (section = (_cups_section_t *)cupsArrayFirst(columns[column]);
	318	section;
	319	section = (_cups_section_t *)cupsArrayNext(columns[column]))
	320	{
	321	cupsFilePrintf(fp, "<h2 class='title'>%s</h2>\n", section->name);
	322	for (html = (_cups_html_t *)cupsArrayFirst(section->files);
	323	html;
	324	html = (_cups_html_t *)cupsArrayNext(section->files))
	325	cupsFilePrintf(fp, "<p class='compact'><a href='%s'>%s</a></p>\n",
	326	html->path, html->title);
	327	}
	328	cupsFilePuts(fp, "</td>\n");
	329	}
	330	cupsFilePuts(fp, "</tr>\n"
	331	"</table>\n"
	332	"</body>\n"
	333	"</html>\n");
	334	cupsFileClose(fp);
	335	}
	336
	337
	338	/*
	339	* 'write_info()' - Write the Info.plist file.
	340	*/
	341
	342	static void
	343	write_info(const char path, / I - File to write */
85b5d1df	344	const char revision) / I - Subversion revision number */
f11a948a MS	345	{
	346	cups_file_t fp; / File */
	347
	348
	349	if ((fp = cupsFileOpen(path, "w")) == NULL)
	350	{
	351	fprintf(stderr, "makedocset: Unable to create %s: %s\n", path,
	352	strerror(errno));
	353	exit(1);
	354	}
	355
	356	cupsFilePrintf(fp, "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n"
	357	"<!DOCTYPE plist PUBLIC \"-//Apple//DTD PLIST 1.0//EN\" "
	358	"\"http://www.apple.com/DTDs/PropertyList-1.0.dtd\">\n"
	359	"<plist version=\"1.0\">\n"
	360	"<dict>\n"
	361	"\t<key>CFBundleIdentifier</key>\n"
	362	"\t<string>org.cups.docset</string>\n"
	363	"\t<key>CFBundleName</key>\n"
	364	"\t<string>CUPS Documentation</string>\n"
	365	"\t<key>CFBundleVersion</key>\n"
85b5d1df MS	366	"\t<string>%d.%d.%s</string>\n"
	367	"\t<key>CFBundleShortVersionString</key>\n"
	368	"\t<string>%d.%d.%d</string>\n"
f11a948a MS	369	"\t<key>DocSetFeedName</key>\n"
	370	"\t<string>cups.org</string>\n"
	371	"\t<key>DocSetFeedURL</key>\n"
85b5d1df	372	"\t<string>http://www.cups.org/org.cups.docset.atom"
f11a948a	373	"</string>\n"
85b5d1df MS	374	"\t<key>DocSetPublisherIdentifier</key>\n"
	375	"\t<string>org.cups</string>\n"
	376	"\t<key>DocSetPublisherName</key>\n"
	377	"\t<string>CUPS</string>\n"
f11a948a	378	"</dict>\n"
85b5d1df MS	379	"</plist>\n",
	380	CUPS_VERSION_MAJOR, CUPS_VERSION_MINOR, revision,
	381	CUPS_VERSION_MAJOR, CUPS_VERSION_MINOR, CUPS_VERSION_PATCH);
f11a948a MS	382
	383	cupsFileClose(fp);
	384	}
	385
	386
	387	/*
	388	* 'write_nodes()' - Write the Nodes.xml file.
	389	*/
	390
	391	static void
	392	write_nodes(const char path, / I - File to write */
	393	help_index_t hi) / I - Index of files */
	394	{
	395	cups_file_t fp; / Output file */
	396	int id; /* Current node ID */
	397	help_node_t node; / Current help node */
	398	int subnodes; /* Currently in Subnodes for file? */
	399	int needclose; /* Need to close the current node? */
	400
	401
	402	if ((fp = cupsFileOpen(path, "w")) == NULL)
	403	{
	404	fprintf(stderr, "makedocset: Unable to create %s: %s\n", path,
	405	strerror(errno));
	406	exit(1);
	407	}
	408
	409	cupsFilePuts(fp, "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n"
	410	"<DocSetNodes version=\"1.0\">\n"
	411	"<TOC>\n"
	412	"<Node id=\"0\">\n"
	413	"<Name>CUPS Documentation</Name>\n"
	414	"<Path>Documentation/index.html</Path>\n"
	415	"</Node>\n");
	416
	417	for (node = (help_node_t *)cupsArrayFirst(hi->nodes), id = 1, subnodes = 0,
	418	needclose = 0;
	419	node;
	420	node = (help_node_t *)cupsArrayNext(hi->nodes), id ++)
	421	{
	422	if (node->anchor)
	423	{
	424	if (!subnodes)
	425	{
	426	cupsFilePuts(fp, "<Subnodes>\n");
	427	subnodes = 1;
	428	}
88f9aafc	429
f11a948a MS	430	cupsFilePrintf(fp, "<Node id=\"%d\">\n"
	431	"<Path>Documentation/%s</Path>\n"
	432	"<Anchor>%s</Anchor>\n"
	433	"<Name>%s</Name>\n"
	434	"</Node>\n", id, node->filename, node->anchor,
	435	node->text);
	436	}
	437	else
	438	{
	439	if (subnodes)
	440	{
	441	cupsFilePuts(fp, "</Subnodes>\n");
	442	subnodes = 0;
	443	}
	444
	445	if (needclose)
	446	cupsFilePuts(fp, "</Node>\n");
	447
	448	cupsFilePrintf(fp, "<Node id=\"%d\">\n"
	449	"<Path>Documentation/%s</Path>\n"
	450	"<Name>%s</Name>\n", id, node->filename, node->text);
	451	needclose = 1;
	452	}
	453	}
	454
	455	if (subnodes)
	456	cupsFilePuts(fp, "</Subnodes>\n");
	457
	458	if (needclose)
	459	cupsFilePuts(fp, "</Node>\n");
	460
	461	cupsFilePuts(fp, "</TOC>\n"
	462	"</DocSetNodes>\n");
	463
	464	cupsFileClose(fp);
	465	}