<commit_before>\documentclass[11pt,letterpaper,onecolumn]{scrartcl}
\usepackage{tocloft}
\usepackage{stdclsdv}
\usepackage{comment}
\usepackage{vmargin}
\usepackage{t1enc}
\usepackage{fancyvrb}
\usepackage{url}
\usepackage{calc}
\usepackage{array}
\usepackage{graphicx}
\usepackage{color}
\usepackage{listings}
\usepackage[latin1]{inputenc}
\usepackage[english]{babel}
\usepackage{supertabular}
\usepackage{fancyhdr}
\usepackage{multicol}
\usepackage{float}
\usepackage{textcomp}
\usepackage{alltt}
\definecolor{LstColor}{cmyk}{0.1,0.1,0,0.025} 
\setcounter{tocdepth}{1}
\ifx\pdfoutput\undefined
\usepackage[ps2pdf,
            pagebackref=true,
            colorlinks=true,
            linkcolor=blue
           ]{hyperref}
\usepackage{pspicture}
\else
\usepackage[pdftex,
            pagebackref=true,
            colorlinks=true,
            linkcolor=blue,
            pdfpagelabels,
            pdfstartpage=2
           ]{hyperref}
\fi
\renewcommand{\headheight}{14pt}

\begin{document}
\begin{sloppypar}

\lstset{language=c++,basicstyle=\ttfamily\tiny,commentstyle=\ttfamily\tiny,tabsize=2,breaklines,backgroundcolor=\color{LstColor},fontadjust=true,keepspaces=false,fancyvrb=true,showstringspaces=false,moredelim=[is][\textbf]{\\emph\{}{\}}}.
\title{Csound Windows Build \\ 5.12.1}

\author{<NAME> \\ \texttt{<EMAIL>}}
\maketitle

\section{Introduction}
\label{sec:Introduction}

This file should be updated in reasonable detail with each release of the Windows installers for Csound, in order to provide instructions for building Csound on Windows. Please note the last date each package was updated and, if relevant, its current version number. Do this, of course, \emph{only} if your build succeeds \emph{and} the package version is more recent than the one previously recorded in this document.

Hyperlinks to repositories are provided to speed downloading and installing third-party dependencies.

Csound on Windows is built using MinGW/MSys from (\url{www.mingw.org}). Code is built for release, with full optimizations including intrinsics and vectorization. These optimizations may preclude debugging. In that case, a separate debug build must be made in order to debug. However, the only differences between the debug build and the release build must be the presence or absence of optimizations and the generation or not of debugging information. Code generation for both builds must be for ``release versions'' of the runtime libraries and third party libraries. This code generation standard also applies, of course, to actually building the third party libraries.

All third party libraries will be updated from the most recent version that seems to be used by a majority of their users --- whatever that is (trunk, most recent tag, stable release, whatever). If pre-built binaries are available, use them. Otherwise, build third party libraries with the same version of the compiler that is used to build Csound itself. If the library does not come with a functional build system for MinGW/MSys, create an SConstruct file for it. However, some libraries have to be built with Microsoft Visual C++, of which fortunately there is a free Express Edition.

The conceit of this build system is that Csound is built in a standard Linux environment, which is simulated using MSys, using the standard GNU compiler, which is MinGW. To assist us in this delusion, the Linux root directory is simulated by \url{C:/utah}, which contains a more or less standard Linux filesystem (at least, it does when in the MSys shell). Third party libraries are therefore located in \url{/c/utah/opt}.

\section{Build Steps}
\label{sec:BuildSteps}

