RFC: standardizing SVN properties in the doc repo
René Ladan
rene at freebsd.org
Fri Oct 19 12:44:41 UTC 2012
On 19-10-2012 14:31, Gabor Kovesdan wrote:
> Hi,
>
> currently, the proper use of SVN properties and dealing with file types
> are not standardized in the doc repo. I propose the following policy for
> the repo:
>
> - Use the .sh extension for shell scripts so that they can be easily
> identified as such
>
> - Always add the $FreeBSD$ keyword and set svn:keywords to FreeBSD=%H if
> you create a text non-binary file that support escaping it.
>
> - Only set fbsd:nokeywords for non-binary (i.e. human-readable) files if
> there are no ways to escape the keyword.
>
> - If SVN detects your non-binary file as binary (may happen with
> non-Latin encodings), DO NOT SET fbsd:nokeywords but use fbsd:notbinary.
>
> - If SVN complains that a binary file does not have the keyword, first
> try to set the correct mime-type (see below) and only set
> fbsd:nokeywords if SVN still rejects the file.
>
> .css text/css
> .dtd application/xml-dtd
> .ent application/xml-dtd
> .gif image/gif
> .gz application/gzip
> .html text/html
> .ico image/vnd.microsoft.icon
> .jpg image/jpeg
> .js application/javascript
> .log text/plain
> .pdf application/pdf
> .png image/png
> .rss application/rss+xml
> .sh text/plain
> .svg image/svg+xml
> .txt text/plain
> .xml application/xml
> .xsl application/xslt+xml
>
> If there are no objections, I'll give a sweep to the tree to make it
> consistent and I'll document this.
What about adding a dsvn script like we have for the Ports Tree to take
care of the svn attributes?
René
More information about the freebsd-doc
mailing list