mirror of
https://gitlab.com/libvirt/libvirt.git
synced 2024-12-25 15:15:25 +00:00
600462834f
In many files there are header comments that contain an Author: statement, supposedly reflecting who originally wrote the code. In a large collaborative project like libvirt, any non-trivial file will have been modified by a large number of different contributors. IOW, the Author: comments are quickly out of date, omitting people who have made significant contribitions. In some places Author: lines have been added despite the person merely being responsible for creating the file by moving existing code out of another file. IOW, the Author: lines give an incorrect record of authorship. With this all in mind, the comments are useless as a means to identify who to talk to about code in a particular file. Contributors will always be better off using 'git log' and 'git blame' if they need to find the author of a particular bit of code. This commit thus deletes all Author: comments from the source and adds a rule to prevent them reappearing. The Copyright headers are similarly misleading and inaccurate, however, we cannot delete these as they have legal meaning, despite being largely inaccurate. In addition only the copyright holder is permitted to change their respective copyright statement. Reviewed-by: Erik Skultety <eskultet@redhat.com> Signed-off-by: Daniel P. Berrangé <berrange@redhat.com>
132 lines
5.5 KiB
XML
132 lines
5.5 KiB
XML
<?xml version="1.0"?>
|
|
<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0"
|
|
xmlns="http://www.devhelp.net/book"
|
|
xmlns:exsl="http://exslt.org/common"
|
|
xmlns:str="http://exslt.org/strings"
|
|
extension-element-prefixes="exsl str"
|
|
exclude-result-prefixes="exsl str">
|
|
<!-- The stylesheet for the html pages -->
|
|
<xsl:import href="html.xsl"/>
|
|
|
|
<xsl:output method="xml" encoding="UTF-8" indent="yes"/>
|
|
|
|
<!-- Build keys for all symbols -->
|
|
<xsl:key name="symbols" match="/api/symbols/*" use="@name"/>
|
|
|
|
<xsl:template match="/">
|
|
<xsl:document xmlns="http://www.devhelp.net/book" href="libvirt.devhelp"
|
|
method="xml" encoding="UTF-8" indent="yes">
|
|
<xsl:apply-templates/>
|
|
</xsl:document>
|
|
</xsl:template>
|
|
|
|
<xsl:template match="/api">
|
|
<book title="{@name} Reference Manual" link="index.html" author="" name="{@name}">
|
|
<xsl:apply-templates select="files"/>
|
|
<xsl:apply-templates select="symbols"/>
|
|
</book>
|
|
<xsl:call-template name="generate_index"/>
|
|
<xsl:call-template name="generate_general"/>
|
|
</xsl:template>
|
|
<xsl:template match="/api/files">
|
|
<chapters>
|
|
<sub name="API" link="general.html">
|
|
<xsl:apply-templates select="file"/>
|
|
</sub>
|
|
</chapters>
|
|
</xsl:template>
|
|
<xsl:template match="/api/files/file">
|
|
<xsl:variable name="module" select="@name"/>
|
|
<xsl:variable name="prev" select="string(preceding-sibling::file[position()=1]/@name)"/>
|
|
<xsl:variable name="next" select="string(following-sibling::file[position()=1]/@name)"/>
|
|
<sub name="{@name}" link="libvirt-{@name}.html"/>
|
|
<xsl:document xmlns="" href="libvirt-{@name}.html" method="xml" indent="yes" encoding="UTF-8">
|
|
<html>
|
|
<head>
|
|
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
|
|
<title><xsl:value-of select="concat(@name, ': ', summary)"/></title>
|
|
<meta name="generator" content="Libvirt devhelp stylesheet"/>
|
|
<link rel="start" href="index.html" title="libvirt Reference Manual"/>
|
|
<link rel="up" href="general.html" title="API"/>
|
|
<link rel="stylesheet" href="style.css" type="text/css"/>
|
|
<link rel="chapter" href="general.html" title="API"/>
|
|
</head>
|
|
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
|
|
|
|
<table class="navigation" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
|
|
<tr valign="middle">
|
|
<xsl:if test="$prev != ''">
|
|
<td><a accesskey="p" href="libvirt-{$prev}.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"/></a></td>
|
|
</xsl:if>
|
|
<td><a accesskey="u" href="general.html"><img src="up.png" width="24" height="24" border="0" alt="Up"/></a></td>
|
|
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"/></a></td>
|
|
<xsl:if test="$next != ''">
|
|
<td><a accesskey="n" href="libvirt-{$next}.html"><img src="right.png" width="24" height="24" border="0" alt="Next"/></a></td>
|
|
</xsl:if>
|
|
<th width="100%" align="center">libvirt Reference Manual</th>
|
|
</tr>
|
|
</table>
|
|
<h2><span class="refentrytitle"><xsl:value-of select="@name"/></span></h2>
|
|
<p><xsl:value-of select="@name"/> - <xsl:value-of select="summary"/></p>
|
|
<p><xsl:value-of select="description"/></p>
|
|
<xsl:if test="deprecated">
|
|
<p> WARNING: this module is deprecated !</p>
|
|
</xsl:if>
|
|
<div class="refsynopsisdiv">
|
|
<h2>Synopsis</h2>
|
|
<pre class="synopsis">
|
|
<xsl:apply-templates mode="synopsis" select="exports"/>
|
|
</pre>
|
|
</div>
|
|
<div class="refsect1" lang="en">
|
|
<h2>Description</h2>
|
|
</div>
|
|
<div class="refsect1" lang="en">
|
|
<h2>Details</h2>
|
|
<div class="refsect2" lang="en">
|
|
<xsl:apply-templates mode="details" select="/api/symbols/macro[@file=$module]"/>
|
|
<xsl:apply-templates mode="details" select="/api/symbols/typedef[@file=$module] | /api/symbols/struct[@file=$module]"/>
|
|
<xsl:apply-templates mode="details" select="/api/symbols/functype[@file=$module]"/>
|
|
<xsl:apply-templates mode="details" select="/api/symbols/variable[@file=$module]"/>
|
|
<xsl:apply-templates mode="details" select="/api/symbols/function[@file=$module]"/>
|
|
</div>
|
|
</div>
|
|
</body>
|
|
</html>
|
|
</xsl:document>
|
|
</xsl:template>
|
|
<xsl:template match="/api/symbols">
|
|
<functions>
|
|
<xsl:apply-templates select="macro"/>
|
|
<xsl:apply-templates select="enum"/>
|
|
<xsl:apply-templates select="typedef"/>
|
|
<xsl:apply-templates select="struct"/>
|
|
<xsl:apply-templates select="functype"/>
|
|
<xsl:apply-templates select="variable"/>
|
|
<xsl:apply-templates select="function"/>
|
|
</functions>
|
|
</xsl:template>
|
|
<xsl:template match="/api/symbols/functype">
|
|
<function name="{@name}" link="libvirt-{@file}.html#{@name}"/>
|
|
</xsl:template>
|
|
<xsl:template match="/api/symbols/function">
|
|
<function name="{@name} ()" link="libvirt-{@file}.html#{@name}"/>
|
|
</xsl:template>
|
|
<xsl:template match="/api/symbols/typedef">
|
|
<function name="{@name}" link="libvirt-{@file}.html#{@name}"/>
|
|
</xsl:template>
|
|
<xsl:template match="/api/symbols/enum">
|
|
<function name="{@name}" link="libvirt-{@file}.html#{@name}"/>
|
|
</xsl:template>
|
|
<xsl:template match="/api/symbols/struct">
|
|
<function name="{@name}" link="libvirt-{@file}.html#{@name}"/>
|
|
</xsl:template>
|
|
<xsl:template match="/api/symbols/macro">
|
|
<function name="{@name}" link="libvirt-{@file}.html#{@name}"/>
|
|
</xsl:template>
|
|
<xsl:template match="/api/symbols/variable">
|
|
<function name="{@name}" link="libvirt-{@file}.html#{@name}"/>
|
|
</xsl:template>
|
|
|
|
</xsl:stylesheet>
|