\begin{enumerate}
	\item (Done) Update the documentation tools.
		\begin{enumerate}
	    \item (Done) Update the docbook toolchain:
				\begin{enumerate}
					\item (Done) Install the current Windows build of \texttt{xsltproc} from \url{http://www.zlatkovic.com/libxml.en.html}. This may involve also installing libraries upon which \texttt{xsltproc} depends.
					\item (Done) Install the current Docbook XML DTDs from \url{http://www.oasis-open.org/docbook/xml/4.5/docbook-xml-4.5.zip}, and set the \verb|XML_CATALOG_FILES| environment variable to point to the installation directory.
					\item (Done) Install the current Docbook XSL stylesheets from \url{http://sourceforge.net/project/downloading.php?group_id=21935&filename=docbook-xsl-1.75.1.zip}, and set the \verb|XSL_BASE_PATH| environment variable to point to the installation directory. Then fill in the \texttt{rewritePrefix} attributes to make the \url{catalog.xml} file be something like:<commit_msg>no message Committed on the Free edition of March Hare Software CVSNT Client. Upgrade to CVS Suite for more features and support: http://march-hare.com/cvsnt/<commit_after>\documentclass[11pt,letterpaper,onecolumn]{scrartcl}
\usepackage{tocloft}
\usepackage{stdclsdv}
\usepackage{comment}
\usepackage{vmargin}
\usepackage{t1enc}
\usepackage{fancyvrb}
\usepackage{url}
\usepackage{calc}
\usepackage{array}
\usepackage{graphicx}
\usepackage{color}
\usepackage{listings}
\usepackage[latin1]{inputenc}
\usepackage[english]{babel}
\usepackage{supertabular}
\usepackage{fancyhdr}
\usepackage{multicol}
\usepackage{float}
\usepackage{textcomp}
\usepackage{alltt}
\definecolor{LstColor}{cmyk}{0.1,0.1,0,0.025} 
\setcounter{tocdepth}{1}
\ifx\pdfoutput\undefined
\usepackage[ps2pdf,
            pagebackref=true,
            colorlinks=true,
            linkcolor=blue
           ]{hyperref}
\usepackage{pspicture}
\else
\usepackage[pdftex,
            pagebackref=true,
            colorlinks=true,
            linkcolor=blue,
            pdfpagelabels,
            pdfstartpage=2
           ]{hyperref}
\fi
\renewcommand{\headheight}{14pt}

\begin{document}
\begin{sloppypar}

\lstset{language=c++,basicstyle=\ttfamily\tiny,commentstyle=\ttfamily\tiny,tabsize=2,breaklines,backgroundcolor=\color{LstColor},fontadjust=true,keepspaces=false,fancyvrb=true,showstringspaces=false,moredelim=[is][\textbf]{\\emph\{}{\}}}.
\title{Csound Windows Build \\ 5.12.1}

\author{<NAME> \\ \texttt{<EMAIL>}}
\maketitle

\section{Introduction}
\label{sec:Introduction}

This file should be updated in reasonable detail with each release of the Windows installers for Csound, in order to provide instructions for building Csound on Windows. Please note the last date each package was updated and, if relevant, its current version number. Do this, of course, \emph{only} if your build succeeds \emph{and} the package version is more recent than the one previously recorded in this document.

Hyperlinks to repositories are provided to speed downloading and installing third-party dependencies.

Csound on Windows is built using MinGW/MSys from (\url{www.mingw.org}). Code is built for release, with full optimizations including intrinsics and vectorization. These optimizations may preclude debugging. In that case, a separate debug build must be made in order to debug. However, the only differences between the debug build and the release build must be the presence or absence of optimizations and the generation or not of debugging information. Code generation for both builds must be for ``release versions'' of the runtime libraries and third party libraries. This code generation standard also applies, of course, to actually building the third party libraries.

All third party libraries will be updated from the most recent version that seems to be used by a majority of their users --- whatever that is (trunk, most recent tag, stable release, whatever). If pre-built binaries are available, use them. Otherwise, build third party libraries with the same version of the compiler that is used to build Csound itself. If the library does not come with a functional build system for MinGW/MSys, create an SConstruct file for it. However, some libraries have to be built with Microsoft Visual C++, of which fortunately there is a free Express Edition.

The conceit of this build system is that Csound is built in a standard Linux environment, which is simulated using MSys, using the standard GNU compiler, which is MinGW. To assist us in this delusion, the Linux root directory is simulated by \url{C:/utah}, which contains a more or less standard Linux filesystem (at least, it does when in the MSys shell). Third party libraries are therefore located in \url{/c/utah/opt}.

\section{Build Steps}
\label{sec:BuildSteps}

\begin{enumerate}
	\item (Done) Update the documentation tools.
		\begin{enumerate}
	    \item (Done) Update the docbook toolchain:
				\begin{enumerate}
					\item (Done) Install the current Windows build of \texttt{xsltproc} from \url{http://www.zlatkovic.com/libxml.en.html}. This may involve also installing libraries upon which \texttt{xsltproc} depends.
					\item (Done) Install the current Docbook XML DTDs from \url{http://www.oasis-open.org/docbook/xml/4.5/docbook-xml-4.5.zip}.
					\item (Done) Install the current Docbook XSL stylesheets from \url{http://sourceforge.net/project/downloading.php?group_id=21935&filename=docbook-xsl-1.75.1.zip}Fill in the \texttt{rewritePrefix} attributes to make the \url{catalog.xml} file be something like:
{'fraction_non_alphanumeric': 0.08795285901353121, 'fraction_numerical': 0.00785683107813182, 'mean_word_length': 4.6469500924214415, 'pattern_counts': {'":': 0, '<': 7, '<?xml version=': 0, '>': 7, 'https://': 0, 'lorem ipsum': 0, 'www.': 6, 'xml': 8}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 4, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '7343361', 'n_tokens_mistral': 2666, 'n_tokens_neox': 2501, 'n_words': 987}