@@ -86,18 +87,67 @@ + + - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + @@ -115,60 +165,72 @@ + + JUnit test module @{name} + + + + + + - - - - - - + + - - + + + + + - - + + + + + + + - - - - + - + + - - + + + + + + + diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/helium-antlib/metadata/src/com/nokia/helium/metadata/SQLFMPPLoader.java --- a/buildframework/helium/external/helium-antlib/metadata/src/com/nokia/helium/metadata/SQLFMPPLoader.java Wed Oct 28 14:39:48 2009 +0000 +++ b/buildframework/helium/external/helium-antlib/metadata/src/com/nokia/helium/metadata/SQLFMPPLoader.java Wed Dec 23 19:29:07 2009 +0200 @@ -34,6 +34,7 @@ import com.nokia.helium.metadata.db.MetaDataDb; import org.apache.log4j.Logger; + /** * Utility class to access the data from the database and used by FMPP * templates. @@ -52,11 +53,11 @@ * @see fmpp.tdd.DataLoader#load(fmpp.Engine, java.util.List) */ public Object load(Engine engine, List args) throws Exception { - log.debug("args.size:" + args.size()); + //log.debug("args.size:" + args.size()); java.util.ListIterator iter = args.listIterator(); int argsSize = args.size(); if (argsSize < 1) { - throw new Exception("input DB path should be provided"); + throw new Exception("Input DB path should be provided to load into FMPP."); } /* arg[0] - dbpath @@ -82,7 +83,7 @@ * @return returns the template model for the query */ public TemplateModel get(String query) { - log.debug("QueryModel:" + query); + //log.debug("QueryModel:" + query); return new QueryTemplateModel(query); } @@ -111,7 +112,7 @@ * @param query for which the template model needs to be returned. */ public QueryTemplateModel(String query) { - log.debug("query in SQLTemplateModel" + query); + //log.debug("query in SQLTemplateModel" + query); this.query = query; } @@ -121,9 +122,9 @@ */ public TemplateModel get(String key) { checkAndReadData(); - log.debug("QueryModel:" + key); + //log.debug("QueryModel:" + key); List dataList = indexMap.get(key); - log.debug("datalist size" + dataList.size()); + //log.debug("datalist size" + dataList.size()); if (dataList.size() == 1 ) { return new SimpleScalar((String)dataList.get(0)); } @@ -136,11 +137,11 @@ */ private void checkAndReadData() { if (!isDataRead) { - log.debug("isDataRead:" + isDataRead); + //log.debug("isDataRead:" + isDataRead); isDataRead = true; indexMap = metadataDb.getIndexMap(query); } - log.debug("indexmap size" + indexMap.size()); + //log.debug("indexmap size" + indexMap.size()); } /* @@ -196,7 +197,7 @@ * @return the iterator model from which the data is accessed. */ public TemplateModelIterator iterator() { - log.debug("iterator constructor called"); + //log.debug("iterator constructor called"); return new SQLTemplateModelIterator(query); } } @@ -218,15 +219,17 @@ public TemplateModel next() { SimpleHash simpleHash = null; try { - log.debug("checking any more element"); + //log.debug("checking any more element"); if (rowList != null && (count >= rowList.size())) { finished = true; } - log.debug("next:count:" + count); + //log.debug("next:count:" + count); simpleHash = new SimpleHash(rowList.get(count)); count ++; return simpleHash; } catch (Exception ex) { + // We are Ignoring the errors as no need to fail the build. + log.debug("Iteration exception" + ex.getMessage()); ex.printStackTrace(); } return null; @@ -235,10 +238,10 @@ public boolean hasNext() { if (rowList == null || READ_LIMIT <= count) { if (!finished) { - log.debug("getting records"); + //log.debug("Getting records"); rowList = metadataDb.getRecords(query, READ_LIMIT, currentOffsetIndex * READ_LIMIT); count = 0; - log.debug("rowList.size : " + rowList.size()); + //log.debug("rowList.size : " + rowList.size()); if (rowList.size() == 0) { finished = true; } diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/helium-antlib/metadata/src/com/nokia/helium/metadata/ant/antlib.xml --- a/buildframework/helium/external/helium-antlib/metadata/src/com/nokia/helium/metadata/ant/antlib.xml Wed Oct 28 14:39:48 2009 +0000 +++ b/buildframework/helium/external/helium-antlib/metadata/src/com/nokia/helium/metadata/ant/antlib.xml Wed Dec 23 19:29:07 2009 +0200 @@ -23,6 +23,7 @@ + diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/helium-antlib/metadata/src/com/nokia/helium/metadata/ant/conditions/MetaDataLogCondition.java --- a/buildframework/helium/external/helium-antlib/metadata/src/com/nokia/helium/metadata/ant/conditions/MetaDataLogCondition.java Wed Oct 28 14:39:48 2009 +0000 +++ b/buildframework/helium/external/helium-antlib/metadata/src/com/nokia/helium/metadata/ant/conditions/MetaDataLogCondition.java Wed Dec 23 19:29:07 2009 +0200 @@ -81,8 +81,7 @@ if (severity == null) throw new BuildException("'severity' attribute is not defined"); - this.log("Looking for severity '" + severity + "' under '" - + fileName.getAbsolutePath() + "'"); + //this.log("Looking for severity '" + severity + "' under '" + fileName.getAbsolutePath() + "'"); MetaDataDb.Priority prty = null; if (severity.equalsIgnoreCase("ERROR")) { diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/helium-antlib/metadata/src/com/nokia/helium/metadata/ant/taskdefs/MetaDataDelete.java --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/helium-antlib/metadata/src/com/nokia/helium/metadata/ant/taskdefs/MetaDataDelete.java Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,129 @@ +/* + * Copyright (c) 2007-2008 Nokia Corporation and/or its subsidiary(-ies). + * All rights reserved. + * This component and the accompanying materials are made available + * under the terms of the License "Eclipse Public License v1.0" + * which accompanies this distribution, and is available + * at the URL "http://www.eclipse.org/legal/epl-v10.html". + * + * Initial Contributors: + * Nokia Corporation - initial contribution. + * + * Contributors: + * + * Description: + * + */ + +package com.nokia.helium.metadata.ant.taskdefs; + +import org.apache.tools.ant.types.FileSet; +import org.apache.tools.ant.DirectoryScanner; +import org.apache.tools.ant.BuildException; +import org.apache.tools.ant.Task; +import java.util.Vector; +import java.util.ArrayList; +import java.util.List; +import org.apache.log4j.Logger; +import com.nokia.helium.metadata.db.*; +import java.util.Date; + +/** + * This task provide a way to delete the data from db for a log file set. + * + *

+ * Example 1:
+ * <metadadelete database="compile_log.db">
+ *     <fileset casesensitive="false" file="sbs.log.file"/>
+ * </metadadelete>
+ *

+ * + * @ant.task name="metadatadelete" category="Metadata" + */ +public class MetaDataDelete extends Task { + + private static Logger log = Logger.getLogger(MetaDataDelete.class); + + private String database; + + private boolean failOnError = true; + + private Vector fileSetList = new Vector(); + + /** + * Helper function to set the database parameter + * + * @ant.required + */ + public void setDatabase(String dbFile) { + database = dbFile; + } + + public void setFailOnError(String failNotify) { + if (failNotify.equals("false")) { + failOnError = false; + } + } + + /** + * Updates the list of filelist from the input fileset. + * @param fileSetList input fileset list + * @return the matched files including the base dir. + */ + private List getFileListFromFileSet() { + List fileList = new ArrayList(); + for (FileSet fs : fileSetList) { + DirectoryScanner ds = fs.getDirectoryScanner(getProject()); + String[] includedFiles = ds.getIncludedFiles(); + for ( String file : includedFiles ) { + fileList.add(file); + log.debug("includedfiles: " + file); + } + } + log.debug("fileList.size" + fileList.size()); + return fileList; + } + + /** + * Adds the fileset (list of input log files to be processed). + * @param fileSet fileset to be added + * + */ + public void add(FileSet fileSet) { + fileSetList.add(fileSet); + } + + /** + * Helper function to get the database + * + */ + public String getDatabase() { + return database; + } + + + @Override + public void execute() { + MetaDataDb metadataDb = null; + try { + log.debug("Initializing DB: " + database + "to delete"); + log("time before removing entries from db" + new Date()); + metadataDb = new MetaDataDb(database); + metadataDb.removeEntries(getFileListFromFileSet()); + log("time after removing entries from db" + new Date()); + } catch (BuildException ex1) { + if (failOnError) { + throw ex1; + } + } catch (Exception ex) { + if (failOnError) { + throw new BuildException("Failed during writing data to db"); + } + } finally { + log.debug("finalizing DB: " + database); + if (metadataDb != null) { + metadataDb.finalizeDB(); + } + } + } +} \ No newline at end of file diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/helium-antlib/metadata/src/com/nokia/helium/metadata/ant/taskdefs/MetaDataRecord.java --- a/buildframework/helium/external/helium-antlib/metadata/src/com/nokia/helium/metadata/ant/taskdefs/MetaDataRecord.java Wed Oct 28 14:39:48 2009 +0000 +++ b/buildframework/helium/external/helium-antlib/metadata/src/com/nokia/helium/metadata/ant/taskdefs/MetaDataRecord.java Wed Dec 23 19:29:07 2009 +0200 @@ -22,10 +22,9 @@ import org.apache.tools.ant.Task; import java.util.Vector; import java.util.Iterator; -//import java.util.ArrayList; import org.apache.log4j.Logger; -//import org.apache.tools.ant.types.FileSet; import com.nokia.helium.metadata.db.*; +import java.util.Date; /** * This task provide a way to record the data in the Database. @@ -114,6 +113,7 @@ log.debug("Initializing DB: " + database); metadataDb = new MetaDataDb(database); log.debug("Parsing the input and writing to DB"); + log("time before recording to db" + new Date()); for ( MetaDataInput metadataInput : metadataList ) { boolean removed = false; Iterator inputIterator = metadataInput.iterator(); @@ -125,6 +125,7 @@ metadataDb.addLogEntry(logEntry); } } + log("time after recording to db" + new Date()); log.debug("Successfully writen to DB"); } catch (BuildException ex1) { if (failOnError) { diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/helium-antlib/metadata/src/com/nokia/helium/metadata/ant/types/AbldLogMetaDataInput.java --- a/buildframework/helium/external/helium-antlib/metadata/src/com/nokia/helium/metadata/ant/types/AbldLogMetaDataInput.java Wed Oct 28 14:39:48 2009 +0000 +++ b/buildframework/helium/external/helium-antlib/metadata/src/com/nokia/helium/metadata/ant/types/AbldLogMetaDataInput.java Wed Dec 23 19:29:07 2009 +0200 @@ -60,36 +60,41 @@ public AbldLogMetaDataInput() { } - public boolean isEntryAvailable() { + /** + * Function to check from the input stream if is there any entries available. + * @return true if there are any entry available otherwise false. + */ + public boolean isEntryCreated(File currentFile) { String exceptions = ""; - int currentFileIndex = getCurrentFileIndex(); int lineNumber = getLineNumber(); BufferedReader currentReader = getCurrentReader(); - log.debug("Getting next set of log entries for Abld Input"); - //log.debug("currentFileIndex" + currentFileIndex); - List fileList = getFileList(); - int fileListSize = fileList.size(); - log.debug("fileList.size" + fileListSize); - while (currentFileIndex < fileListSize) { - try { - //log.debug("currentfileindex while getting file name: " + currentFileIndex); - File currentFile = fileList.get(currentFileIndex); - if (currentReader == null) { - lineNumber = 0; - setLineNumber(lineNumber); - log.debug("Current abld log file name:" + currentFile); - log.info("Processing file: " + currentFile); - currentReader = new BufferedReader(new FileReader(currentFile)); - setCurrentReader(currentReader); - } - String logText = null; - while ((logText = currentReader.readLine()) != null) { - lineNumber ++; - setLineNumber(lineNumber); - logText = logText.replaceFirst("'^\\s*\\[.+?\\]\\s*", ""); - if (logText.startsWith("++ Finished at")) { - //log.debug("matching finished regex"); + try { + if (currentReader == null) { + lineNumber = 0; + setLineNumber(lineNumber); + log.debug("Current abld log file name:" + currentFile); + log.debug("Processing file: " + currentFile); + currentReader = new BufferedReader(new FileReader(currentFile)); + setCurrentReader(currentReader); + } + String logText = null; + while ((logText = currentReader.readLine()) != null) { + lineNumber ++; + setLineNumber(lineNumber); + logText = logText.replaceFirst("'^\\s*\\[.+?\\]\\s*", ""); + if (logText.startsWith("++ Finished at")) { + if (currentComponent != null && !entryCreated) { + addEntry("DEFAULT", currentComponent, currentFile.toString(), + 0, "" ); + entryCreated = true; + recordText = false; + return true; + } + entryCreated = false; + } else if (logText.startsWith("=== ")) { + Matcher finishMatch = abldFinishedPattern.matcher(logText); + if (finishMatch.matches()) { if (currentComponent != null && !entryCreated) { addEntry("DEFAULT", currentComponent, currentFile.toString(), 0, "" ); @@ -98,69 +103,46 @@ return true; } entryCreated = false; - } else if (logText.startsWith("=== ")) { - //log.debug("trying to match with finish pattern ======="); - Matcher finishMatch = abldFinishedPattern.matcher(logText); - if (finishMatch.matches()) { - if (currentComponent != null && !entryCreated) { - addEntry("DEFAULT", currentComponent, currentFile.toString(), - 0, "" ); - entryCreated = true; - recordText = false; - return true; - } - entryCreated = false; - } else { - //log.debug("trying to match the start pattern"); - Matcher componentMatch = abldComponentPattern.matcher(logText); - if (componentMatch.matches()) { - //log.debug("matched abldComponentPattern"); - currentComponent = componentMatch.group(2); - recordText = true; - } + } else { + Matcher componentMatch = abldComponentPattern.matcher(logText); + if (componentMatch.matches()) { + currentComponent = componentMatch.group(2); + recordText = true; + } - Matcher startMatch = abldStartedPattern.matcher(logText); - if (startMatch.matches()) { - //log.debug("matched abldStartedPattern"); - currentComponent = startMatch.group(1); - recordText = true; - } + Matcher startMatch = abldStartedPattern.matcher(logText); + if (startMatch.matches()) { + currentComponent = startMatch.group(1); + recordText = true; } - } else { - if (recordText) { - String severity = getSeverity(logText); - if (severity != null) { - //log.debug("severity:" + severity); - //log.debug("currentFile:" + currentFile); - //log.debug("lineNumber:" + lineNumber); - //log.debug("logText:" + logText); - entryCreated = true; - addEntry(severity, currentComponent, currentFile.toString(), - lineNumber, logText ); - return true; - } + } + } else { + if (recordText) { + String severity = getSeverity(logText); + if (severity != null) { + entryCreated = true; + addEntry(severity, currentComponent, currentFile.toString(), + lineNumber, logText ); + return true; } } } - currentReader.close(); - currentReader = null; - setCurrentReader(currentReader); - currentFileIndex ++; - setCurrentFileIndex(currentFileIndex); - //log.debug("currentfileindex: " + currentFileIndex); - //log.debug("fileListSize: " + fileListSize); - } catch (Exception ex) { - log.debug("Exception in AbldLogMetadata", ex); - try { - currentReader.close(); - } catch ( IOException iex) { - log.debug("Exception in closing reader"); - } - currentReader = null; - setCurrentReader(null); - exceptions = exceptions + ex.getMessage() + "\n"; - return false; } + currentReader.close(); + currentReader = null; + setCurrentReader(currentReader); + } catch (Exception ex) { + log.debug("Exception in AbldLogMetadata", ex); + try { + currentReader.close(); + } catch ( IOException iex) { + // We are Ignoring the errors as no need to fail the build. + log.debug("Exception in closing reader", iex); + } + currentReader = null; + setCurrentReader(null); + exceptions = exceptions + ex.getMessage() + "\n"; + return false; } if (!exceptions.equals("")) { throw new BuildException(exceptions); diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/helium-antlib/metadata/src/com/nokia/helium/metadata/ant/types/AntLogMetaDataInput.java --- a/buildframework/helium/external/helium-antlib/metadata/src/com/nokia/helium/metadata/ant/types/AntLogMetaDataInput.java Wed Oct 28 14:39:48 2009 +0000 +++ b/buildframework/helium/external/helium-antlib/metadata/src/com/nokia/helium/metadata/ant/types/AntLogMetaDataInput.java Wed Dec 23 19:29:07 2009 +0200 @@ -52,82 +52,69 @@ private boolean entryCreated; + /** + * Constructor + */ public AntLogMetaDataInput() { } - public boolean isEntryAvailable() { + /** + * Function to check from the input stream if is there any entries available. + * @return true if there are any entry available otherwise false. + */ + public boolean isEntryCreated(File currentFile) { String exceptions = ""; - int currentFileIndex = getCurrentFileIndex(); int lineNumber = getLineNumber(); BufferedReader currentReader = getCurrentReader(); - log.debug("Getting next set of log entries for Ant Input"); - //log.debug("currentFileIndex" + currentFileIndex); - List fileList = getFileList(); - //log.debug("is filelist empty" + fileList.isEmpty()); - int fileListSize = fileList.size(); - log.debug("fileList.size" + fileListSize); - while (currentFileIndex < fileListSize) { - try { - lineNumber ++; - setLineNumber(lineNumber); - log.debug("currentfileindex while getting file name: " + currentFileIndex); - File currentFile = fileList.get(currentFileIndex); - if (currentReader == null) { - setLineNumber(0); - log.debug("Current Text log file name:" + currentFile); - log.info("Processing file: " + currentFile); - currentReader = new BufferedReader(new FileReader(currentFile)); - setCurrentReader(currentReader); - } - String logText = ""; - while ((logText = currentReader.readLine()) != null) { - //log.debug("logtext : " + logText + " line-number: " + lineNumber); - //log.debug("logtext : " + logText + " line-number: " + lineNumber); - Matcher match = antTargetPattern.matcher(logText); - if (match.matches()) { - if (currentComponent != null && !entryCreated) { - addEntry("DEFAULT", currentComponent, currentFile.toString(), - 0, "" ); - entryCreated = true; - return true; - } - entryCreated = false; - currentComponent = match.group(1); - //log.debug("currentComponent:" + currentComponent); - } - logText = logText.replaceFirst("^[ ]*\\[.+?\\][ ]*", ""); - String severity = getSeverity(logText); - if (severity != null) { -// log.debug("severity:" + severity); -// log.debug("currentFile:" + currentFile); -// log.debug("lineNumber:" + lineNumber); -// log.debug("logText:" + logText); + try { + if (currentReader == null) { + setLineNumber(0); + log.debug("Current Text log file name:" + currentFile); + log.debug("Processing file: " + currentFile); + currentReader = new BufferedReader(new FileReader(currentFile)); + setCurrentReader(currentReader); + } + String logText = ""; + while ((logText = currentReader.readLine()) != null) { + Matcher match = antTargetPattern.matcher(logText); + if (match.matches()) { + if (currentComponent != null && !entryCreated) { + addEntry("DEFAULT", currentComponent, currentFile.toString(), + 0, "" ); entryCreated = true; - // If there is no current component which means - // it is a redirected output, using file name as comp name - if (currentComponent == null ) { - currentComponent = currentFile.getName(); - } - addEntry(severity, currentComponent, currentFile.toString(), - lineNumber, logText ); - logText = ""; return true; } + entryCreated = false; + currentComponent = match.group(1); } + logText = logText.replaceFirst("^[ ]*\\[.+?\\][ ]*", ""); + String severity = getSeverity(logText); + if (severity != null) { + entryCreated = true; + // If there is no current component which means + // it is a redirected output, using file name as comp name + if (currentComponent == null ) { + currentComponent = currentFile.getName(); + } + addEntry(severity, currentComponent, currentFile.toString(), + lineNumber, logText ); + logText = ""; + return true; + } + } + currentReader.close(); + currentReader = null; + setCurrentReader(currentReader); + if (isAdditionalEntry()) { + return true; + } + } catch (Exception ex) { + log.debug("Exception in AntLogMetadata", ex); + try { currentReader.close(); - currentReader = null; - setCurrentReader(currentReader); - currentFileIndex ++; - setCurrentFileIndex(currentFileIndex); - //log.debug("currentfileindex: " + currentFileIndex); - //log.debug("fileListSize: " + fileListSize); - } catch (Exception ex) { - log.debug("Exception in AntLogMetadata", ex); - try { - currentReader.close(); - } catch ( IOException iex) { - log.debug("Exception in closing reader"); - } + } catch ( IOException iex) { + // We are Ignoring the errors as no need to fail the build. + log.debug("Exception in closing reader", iex); currentReader = null; setCurrentReader(null); exceptions = exceptions + ex.getMessage() + "\n"; @@ -137,7 +124,6 @@ if (!exceptions.equals("")) { throw new BuildException(exceptions); } - return false; } } \ No newline at end of file diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/helium-antlib/metadata/src/com/nokia/helium/metadata/ant/types/LogMetaDataInput.java --- a/buildframework/helium/external/helium-antlib/metadata/src/com/nokia/helium/metadata/ant/types/LogMetaDataInput.java Wed Oct 28 14:39:48 2009 +0000 +++ b/buildframework/helium/external/helium-antlib/metadata/src/com/nokia/helium/metadata/ant/types/LogMetaDataInput.java Wed Dec 23 19:29:07 2009 +0200 @@ -43,7 +43,11 @@ private static Logger log = Logger.getLogger(LogMetaDataInput.class); private Vector fileSetList = new Vector(); + + private int currentFileIndex; + private boolean entryAddedForLog; + private List fileList; private Vector metadataFilterSets = new Vector(); private Vector completeFilterList; @@ -54,7 +58,6 @@ public LogMetaDataInput() { - //initRecordInfo(); } /** @@ -83,7 +86,11 @@ add(filterSet); return filterSet; } - + + /** + * Helper function to return all the filters associated with this metadata input + * @return all the filters merged based on the order of definition. + */ private Vector getCompleteFilters()throws Exception { Vector allFilter = new Vector(); for (MetaDataFilterSet filterSet : metadataFilterSets) { @@ -111,6 +118,10 @@ return fileList; } + /** + * Internal function to get the entry + * @return the top most entry in the list. + */ private MetaDataDb.LogEntry getEntry()throws Exception { if (logEntries != null && logEntries.size() > 0) { return logEntries.remove(0); @@ -119,12 +130,65 @@ } } + /** + * Helper function to return the file list of the metadata input + * @return file list of this metadata input. + */ protected List getFileList() { return fileList; } - abstract boolean isEntryAvailable() throws Exception ; + protected File getCurrentFile() { + List fileList = getFileList(); + return fileList.get(currentFileIndex); + } + + /** + * Function to check from the input stream if is there any entries available. Implemented by the sub classes. + * @return true if there are any entry available otherwise false. + */ + boolean isEntryAvailable() throws Exception { + try { + int fileListSize = getFileList().size(); + while (currentFileIndex < fileListSize) { + boolean entryCreated = false; + File currentFile = getCurrentFile(); + entryCreated = isEntryCreated(currentFile); + if (entryCreated) { + if (!entryAddedForLog) { + entryAddedForLog = true; + } + return entryCreated; + } + if (!entryAddedForLog) { + // If no entry, then logfile is added to the database. + addEntry("default", "general", getCurrentFile().toString(), -1, "", -1); + currentFileIndex ++; + return true; + } + currentFileIndex ++; + } + } catch (Exception ex1 ) { + log.info("Exception processing stream: " + ex1.getMessage()); + log.debug("exception while parsing the stream", ex1); + throw ex1; + } + return false; + } + + /** + * Function to check from the input stream if is there any entries available. + * @param file for which the contents needs to be parsed for errors + * @return true if there are any entry available otherwise false. + */ + abstract boolean isEntryCreated(File currentFile) throws Exception; + + /** + * Returns the severity matches for the log text + * @param log text for which the severity needs to be identified. + * @return the severity of the input text + */ protected String getSeverity(String logText) throws Exception { try { if (completeFilterList == null) { @@ -133,7 +197,6 @@ for ( MetaDataFilter filter : completeFilterList) { Pattern pattern = filter.getPattern(); if ((pattern.matcher(logText)).matches()) { - //log.debug("pattern matched"); return filter.getPriority(); } } @@ -144,8 +207,32 @@ return null; } + + /** + * Helper function to store the entry which will be added to the database + * @param priority for the entry + * @param component of the entry + * @param logpath of the entry + * @param lineNo of the entry + * @param log text message of the entry + */ protected void addEntry(String priority, String component, String logPath, int lineNo, String logText) throws Exception { + addEntry(priority, component, logPath, lineNo, logText, -1); + } + + + /** + * Helper function to store the entry which will be added to the database + * @param priority for the entry + * @param component of the entry + * @param logpath of the entry + * @param lineNo of the entry + * @param log text message of the entry + * @param elapsedTime of the component + */ + protected void addEntry(String priority, String component, String logPath, int lineNo, + String logText, float elapsedTime) throws Exception { //log.debug("adding entry to the list"); File logPathFile = new File(logPath.trim()); String baseDir = logPathFile.getParent(); @@ -153,9 +240,17 @@ String uniqueLogPath = baseDir + "/" + logPathFile.getName(); logEntries.add(new MetaDataDb.LogEntry( logText, priority, - component, uniqueLogPath, lineNo)); + component, uniqueLogPath, lineNo, elapsedTime)); } - + + /** + * Looks for the text which matches the filter regular expression and adds the entries to the database. + * @param logTextInfo text message to be searched with filter regular expressions + * @param priority for the entry + * @param currentComponent of the logtextInfo + * @param logpath fo;e fpr wjocj tje text info has to be looked for with filter expression + * @param lineNumber of the text message + */ protected boolean findAndAddEntries(String logTextInfo, String currentComponent, String logPath, int lineNumber)throws Exception { boolean entryAdded = false; @@ -164,20 +259,28 @@ for (int i = 0; i < logText.length; i++) { severity = getSeverity(logText[i]); if ( severity != null) { - log.debug("found match: ----" + logText[i]); addEntry(severity, currentComponent, logPath, - i + lineNumber, logText[i] ); + i + lineNumber, logText[i]); if (!entryAdded) { entryAdded = true; } } } return entryAdded; - } + } + + /** + * Log text are processed based on iterator. When ever the entry is found the entry is returned + * and the function is called again for further entries. + * @return the iterator object for the metadata input. + */ public Iterator iterator() { return metadataInputIterator; } + /** + * Class to process the files as stream and add the entries todb + */ public class MetaDataInputIterator implements Iterator { public boolean hasNext() { if (fileList == null) { @@ -187,23 +290,29 @@ } } if (logEntries.size() > 0) { - log.debug("returning from existing entries"); return true; } boolean retValue = false; try { retValue = isEntryAvailable(); } catch ( Exception ex) { - throw new BuildException("Exception in metadata input."); + throw new BuildException("Exception while analysing errors from the log:", ex); } return retValue; } + /** + * Helper function to remove entries if any + */ public void remove() { } + + /** + * Gets the next entry, which has been identified + * @return log entry to be added to the database. + */ public MetaDataDb.LogEntry next() { - //log.debug("getting next element: " + logEntry); MetaDataDb.LogEntry entry = null; try { entry = getEntry(); diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/helium-antlib/metadata/src/com/nokia/helium/metadata/ant/types/MetaDataFilter.java --- a/buildframework/helium/external/helium-antlib/metadata/src/com/nokia/helium/metadata/ant/types/MetaDataFilter.java Wed Oct 28 14:39:48 2009 +0000 +++ b/buildframework/helium/external/helium-antlib/metadata/src/com/nokia/helium/metadata/ant/types/MetaDataFilter.java Wed Dec 23 19:29:07 2009 +0200 @@ -104,6 +104,10 @@ pattern = Pattern.compile(regex); } + /** + * Helper function to return the pattern + * @return the pattern of this filter. + */ public Pattern getPattern() { return pattern; } diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/helium-antlib/metadata/src/com/nokia/helium/metadata/ant/types/MetaDataFilterSet.java --- a/buildframework/helium/external/helium-antlib/metadata/src/com/nokia/helium/metadata/ant/types/MetaDataFilterSet.java Wed Oct 28 14:39:48 2009 +0000 +++ b/buildframework/helium/external/helium-antlib/metadata/src/com/nokia/helium/metadata/ant/types/MetaDataFilterSet.java Wed Dec 23 19:29:07 2009 +0200 @@ -22,6 +22,8 @@ import java.util.*; import org.apache.tools.ant.types.Reference; import org.apache.tools.ant.types.DataType; +import org.apache.tools.ant.BuildException; +import org.apache.tools.ant.Project; import org.apache.log4j.Logger; import fmpp.models.CsvSequence; import freemarker.template.TemplateSequenceModel; @@ -92,14 +94,15 @@ try { filterSetObject = refId.getReferencedObject(); } catch ( Exception ex) { - log.info("Reference id of the filter is not valid"); - throw ex; + log.debug("Reference id of the metadata filter is not valid.", ex); + throw new BuildException("Reference id of the metadata filter is not valid " + ex.getMessage(), ex); } if (filterSetObject != null && filterSetObject instanceof MetaDataFilterSet) { allFilters.addAll(((MetaDataFilterSet)filterSetObject).getAllFilters()); return allFilters; } - throw new Exception ("filterset object is not instance of MetaDataFilterSet"); + log.debug("Filterset object is not instance of MetaDataFilterSet"); + throw new Exception ("Filterset object is not instance of MetaDataFilterSet"); } // Add any nested filtersets for (MetaDataFilterSet filterSet : filterSets) { @@ -108,7 +111,11 @@ return removeInvalidFilters(allFilters); } - + + /** + * Helper function called to remove any invalid filters + * @return only the valid filters + */ private Vector removeInvalidFilters(Vector filterList) { ListIterator iter = filterList.listIterator(); while (iter.hasNext()) { @@ -116,8 +123,7 @@ String priority = filter.getPriority(); String regEx = filter.getRegex(); if (priority == null || regEx == null) { - log.info("Warning: invalid filter removed"); - log.debug("Warning: some filter is invalid removing it"); + log("Warning: some filter is invalid removing it", Project.MSG_WARN); iter.remove(); } } @@ -166,7 +172,10 @@ } } - + /** + * Helper function to add the filters from the csv files + * @param csv file path from which the filters needs to be added. + */ private void addCSVFromFile(String csvPath) throws Exception { CsvSequence csvs = new CsvSequence(); csvs.setSeparator(','); @@ -174,22 +183,22 @@ try { csvs.load(new FileReader(new File(filterFile))); } catch (java.io.FileNotFoundException fex) { - log.error("File not found:" + filterFile); + log.debug("Metadata CSV file not found:", fex); throw fex; } catch (fmpp.util.StringUtil.ParseException pex) { - log.error("parser exception"); + log.debug("FMPP not able parse the Metadata CSV file. ", pex); throw pex; } catch (java.io.IOException iex) { - log.error("I/O exception"); + log.debug("Metadata I/O Exception. " + iex.getMessage(), iex); throw iex; } int size = 0; try { - log.debug("filter CSV record size: " + csvs.size()); + log.debug("filter CSV record size: " + csvs.size()); size = csvs.size(); } catch (Exception ex) { - log.info("Warning: filter parsing error"); - log.debug("Exception in processing csv file"); + // We are Ignoring the errors as no need to fail the build. + log.debug("Exception in processing csv file " + filterFile, ex); } for (int i = 0; i < size; i++) { try { @@ -197,8 +206,8 @@ .get(i); int modelSize = model.size(); if (modelSize != 3 ) { - log.debug("csv row size:" + size); - throw new Exception("filter format is invalid"); + log.debug("Metadata CSV file filter file format is invalid. It has row size " + size); + throw new Exception("Metadata CSV file filter file format is invalid. It has row size " + size); } MetaDataFilter filter = new MetaDataFilter(); filter.setPriority(model.get(0).toString()); @@ -206,8 +215,8 @@ filter.setDescription(model.get(2).toString()); filters.add(filter); } catch (Exception ex) { - log.info("Warning: filter parsing error"); - log.debug("Exception in processing csv file"); + // We are Ignoring the errors as no need to fail the build. + log.debug("Exception in processing Metadate csv file " + filterFile, ex); } } } diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/helium-antlib/metadata/src/com/nokia/helium/metadata/ant/types/MetadataSource.java --- a/buildframework/helium/external/helium-antlib/metadata/src/com/nokia/helium/metadata/ant/types/MetadataSource.java Wed Oct 28 14:39:48 2009 +0000 +++ b/buildframework/helium/external/helium-antlib/metadata/src/com/nokia/helium/metadata/ant/types/MetadataSource.java Wed Dec 23 19:29:07 2009 +0200 @@ -28,7 +28,7 @@ /** * This type define an input source that will be communicated to the notifiers. - * Not used, deprecated and an xml and html file is generated fof signal modules. + * Not used, deprecated and an xml and html file is generated for signal modules. * @ant.type name="metadatasource" category="Metadata" * @deprecated * diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/helium-antlib/metadata/src/com/nokia/helium/metadata/ant/types/PolicyLogMetaDataInput.java --- a/buildframework/helium/external/helium-antlib/metadata/src/com/nokia/helium/metadata/ant/types/PolicyLogMetaDataInput.java Wed Oct 28 14:39:48 2009 +0000 +++ b/buildframework/helium/external/helium-antlib/metadata/src/com/nokia/helium/metadata/ant/types/PolicyLogMetaDataInput.java Wed Dec 23 19:29:07 2009 +0200 @@ -46,11 +46,18 @@ private Map currentAttributeMap; - + + /** + * Constructor + */ public PolicyLogMetaDataInput() { } + /** + * Helper function to return the attributes of the stream reader + * @returns the attributes as a map. + */ private Map getAttributes(XMLStreamReader streamReader) { int count = streamReader.getAttributeCount() ; if (count > 0 ) { @@ -65,16 +72,24 @@ } - + /** + * Function to process the start event of xml stream callback. + * @param streamReader: the input stream reader which contains the xml data to be parsed for recording data. + * @return true if there are any element to be added to the database. + */ boolean startElement (XMLStreamReader streamReader) { String tagName = streamReader.getLocalName(); - //log.debug("startElement: " + tagName); if (tagName.equalsIgnoreCase("error")) { currentAttributeMap = getAttributes(streamReader); } return false; } + /** + * Function to process the end event of xml stream callback. + * @param streamReader: the input stream reader which contains the xml data to be parsed for recording data. + * @return true if there are any element to be added to the database. + */ boolean endElement(XMLStreamReader streamReader) throws Exception { boolean retValue = false; try { @@ -111,7 +126,11 @@ } return retValue; } - + + /* Function to process the characters event of xml stream callback. + * @param streamReader: the input stream reader which contains the xml data to be parsed for recording data. + * @return true if there are any element to be added to the database. + */ boolean characters (XMLStreamReader streamReader) { return false; } diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/helium-antlib/metadata/src/com/nokia/helium/metadata/ant/types/SBSLogMetaDataInput.java --- a/buildframework/helium/external/helium-antlib/metadata/src/com/nokia/helium/metadata/ant/types/SBSLogMetaDataInput.java Wed Oct 28 14:39:48 2009 +0000 +++ b/buildframework/helium/external/helium-antlib/metadata/src/com/nokia/helium/metadata/ant/types/SBSLogMetaDataInput.java Wed Dec 23 19:29:07 2009 +0200 @@ -19,10 +19,12 @@ import java.io.*; import java.util.*; -//import javax.xml.parsers.SAXParser; -//import javax.xml.parsers.SAXParserFactory; +import java.util.regex.Pattern; +import java.util.regex.Matcher; import org.apache.log4j.Logger; import javax.xml.stream.XMLStreamReader; +import javax.xml.stream.XMLInputFactory; +import javax.xml.stream.events.XMLEvent; /** @@ -33,7 +35,7 @@ * <metadatafilterset filterfile="common.csv" /> * </hlm:metadatafilterset> * - * <hlm:sbsmetadatainput> + * <hlm:sbsmetadatainput cleanLogFile="cleanlog.file" > * <fileset dir="${project.dir}/../data/"> * <include name="*compile.log"/> * </fileset> @@ -44,21 +46,497 @@ */ public class SBSLogMetaDataInput extends XMLLogMetaDataInput { + private static final String SPECIAL_CASE_REG_EX = "(make.exe|make): \\*\\*\\*.*(/.*)(_exe|_dll|_pdd|_ldd|_kext|_lib)/.*"; + + private static final String DRIVE_LETTER_REGEX = "(([a-z]|[A-Z]):(\\\\|/))(.*)(/bld\\.inf)"; + private Logger log = Logger.getLogger(SBSLogMetaDataInput.class); private String currentComponent; + private float currentElapsedTime; + private String logTextInfo = ""; + private HashMap> generalTextEntries = new HashMap>(); + + private CategorizationHandler categorizationHandler; + private int lineNumber; private boolean recordText; + private File cleanLogFile; + private boolean additionalEntry; + + private Pattern specialCasePattern; + + private HashMap componentTimeMap = new HashMap(); + + /** + * Constructor + */ public SBSLogMetaDataInput() { + specialCasePattern = Pattern.compile(SPECIAL_CASE_REG_EX); } - private String getComponent(XMLStreamReader streamReader) { + + /** + * Removes the bld inf and the drive letter from the text + * @param text in which the bld.inf and drive letter to be removed + * @return updated string. + */ + static String removeDriveAndBldInf(String text) { + Matcher matcher = (Pattern.compile(DRIVE_LETTER_REGEX)).matcher(text); + if (matcher.matches()) { + return matcher.group(4); + } else { + return text; + } + } + + /** + * Removes the bld inf and the drive letter from the text + * @param text in which the bld.inf and drive letter to be removed + * @return updated string. + */ + static String getComponent(XMLStreamReader streamReader) { + String currentComponent = getAttribute("bldinf", streamReader); + if ( currentComponent != null && currentComponent.equals("")) { + return null; + } + if (currentComponent != null ) { + currentComponent = removeDriveAndBldInf(currentComponent); + } + return currentComponent; + } + + /** + * Generic function to return the attribute value of an attribute from stream + * @param attribute for which the value from xml stream to be returned. + * @return the attribute value of an attribute. + */ + static String getAttribute(String attribute, XMLStreamReader streamReader) { + int count = streamReader.getAttributeCount() ; + for (int i = 0 ; i < count ; i++) { + if ( streamReader.getAttributeLocalName(i).equals(attribute) ) { + return streamReader.getAttributeValue(i); + } + } + return null; + } + + /** + * Helper function to set the clean log file + * @param logFile which is the clean log file to process for additional categories + */ + public void setCleanLogFile(File logFile) { + cleanLogFile = logFile; + } + + /** + * Function to process the characters event of xml stream callback. + * @param streamReader: the input stream reader which contains the xml data to be parsed for recording data. + * @return true if there are any element to be added to the database. + */ + public boolean characters (XMLStreamReader streamReader) { + if (recordText) { + logTextInfo += streamReader.getText(); + } else { + if (!additionalEntry) { + additionalEntry = true; + } + String cdataText = streamReader.getText().trim(); + String [] textList = cdataText.split("\n"); + for (String text : textList) { + Matcher specialCaseMatcher = specialCasePattern.matcher(text); + List entryList = null; + if (specialCaseMatcher.matches()) { + String componentName = specialCaseMatcher.group(2); + String extension = specialCaseMatcher.group(3); + String componentWithTarget = (componentName.substring(1) + "." + + extension.substring(1)).toLowerCase(); + CategoryEntry newEntry = new CategoryEntry(text, componentWithTarget , + "error", streamReader.getLocation().getLineNumber(), getCurrentFile().toString()); + entryList = generalTextEntries.get(componentWithTarget); + if ( entryList == null) { + entryList = new ArrayList(); + generalTextEntries.put(componentWithTarget, entryList); + } + entryList.add(newEntry); + } else { + String componentWithTarget = null; + int indexMakeString = text.indexOf( "make: ***" ); + int indexSlash = text.lastIndexOf( "/" ); + if (indexMakeString != -1 && indexSlash != -1) { + int indexExt = ( indexSlash + 1) + text.substring(indexSlash).indexOf( "." ); + if ( indexExt != -1 ) { + componentWithTarget = (text.substring(indexSlash,indexExt + 3)).toLowerCase(); + } + } + if (componentWithTarget != null) { + CategoryEntry newEntry = new CategoryEntry(text, componentWithTarget , + "error", streamReader.getLocation().getLineNumber(), getCurrentFile().toString()); + entryList = generalTextEntries.get(componentWithTarget); + if (entryList == null) { + entryList = new ArrayList(); + generalTextEntries.put(componentWithTarget, entryList); + } + entryList.add(newEntry); + } + + } + } + } + return false; + } + + /** + * Function to process the start event of xml stream callback. + * @param streamReader: the input stream reader which contains the xml data to be parsed for recording data. + * @return true if there are any element to be added to the database. + */ + public boolean startElement (XMLStreamReader streamReader) throws Exception { + try { + String tagName = streamReader.getLocalName(); + if (tagName.equalsIgnoreCase("buildlog")) { + log.debug("starting with buildlog"); + } + if (tagName.equalsIgnoreCase("recipe") ) { + lineNumber = streamReader.getLocation().getLineNumber(); + currentComponent = getComponent(streamReader); + recordText = true; + } else if (tagName.equalsIgnoreCase("error") + || tagName.equalsIgnoreCase("warning")) { + lineNumber = streamReader.getLocation().getLineNumber(); + currentComponent = getComponent(streamReader); + recordText = true; + } else if (tagName.equalsIgnoreCase("whatlog") ) { + currentComponent = getComponent(streamReader); + } else if (tagName.equalsIgnoreCase("time")) { + currentElapsedTime = Float.valueOf(getAttribute("elapsed", streamReader)).floatValue(); + if (currentComponent != null) { + TimeEntry timeObject = componentTimeMap.get(currentComponent); + if (timeObject == null) { + timeObject = new TimeEntry(currentElapsedTime, getCurrentFile().toString()); + componentTimeMap.put(currentComponent, timeObject); + } else { + timeObject.addElapsedTime(currentElapsedTime); + } + } + } + } catch (Exception ex) { + log.debug("exception in startelement",ex); + throw ex; + } + return false; + } + + /** + * Checks whether is there any additional entry. During log parsing, all the text which are not part of any tag + * and are part of CDATA are recorded in a list and checked in this function for any matching errors and processed + * for their categorization. + * @return true if there are any element to be added to the database. + */ + public boolean isAdditionalEntry() { + try { + if (!componentTimeMap.isEmpty()) { + Set componentSet = componentTimeMap.keySet(); + for (String component : componentSet) { + + TimeEntry entry = componentTimeMap.get(component); + addEntry("default", component, entry.getFilePath(), -1, + null, entry.getElapsedTime()); + componentTimeMap.remove(component); + return true; + } + } + if (cleanLogFile != null ) { + if (categorizationHandler == null ) { + log.info("initializing categorization handler"); + categorizationHandler = + new CategorizationHandler(cleanLogFile, generalTextEntries); + } + } + if (categorizationHandler != null && categorizationHandler.hasNext()) { + try { + CategoryEntry entry = categorizationHandler.getNext(); + if (entry != null) { + addEntry(entry.getSeverity(), entry.getCategory(), entry.getLogFile(), + entry.getLineNumber(), entry.getText()); + return true; + } + } catch (Exception ex) { + log.debug("Exception during categorization handler", ex); + return false; + } + } + } catch (Exception ex) { + log.debug("Exception in finding additional entry", ex); + } + return false; + } + + /** + * Function to process the end event of xml stream callback. + * @param streamReader: the input stream reader which contains the xml data to be parsed for recording data. + * @return true if there are any element to be added to the database. + */ + public boolean endElement(XMLStreamReader streamReader) throws Exception { + try { + String tagName = streamReader.getLocalName(); + if (tagName.equalsIgnoreCase("recipe")) { + recordText = false; + if (logTextInfo != null) { + if (currentComponent == null) { + currentComponent = "general"; + } + boolean entryCreated = findAndAddEntries(logTextInfo, currentComponent, + getCurrentFile().toString(), lineNumber); + logTextInfo = ""; + if ( entryCreated) { + return true; + } + } + } else if (tagName.equalsIgnoreCase("error") + || tagName.equalsIgnoreCase("warning")) { + recordText = false; + if (currentComponent == null) { + currentComponent = "general"; + } + addEntry(tagName, currentComponent, getCurrentFile().toString(), lineNumber, + logTextInfo); + logTextInfo = ""; + return true; + } else if (tagName.equalsIgnoreCase("whatlog") ) { + addEntry("default", currentComponent, getCurrentFile().toString(), -1, + ""); + return true; + } + } catch (Exception ex) { + log.debug("Exception while processing for sbs metadata input", ex); + throw ex; + } + return false; + } +} + +/* This class stores the temporary Time entry which is being recorded for each data + * at the end of the build and during isAdditionalEntry function, the time for the component + * is updated in the database. + */ +class TimeEntry { + + private float elapsedTime; + private String filePath; + + /** + * Constructor to store the elapsedTime and the path which are to be updated to the database. + * @param elapsedTime: time duration of the component. + * @path of the component. + */ + public TimeEntry(float elapsedTime, String path) { + elapsedTime = elapsedTime; + filePath = path; + } + + + /** + * Helper function to add time to the previous elapsed time. + * @param time to be added to the elapsed timet. + */ + public void addElapsedTime(float time) { + elapsedTime += time; + } + + /** + * Helper function to return the elapsed time + * @return elapsed time of this time entry. + */ + public float getElapsedTime() { + return elapsedTime; + } + + /** + * Helper function to return the file path of this entry + * @return path of this time entry. + */ + public String getFilePath() { + return filePath; + } +} +/* This class stores the temporary category entry which is processed during + * at the end of the build and categorized and written to the database. + */ +class CategoryEntry { + + private String text; + private int lineNumber; + private String fileName; + private String severity; + private String category; + + + /** + * Constructor of the category entry + * @param txt - text message of the entry + * @param ctgry - category of the entry + * @param svrty - severity of this entry + * @param lnNo - line number of this entry + * @param flName - name of the file being processed. + * @return path of this time entry. + */ + public CategoryEntry(String txt, String ctgry, + String svrty, int lnNo, String flName) { + text = txt; + lineNumber = lnNo; + fileName = flName; + severity = svrty; + category = "general"; + if (ctgry != null) { + category = ctgry; + } + } + + /** + * Helper function to set the category + * @param set the category + */ + void setCategory(String ctgry) { + category = ctgry; + } + + /** + * Helper function to return the category + * @return the category of this entry. + */ + String getCategory() { + return category; + } + + /** + * Returns the logfile of this entry + * @return logfile of this entry + */ + String getLogFile() { + return fileName; + } + + /** + * Helper function returns the severity of this entry + * @return severity of this entry + */ + String getSeverity() { + return severity; + } + + /** + * Helper function returns the line number of this entry + * @return the line number of this entry. + */ + + int getLineNumber() { + return lineNumber; + } + + /** + * Helper function returns the text message of this entry + * @return text message of this entry + */ + String getText() { + return text; + } + +} + +/* This class handles the categorization of scanlog errors based on the clean log output + * from raptor. + */ + class CategorizationHandler { + + private int count; + + private String currentComponent; + private boolean isInFileTag; + + private HashMap> categoryList; + + private List currentList; + + private XMLInputFactory xmlInputFactory; + + private XMLStreamReader xmlStreamReader; + + private Logger log = Logger.getLogger(CategorizationHandler.class); + + /** + * Constructor + * @param clean log file input using which the CDATA text are categorized + * @param list of entries to be categorized + */ + public CategorizationHandler(File cleanLogFile, HashMap> ctgMap) { + categoryList = ctgMap; + Set categorySet = categoryList.keySet(); + if (cleanLogFile != null ) { + try { + xmlInputFactory = XMLInputFactory.newInstance(); + xmlStreamReader = xmlInputFactory.createXMLStreamReader(cleanLogFile.toString(), + new BufferedInputStream(new FileInputStream(cleanLogFile))); + } catch ( Exception ex) { + log.debug("exception while initializing stax processor",ex); + } + } + } + + /** + * Checks whether is there any entry (by checking for categorization of the recorded CDATA text) + * @return true if there any entry that are being categorized. + */ + public boolean hasNext() { + boolean generalEntriesStatus = categoryList != null && !categoryList.isEmpty(); + boolean currentListStatus = currentList != null && ! currentList.isEmpty(); + return generalEntriesStatus || currentListStatus; + } + + /** + * Process the startelement event of XML Stream from clean log. + * @param streamReader clean log xml stream reader to be processed + * @return true if there are any entry to be added. + */ + public boolean startElement(XMLStreamReader streamReader) throws Exception { + String tagName = streamReader.getLocalName(); + if (tagName.equals("clean")) { + currentComponent = getCategory(streamReader); + if (currentComponent != null) { + currentComponent = SBSLogMetaDataInput.removeDriveAndBldInf(currentComponent); + } + } + if (tagName.equals("file")) { + isInFileTag = true; + } + return false; + } + + /** + * Process the endelement event of XML Stream from clean log. + * @param streamReader clean log xml stream reader to be processed + * @return true if there are any entry to be added. + */ + public boolean endElement (XMLStreamReader streamReader) throws Exception { + String tagName = streamReader.getLocalName(); + if (tagName.equals("file")) { + isInFileTag = false; + } + return false; + } + + /** + * Internal function to find bld inf from the component + * @param streamReader clean log xml stream reader to be processed + * @return the bld.inf attribute. + */ + private String getCategory(XMLStreamReader streamReader) { int count = streamReader.getAttributeCount() ; for (int i = 0 ; i < count ; i++) { if ( streamReader.getAttributeLocalName(i).equals("bldinf") ) { @@ -68,70 +546,110 @@ return null; } - public boolean characters (XMLStreamReader streamReader) { - if (recordText) { - logTextInfo += streamReader.getText(); + /** + * Internal function to find the CDATA text of the file attribute. + * @param streamReader clean log xml stream reader to be processed + * @return the CDATA text of tag. + */ + private String characters(XMLStreamReader xmlStreamReader) { + if (isInFileTag) { + return xmlStreamReader.getText().toLowerCase(); } - return false; + return null; } - - public boolean startElement (XMLStreamReader streamReader) throws Exception { - try { - String tagName = streamReader.getLocalName(); - if (tagName.equalsIgnoreCase("buildlog")) { - log.debug("starting with buildlog"); + + /** + * Gets the entry which matches the input path. For each line of tag attribute, the entry list + * is compared with that and if there is any match, then it returns the entry from the list, which + * is being mtached. + * @param path for which matching entry is looked for. + * @return entry which matched the path from the clean log file. + */ + private List getEntry(String path) { + int index = 0; + Set categorySet = categoryList.keySet(); + for (String key : categorySet) { + if (path.indexOf(key) != -1) { + List entry = categoryList.get(key); + categoryList.remove(key); + return entry; } - if (tagName.equalsIgnoreCase("recipe") ) { - lineNumber = streamReader.getLocation().getLineNumber(); - //log.debug(" startElement: receipe tag"); - recordText = true; - //currentComponent = attributes.getValue("bldinf"); - currentComponent = getComponent(streamReader); - } else if (tagName.equalsIgnoreCase("error") - || tagName.equalsIgnoreCase("warning")) { - lineNumber = streamReader.getLocation().getLineNumber(); - recordText = true; - } else if (tagName.equalsIgnoreCase("whatlog") ) { - currentComponent = getComponent(streamReader); - } - } catch (Exception ex) { - log.debug("exception in startelement",ex); - throw ex; } - return false; + return null; + } + + /** + * Internal function to update the category entries of the list. + * @param categoryList for which the category. + * @param category which is to be updated to the list. + */ + private void updateCategoryEntries(List categoryList, String category) { + for (CategoryEntry entry : categoryList) { + entry.setCategory(category); + } } - - public boolean endElement(XMLStreamReader streamReader) throws Exception { + /** + * Gets the next entry from the stream based on categorization. + * @return the category entry which is identified as categorized entry. + */ + public CategoryEntry getNext() throws Exception { try { - String tagName = streamReader.getLocalName(); - if (tagName.equalsIgnoreCase("recipe")) { - recordText = false; - if (logTextInfo != null) { - //log.debug("endElement: lineNumber: " + lineNumber); - boolean entryCreated = findAndAddEntries(logTextInfo, currentComponent, - getCurrentFile().toString(), lineNumber); - logTextInfo = ""; - if ( entryCreated) { - //log.debug("Entry creating end element"); - return true; + boolean entryCreated = false; + if (currentList != null && !currentList.isEmpty()) { + CategoryEntry entry = currentList.get(0); + currentList.remove(0); + return entry; + } + if (xmlStreamReader != null ) { + while (xmlStreamReader.hasNext()) { + int eventType = xmlStreamReader.next(); + switch (eventType) { + case XMLEvent.START_ELEMENT: + entryCreated = startElement(xmlStreamReader); + break; + case XMLEvent.END_ELEMENT: + endElement(xmlStreamReader); + break; + case XMLEvent.CHARACTERS: + String path = characters(xmlStreamReader); + if (path != null ) { + currentList = getEntry(path); + if (currentList != null && !currentList.isEmpty()) { + if (currentComponent != null) { + updateCategoryEntries(currentList, currentComponent); + CategoryEntry entry = (CategoryEntry)currentList.remove(0); + return entry; + } + } + } + break; + default: + break; } } - } else if (tagName.equalsIgnoreCase("error") - || tagName.equalsIgnoreCase("warning")) { - recordText = false; - addEntry(tagName, "general", getCurrentFile().toString(), lineNumber, - logTextInfo); - logTextInfo = ""; - return true; - } else if (tagName.equalsIgnoreCase("whatlog") ) { - addEntry("default", currentComponent, getCurrentFile().toString(), -1, - ""); + if (xmlStreamReader != null) { + close(); + } + } + } catch ( Exception ex) { + log.debug("exception in categorization",ex); + throw ex; + } + return null; + } + /** + * Internal function to close the clean log file stream + */ + private void close() { + try { + if (xmlStreamReader != null) { + xmlStreamReader.close(); + xmlStreamReader = null; } } catch (Exception ex) { - log.debug("Exception while processing for sbs metadata input", ex); - throw ex; + log.debug("exception while closing xml stream",ex); } - return false; + } } \ No newline at end of file diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/helium-antlib/metadata/src/com/nokia/helium/metadata/ant/types/TextLogMetaDataInput.java --- a/buildframework/helium/external/helium-antlib/metadata/src/com/nokia/helium/metadata/ant/types/TextLogMetaDataInput.java Wed Oct 28 14:39:48 2009 +0000 +++ b/buildframework/helium/external/helium-antlib/metadata/src/com/nokia/helium/metadata/ant/types/TextLogMetaDataInput.java Wed Dec 23 19:29:07 2009 +0200 @@ -43,87 +43,95 @@ private Logger log = Logger.getLogger(TextLogMetaDataInput.class); - private int currentFileIndex; - private int lineNumber; private BufferedReader currentReader; + /** + * Constructor + */ public TextLogMetaDataInput() { } - - protected void setCurrentFileIndex(int fileIndex) { - currentFileIndex = fileIndex; - } + /** + * Helper function to set the line number + * @param lineNo to be set for the entry + */ protected void setLineNumber(int lineNo) { lineNumber = lineNo; } - protected int getCurrentFileIndex() { - return currentFileIndex; - } - + /** + * Helper function to return the line number of this entry. + * @return line number of the entry. + */ protected int getLineNumber() { return lineNumber; } + /** + * Helper function to set the reader of this stream + * @param reader to process the stream. + */ protected void setCurrentReader(BufferedReader reader) { currentReader = reader; } - + + /** + * Function to check if is there any additionaly entry. This is being used for example during streaming + * recorded and at the end of streaming use the recorded data to add any additional entry. Used by + * @return true if there are any additional entries which are to be recorded in the database. + */ + public boolean isAdditionalEntry() { + return false; + } + + /** + * Helper function to return the lbuffer reader for the current meta data input + * @return buffer reader object for the current metadata input. + */ protected BufferedReader getCurrentReader() { return currentReader; } - public boolean isEntryAvailable() throws Exception { - //Todo: Optimize the function so the most of the statements could - //be reused with other metadata input. + public boolean isEntryCreated(File currentFile) throws Exception { String exceptions = ""; - //log.debug("Getting next set of log entries for Text Input"); - //log.debug("currentFileIndex" + currentFileIndex); - List fileList = getFileList(); - //log.debug("is filelist empty" + fileList.isEmpty()); - int fileListSize = fileList.size(); - while (currentFileIndex < fileListSize) { - try { - //log.debug("currentfileindex while getting file name: " + currentFileIndex); - File currentFile = fileList.get(currentFileIndex); - if (currentReader == null) { - lineNumber = 0; - log.debug("Current Text log file name:" + currentFile); - log.info("Processing file: " + currentFile); - currentReader = new BufferedReader(new FileReader(currentFile)); + try { + if (currentReader == null) { + lineNumber = 0; + log.debug("Current Text log file name:" + currentFile); + log.debug("Processing file: " + currentFile); + currentReader = new BufferedReader(new FileReader(currentFile)); + } + String logText = null; + while ((logText = currentReader.readLine()) != null) { + logText = logText.replaceFirst("^[ ]*\\[.+?\\][ ]*", ""); + String severity = getSeverity(logText); + if (severity != null) { + addEntry(severity, currentFile.getName(), currentFile.toString(), + lineNumber, logText ); + lineNumber ++; + return true; } - String logText = null; - while ((logText = currentReader.readLine()) != null) { - //log.debug("logtext : " + logText + " line-number: " + lineNumber); - //log.debug("logtext : " + logText + " line-number: " + lineNumber); - logText = logText.replaceFirst("^[ ]*\\[.+?\\][ ]*", ""); - String severity = getSeverity(logText); - if (severity != null) { -// log.debug("severity:" + severity); -// log.debug("currentFile:" + currentFile); -// log.debug("lineNumber:" + lineNumber); -// log.debug("logText:" + logText); - - addEntry(severity, currentFile.getName(), currentFile.toString(), - lineNumber, logText ); - lineNumber ++; - return true; - } - lineNumber ++; - } + } + currentReader.close(); + currentReader = null; + if (isAdditionalEntry()) { + return true; + } + } catch (Exception ex) { + log.debug("Exception in TextLogMetadata", ex); + try { currentReader.close(); currentReader = null; - currentFileIndex ++; - } catch (Exception ex) { - log.debug("Exception in TextLogMetadata", ex); + } catch (Exception ex1) { + // We are Ignoring the errors as no need to fail the build. + log.debug("Exception in TextLogMetadata", ex1); try { currentReader.close(); } catch ( IOException iex) { - log.info("exception in closing reader"); + // We are Ignoring the errors as no need to fail the build. log.debug("Exception in closing reader", iex); } currentReader = null; diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/helium-antlib/metadata/src/com/nokia/helium/metadata/ant/types/XMLLogMetaDataInput.java --- a/buildframework/helium/external/helium-antlib/metadata/src/com/nokia/helium/metadata/ant/types/XMLLogMetaDataInput.java Wed Oct 28 14:39:48 2009 +0000 +++ b/buildframework/helium/external/helium-antlib/metadata/src/com/nokia/helium/metadata/ant/types/XMLLogMetaDataInput.java Wed Dec 23 19:29:07 2009 +0200 @@ -19,12 +19,9 @@ import java.io.*; import java.util.*; -//import javax.xml.parsers.SAXParser; -//import javax.xml.parsers.SAXParserFactory; import org.apache.log4j.Logger; import javax.xml.stream.XMLInputFactory; import javax.xml.stream.XMLStreamReader; -//import javax.xml.stream.XMLStreamException; import javax.xml.stream.events.XMLEvent; @@ -40,20 +37,28 @@ private XMLStreamReader xmlStreamReader; - private int currentFileIndex; + private boolean inParsing; + + /** + * Constructor + */ public XMLLogMetaDataInput() { try { + inParsing = true; xmlInputFactory = XMLInputFactory.newInstance(); xmlInputFactory.setProperty(XMLInputFactory.IS_REPLACING_ENTITY_REFERENCES,Boolean.TRUE); xmlInputFactory.setProperty(XMLInputFactory.IS_SUPPORTING_EXTERNAL_ENTITIES,Boolean.FALSE); xmlInputFactory.setProperty(XMLInputFactory.IS_COALESCING , Boolean.TRUE); } catch (Exception ex) { - ex.printStackTrace(); + // We are Ignoring the errors as no need to fail the build. + log.debug("Exception while initializing stax processing",ex); } } - + /** + * Closes the xml stream + */ private void close() { try { if (xmlStreamReader != null) { @@ -61,106 +66,83 @@ xmlStreamReader = null; } } catch (Exception ex) { - log.info("Exception whil closing xml stream" + ex.getMessage()); - log.debug("exception while closing xml stream",ex); + // We are Ignoring the errors as no need to fail the build. + log.debug("Exception while closing xml stream", ex); } } - - protected File getCurrentFile() { - List fileList = getFileList(); - return fileList.get(currentFileIndex); - } - - boolean isEntryAvailable() throws Exception { - //log.debug("Getting next set of log entries for xml Input"); - //log.debug("currentFileIndex" + currentFileIndex); - int fileListSize = getFileList().size(); - //log.debug("fileList.size" + fileListSize); - //if ( isEntryCreatedForRemainingText() ) { - // log.debug("Entry creating from remaining text"); - // return true; - //} - try { - while (currentFileIndex < fileListSize) { - boolean entryCreated = false; - File currentFile = getCurrentFile(); - if (xmlStreamReader == null) { - log.info("Processing file: " + currentFile); - xmlStreamReader = xmlInputFactory.createXMLStreamReader( - currentFile.toString(), new BufferedInputStream(new FileInputStream(currentFile))); - //First the START_DOCUMENT is the first event directly pointed to. - } - int eventType = xmlStreamReader.getEventType(); - while (xmlStreamReader.hasNext()) { - eventType = xmlStreamReader.next(); - switch (eventType) { - case XMLEvent.START_ELEMENT: - //log.debug("XMLEvent:START_ELEMENT"); - entryCreated = startElement(xmlStreamReader); - break; - case XMLEvent.END_ELEMENT: - //log.debug("XMLEvent:END_ELEMENT"); - entryCreated = endElement(xmlStreamReader); - //log.debug("XMLEvent:END_ELEMENT: entryCreated: " +entryCreated); - break; - case XMLEvent.PROCESSING_INSTRUCTION: - //log.debug("XMLEvent:PI_DATA"); - //printPIData(xmlr); - break; - case XMLEvent.CHARACTERS: - //log.debug("XMLEvent:chacacters"); - entryCreated = characters(xmlStreamReader); - break; - case XMLEvent.COMMENT: - log.debug("XMLEvent:COMMENT"); - break; - case XMLEvent.START_DOCUMENT: - log.debug("XMLEvent:START_DOCUMENT"); - break; - case XMLEvent.END_DOCUMENT: - log.debug("XMLEvent:END_DOCUMENT"); - break; - case XMLEvent.ENTITY_REFERENCE: - log.debug("XMLEvent:ENTITY_REFERENCE"); - break; - case XMLEvent.ATTRIBUTE: - log.debug("XMLEvent:ATTRIBUTE"); - break; - case XMLEvent.DTD: - log.debug("XMLEvent:DTD"); - break; - case XMLEvent.CDATA: - log.debug("XMLEvent:CDATA"); - break; - case XMLEvent.SPACE: - log.debug("XMLEvent:chacacters"); - break; - default: - break; - } - if ( entryCreated) { - return true; - } + /** + * Function to check from the input stream if is there any entries available. + * @param file for which the contents needs to be parsed for errors + * @return true if there are any entry available otherwise false. + */ + boolean isEntryCreated(File currentFile) throws Exception { + boolean entryCreated = false; + if (inParsing ) { + if (xmlStreamReader == null) { + log.debug("Processing file: " + currentFile); + xmlStreamReader = xmlInputFactory.createXMLStreamReader( + currentFile.toString(), new BufferedInputStream(new FileInputStream(currentFile))); + } + int eventType = xmlStreamReader.getEventType(); + while (xmlStreamReader.hasNext()) { + eventType = xmlStreamReader.next(); + switch (eventType) { + case XMLEvent.START_ELEMENT: + entryCreated = startElement(xmlStreamReader); + break; + case XMLEvent.END_ELEMENT: + entryCreated = endElement(xmlStreamReader); + break; + case XMLEvent.CHARACTERS: + entryCreated = characters(xmlStreamReader); + break; + default: + break; } - if (xmlStreamReader != null) { - close(); + if ( entryCreated) { + return true; } - currentFileIndex ++; } - } catch (Exception ex1 ) { - log.info("Exception processing xml stream: " + ex1.getMessage()); - log.debug("exception while parsing the stream", ex1); - close(); + if (xmlStreamReader != null) { + close(); + } + inParsing = false; + } + if (isAdditionalEntry()) { + return true; } return false; } - + /** + * Function to check if is there any additionaly entry. This is being used for example during streaming + * recorded and at the end of streaming use the recorded data to add any additional entry. Used by + * @return true if there are any additional entries which are to be recorded in the database. + */ + public boolean isAdditionalEntry() { + return false; + } + + /** + * Function implemented by the subclasses to process the start event of xml stream callback. + * @param streamReader: the input stream reader which contains the xml data to be parsed for recording data. + * @return true if there are any element to be added to the database. + */ abstract boolean startElement (XMLStreamReader streamReader) throws Exception ; + /** + * Function implemented by the subclasses to process the end event of xml stream callback. + * @param streamReader: the input stream reader which contains the xml data to be parsed for recording data. + * @return true if there are any element to be added to the database. + */ abstract boolean endElement(XMLStreamReader streamReader) throws Exception; - + + /** + * Function implemented by the subclasses to process the characters event of xml stream callback. + * @param streamReader: the input stream reader which contains the xml data to be parsed for recording data. + * @return true if there are any element to be added to the database. + */ abstract boolean characters (XMLStreamReader streamReader); } diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/helium-antlib/metadata/src/com/nokia/helium/metadata/db/MetadataDb.java --- a/buildframework/helium/external/helium-antlib/metadata/src/com/nokia/helium/metadata/db/MetadataDb.java Wed Oct 28 14:39:48 2009 +0000 +++ b/buildframework/helium/external/helium-antlib/metadata/src/com/nokia/helium/metadata/db/MetadataDb.java Wed Dec 23 19:29:07 2009 +0200 @@ -24,10 +24,10 @@ import java.sql.Statement; import java.sql.ResultSet; import java.sql.ResultSetMetaData; -//import java.sql.DatabaseMetaData; + import org.apache.log4j.Logger; import org.apache.tools.ant.BuildException; -import java.util.HashMap; +import java.util.LinkedHashMap; import java.util.List; import java.util.ArrayList; import java.util.Map; @@ -45,19 +45,23 @@ private static final int LOG_ENTRY_CACHE_LIMIT = 500; - //private static final int RECORD_LIMIT recordLimit = 5000; - + private static final int DB_SCHEMA_VERSION = 1; + + private static final String[] INIT_TABLES = { + "CREATE TABLE schema (version INTEGER default " + DB_SCHEMA_VERSION + ")", "CREATE TABLE metadata (priority_id INTEGER, component_id INTEGER, line_number INTEGER, data TEXT, logpath_id INTEGER)", "CREATE TABLE component (id INTEGER PRIMARY KEY,component TEXT, logPath_id INTEGER, UNIQUE (logPath_id,component))", "CREATE TABLE priority (id INTEGER PRIMARY KEY,priority TEXT)", - "CREATE TABLE logfiles (id INTEGER PRIMARY KEY, path TEXT)" + "CREATE TABLE logfiles (id INTEGER PRIMARY KEY, path TEXT)", + "CREATE TABLE componenttime (cid INTEGER PRIMARY KEY, time DOUBLE default 0, UNIQUE (cid))" }; private static final String INSERT_METADATA_ENTRY = "INSERT INTO metadata VALUES(?, ?, ?, ?, ?)"; private static final String INSERT_LOGENTRY = "INSERT or IGNORE INTO logfiles VALUES(?, ?)"; private static final String INSERT_PRIORITYENTRY = "INSERT INTO priority VALUES(?, ?)"; - private static final String INSERT_COMPONENTENTRY = "INSERT or IGNORE INTO component VALUES((SELECT max(id) FROM component)+1, ?, ?) "; + private static final String INSERT_COMPONENTENTRY = "INSERT or IGNORE INTO component VALUES(?, ?, ?) ";; + private static final String INSERT_COMPONENT_TIME = "INSERT or IGNORE INTO componenttime VALUES(?, ?)"; private String dbPath; @@ -72,6 +76,7 @@ private PreparedStatement insertMetaDataEntryStmt; private PreparedStatement insertLogEntryStmt; private PreparedStatement insertComponentStmt; + private PreparedStatement insertComponentTimeStmt; private int entryCacheSize; @@ -90,18 +95,47 @@ } catch (java.lang.ClassNotFoundException e) { - log.debug("No JDBC Driver found"); throw new BuildException("JDBC Driver could not be found"); } synchronized (MetaDataDb.class) { // See if the database needs to be initialized boolean initializeDatabase = false; - if (!new File(dbPath).exists()) + File dbFile = new File(dbPath); + if (!dbFile.exists()) { initializeDatabase = true; + } else { + try { + log.debug("checking for schema version of db"); + initializeConnection(); + Statement stmt = connection.createStatement(); + ResultSet rs = stmt.executeQuery("select version from schema"); + int version = -1; + if ( rs.next()) { + version = rs.getInt(1); + } + rs.close(); + stmt.close(); + log.debug("schema version of db:" + version); + if (version != DB_SCHEMA_VERSION) { + log.debug("Schema Not matched deleting db file"); + dbFile.delete(); + initializeDatabase = true; + } + finalizeConnection(); + } catch (SQLException ex) { + try { + finalizeConnection(); + } catch (SQLException ex1) { + throw new BuildException("Exception while finalizing Metadata database. ", ex1); + } + // We are Ignoring the errors as no need to fail the build. + log.debug("Exception checking schema for db", ex); + dbFile.delete(); + initializeDatabase = true; + } } - try { initializeConnection(); @@ -123,8 +157,8 @@ statement.addBatch("INSERT INTO priority (priority) VALUES (\"" + priorityValues[i] + "\")"); } + statement.addBatch("INSERT INTO schema (version) VALUES (\"" + DB_SCHEMA_VERSION + " \")"); statement.addBatch("create unique index logfile_unique_1 on logfiles (path)"); - //statement.addBatch("create unique index component_unique_1 on component (component)"); int[] returnCodes = statement.executeBatch(); connection.commit(); @@ -135,8 +169,7 @@ } catch (SQLException e) { - log.debug("problem initializing database",e); - throw new BuildException("Problem initializing database"); + throw new BuildException("Problem while initializing Metadata database. ", e); } } } @@ -146,7 +179,7 @@ { // The values assigned to these enums should match the // automatically assigned values created in the database table - FATAL(1), ERROR(2), WARNING(3), INFO(4), REMARK(5), DEFAULT(6); + FATAL(1), ERROR(2), WARNING(3), INFO(4), REMARK(5), DEFAULT(6), CRITICAL(7); private final int value; Priority(int value) { @@ -163,6 +196,11 @@ }; + /** + * Helper class to store the log entry , used to write to the database + * + * @param databasePath The path to the database + */ public static class LogEntry { private String text; @@ -175,18 +213,36 @@ private String logPath; + private float elapsedTime; + + /** + * Constructor for the helper class + */ public LogEntry(String text, Priority priority, String component, - String logPath, int lineNumber) + String logPath, int lineNumber, float time) { this.text = text; this.priority = priority; this.component = component; this.lineNumber = lineNumber; this.logPath = logPath; + this.elapsedTime = time; } + /** + * Constructor for the helper class + */ + public LogEntry(String text, Priority priority, String component, + String logPath, int lineNumber) + { + this(text, priority, component, logPath, lineNumber, -1); + } + + /** + * Constructor for the helper class + */ public LogEntry(String text, String priorityTxt, String component, String logPath, - int lineNumber) throws Exception + int lineNumber, float time) throws Exception { Priority prty = null; String prtyText = priorityTxt.trim().toLowerCase(); @@ -202,6 +258,8 @@ prty = Priority.REMARK; } else if (prtyText.equals("default")) { prty = Priority.DEFAULT; + } else if (prtyText.equals("critical")) { + prty = Priority.CRITICAL; } else { log.debug("Error: priority " + prtyText + " is not acceptable by metadata and set to Error"); prty = Priority.ERROR; @@ -214,8 +272,23 @@ this.component = component; this.lineNumber = lineNumber; + this.elapsedTime = time; } - + + /** + * Constructor for the helper class + */ + public LogEntry(String text, String priorityTxt, String component, String logPath, + int lineNumber) throws Exception + { + this(text, priorityTxt, component, logPath, lineNumber, -1); + } + + /** + * Helper function to return to getLogPath + * @ + */ + public String getLogPath() { return logPath; @@ -241,6 +314,10 @@ { return priority; } + + public double getElapsedTime() { + return elapsedTime; + } public void setPriority(Priority priority) { @@ -268,7 +345,6 @@ public void finalizeStatements() throws SQLException { if (statementsInitialized) { if ( entryCacheSize > 0) { - //log.debug("writing to database"); entryCacheSize = 0; writeLogDataToDB(); } @@ -291,8 +367,8 @@ finalizeConnection(); } } catch (SQLException ex) { - log.debug("exception while finalizing the db", ex); - //throw ex; + // We are Ignoring the errors as no need to fail the build. + log.debug("Exception while finalizing the Metadata database. ", ex); } } @@ -302,8 +378,7 @@ */ //Note: Always the query should be in "/" format only public Map> getIndexMap(String query) { - Map> indexMap = new HashMap>(); - log.debug("sql query" + query); + Map> indexMap = new LinkedHashMap>(); try { initializeConnection(); Statement stmt = connection.createStatement(); @@ -319,12 +394,13 @@ int type = rsmd.getColumnType(i); if (type == java.sql.Types.INTEGER ) { data = "" + rs.getInt(i); + } else if (type == java.sql.Types.DOUBLE ) { + data = "" + rs.getDouble(i); } else { data = rs.getString(i); } - log.debug("data:" + data); if ( i == 1) { - key = data; + key = data; } else { dataList.add(data); } @@ -335,8 +411,8 @@ stmt.close(); finalizeConnection(); } catch (Exception ex) { + // We are Ignoring the errors as no need to fail the build. log.debug("Warning: Exception while getting the index map", ex); - //throw ex; } return indexMap; } @@ -344,7 +420,6 @@ //Note: Always the query should be in "/" format only public List> getRecords(String query) { List> rowList = new ArrayList>(); - log.debug("sql query" + query); try { initializeConnection(); Statement stmt = connection.createStatement(); @@ -355,26 +430,19 @@ List columnNames = new ArrayList(); for (int i = 1; i <= numberOfColumns; i++) { columnNames.add(rsmd.getColumnName(i)); - log.debug("columnName:" + rsmd.getColumnName(i)); } - - log.debug("resultSet MetaData column Count=" + numberOfColumns); if (rs.isBeforeFirst()) { while (rs.next()) { - Map recordMap = new HashMap(); - log.debug("adding records"); + Map recordMap = new LinkedHashMap(); for (int i = 1; i <= numberOfColumns; i++) { int type = rsmd.getColumnType(i); String columnName = columnNames.get(i - 1); - //log.debug("columnName:" + columnName); if (type == java.sql.Types.INTEGER ) { Integer data = new Integer(rs.getInt(i)); recordMap.put(columnName, data); - log.debug("data:" + data); } else { String data = rs.getString(i); recordMap.put(columnName, data ); - log.debug("data:" + data); } } rowList.add(recordMap); @@ -383,8 +451,8 @@ stmt.close(); finalizeConnection(); } catch (Exception ex) { - log.debug("Warning: Exception while getting the record details", ex); - //throw ex; + // We are Ignoring the errors as no need to fail the build. + log.warn("Warning: Exception while getting the record details", ex); } return rowList; } @@ -409,7 +477,6 @@ private void updateIndexTables(LogEntry entry) throws SQLException { connection.setAutoCommit(false); - //log.debug("updating logpath: " + entry.getLogPath()); insertLogEntryStmt.setNull(1, 4); insertLogEntryStmt.setString(2, entry.getLogPath()); insertLogEntryStmt.addBatch(); @@ -418,7 +485,6 @@ readConnection = DriverManager.getConnection(url); readConnection.setAutoCommit(false); Statement stmt = readConnection.createStatement(); - log.debug("exiting synchronization---2"); ResultSet rs = stmt.executeQuery("select id from logfiles where path='" + entry.getLogPath().trim() + "'"); int logPathId = 0; @@ -427,7 +493,6 @@ } stmt.close(); readConnection.close(); - log.debug("exiting synchronization---5"); insertComponentStmt.setNull(1, 4); insertComponentStmt.setString(2, entry.getComponent()); insertComponentStmt.setInt(3, logPathId); @@ -452,27 +517,49 @@ stmt.close(); } + public void removeEntries(List logPathList) throws Exception { + initializeConnection(); + Statement stmt = connection.createStatement(); + for (String logPath : logPathList) { + log.debug("logpath for delete: " + logPath); + log.debug("logpath delete query1 " + "DELETE FROM metadata WHERE logpath_id IN (SELECT id from logfiles WHERE path like '" + logPath + "')"); + stmt.executeUpdate("DELETE FROM metadata WHERE logpath_id IN (SELECT id from logfiles WHERE path like '%" + logPath + "%')"); + log.debug("logpath for delete2: " + "DELETE FROM component_time WHERE cid IN (select id from component where logpath_id in (select id from logfiles where path like '%" + logPath + "%'))"); + stmt.executeUpdate("DELETE FROM componenttime WHERE cid IN (select id from component where logpath_id in (select id from logfiles where path like '%" + logPath + "%'))"); + log.debug("logpath for delete3: " + "DELETE FROM component WHERE logpath_id IN (select id from logfiles where path like '%" + logPath + "%')"); + stmt.executeUpdate("DELETE FROM component WHERE logpath_id IN (select id from logfiles where path like '%" + logPath + "%')"); + log.debug("logpath for delete: " + "DELETE FROM logfiles WHERE path like ('%" + logPath + "%')"); + stmt.executeUpdate("DELETE FROM logfiles WHERE path like ('%" + logPath + "%')"); + } + stmt.close(); + finalizeConnection(); + } + public void addLogEntry(LogEntry entry) throws Exception { synchronized (MetaDataDb.class) { try { if (!statementsInitialized) { - log.debug("initializing statements for JDBC"); + log.debug("Initializing statements for JDBC"); initializeConnection(); - insertMetaDataEntryStmt = connection.prepareStatement("INSERT INTO metadata VALUES(?, ?, ?, ?, ?)"); - insertLogEntryStmt = connection.prepareStatement("INSERT or IGNORE INTO logfiles VALUES(?, ?)"); - insertComponentStmt = connection.prepareStatement("INSERT or IGNORE INTO component VALUES(?, ?, ?) "); + insertMetaDataEntryStmt = connection.prepareStatement(INSERT_METADATA_ENTRY); + insertLogEntryStmt = connection.prepareStatement(INSERT_LOGENTRY); + insertComponentStmt = connection.prepareStatement(INSERT_COMPONENTENTRY); + insertComponentTimeStmt = connection.prepareStatement(INSERT_COMPONENT_TIME); statementsInitialized = true; } - log.debug("MetaDataDB:entry:priority: " + entry.getPriority()); connection.setAutoCommit(false); updateIndexTables(entry); - if ( entry.getPriority() != Priority.DEFAULT) { + double time = entry.getElapsedTime(); + int logPathId = 0; + int componentId = 0; + Statement stmt = null; + ResultSet rs = null; + if ((time != -1) || entry.getPriority() != Priority.DEFAULT) { readConnection = DriverManager.getConnection(url); - Statement stmt = readConnection.createStatement(); - ResultSet rs = stmt.executeQuery("select id from logfiles where path='" + + stmt = readConnection.createStatement(); + rs = stmt.executeQuery("select id from logfiles where path='" + entry.getLogPath().trim() + "'"); - int logPathId = 0; if ( rs.next()) { logPathId = rs.getInt(1); } @@ -482,13 +569,27 @@ stmt = readConnection.createStatement(); rs = stmt.executeQuery("select id from component where component='" + entry.getComponent() + "' and logpath_id='" + logPathId + "'"); - int componentId = 0; if ( rs.next()) { componentId = rs.getInt(1); } rs.close(); stmt.close(); + } + if (time != -1) { + connection.setAutoCommit(false); + insertComponentTimeStmt.setInt(1, componentId); + insertComponentTimeStmt.setDouble(2, 0); + insertComponentTimeStmt.addBatch(); + insertComponentTimeStmt.executeBatch(); + connection.commit(); + insertComponentTimeStmt.clearBatch(); + stmt = readConnection.createStatement(); + stmt.executeUpdate("UPDATE componenttime SET time= (time + " + time + + ") WHERE cid = " + componentId ); + stmt.close(); readConnection.close(); + } + if ( entry.getPriority() != Priority.DEFAULT) { insertMetaDataEntryStmt.setInt(1, entry.getPriority().getValue()); insertMetaDataEntryStmt.setInt(2, componentId); insertMetaDataEntryStmt.setInt(3, entry.getLineNumber()); @@ -496,14 +597,14 @@ insertMetaDataEntryStmt.addBatch(); entryCacheSize ++; if (entryCacheSize >= LOG_ENTRY_CACHE_LIMIT) { - log.debug("writing data to database"); writeLogDataToDB(); entryCacheSize = 0; } } } catch (SQLException ex) { - log.debug(" Exception while writing the record"); - throw ex; + throw new BuildException("Exception while writing the records into Metadata DB", ex); + } catch (Exception ex1) { + throw new BuildException("Exception while writing the records into Metadata DB", ex1); } } } diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/helium-antlib/metadata/src/templates/general_category.txt.ftl --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/helium-antlib/metadata/src/templates/general_category.txt.ftl Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,36 @@ +<#-- +============================================================================ +Name : summary.html.ftl +Part of : Helium + +Copyright (c) 2009 Nokia Corporation and/or its subsidiary(-ies). +All rights reserved. +This component and the accompanying materials are made available +under the terms of the License "Eclipse Public License v1.0" +which accompanies this distribution, and is available +at the URL "http://www.eclipse.org/legal/epl-v10.html". + +Initial Contributors: +Nokia Corporation - initial contribution. + +Contributors: + +Description: + +============================================================================ +--> + + <#assign table_info = pp.loadData('com.nokia.helium.metadata.SQLFMPPLoader', + "${dbPath}") > + + + +<#assign logpath_table = table_info['select * from logfiles'] > +<#assign logpath_id = logpath_table?keys> +<#list logpath_id as logpath> + <#assign component_table = table_info['select id, component from component where logPath_id=${logpath}'] > + <#assign component_ids = component_table?keys?sort > + <#list component_ids as component_id > + component : ${component_table['${component_id}']} : logfile : ${logpath_table['${logpath}']} + + diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/helium-antlib/metadata/src/templates/summary.html.ftl --- a/buildframework/helium/external/helium-antlib/metadata/src/templates/summary.html.ftl Wed Oct 28 14:39:48 2009 +0000 +++ b/buildframework/helium/external/helium-antlib/metadata/src/templates/summary.html.ftl Wed Dec 23 19:29:07 2009 +0200 @@ -97,27 +97,29 @@ <@helium_logger_node_content nodeid="${helium_node_id}"> <#list component_ids as component_id> - <#assign helium_node_id = helium_node_id + 1> - <@helium_logger_node_head nodeid="${helium_node_id}" title="${component_table['${component_id}']}"> + <#if "${component_table['${component_id}']}" != "general" > + <#assign helium_node_id = helium_node_id + 1> + <@helium_logger_node_head nodeid="${helium_node_id}" title="${component_table['${component_id}']}"> + <#list priority_ids as priority> + <#assign priority_text = "${priority_table['${priority}']}"?lower_case> + <#assign priority_count = "${table_info['select count(data) as COUNT from metadata where logpath_id=${logpath} and priority_id = ${priority} and component_id = ${component_id}'][0]['COUNT']}" > + <@logfile_severity "${component_table['${component_id}']}", "${priority_text}", + "${priority_count}", + "${helium_node_id}" /> + + + <@helium_logger_node_content nodeid="${helium_node_id}"> <#list priority_ids as priority> - <#assign priority_text = "${priority_table['${priority}']}"?lower_case> - <#assign priority_count = "${table_info['select count(data) as COUNT from metadata where logpath_id=${logpath} and priority_id = ${priority} and component_id = ${component_id}'][0]['COUNT']}" > - <@logfile_severity "${component_table['${component_id}']}", "${priority_text}", - "${priority_count}", - "${helium_node_id}" /> + <#list table_info['select * from metadata where logpath_id = ${logpath} and priority_id = ${priority} and component_id = ${component_id}'] as recordentry > + <#-- <#if sublog?node_name == "logfile"> --> + <@logfile_entry_detail recordentry, "${helium_node_id}" /> + <#-- <#elseif sublog?node_name == "log"> + <@antlognode sublog/> + --> + - - <@helium_logger_node_content nodeid="${helium_node_id}"> - <#list priority_ids as priority> - <#list table_info['select * from metadata where logpath_id = ${logpath} and priority_id = ${priority} and component_id = ${component_id}'] as recordentry > - <#-- <#if sublog?node_name == "logfile"> --> - <@logfile_entry_detail recordentry, "${helium_node_id}" /> - <#-- <#elseif sublog?node_name == "log"> - <@antlognode sublog/> - --> - - - + + diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/helium-antlib/metadata/tests/build.xml --- a/buildframework/helium/external/helium-antlib/metadata/tests/build.xml Wed Oct 28 14:39:48 2009 +0000 +++ b/buildframework/helium/external/helium-antlib/metadata/tests/build.xml Wed Dec 23 19:29:07 2009 +0200 @@ -22,7 +22,8 @@ --> Helium Antlib metadata tests. - + + @@ -33,9 +34,6 @@ - - - - + \ No newline at end of file diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/helium-antlib/metadata/tests/data/categorization.log --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/helium-antlib/metadata/tests/data/categorization.log Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,45 @@ + + + + + + +make: *** [X:/epoc32/build/organizer/c_aff6bae36b1df6c4/srchuiresviewplugin_dll/armv5/urel/srchuiresultview.o] Error 1 + +X:/epoc32/release/armv5/udeb/srchuiresviewplugin.dll +"X:/epoc32/build/organizer/c_aff6bae36b1df6c4/srchuiresviewplugin_dll/armv5/udeb/srchuiresviewplugin{000a0000}.def" +"X:/epoc32/build/organizer/c_aff6bae36b1df6c4/srchuiresviewplugin_dll/armv5/udeb/srchuiresviewplugin{000a0000}.dso" +X:/epoc32/release/armv5/udeb/srchuiresviewplugin.dll.sym +X:/epoc32/build/organizer/c_aff6bae36b1df6c4/srchuiresviewplugin_dll/armv5/udeb/srchuiresviewplugin_udeb_objects.via +X:/epoc32/release/armv5/udeb/srchuiresviewplugin.dll.map +X:/epoc32/build/organizer/c_aff6bae36b1df6c4/srchuiresviewplugin_dll/armv5/udeb/srchuiresultview.o.d +X:/epoc32/build/organizer/c_aff6bae36b1df6c4/srchuiresviewplugin_dll/armv5/udeb/srchuiresultcontainer.o.d +X:/epoc32/build/organizer/c_aff6bae36b1df6c4/srchuiresviewplugin_dll/armv5/udeb/srchuiresultmodel.o.d +X:/epoc32/build/organizer/c_aff6bae36b1df6c4/srchuiresviewplugin_dll/armv5/udeb/proxy.o.d +X:/epoc32/build/organizer/c_aff6bae36b1df6c4/srchuiresviewplugin_dll/armv5/udeb/srchuiresultview.o +X:/epoc32/build/organizer/c_aff6bae36b1df6c4/srchuiresviewplugin_dll/armv5/udeb/srchuiresultcontainer.o +X:/epoc32/build/organizer/c_aff6bae36b1df6c4/srchuiresviewplugin_dll/armv5/udeb/srchuiresultmodel.o +X:/epoc32/build/organizer/c_aff6bae36b1df6c4/srchuiresviewplugin_dll/armv5/udeb/proxy.o +X:/epoc32/build/organizer/c_aff6bae36b1df6c4/srchuiresviewplugin_dll/armv5/udeb/srchuiresultview.o +X:/epoc32/build/organizer/c_aff6bae36b1df6c4/srchuiresviewplugin_dll/armv5/udeb/srchuiresultcontainer.o +X:/epoc32/build/organizer/c_aff6bae36b1df6c4/srchuiresviewplugin_dll/armv5/udeb/srchuiresultmodel.o +X:/epoc32/build/organizer/c_aff6bae36b1df6c4/srchuiresviewplugin_dll/armv5/udeb/proxy.o +X:/epoc32/release/armv5.product/udeb/srchuiresviewplugin.dll +X:/epoc32/release/armv5.product/udeb/srchuiresviewplugin.dll.sym +X:/epoc32/release/armv5.product/udeb/srchuiresviewplugin.dll.map +X:/epoc32/build/organizer/c_aff6bae36b1df6c4/srchuiresviewplugin_dll/armv5 +X:/epoc32/build/organizer/c_aff6bae36b1df6c4/srchuiresviewplugin_dll/armv5 +X:/epoc32/build/organizer/c_aff6bae36b1df6c4/srchuiresviewplugin_dll/armv5/udeb +X:/epoc32/release/armv5/udeb +X:/epoc32/release/armv5/lib +X:/epoc32/release/armv5/lib +X:/epoc32/release/armv5.product/udeb + + diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/helium-antlib/metadata/tests/data/categorization_clean.log --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/helium-antlib/metadata/tests/data/categorization_clean.log Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,33 @@ + + + +X:/epoc32/release/armv5/udeb/srchuiresviewplugin.dll +"X:/epoc32/build/organizer/c_aff6bae36b1df6c4/srchuiresviewplugin_dll/armv5/udeb/srchuiresviewplugin{000a0000}.def" +"X:/epoc32/build/organizer/c_aff6bae36b1df6c4/srchuiresviewplugin_dll/armv5/udeb/srchuiresviewplugin{000a0000}.dso" +X:/epoc32/release/armv5/udeb/srchuiresviewplugin.dll.sym +X:/epoc32/build/organizer/c_aff6bae36b1df6c4/srchuiresviewplugin_dll/armv5/udeb/srchuiresviewplugin_udeb_objects.via +X:/epoc32/release/armv5/udeb/srchuiresviewplugin.dll.map +X:/epoc32/build/organizer/c_aff6bae36b1df6c4/srchuiresviewplugin_dll/armv5/udeb/srchuiresultview.o.d +X:/epoc32/build/organizer/c_aff6bae36b1df6c4/srchuiresviewplugin_dll/armv5/udeb/srchuiresultcontainer.o.d +X:/epoc32/build/organizer/c_aff6bae36b1df6c4/srchuiresviewplugin_dll/armv5/udeb/srchuiresultmodel.o.d +X:/epoc32/build/organizer/c_aff6bae36b1df6c4/srchuiresviewplugin_dll/armv5/udeb/proxy.o.d +X:/epoc32/build/organizer/c_aff6bae36b1df6c4/srchuiresviewplugin_dll/armv5/udeb/srchuiresultview.o +X:/epoc32/build/organizer/c_aff6bae36b1df6c4/srchuiresviewplugin_dll/armv5/udeb/srchuiresultcontainer.o +X:/epoc32/build/organizer/c_aff6bae36b1df6c4/srchuiresviewplugin_dll/armv5/udeb/srchuiresultmodel.o +X:/epoc32/build/organizer/c_aff6bae36b1df6c4/srchuiresviewplugin_dll/armv5/udeb/proxy.o +X:/epoc32/build/organizer/c_aff6bae36b1df6c4/srchuiresviewplugin_dll/armv5/udeb/srchuiresultview.o +X:/epoc32/build/organizer/c_aff6bae36b1df6c4/srchuiresviewplugin_dll/armv5/udeb/srchuiresultcontainer.o +X:/epoc32/build/organizer/c_aff6bae36b1df6c4/srchuiresviewplugin_dll/armv5/udeb/srchuiresultmodel.o +X:/epoc32/build/organizer/c_aff6bae36b1df6c4/srchuiresviewplugin_dll/armv5/udeb/proxy.o +X:/epoc32/release/armv5.product/udeb/srchuiresviewplugin.dll +X:/epoc32/release/armv5.product/udeb/srchuiresviewplugin.dll.sym +X:/epoc32/release/armv5.product/udeb/srchuiresviewplugin.dll.map +X:/epoc32/build/organizer/c_aff6bae36b1df6c4/srchuiresviewplugin_dll/armv5 +X:/epoc32/build/organizer/c_aff6bae36b1df6c4/srchuiresviewplugin_dll/armv5 +X:/epoc32/build/organizer/c_aff6bae36b1df6c4/srchuiresviewplugin_dll/armv5/udeb +X:/epoc32/release/armv5/udeb +X:/epoc32/release/armv5/lib +X:/epoc32/release/armv5/lib +X:/epoc32/release/armv5.product/udeb + + diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/helium-antlib/metadata/tests/data/noerror.log --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/helium-antlib/metadata/tests/data/noerror.log Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,3 @@ + + + diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/helium-antlib/metadata/tests/data/parser_error.log --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/helium-antlib/metadata/tests/data/parser_error.log Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,46 @@ + + + + + + + +make: *** [X:/epoc32/build/organizer/c_aff6bae36b1df6c4/srchuiresviewplugin_dll/armv5/urel/srchuiresultview.o] Error 1 + +X:/epoc32/release/armv5/udeb/srchuiresviewplugin.dll +"X:/epoc32/build/organizer/c_aff6bae36b1df6c4/srchuiresviewplugin_dll/armv5/udeb/srchuiresviewplugin{000a0000}.def" +"X:/epoc32/build/organizer/c_aff6bae36b1df6c4/srchuiresviewplugin_dll/armv5/udeb/srchuiresviewplugin{000a0000}.dso" +X:/epoc32/release/armv5/udeb/srchuiresviewplugin.dll.sym +X:/epoc32/build/organizer/c_aff6bae36b1df6c4/srchuiresviewplugin_dll/armv5/udeb/srchuiresviewplugin_udeb_objects.via +X:/epoc32/release/armv5/udeb/srchuiresviewplugin.dll.map +X:/epoc32/build/organizer/c_aff6bae36b1df6c4/srchuiresviewplugin_dll/armv5/udeb/srchuiresultview.o.d +X:/epoc32/build/organizer/c_aff6bae36b1df6c4/srchuiresviewplugin_dll/armv5/udeb/srchuiresultcontainer.o.d +X:/epoc32/build/organizer/c_aff6bae36b1df6c4/srchuiresviewplugin_dll/armv5/udeb/srchuiresultmodel.o.d +X:/epoc32/build/organizer/c_aff6bae36b1df6c4/srchuiresviewplugin_dll/armv5/udeb/proxy.o.d +X:/epoc32/build/organizer/c_aff6bae36b1df6c4/srchuiresviewplugin_dll/armv5/udeb/srchuiresultview.o +X:/epoc32/build/organizer/c_aff6bae36b1df6c4/srchuiresviewplugin_dll/armv5/udeb/srchuiresultcontainer.o +X:/epoc32/build/organizer/c_aff6bae36b1df6c4/srchuiresviewplugin_dll/armv5/udeb/srchuiresultmodel.o +X:/epoc32/build/organizer/c_aff6bae36b1df6c4/srchuiresviewplugin_dll/armv5/udeb/proxy.o +X:/epoc32/build/organizer/c_aff6bae36b1df6c4/srchuiresviewplugin_dll/armv5/udeb/srchuiresultview.o +X:/epoc32/build/organizer/c_aff6bae36b1df6c4/srchuiresviewplugin_dll/armv5/udeb/srchuiresultcontainer.o +X:/epoc32/build/organizer/c_aff6bae36b1df6c4/srchuiresviewplugin_dll/armv5/udeb/srchuiresultmodel.o +X:/epoc32/build/organizer/c_aff6bae36b1df6c4/srchuiresviewplugin_dll/armv5/udeb/proxy.o +X:/epoc32/release/armv5.product/udeb/srchuiresviewplugin.dll +X:/epoc32/release/armv5.product/udeb/srchuiresviewplugin.dll.sym +X:/epoc32/release/armv5.product/udeb/srchuiresviewplugin.dll.map +X:/epoc32/build/organizer/c_aff6bae36b1df6c4/srchuiresviewplugin_dll/armv5 +X:/epoc32/build/organizer/c_aff6bae36b1df6c4/srchuiresviewplugin_dll/armv5 +X:/epoc32/build/organizer/c_aff6bae36b1df6c4/srchuiresviewplugin_dll/armv5/udeb +X:/epoc32/release/armv5/udeb +X:/epoc32/release/armv5/lib +X:/epoc32/release/armv5/lib +X:/epoc32/release/armv5.product/udeb + + diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/helium-antlib/metadata/tests/functionality/func_add_test.ant.xml --- a/buildframework/helium/external/helium-antlib/metadata/tests/functionality/func_add_test.ant.xml Wed Oct 28 14:39:48 2009 +0000 +++ b/buildframework/helium/external/helium-antlib/metadata/tests/functionality/func_add_test.ant.xml Wed Dec 23 19:29:07 2009 +0200 @@ -160,6 +160,26 @@ + + + + + + + + + + + + + + + + + diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/helium-antlib/metadata/tests/functionality/test_regex.ant.xml --- a/buildframework/helium/external/helium-antlib/metadata/tests/functionality/test_regex.ant.xml Wed Oct 28 14:39:48 2009 +0000 +++ b/buildframework/helium/external/helium-antlib/metadata/tests/functionality/test_regex.ant.xml Wed Dec 23 19:29:07 2009 +0200 @@ -41,6 +41,102 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + macro: ${project.dir}/../../src/templates/macro + + + dbPath: ${project.dir}/../output/log-entry-for-no-error.sqlite + ant: antProperties() + + + + + + Helium antlib quality tests. + + + - - - - + diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/helium-antlib/sbs/bld.bat --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/helium-antlib/sbs/bld.bat Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,60 @@ +@echo off + +rem +rem Copyright (c) 2009 Nokia Corporation and/or its subsidiary(-ies). +rem All rights reserved. +rem This component and the accompanying materials are made available +rem under the terms of the License "Eclipse Public License v1.0" +rem which accompanies this distribution, and is available +rem at the URL "http://www.eclipse.org/legal/epl-v10.html". +rem +rem Initial Contributors: +rem Nokia Corporation - initial contribution. +rem +rem Contributors: +rem +rem Description: +rem + +setlocal +if not defined JAVA_6_HOME ( +set TESTED_JAVA=C:\Apps\j2sdk_1.6.0_02 +) ELSE set TESTED_JAVA=%JAVA_6_HOME% +if exist %TESTED_JAVA% (set JAVA_HOME=%TESTED_JAVA%) + +REM Configure Ant +if not defined TESTED_ANT_HOME ( +set TESTED_ANT_HOME=C:\Apps\ant_1.7 +) +if exist %TESTED_ANT_HOME% (set ANT_HOME=%TESTED_ANT_HOME%) + +REM Configure the expected Ant Version details below +SET expMajorVer=1 +SET expMinorVer=7 + +rem *** Verify Ant Version *** +rem -- Run the 'ant -version' command and capture the output to a variable +for /f "tokens=*" %%a in ('ant -version') do (set antversion=%%a) +echo *** Installed Version : %antversion% + +rem -- Parse the version string obtained above and get the version number +for /f "tokens=4 delims= " %%a in ("%antversion%") do set val=%%a +rem -- Parse the version number delimiting the '.' and set the major and +rem minor versions +for /f "tokens=1-2 delims=." %%a in ("%val%") do ( +set /A majorVersion=%%a +set /A minorVersion=%%b +) +rem -- Check whether major version is greater than or equal to the expected. +if %majorVersion% geq %expMajorVer% ( +rem -- if major version is valid, check minor version. If minor version is less +rem than expected display message and abort the execution. +if %minorVersion% lss %expMinorVer% (echo *** Incorrect version of Ant found. Please check you have atleast Ant 1.7.0 & goto :errorstop ) +) + +ant %* +endlocal + +:errorstop +@echo *** Build aborted with error +exit /b 1 \ No newline at end of file diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/helium-antlib/sbs/build.xml --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/helium-antlib/sbs/build.xml Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,37 @@ + + + + Helium Antlib sbs build file. + + + + + + + + + + + + + diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/helium-antlib/sbs/src/com/nokia/helium/sbs/SAXSysdefParser.java --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/helium-antlib/sbs/src/com/nokia/helium/sbs/SAXSysdefParser.java Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,94 @@ +/* +* Copyright (c) 2007-2008 Nokia Corporation and/or its subsidiary(-ies). +* All rights reserved. +* This component and the accompanying materials are made available +* under the terms of the License "Eclipse Public License v1.0" +* which accompanies this distribution, and is available +* at the URL "http://www.eclipse.org/legal/epl-v10.html". +* +* Initial Contributors: +* Nokia Corporation - initial contribution. +* +* Contributors: +* +* Description: +* +*/ + +package com.nokia.helium.sbs; + +import org.dom4j.Document; +import org.apache.tools.ant.BuildException; +import org.dom4j.Element; +import org.dom4j.Attribute; +import org.dom4j.ElementPath; +import org.dom4j.ElementHandler; +import org.dom4j.io.SAXReader; +import org.apache.log4j.Logger; + +import java.io.*; +import java.util.*; + +/** + * Parses the sysdef config file and extracts the available configurations + */ +public class SAXSysdefParser { + private File sysdefFile; + private String configs = ""; + private List layers; + private boolean initialized; + private Logger log = Logger.getLogger(SAXSysdefParser.class); + + /** + * Constructor + * @param fileName - name of the sysdef file to parse + */ + public SAXSysdefParser(File fileName) { + + sysdefFile = fileName; + } + + public List getLayers() { + if (!initialized ) { + initialized = true; + parseConfig("layer"); + if (layers == null) { + throw new BuildException("No layers found from sysdef"); + } + } + return layers; + } + + /** + * Constructor + * @return list of available configurations that can be built. + */ + public void parseConfig(String nodeToGet) { + layers = new ArrayList(); + SAXReader reader = new SAXReader(); + reader.addHandler( "/SystemDefinition/systemModel/" + nodeToGet, + new ElementHandler() { + public void onStart(ElementPath path) { + } + public void onEnd(ElementPath path) { + Element row = path.getCurrent(); + Iterator itr = row.attributeIterator(); + while (itr.hasNext()) + { + Attribute child = (Attribute) itr.next(); + String attrName = child.getQualifiedName(); + if (attrName.equals("name")) { + layers.add((String)child.getValue()); + } + } + row.detach(); + } + } + ); + try { + Document doc = reader.read(sysdefFile); + } catch (Exception e) { + e.printStackTrace(); + } + } +} \ No newline at end of file diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/helium-antlib/sbs/src/com/nokia/helium/sbs/SBSCommandBase.java --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/helium-antlib/sbs/src/com/nokia/helium/sbs/SBSCommandBase.java Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,83 @@ +/* +* Copyright (c) 2007-2008 Nokia Corporation and/or its subsidiary(-ies). +* All rights reserved. +* This component and the accompanying materials are made available +* under the terms of the License "Eclipse Public License v1.0" +* which accompanies this distribution, and is available +* at the URL "http://www.eclipse.org/legal/epl-v10.html". +* +* Initial Contributors: +* Nokia Corporation - initial contribution. +* +* Contributors: +* +* Description: +* +*/ +package com.nokia.helium.sbs; + +import java.io.File; +import java.util.HashMap; + +import com.nokia.helium.core.plexus.CommandBase; + +/** + * Simple SBS wrapper based on the CommandBase class. + * + */ +public class SBSCommandBase extends CommandBase { + + private File workingDir; + + private String cleanLogPath; + + /** + * @return sbs. + */ + @Override + protected String getExecutable() { + return "sbs"; + } + + /** + * {@inheritDoc} + */ + @Override + protected void throwException(String message, Throwable t) throws SBSException { + throw new SBSException(message, t); + } + + /** + * Set the working directory where emake should be called. + * @param workingDir the working directory. + */ + public void setWorkingDir(File workingDir) { + this.workingDir = workingDir; + } + + /** + * Get the workingDir defined by the user. + * @return the working dir. + */ + @Override + public File getWorkingDir() { + return workingDir; + } + + public void setCleanLogFilePath(String path) { + cleanLogPath = path; + } + + /** + * Executes the command using as argline, instead of argument. + * @param argLine, argline to execute. + */ + public void execute(String argLine) throws SBSException { + HashMap envMap = new HashMap(); + envMap.put("PYTHONPATH", ""); + if ( cleanLogPath != null) { + envMap.put("SBS_CLEAN_LOG_FILE", cleanLogPath); + } + executeCmdLine(argLine, envMap, null); + } +} diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/helium-antlib/sbs/src/com/nokia/helium/sbs/SBSException.java --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/helium-antlib/sbs/src/com/nokia/helium/sbs/SBSException.java Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,41 @@ +/* +* Copyright (c) 2007-2008 Nokia Corporation and/or its subsidiary(-ies). +* All rights reserved. +* This component and the accompanying materials are made available +* under the terms of the License "Eclipse Public License v1.0" +* which accompanies this distribution, and is available +* at the URL "http://www.eclipse.org/legal/epl-v10.html". +* +* Initial Contributors: +* Nokia Corporation - initial contribution. +* +* Contributors: +* +* Description: +* +*/ +package com.nokia.helium.sbs; + +/** + * Exception raise by the SBS Modules. + * + */ +public class SBSException extends Exception { + + /** + * An exception with message. + * @param message + */ + public SBSException(String message) { + super(message); + } + + /** + * An exception with message and cause. + * @param message + */ + public SBSException(String message, Throwable t) { + super(message, t); + } + +} \ No newline at end of file diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/helium-antlib/sbs/src/com/nokia/helium/sbs/ant/SBSBuildList.java --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/helium-antlib/sbs/src/com/nokia/helium/sbs/ant/SBSBuildList.java Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,65 @@ +/* + * Copyright (c) 2007-2008 Nokia Corporation and/or its subsidiary(-ies). + * All rights reserved. + * This component and the accompanying materials are made available + * under the terms of the License "Eclipse Public License v1.0" + * which accompanies this distribution, and is available + * at the URL "http://www.eclipse.org/legal/epl-v10.html". + * + * Initial Contributors: + * Nokia Corporation - initial contribution. + * + * Contributors: + * + * Description: + * + */ + +package com.nokia.helium.sbs.ant; + +import org.apache.tools.ant.Project; +import org.apache.tools.ant.BuildException; +import java.util.Hashtable; +import java.util.List; +import java.util.HashMap; +import com.nokia.helium.sbs.ant.types.*; +import com.nokia.helium.sbs.ant.taskdefs.*; +import org.apache.log4j.Logger; + +public final class SBSBuildList { + + + + private static HashMap sbsBuildMap; + + private static Logger log = Logger.getLogger(SBSBuildList.class); + + private SBSBuildList() { + } + + public static List getSBSInputList(Project project, String buildName) { + if (sbsBuildMap == null) { + initialize(project); + } + SBSBuild sbsBuild = sbsBuildMap.get(buildName); + if (sbsBuild == null) { + throw new BuildException("Config name : " + buildName + " is not valid"); + } + List retList = null; + if (sbsBuild != null) { + retList = sbsBuild.getSBSInputList(); + } + return retList; + } + + private static void initialize(Project project) { + Hashtable references = project.getReferences(); + sbsBuildMap = new HashMap(); + for (Object key : references.keySet()) { + Object sbsBuildObject = references.get(key); + if ( sbsBuildObject != null && sbsBuildObject instanceof SBSBuild) { + sbsBuildMap.put(key, (SBSBuild)sbsBuildObject); + } + } + } +} \ No newline at end of file diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/helium-antlib/sbs/src/com/nokia/helium/sbs/ant/antlib.xml --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/helium-antlib/sbs/src/com/nokia/helium/sbs/ant/antlib.xml Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,32 @@ + + + + + + + + + + + + \ No newline at end of file diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/helium-antlib/sbs/src/com/nokia/helium/sbs/ant/taskdefs/GetSBSInputs.java --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/helium-antlib/sbs/src/com/nokia/helium/sbs/ant/taskdefs/GetSBSInputs.java Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,60 @@ +/* + * Copyright (c) 2007-2008 Nokia Corporation and/or its subsidiary(-ies). + * All rights reserved. + * This component and the accompanying materials are made available + * under the terms of the License "Eclipse Public License v1.0" + * which accompanies this distribution, and is available + * at the URL "http://www.eclipse.org/legal/epl-v10.html". + * + * Initial Contributors: + * Nokia Corporation - initial contribution. + * + * Contributors: + * + * Description: + * + */ + +package com.nokia.helium.sbs.ant.taskdefs; + +import java.util.List; +import org.apache.tools.ant.BuildException; +import org.apache.tools.ant.Task; +import com.nokia.helium.sbs.ant.types.*; +import com.nokia.helium.sbs.ant.*; +import org.apache.log4j.Logger; + +public class GetSBSInputs extends Task { + + private Logger log = Logger.getLogger(GetSBSInputs.class); + private String configName; + private String outputProperty; + + + public void setConfig(String name) { + configName = name; + } + + public void setOutputProperty(String property) { + outputProperty = property; + } + + /** + * Execute the task. Set the property with number of severities. + * @throws BuildException + */ + public void execute() { + if (configName == null) { + throw new BuildException("configInput is not defined"); + } + List sbsInputList = SBSBuildList.getSBSInputList(getProject(), configName); + StringBuffer inputs = new StringBuffer(); + for (SBSInput input : sbsInputList) { + if (inputs.length() > 0) { + inputs.append(","); + } + inputs.append(input.getRefid().getRefId()); + getProject().setProperty(outputProperty,inputs.toString()); + } + } +} \ No newline at end of file diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/helium-antlib/sbs/src/com/nokia/helium/sbs/ant/taskdefs/SBSTask.java --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/helium-antlib/sbs/src/com/nokia/helium/sbs/ant/taskdefs/SBSTask.java Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,311 @@ +/* + * Copyright (c) 2007-2008 Nokia Corporation and/or its subsidiary(-ies). + * All rights reserved. + * This component and the accompanying materials are made available + * under the terms of the License "Eclipse Public License v1.0" + * which accompanies this distribution, and is available + * at the URL "http://www.eclipse.org/legal/epl-v10.html". + * + * Initial Contributors: + * Nokia Corporation - initial contribution. + * + * Contributors: + * + * Description: + * + */ + +package com.nokia.helium.sbs.ant.taskdefs; + +import java.util.List; +import org.w3c.dom.*; +import javax.xml.parsers.DocumentBuilder; +import javax.xml.parsers.DocumentBuilderFactory; +import javax.xml.transform.*; +import javax.xml.transform.dom.*; +import javax.xml.transform.stream.*; +import java.io.FileWriter; +import java.text.DecimalFormat; +import java.util.Date; +import com.nokia.helium.core.plexus.AntStreamConsumer; +import java.io.File; +import org.apache.tools.ant.BuildException; +import org.apache.tools.ant.Task; +import com.nokia.helium.core.ant.types.Variable; +import com.nokia.helium.core.ant.types.VariableSet; +import com.nokia.helium.sbs.ant.types.*; +import com.nokia.helium.sbs.ant.*; +import org.apache.log4j.Logger; +import org.apache.tools.ant.types.PatternSet; +import com.nokia.helium.sbs.SAXSysdefParser; +import com.nokia.helium.sbs.SBSCommandBase; +import com.nokia.helium.sbs.SBSException; +import java.util.ArrayList; +import java.util.Hashtable; +import com.nokia.helium.core.plexus.FileStreamConsumer; +import java.util.Collection; + +public class SBSTask extends Task { + + private Logger log = Logger.getLogger(SBSTask.class); + private String sbsInputName; + private String layerPatternSetRef; + private File sysDefFile; + private File workingDir; + private File errorFile; + private String logSuffix; + private String cleanLog; + private String outputLogName; + private File statsLog; + private boolean executeCmd = true; + private boolean failOnError = true; + private Date startTime; + private Date endTime; + + + public void setCleanLog(String logPath) { + cleanLog = logPath; + } + + public void setOutputLog(String logName) { + outputLogName = logName; + } + + public void setStatsLog(File log) { + statsLog = log; + } + + public void setSBSInput(String inputName) { + sbsInputName = inputName; + } + + public void setErrorOutput(File file) { + errorFile = file; + } + + public void setSysDefFile(File file) { + sysDefFile = file; + } + + public void setLogSuffix(String suffix) { + logSuffix = suffix; + } + + public void setLayerPatternSetRef(String id) { + layerPatternSetRef = id; + } + + public void setWorkingDir(File dir) { + workingDir = dir; + } + + public void setExecute(boolean execute) { + executeCmd = execute; + } + + public void setFailOnError(boolean failBuild) { + failOnError = failBuild; + } + + /** + * Execute the task. Set the property with number of severities. + * @throws BuildException + */ + public void execute() { + if (sbsInputName == null) { + throw new BuildException("sbsInputName is not defined"); + } + if (sysDefFile == null) { + throw new BuildException("System Definition file is missing"); + } + if (workingDir == null) { + throw new BuildException("workingDir must be set"); + } + + List filteredLayers = getFilteredLayers(); + SBSCommandBase sbsCmd = new SBSCommandBase(); + sbsCmd.setWorkingDir(workingDir); + if (cleanLog != null) { + sbsCmd.setCleanLogFilePath(cleanLog); + } + try { + log.debug("error stream file : " + errorFile); + sbsCmd.addOutputLineHandler(new AntStreamConsumer(this)); + if (errorFile == null) { + log.debug("redirecting error to Antstream"); + sbsCmd.addErrorLineHandler(new AntStreamConsumer(this)); + } else { + log.debug("redirecting error to file stream"); + sbsCmd.addErrorLineHandler(new FileStreamConsumer(errorFile)); + } + } catch (java.io.FileNotFoundException ex) { + log.info("file path: " + errorFile + "Not valid" ); + } + Object refObject = getProject().getReferences().get(sbsInputName); + if (refObject == null) { + throw new BuildException("invalid sbs input reference: " + sbsInputName); + } + if ( refObject != null && ! (refObject instanceof SBSInput)) { + throw new BuildException("sbs input name " + sbsInputName + "is not valid"); + } + SBSInput sbsInput = (SBSInput)refObject; + StringBuffer cmdOptions = new StringBuffer(); + VariableSet sbsOptions = sbsInput.getFullSBSOptions(); + cmdOptions.append(" -s " + sysDefFile); + Collection variableList = sbsOptions.getVariables(); + if (sbsOptions != null ) { + if (variableList.isEmpty()) { + throw new BuildException("sbsoptions cannot be empty for input: " + sbsInputName); + } + } + for (Variable variable : variableList) { + cmdOptions.append(" " + variable.getParameter()); + } + SBSMakeOptions sbsMakeOptions = sbsInput.getFullSBSMakeOptions(); + variableList = null; + if (sbsMakeOptions != null) { + cmdOptions.append(" -e " + sbsMakeOptions.getEngine()); + String ppThreads = sbsMakeOptions.getPPThreads(); + if (ppThreads != null) { + cmdOptions.append(" -j " + ppThreads); + } + variableList = sbsMakeOptions.getVariables(); + //if (variableList.isEmpty()) { + // throw new BuildException("sbs make options cannot be empty for input: " + sbsInputName); + //} + for (Variable variable : variableList) { + cmdOptions.append(" --mo="); + cmdOptions.append(variable.getParameter()); + } + } + if (filteredLayers != null) { + if (filteredLayers.isEmpty()) { + log.info("Warning: No matching layers to build from system definition file, skipped"); + return; + } else { + for (String layer : filteredLayers) { + cmdOptions.append(" -l " + layer); + } + } + } + startTime = new Date(); + try { + log("sbs commands: " + cmdOptions.toString()); + if (executeCmd) { + sbsCmd.execute(cmdOptions.toString()); + } + } catch (SBSException sex) { + log.info("SBS exception occured during sbs execution"); + if (failOnError) { + throw new BuildException("exception during SBS execution", sex); + } + } catch (Exception ex) { + log.info("Exception occured during sbs execution"); + if (failOnError) { + throw new BuildException("exception during SBS execution", ex); + } + } + endTime = new Date(); + updateSBSLogStatistics(statsLog, outputLogName); + } + + private List getFilteredLayers() { + List filteredLayers = null; + if (layerPatternSetRef != null) { + Hashtable references = getProject().getReferences(); + Object layerPatternSetObject = references.get(layerPatternSetRef); + if ( layerPatternSetObject != null && ! (layerPatternSetObject instanceof PatternSet)) { + throw new BuildException("Layer Pattern set is not of type PatternSet"); + } + if (layerPatternSetObject != null) { + PatternSet layerPatternSet = (PatternSet) layerPatternSetObject; + SAXSysdefParser sysDefParser = new SAXSysdefParser(sysDefFile); + List fullLayerList = sysDefParser.getLayers(); + filteredLayers = new ArrayList(); + String[] includes = layerPatternSet.getIncludePatterns(getProject()); + String[] excludes = layerPatternSet.getExcludePatterns(getProject()); + if (includes == null && excludes == null) { + throw new BuildException("No patterns specified"); + } + for (String layer : fullLayerList) { + if (includes == null) { + if (!isExcluded(layer, excludes)) { + filteredLayers.add(layer); + } + continue; + } + if (isIncluded(layer, includes) ) { + if (!isExcluded(layer, excludes)) { + filteredLayers.add(layer); + } + } + } + } + } + return filteredLayers; + } + + + private boolean isIncluded(String text, String[] includes) { + if (includes != null) { + for (String pattern : includes) { + if (text.matches(pattern)) { + return true; + } + } + } + return false; + } + + private void updateSBSLogStatistics(File infoFileName, + String logFileName) { + + try { + DocumentBuilderFactory sbsInfo = DocumentBuilderFactory.newInstance(); + DocumentBuilder docBuilder = sbsInfo.newDocumentBuilder(); + Document doc = docBuilder.newDocument(); + Element root = doc.createElement("sbsinfo"); + doc.appendChild(root); + Element child = doc.createElement("logfile"); + child.setAttribute("name", logFileName); + root.appendChild(child); + + long timeDiff = (endTime.getTime() - startTime.getTime()) / 1000; + child = doc.createElement("durationlong"); + child.setAttribute("time", "" + timeDiff); + root.appendChild(child); + child = doc.createElement("duration"); + int hours = (int) (timeDiff / 3600); + int minutesSeconds = (int)(timeDiff % 3600); + int minutes = minutesSeconds / 60; + int seconds = minutesSeconds % 60; + DecimalFormat decimalFormat = new DecimalFormat(); + decimalFormat.setMinimumIntegerDigits(2); + String duration = decimalFormat.format(hours) + "H:" + + decimalFormat.format(minutes) + "M:" + decimalFormat.format(seconds) + "S"; + //Todo: handle if the time difference is greater than 24 hours + child.setAttribute("time", duration); + root.appendChild(child); + Transformer transformer = TransformerFactory.newInstance().newTransformer(); + transformer.setOutputProperty(OutputKeys.INDENT, "yes"); + FileWriter sbsWriter = new FileWriter(infoFileName); + StreamResult result = new StreamResult(sbsWriter); + DOMSource sbsSource = new DOMSource(doc); + transformer.transform(sbsSource, result); + } catch (Exception ex) { + log.debug("exception while xml writing sbs log info", ex); + } + + } + + private boolean isExcluded(String text, String[] excludes) { + if (excludes != null) { + for (String pattern : excludes) { + if (text.matches(pattern)) { + return true; + } + } + } + return false; + } +} \ No newline at end of file diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/helium-antlib/sbs/src/com/nokia/helium/sbs/ant/types/SBSBuild.java --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/helium-antlib/sbs/src/com/nokia/helium/sbs/ant/types/SBSBuild.java Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,92 @@ +/* +* Copyright (c) 2007-2008 Nokia Corporation and/or its subsidiary(-ies). +* All rights reserved. +* This component and the accompanying materials are made available +* under the terms of the License "Eclipse Public License v1.0" +* which accompanies this distribution, and is available +* at the URL "http://www.eclipse.org/legal/epl-v10.html". +* +* Initial Contributors: +* Nokia Corporation - initial contribution. +* +* Contributors: +* +* Description: +* +*/ + +package com.nokia.helium.sbs.ant.types; + +import org.apache.tools.ant.types.DataType; +import org.apache.tools.ant.BuildException; +import java.util.Vector; +import java.util.List; +import java.util.ArrayList; +import org.apache.tools.ant.types.Reference; +import org.apache.log4j.Logger; + + +/** + * Helper class to store the command line variables + * with name / value pair. + * @ant.type name="arg" + * @ant.type name="makeOption" + */ +public class SBSBuild extends DataType +{ + private static Logger log = Logger.getLogger(SBSBuild.class); + + private String name; + + private Vector sbsInputList = new Vector(); + + + public SBSBuild() { + } + + /** + * Set the name of the variable. + * @param name + */ + public void setName(String nm) { + name = nm; + } + + /** + * Gets the name of the build input. + * @param name + */ + public String getName() { + return name; + } + + /** + * Creates an empty variable element and adds + * it to the variables list + * @return empty Variable pair + */ + public SBSInput createSBSInput() { + SBSInput input = new SBSInput(); + sbsInputList.add(input); + return input; + } + + public List getSBSInputList() { + List inputList = new ArrayList(); + Reference refId = getRefid(); + Object sbsInputObject = null; + if (refId != null) { + try { + sbsInputObject = refId.getReferencedObject(); + } catch ( Exception ex) { + //log.info("Reference id of sbsinput list is not valid"); + throw new BuildException("Reference id (" + refId.getRefId() + ") of sbsinput list is not valid"); + } + if (sbsInputObject != null && sbsInputObject instanceof SBSInput) { + inputList.add((SBSInput)sbsInputObject); + } + } + inputList.addAll(sbsInputList); + return inputList; + } +} diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/helium-antlib/sbs/src/com/nokia/helium/sbs/ant/types/SBSInput.java --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/helium-antlib/sbs/src/com/nokia/helium/sbs/ant/types/SBSInput.java Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,251 @@ +/* +* Copyright (c) 2007-2008 Nokia Corporation and/or its subsidiary(-ies). +* All rights reserved. +* This component and the accompanying materials are made available +* under the terms of the License "Eclipse Public License v1.0" +* which accompanies this distribution, and is available +* at the URL "http://www.eclipse.org/legal/epl-v10.html". +* +* Initial Contributors: +* Nokia Corporation - initial contribution. +* +* Contributors: +* +* Description: +* +*/ + +package com.nokia.helium.sbs.ant.types; + +import com.nokia.helium.core.ant.types.VariableSet; +import com.nokia.helium.core.ant.VariableIFImpl; +import java.util.Collection; +import com.nokia.helium.core.ant.types.Variable; +import org.apache.tools.ant.BuildException; +import java.util.Vector; +import org.apache.tools.ant.types.Reference; +import org.apache.log4j.Logger; + +/** + * Helper class to store the variable set (list of variables + * with name / value pair) + * @ant.type name="argSet" + */ +public class SBSInput extends VariableIFImpl { + + private static Logger log = Logger.getLogger(SBSInput.class); + + private Vector sbsOptions = new Vector(); + private Vector sbsMakeOptions = new Vector(); + private Vector sbsInputList = new Vector(); + + /** + * Constructor + */ + public SBSInput() { + } + + /** + * Creates an empty variable element and adds + * it to the variables list + * @return empty Variable pair + */ + public VariableSet createSBSOptions() { + SBSInput sbsInput = new SBSInput(); + VariableSet varSet = new VariableSet(); + sbsInput.addSBSOptions(varSet); + sbsInputList.add(sbsInput); + return varSet; + } + + public void addSBSOptions(VariableSet varSet) { + sbsOptions.add(varSet); + } + + /** + * Creates an empty variable element and adds + * it to the variables list + * @return empty Variable pair + */ + public VariableSet createSBSMakeOptions() { + SBSInput sbsInput = new SBSInput(); + SBSMakeOptions varSet = new SBSMakeOptions(); + sbsInput.addSBSMakeOptions(varSet); + sbsInputList.add(sbsInput); + return varSet; + } + + public void addSBSMakeOptions(SBSMakeOptions varSet) { + sbsMakeOptions.add(varSet); + } + + public SBSInput createSBSInput() { + SBSInput sbsInput = new SBSInput(); + sbsInputList.add(sbsInput); + return sbsInput; + } + + public Vector getSBSOptions() { + return sbsOptions; + } + + public Vector getSBSMakeOptions() { + return sbsMakeOptions; + } + + private void validateInput() { + if (getRefid() != null && (!sbsMakeOptions.isEmpty() || !sbsOptions.isEmpty())) { + throw new BuildException("SBSInput with refid should not have sbsoptions / sbsmakeoptions"); + } + } + + private Vector getSBSOptions(SBSInput sbsInput) { + Vector fullList = null; + sbsInput.validateInput(); + Reference refId = sbsInput.getRefid(); + Object sbsInputObject = null; + if (refId != null) { + try { + sbsInputObject = refId.getReferencedObject(); + } catch ( Exception ex) { + //log.info("Reference id of sbsinput list is not valid"); + throw new BuildException("Reference id (" + refId.getRefId() + ") of sbsinput list is not valid"); + } + if (sbsInputObject != null && sbsInputObject instanceof SBSInput) { + VariableSet options = ((SBSInput)sbsInputObject).getFullSBSOptions(); + if (options != null ) { + if (fullList == null) { + fullList = new Vector(); + } + fullList.add(options); + } + } + } + Vector optionsList = sbsInput.getSBSOptions(); + if (optionsList != null ) { + if (fullList == null) { + fullList = new Vector(); + } + fullList.addAll(optionsList); + } + return fullList; + } + + private Vector getSBSMakeOptions(SBSInput sbsInput) { + Vector sbsMakeOptionsList = null; + Reference refId = sbsInput.getRefid(); + Object sbsInputObject = null; + if (refId != null) { + try { + sbsInputObject = refId.getReferencedObject(); + } catch ( Exception ex) { + throw new BuildException("Reference id (" + refId.getRefId() + ") of sbsinput list is not valid"); + } + if (sbsInputObject != null && sbsInputObject instanceof SBSInput) { + SBSMakeOptions options = ((SBSInput)sbsInputObject).getFullSBSMakeOptions(); + if (options != null ) { + if (sbsMakeOptionsList == null) { + sbsMakeOptionsList = new Vector(); + } + sbsMakeOptionsList.add(options); + } + } + } + Vector options = sbsInput.getSBSMakeOptions(); + if (options != null) { + if (sbsMakeOptionsList == null) { + sbsMakeOptionsList = new Vector(); + } + sbsMakeOptionsList.addAll(options); + } + return sbsMakeOptionsList; + } + + public VariableSet getFullSBSOptions() { + Vector fullList = null; + VariableSet resultSet = null; + Vector currentOptions = getSBSOptions(this); + if (currentOptions != null && !currentOptions.isEmpty()) { + if (fullList == null ) { + fullList = new Vector(); + } + fullList.addAll(currentOptions); + } + for (SBSInput sbsInput : sbsInputList) { + Vector options = getSBSOptions(sbsInput); + if (options != null && !options.isEmpty()) { + if (fullList == null ) { + fullList = new Vector(); + } + fullList.addAll(options); + } + } + if (fullList != null) { + for (VariableSet varSet : fullList) { + for (Variable var : varSet.getVariables()) { + if (resultSet == null) { + resultSet = new VariableSet(); + } + resultSet.add(var); + } + } + } + return resultSet; + } + + public SBSMakeOptions getFullSBSMakeOptions() { + Vector sbsMakeOptionsList = null; + SBSMakeOptions resultSet = null; + Vector currentOptions = getSBSMakeOptions(this); + if (currentOptions != null && !currentOptions.isEmpty()) { + if (sbsMakeOptionsList == null ) { + sbsMakeOptionsList = new Vector(); + } + sbsMakeOptionsList.addAll(currentOptions); + } + for (SBSInput sbsInput : sbsInputList) { + Vector options = getSBSMakeOptions(sbsInput); + if (options != null && !options.isEmpty()) { + if (sbsMakeOptionsList == null ) { + sbsMakeOptionsList = new Vector(); + } + sbsMakeOptionsList.addAll(options); + } + } + if (sbsMakeOptionsList != null ) { + String engine = null; + for (SBSMakeOptions varSet : sbsMakeOptionsList) { + String currentEngine = varSet.getEngine(); + if (currentEngine != null) { + if (engine == null) { + engine = currentEngine; + if (resultSet == null ) { + resultSet = new SBSMakeOptions(); + } + resultSet.setEngine(currentEngine); + } else { + if (!engine.equals(currentEngine) ) { + throw new BuildException("inheriting engine types mismatch: " + engine + " != " + currentEngine); + } + } + } + if (resultSet == null ) { + resultSet = new SBSMakeOptions(); + } + for (Variable var : varSet.getVariables()) { + resultSet.add(var); + } + } + } + return resultSet; + } + + public Collection getVariables() { + Collection varList = null; + VariableSet options = getFullSBSOptions(); + if (options != null) { + varList = options.getVariables(); + } + return varList; + } +} \ No newline at end of file diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/helium-antlib/sbs/src/com/nokia/helium/sbs/ant/types/SBSMakeOptions.java --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/helium-antlib/sbs/src/com/nokia/helium/sbs/ant/types/SBSMakeOptions.java Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,136 @@ +/* +* Copyright (c) 2007-2008 Nokia Corporation and/or its subsidiary(-ies). +* All rights reserved. +* This component and the accompanying materials are made available +* under the terms of the License "Eclipse Public License v1.0" +* which accompanies this distribution, and is available +* at the URL "http://www.eclipse.org/legal/epl-v10.html". +* +* Initial Contributors: +* Nokia Corporation - initial contribution. +* +* Contributors: +* +* Description: +* +*/ + +package com.nokia.helium.sbs.ant.types; + +import com.nokia.helium.core.ant.types.VariableSet; +import org.apache.log4j.Logger; +import org.apache.tools.ant.types.Reference; +import org.apache.tools.ant.BuildException; +import java.util.List; + +/** + * Helper class to store the variable set (list of variables + * with name / value pair) + * @ant.type name="argSet" + */ +public class SBSMakeOptions extends VariableSet { + + private static Logger log = Logger.getLogger(SBSMakeOptions.class); + + private String engine; + + private String ppThreads; + + + private boolean initialized; + /** + * Constructor + */ + public SBSMakeOptions() { + } + + /** + * Helper function called by ant to create the new varset + */ + public SBSMakeOptions createSBSMakeOptions() { + SBSMakeOptions options = new SBSMakeOptions(); + add(options); + return options; + } + + /** + * Helper function to add the created varset + * @param filter to be added to the varset + */ + public void add(SBSMakeOptions option) { + super.add(option); + } + + /** + * Sets the engine type for this options + * @param engine for which the make options are used + */ + public void setEngine(String engineName) { + engine = engineName; + } + + /** + * Sets the ppthreads (no. bldinfs to process) + * @param ppBlock no. bldinfs to process per block + */ + public void setPPThreads(String ppBlock) { + ppThreads = ppBlock; + } + + public String getPPThreads() { + if (!initialized) { + initializeAll(); + initialized = true; + } + return ppThreads; + } + + /** + * Returns the engine name + * @return type of make engine + */ + public String getEngine() { + if (!initialized) { + initializeAll(); + initialized = true; + } + if (engine == null) { + throw new BuildException("engine should not be null"); + } + return engine; + } + private void initializeAll() { + Object sbsInputObject = null; + List varSets = getVariableSets(); + initialize(this); + for (VariableSet varSet : varSets) { + initialize(varSet); + } + } + + private void initialize(VariableSet varSet) { + SBSMakeOptions makeOptions = null; + Reference refId = varSet.getRefid(); + if (refId != null) { + try { + makeOptions = (SBSMakeOptions)refId.getReferencedObject(); + if (makeOptions != null) { + String refEngine = makeOptions.getEngine(); + String threads = makeOptions.getPPThreads(); + if (engine != null && !(engine.equals(refEngine))) { + throw new BuildException(" Config's engine type " + engine + " not matching with reference : " + + refId.getRefId() + ": engine: " + refEngine); + } + if (ppThreads == null) { + ppThreads = threads; + } + if (engine == null) { + engine = refEngine; + } + } + } catch ( Exception ex) { + throw new BuildException(ex.getMessage()); + } + } + } +} \ No newline at end of file diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/helium-antlib/sbs/tests/bld.sh --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/helium-antlib/sbs/tests/bld.sh Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,24 @@ +#!/bin/csh + +# +# Copyright (c) 2009 Nokia Corporation and/or its subsidiary(-ies). +# All rights reserved. +# This component and the accompanying materials are made available +# under the terms of the License "Eclipse Public License v1.0" +# which accompanies this distribution, and is available +# at the URL "http://www.eclipse.org/legal/epl-v10.html". +# +# Initial Contributors: +# Nokia Corporation - initial contribution. +# +# Contributors: +# +# Description: +# + + + +module load java/1.6.0 +module load mercurial +setenv ANT_ARGS "-lib ../lib -lib ../../lib -lib ../../core/lib -lib ../../bin/helium-core.jar -lib ../../bin/helium-sbs.jar -lib ../../antlibs" +ant $* diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/helium-antlib/sbs/tests/build.bat --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/helium-antlib/sbs/tests/build.bat Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,27 @@ +@echo off + +rem +rem Copyright (c) 2009 Nokia Corporation and/or its subsidiary(-ies). +rem All rights reserved. +rem This component and the accompanying materials are made available +rem under the terms of the License "Eclipse Public License v1.0" +rem which accompanies this distribution, and is available +rem at the URL "http://www.eclipse.org/legal/epl-v10.html". +rem +rem Initial Contributors: +rem Nokia Corporation - initial contribution. +rem +rem Contributors: +rem +rem Description: +rem + +setlocal +if not defined JAVA_6_HOME ( +set TESTED_JAVA=C:\Apps\j2sdk_1.6.0_02 +) ELSE set TESTED_JAVA=%JAVA_6_HOME% +if exist %TESTED_JAVA% (set JAVA_HOME=%TESTED_JAVA%) +set ANT_ARGS=-lib ..\lib -lib ..\..\lib -lib ..\..\core\lib -lib ..\..\bin\helium-core.jar -lib ..\..\bin\helium-sbs.jar -lib ..\..\antlibs +ant %* +endlocal + diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/helium-antlib/sbs/tests/build.xml --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/helium-antlib/sbs/tests/build.xml Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,37 @@ + + + + Helium Antlib sbs tests. + + + + + + + + + + + + + \ No newline at end of file diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/helium-antlib/sbs/tests/sbs_default_config.ant.xml --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/helium-antlib/sbs/tests/sbs_default_config.ant.xml Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,164 @@ + + + + Helium Antlib default sbs configuration. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + \ No newline at end of file diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/helium-antlib/sbs/tests/test.sysdef.xml --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/helium-antlib/sbs/tests/test.sysdef.xml Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,142 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +]> + + + + + + + + + + + + + + + + + + + + + + + + + + + \ No newline at end of file diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/helium-antlib/sbs/tests/test_sbs_input.ant.xml --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/helium-antlib/sbs/tests/test_sbs_input.ant.xml Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,179 @@ + + + + + Helium Antlib sbs unittests. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + \ No newline at end of file diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/helium-antlib/scm/demo/build.xml --- a/buildframework/helium/external/helium-antlib/scm/demo/build.xml Wed Oct 28 14:39:48 2009 +0000 +++ b/buildframework/helium/external/helium-antlib/scm/demo/build.xml Wed Dec 23 19:29:07 2009 +0200 @@ -398,4 +398,12 @@ + + + + + + + + diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/helium-antlib/scm/src/com/nokia/helium/scm/ant/taskdefs/ChangelogAction.java --- a/buildframework/helium/external/helium-antlib/scm/src/com/nokia/helium/scm/ant/taskdefs/ChangelogAction.java Wed Oct 28 14:39:48 2009 +0000 +++ b/buildframework/helium/external/helium-antlib/scm/src/com/nokia/helium/scm/ant/taskdefs/ChangelogAction.java Wed Dec 23 19:29:07 2009 +0200 @@ -20,6 +20,11 @@ import java.util.Date; import java.text.SimpleDateFormat; import java.util.Iterator; +import java.io.*; + +import org.dom4j.Document; +import org.dom4j.Element; +import org.dom4j.io.SAXReader; import org.apache.maven.scm.ScmException; import org.apache.maven.scm.ScmRevision; @@ -63,7 +68,7 @@ private String startVersion; private String endVersion; - private String xmlproperty; + private File xmlbom; /** @@ -131,13 +136,13 @@ } /** - * Output property for xml output of changeset list + * File for xml output of changeset list * * @ant.not-required */ - public void setXMLProperty(String xmlproperty) + public void setXmlbom(File xmlbom) { - this.xmlproperty = xmlproperty; + this.xmlbom = xmlbom; } /** @@ -164,7 +169,7 @@ } catch (Exception e) { - throw new BuildException("Date Format not supported jash:" + e.getMessage()); + throw new ScmException("Date Format not supported:" + e.getMessage()); } } else @@ -191,7 +196,7 @@ { getTask().log(changelogSet.toXML()); } - else if (xmlproperty != null) + else if (xmlbom != null) { String output = ""; for (Object o : changelogSet.getChangeSets()) @@ -206,8 +211,36 @@ output = output + "" + revision + "" + c.getComment() + "" + new SimpleDateFormat("yyyy-MM-dd'T'HH:mm:ss").format(c.getDate()) + ""; } - - getProject().setProperty(xmlproperty, output); + String[] path = getTask().getScmUrl().split("/"); + String xml = "untitled\n"; + String thisproject = "" + "" + path[path.length - 1] + "" + "" + getTask().getScmUrl() + "" + "mercurial" + output + "\n"; + xml = xml + thisproject; + try { + if (xmlbom.exists()) + { + SAXReader xmlReader = new SAXReader(); + Document antDoc = xmlReader.read(xmlbom); + for (Iterator iterator = antDoc.selectNodes("//project").iterator(); iterator.hasNext();) + { + boolean equal = false; + Element e = (Element) iterator.next(); + for (Iterator iterator2 = antDoc.selectNodes("//baseline").iterator(); iterator2.hasNext();) + { + Element e2 = (Element) iterator2.next(); + if (e2.getText().equals(getTask().getScmUrl())) + equal = true; + } + if (!equal) + xml = xml + e.asXML() + "\n"; + } + } + xml = xml + ""; + + FileWriter fstream = new FileWriter(xmlbom); + BufferedWriter out = new BufferedWriter(fstream); + out.write(xml); + out.close(); + } catch (Exception e) { e.printStackTrace(); } } else { diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/helium-antlib/scm/src/com/nokia/helium/scm/ant/taskdefs/InitAction.java --- a/buildframework/helium/external/helium-antlib/scm/src/com/nokia/helium/scm/ant/taskdefs/InitAction.java Wed Oct 28 14:39:48 2009 +0000 +++ b/buildframework/helium/external/helium-antlib/scm/src/com/nokia/helium/scm/ant/taskdefs/InitAction.java Wed Dec 23 19:29:07 2009 +0200 @@ -24,7 +24,23 @@ import com.nokia.maven.scm.provider.ScmProviderExt; +/** + * Create a new repository. In the following example the new_repo mercurial repository + * will be created under /some/path/. E.g: + * + *

+ * <hlm:scm verbose="true" scmUrl="scm:hg:/some/path/new_repo">
+ *     <hlm:checkout baseDir="scm:hg:/some/path/new_repo" />
+ * </hlm:scm>
+ *

+ * + * @ant.type name="init" category="SCM" + */ public class InitAction extends BaseDirectoryScmAction { + + /** + * {@inheritDoc} + */ @Override public void execute(ScmRepository repository) throws ScmException { ScmManager scmManager = getTask().getScmManager(); diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/helium-antlib/scm/src/com/nokia/helium/scm/ant/taskdefs/ScmAction.java --- a/buildframework/helium/external/helium-antlib/scm/src/com/nokia/helium/scm/ant/taskdefs/ScmAction.java Wed Oct 28 14:39:48 2009 +0000 +++ b/buildframework/helium/external/helium-antlib/scm/src/com/nokia/helium/scm/ant/taskdefs/ScmAction.java Wed Dec 23 19:29:07 2009 +0200 @@ -21,6 +21,14 @@ import org.apache.maven.scm.repository.ScmRepository; import org.apache.tools.ant.ProjectComponent; +/** + * Abstract class which implements common setting between + * ScmAction implementations. + * + * Any implementing action must implement the execute method as + * a execution of the action. The owning task should be used + * to log message to the user. + */ public abstract class ScmAction extends ProjectComponent { private ScmTask scmtask; @@ -39,6 +47,10 @@ this.scmtask = task; } + /** + * Get the action name based on the classname. + * @return the lowercase class name. + */ public String getName() { String className = getClass().getName(); String commandName = className diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/helium-antlib/scm/src/com/nokia/helium/scm/ant/taskdefs/StatusAction.java --- a/buildframework/helium/external/helium-antlib/scm/src/com/nokia/helium/scm/ant/taskdefs/StatusAction.java Wed Oct 28 14:39:48 2009 +0000 +++ b/buildframework/helium/external/helium-antlib/scm/src/com/nokia/helium/scm/ant/taskdefs/StatusAction.java Wed Dec 23 19:29:07 2009 +0200 @@ -36,7 +36,7 @@ * </fileset> * </hlm:status> * </hlm:scm > - * + * * * @ant.type name="status" category="SCM" */ diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/helium-antlib/scm/src/com/nokia/helium/scm/ant/taskdefs/TagsAction.java --- a/buildframework/helium/external/helium-antlib/scm/src/com/nokia/helium/scm/ant/taskdefs/TagsAction.java Wed Oct 28 14:39:48 2009 +0000 +++ b/buildframework/helium/external/helium-antlib/scm/src/com/nokia/helium/scm/ant/taskdefs/TagsAction.java Wed Dec 23 19:29:07 2009 +0200 @@ -29,14 +29,33 @@ import com.nokia.maven.scm.command.tags.TagsScmResult; import com.nokia.maven.scm.manager.ExtendedScmManager; +/** + * This action will tag current repository revision using a specific name. + * + *

+ * <hlm:scm verbose="true" scmUrl="scm:${repo.type}:${repo.dir}/test1">
+ *     <hlm:tags baseDir="${repo.dir}/test1" reference="my.tags" />
+ * </hlm:scm>
+ *

+ * + * @ant.type name="tags" category="SCM" + */ public class TagsAction extends BaseDirectoryScmAction { private String reference; + /** + * Defines the id of the result type generated by the query. + * @param reference the name of the reference to use. + * @ant.not-required Only log result by default. + */ public void setReference(String reference) { this.reference = reference; } + /** + * {@inheritDoc} + */ @Override public void execute(ScmRepository repository) throws ScmException { TagsScmResult result; diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/helium-antlib/scm/src/com/nokia/helium/scm/ant/types/LatestTag.java --- a/buildframework/helium/external/helium-antlib/scm/src/com/nokia/helium/scm/ant/types/LatestTag.java Wed Oct 28 14:39:48 2009 +0000 +++ b/buildframework/helium/external/helium-antlib/scm/src/com/nokia/helium/scm/ant/types/LatestTag.java Wed Dec 23 19:29:07 2009 +0200 @@ -28,19 +28,43 @@ import org.apache.tools.ant.BuildException; import org.apache.tools.ant.Project; +/** + * The latestTag element will help you to find the latest revision based + * on a pattern. + * + *

+ *  <latestTag name="1.0.*">
+ *     <tagSet id="set.of.tags"/>
+ *  latestTag
+ *

+ * + * @ant.type name="latestTag" category="SCM" + */ public class LatestTag extends Tag { private String pattern; private List tagSets = new ArrayList(); + /** + * Defines the pattern. + * @ant.required + */ public void setPattern(String pattern) { this.pattern = pattern; } + /** + * Add a set of release to search the latest release in. + * @param tagSet + */ public void add(TagSet tagSet) { tagSets.add(tagSet); } + + /** + * {@inheritDoc} + */ @Override public String getName() { if (pattern == null) @@ -56,6 +80,11 @@ return tags.get(0).getName(); } + /** + * Get a reduce set of tags, only tag matching the pattern will be + * included. + * @return the reduce list of tags. + */ protected List getCleanedList() { Pattern pVer = getPattern(); List tags = new ArrayList(); @@ -67,6 +96,15 @@ return tags; } + /** + * Get the pattern as a regular expression. + * '*' will be transformed into (\d+) (which means only numbers + * will be considered). Other character will be quoted. + * For example: + * 1.0.* => 1\.0\.(\d+) + * + * @return the transformed pattern. + */ protected Pattern getPattern() { // Quoting the current pattern getProject().log("pattern: " + pattern, Project.MSG_DEBUG); @@ -79,6 +117,10 @@ return Pattern.compile(qVer); } + /** + * Get the list of tags, from the tagSets. + * @return a list of Tags objects. + */ protected List getTags() { List tags = new ArrayList(); for (TagSet ts : tagSets) { @@ -92,15 +134,30 @@ return tags; } + /** + * This class implements the comparator interface, which will help to + * order the tag compare to the pattern. For example: + * 1.0.2 > 1.0.1 (for pattern 1.0.*) + * 1.1.1 > 1.0.2 (for pattern 1.*.*) + * + * @param A Tag kind of class. + */ public class TagComparator implements Comparator { // Pattern to match for the comparison private Pattern pVer; + /** + * Configure the Comparator with the pattern. + * @param pattern + */ public TagComparator(Pattern pattern) { pVer = pattern; } + /** + * {@inheritDoc} + */ @Override public int compare(T o1, T o2) { getProject().log("Comparing: " + o1.getName() + ">" + o2.getName(), Project.MSG_DEBUG); diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/helium-antlib/scm/src/com/nokia/helium/scm/ant/types/Revision.java --- a/buildframework/helium/external/helium-antlib/scm/src/com/nokia/helium/scm/ant/types/Revision.java Wed Oct 28 14:39:48 2009 +0000 +++ b/buildframework/helium/external/helium-antlib/scm/src/com/nokia/helium/scm/ant/types/Revision.java Wed Dec 23 19:29:07 2009 +0200 @@ -20,6 +20,14 @@ import org.apache.tools.ant.types.DataType; +/** + * The revision element store a particular revision id. + + *

+ *  <revision name="release_1.0" />
+ *

+ * + */ public class Revision extends DataType { private String name; @@ -35,6 +43,10 @@ this.name = name; } + /** + * Get the revision. + * @return the revision. + */ public String getName() { return name; } diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/helium-antlib/scm/src/com/nokia/helium/scm/ant/types/Tag.java --- a/buildframework/helium/external/helium-antlib/scm/src/com/nokia/helium/scm/ant/types/Tag.java Wed Oct 28 14:39:48 2009 +0000 +++ b/buildframework/helium/external/helium-antlib/scm/src/com/nokia/helium/scm/ant/types/Tag.java Wed Dec 23 19:29:07 2009 +0200 @@ -20,6 +20,14 @@ import org.apache.tools.ant.types.DataType; +/** + * The tag type store the value of a desired SCM tag. + * + *

+ *  <tag name="release_1.0" />
+ *

+ * + */ public class Tag extends DataType { private String name; @@ -34,6 +42,10 @@ this.name = name; } + /** + * Get the tag value. + * @return the tag value + */ public String getName() { return name; } diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/helium-antlib/scm/src/com/nokia/helium/scm/ant/types/TagSet.java --- a/buildframework/helium/external/helium-antlib/scm/src/com/nokia/helium/scm/ant/types/TagSet.java Wed Oct 28 14:39:48 2009 +0000 +++ b/buildframework/helium/external/helium-antlib/scm/src/com/nokia/helium/scm/ant/types/TagSet.java Wed Dec 23 19:29:07 2009 +0200 @@ -23,20 +23,45 @@ import org.apache.tools.ant.types.DataType; +/** + * This tagSet type is a container of tag elements. + * + * Example: + *

+ *  <tagSet>
+ *      <tag name="release_1.0" />
+ *      <tag name="release_1.0.1" />
+ *  <7tagSet>
+ *

+ * + * @ant.type name="tagSet" category="SCM" + */ public class TagSet extends DataType { private List tags = new ArrayList(); + /** + * Add a Tag element. + * @param tag + */ public void add(Tag tag) { tags.add(tag); } + /** + * Create and add a Taf element. + * @return the newly created Tag. + */ public Tag createTag() { Tag tag = new Tag(); tags.add(tag); return tag; } - + + /** + * Get the list of tags. + * @return the list of stored tag elements. + */ public List getTags() { return new ArrayList(tags); } diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/helium-antlib/scm/src/com/nokia/maven/scm/command/init/InitScmResult.java --- a/buildframework/helium/external/helium-antlib/scm/src/com/nokia/maven/scm/command/init/InitScmResult.java Wed Oct 28 14:39:48 2009 +0000 +++ b/buildframework/helium/external/helium-antlib/scm/src/com/nokia/maven/scm/command/init/InitScmResult.java Wed Dec 23 19:29:07 2009 +0200 @@ -20,7 +20,15 @@ import org.apache.maven.scm.ScmResult; +/** + * Class to store the result of the init command. + * + */ public class InitScmResult extends ScmResult { + + /** + * {@inheritDoc} + */ public InitScmResult(String commandLine, String providerMessage, String commandOutput, boolean success) { super(commandLine, providerMessage, commandOutput, success); diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/helium-antlib/scm/src/com/nokia/maven/scm/command/pull/AbstractPullCommand.java --- a/buildframework/helium/external/helium-antlib/scm/src/com/nokia/maven/scm/command/pull/AbstractPullCommand.java Wed Oct 28 14:39:48 2009 +0000 +++ b/buildframework/helium/external/helium-antlib/scm/src/com/nokia/maven/scm/command/pull/AbstractPullCommand.java Wed Dec 23 19:29:07 2009 +0200 @@ -28,16 +28,32 @@ import org.apache.maven.scm.command.AbstractCommand; import org.apache.maven.scm.provider.ScmProviderRepository; +/** + * Abstract class to representing a pull command. + * This functionality is mainly targeted for distributed + * repository like Git or Mercurial. + */ public abstract class AbstractPullCommand extends AbstractCommand { + /** + * {@inheritDoc} + */ + @Override public ScmResult executeCommand(ScmProviderRepository repository, ScmFileSet fileSet, CommandParameters parameters) throws ScmException { return executePullCommand(repository, fileSet, parameters.getScmVersion(CommandParameter.SCM_VERSION, new ScmTag("tip"))); } - + /** + * Implements the pull functionality. + * @param repository the reporsitory. + * @param fileSet + * @param scmVersion what revision to pull. + * @return + * @throws ScmException + */ protected abstract PullScmResult executePullCommand(ScmProviderRepository repository, ScmFileSet fileSet, ScmVersion scmVersion) throws ScmException; } diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/helium-antlib/scm/src/com/nokia/maven/scm/command/pull/PullScmResult.java --- a/buildframework/helium/external/helium-antlib/scm/src/com/nokia/maven/scm/command/pull/PullScmResult.java Wed Oct 28 14:39:48 2009 +0000 +++ b/buildframework/helium/external/helium-antlib/scm/src/com/nokia/maven/scm/command/pull/PullScmResult.java Wed Dec 23 19:29:07 2009 +0200 @@ -20,6 +20,10 @@ import org.apache.maven.scm.ScmResult; +/** + * + * + */ public class PullScmResult extends ScmResult { public PullScmResult( String commandLine, String providerMessage, String commandOutput, boolean success ) diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/helium-antlib/scm/src/com/nokia/maven/scm/command/tags/AbstractTagsCommand.java --- a/buildframework/helium/external/helium-antlib/scm/src/com/nokia/maven/scm/command/tags/AbstractTagsCommand.java Wed Oct 28 14:39:48 2009 +0000 +++ b/buildframework/helium/external/helium-antlib/scm/src/com/nokia/maven/scm/command/tags/AbstractTagsCommand.java Wed Dec 23 19:29:07 2009 +0200 @@ -24,9 +24,16 @@ import org.apache.maven.scm.command.AbstractCommand; import org.apache.maven.scm.provider.ScmProviderRepository; +/** + * Abstract class representing a tags command. + * Tags consist in retrieving existing tags for a particular repository. + * + */ public abstract class AbstractTagsCommand extends AbstractCommand { - + /** + * {@inheritDoc} + */ public TagsScmResult executeCommand(ScmProviderRepository repository, ScmFileSet fileSet, CommandParameters parameters) throws ScmException { @@ -34,6 +41,14 @@ } + /** + * Execute the tags operation on the repository. + * @param repository the repository to use for the action + * @param fileSetCommand + * @param parameters + * @return a TagsScmResult representing the output of the command. + * @throws ScmException + */ protected abstract TagsScmResult executeTagsCommand(ScmProviderRepository repository, ScmFileSet fileSetCommand, CommandParameters parameters) throws ScmException; } diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/helium-antlib/scm/src/com/nokia/maven/scm/command/tags/TagsScmResult.java --- a/buildframework/helium/external/helium-antlib/scm/src/com/nokia/maven/scm/command/tags/TagsScmResult.java Wed Oct 28 14:39:48 2009 +0000 +++ b/buildframework/helium/external/helium-antlib/scm/src/com/nokia/maven/scm/command/tags/TagsScmResult.java Wed Dec 23 19:29:07 2009 +0200 @@ -25,14 +25,33 @@ import org.apache.maven.scm.ScmResult; import org.apache.maven.scm.ScmTag; +/** + * Class to store the result from the tags operation. + * + */ public class TagsScmResult extends ScmResult { private List scmVersions = new ArrayList(); + /** + * Default constructor. + * @param commandLine + * @param providerMessage + * @param commandOutput + * @param success + */ public TagsScmResult(String commandLine, String providerMessage, String commandOutput, boolean success) { super(commandLine, providerMessage, commandOutput, success); } + /** + * This constructor stores also the ScmTag retrieved. + * @param commandLine + * @param providerMessage + * @param commandOutput + * @param success + * @param scmVersions + */ public TagsScmResult(String commandLine, String providerMessage, String commandOutput, boolean success, Enumeration scmVersions) { @@ -43,6 +62,10 @@ } } + /** + * Get the list of tags from the command. + * @return + */ public List getTags() { return scmVersions; } diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/helium-antlib/scm/src/com/nokia/maven/scm/manager/BasicExtendedScmManager.java --- a/buildframework/helium/external/helium-antlib/scm/src/com/nokia/maven/scm/manager/BasicExtendedScmManager.java Wed Oct 28 14:39:48 2009 +0000 +++ b/buildframework/helium/external/helium-antlib/scm/src/com/nokia/maven/scm/manager/BasicExtendedScmManager.java Wed Dec 23 19:29:07 2009 +0200 @@ -31,9 +31,17 @@ import com.nokia.maven.scm.command.info.InfoScmResult; import com.nokia.maven.scm.provider.ScmProviderExt; +/** + * Extended SCM manager which implements the additional functionalities + * defined by the ExtendedScmManager. + * + */ public class BasicExtendedScmManager extends BasicScmManager implements ExtendedScmManager { + /** + * {@inheritDoc} + */ @Override public PullScmResult pull(ScmRepository repository, File path) throws ScmException { @@ -47,6 +55,9 @@ } } + /** + * {@inheritDoc} + */ @Override public TagsScmResult tags(ScmRepository repository, File path) throws ScmException { try { @@ -59,6 +70,9 @@ } } + /** + * {@inheritDoc} + */ @Override public InfoScmResult info(ScmRepository repository, File path) throws ScmException { try { diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/helium-antlib/scm/src/com/nokia/maven/scm/provider/ScmProviderExt.java --- a/buildframework/helium/external/helium-antlib/scm/src/com/nokia/maven/scm/provider/ScmProviderExt.java Wed Oct 28 14:39:48 2009 +0000 +++ b/buildframework/helium/external/helium-antlib/scm/src/com/nokia/maven/scm/provider/ScmProviderExt.java Wed Dec 23 19:29:07 2009 +0200 @@ -30,16 +30,50 @@ import com.nokia.maven.scm.command.tags.TagsScmResult; import com.nokia.maven.scm.command.info.InfoScmResult; +/** + * This interface describe additional functionalities provider could implement + * compare to the default ScmProvider interface + * + */ public interface ScmProviderExt { + /** + * Create a new repository. + * @param repository the repository to create. + * @return ScmResult result. + * @throws ScmException + */ ScmResult init(ScmRepository repository) throws ScmException; + /** + * Pull changes, this function is target for distributed SCM file Hg or Git. + * @param repository + * @param path the location of the checkout. + * @return a PullScmResult result object. + * @throws ScmException + */ PullScmResult pull(ScmRepository repository, File path) throws ScmException; + /** + * Get a list of tags from a repository. + * @param repository the repository + * @param fileSet + * @param parameters + * @return a TagsScmResult with the list of tags if successful. + * @throws ScmException + */ TagsScmResult tags(ScmRepository repository, ScmFileSet fileSet, CommandParameters parameters) throws ScmException; + /** + * Get information about current revision. + * @param repository + * @param fileSet + * @param parameters + * @return a InfoScmResult with current revision if successful. + * @throws ScmException + */ InfoScmResult info(ScmRepository repository, ScmFileSet fileSet, CommandParameters parameters) throws ScmException; } diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/helium-antlib/scm/src/com/nokia/maven/scm/provider/hg/command/init/HgInitCommand.java --- a/buildframework/helium/external/helium-antlib/scm/src/com/nokia/maven/scm/provider/hg/command/init/HgInitCommand.java Wed Oct 28 14:39:48 2009 +0000 +++ b/buildframework/helium/external/helium-antlib/scm/src/com/nokia/maven/scm/provider/hg/command/init/HgInitCommand.java Wed Dec 23 19:29:07 2009 +0200 @@ -30,7 +30,7 @@ import org.apache.maven.scm.provider.ScmProviderRepository; import org.apache.maven.scm.provider.hg.HgUtils; import org.apache.maven.scm.provider.hg.command.HgCommandConstants; -import org.apache.maven.scm.provider.hg.repository.HgScmProviderRepository; +import com.nokia.maven.scm.provider.hg.repository.HgScmProviderRepository; import com.nokia.maven.scm.command.init.InitScmResult; @@ -39,32 +39,36 @@ private static Logger log = Logger.getLogger(HgInitCommand.class); @Override - protected ScmResult executeCommand(ScmProviderRepository arg0, - ScmFileSet arg1, CommandParameters arg2) throws ScmException { - // TODO Auto-generated method stub - return null; + protected ScmResult executeCommand(ScmProviderRepository repository, + ScmFileSet basedir, CommandParameters args) throws ScmException { + return executeInitCommand(repository); } public InitScmResult executeInitCommand(ScmProviderRepository repository) throws ScmException { // Get the directory in which to create a new repository. Only local // filesystems supported. - log.info("executeInitCommand" + repository); + log.info("executeInitCommand: " + repository); HgScmProviderRepository hgRepo = (HgScmProviderRepository) repository; String uri = hgRepo.getURI(); - String fileUri = uri.substring("scm:hg:file:/".length()); - log.info(fileUri); - File hgRepoDir = new File(fileUri); + log.info(uri); + File hgRepoDir = new File(uri); + File hgRepoRootDir = hgRepoDir.getParentFile(); - boolean workingDirReady = hgRepoDir.mkdirs(); - if (!workingDirReady) { - throw new ScmException("Could not initiate test branch at: " - + hgRepoDir); + if (!hgRepoRootDir.exists()) { + boolean workingDirReady = hgRepoRootDir.mkdirs(); + if (!workingDirReady) { + throw new ScmException("Could not initiate test branch at: " + + hgRepoRootDir); + } } // Create and run the command - String[] initCmd = new String[] { HgCommandConstants.INIT_CMD }; - HgUtils.execute(new File("f:/hg"), initCmd); - return null; + String[] initCmd = new String[] { HgCommandConstants.INIT_CMD, hgRepoDir.getName()}; + ScmResult result = HgUtils.execute(hgRepoRootDir, initCmd); + return new InitScmResult(result.getCommandLine(), + result.getProviderMessage(), + result.getCommandOutput(), + result.isSuccess()); } } diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/helium-antlib/scm/src/com/nokia/maven/scm/provider/hg/command/update/HgUpdateCommand.java --- a/buildframework/helium/external/helium-antlib/scm/src/com/nokia/maven/scm/provider/hg/command/update/HgUpdateCommand.java Wed Oct 28 14:39:48 2009 +0000 +++ b/buildframework/helium/external/helium-antlib/scm/src/com/nokia/maven/scm/provider/hg/command/update/HgUpdateCommand.java Wed Dec 23 19:29:07 2009 +0200 @@ -49,6 +49,9 @@ ScmFileSet fileSet, ScmVersion tag) throws ScmException { File workingDir = fileSet.getBasedir(); + // Find changes from last revision + int previousRevision = HgUtils.getCurrentRevisionNumber(getLogger(), + workingDir); // Update branch String[] updateCmd = new String[] { "update", @@ -65,30 +68,35 @@ // Find changes from last revision int currentRevision = HgUtils.getCurrentRevisionNumber(getLogger(), workingDir); - int previousRevision = currentRevision - 1; - String[] diffCmd = new String[] { HgCommandConstants.DIFF_CMD, - HgCommandConstants.REVISION_OPTION, "" + previousRevision }; + List updatedFiles = new ArrayList(); + List changes = new ArrayList(); + String[] diffCmd = null; + if (currentRevision == 0) { + diffCmd = new String[] { HgCommandConstants.DIFF_CMD, + "-c", "" + currentRevision}; + } else { + diffCmd = new String[] { HgCommandConstants.DIFF_CMD, + HgCommandConstants.REVISION_OPTION, "" + previousRevision, + HgCommandConstants.REVISION_OPTION, "" + currentRevision}; + } HgDiffConsumer diffConsumer = new HgDiffConsumer(getLogger(), - workingDir); - ScmResult diffResult = HgUtils.execute(diffConsumer, getLogger(), + workingDir); + updateResult = HgUtils.execute(diffConsumer, getLogger(), workingDir, diffCmd); // Now translate between diff and update file status - List updatedFiles = new ArrayList(); - List changes = new ArrayList(); List diffFiles = diffConsumer.getChangedFiles(); Map diffChanges = diffConsumer.getDifferences(); for (ScmFile diffFile : diffFiles) { changes.add(diffChanges.get(diffFile.getPath())); if (diffFile.getStatus() == ScmFileStatus.MODIFIED) { - updatedFiles.add(new ScmFile(diffFile.getPath(),ScmFileStatus.PATCHED)); + updatedFiles.add(new ScmFile(diffFile.getPath(), ScmFileStatus.PATCHED)); } else { updatedFiles.add(diffFile); } } - return new UpdateScmResultWithRevision(updatedFiles, changes, String - .valueOf(currentRevision), diffResult); + .valueOf(currentRevision), updateResult); } } diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/helium-antlib/scm/src/com/nokia/maven/scm/provider/hg/repository/HgScmProviderRepository.java --- a/buildframework/helium/external/helium-antlib/scm/src/com/nokia/maven/scm/provider/hg/repository/HgScmProviderRepository.java Wed Oct 28 14:39:48 2009 +0000 +++ b/buildframework/helium/external/helium-antlib/scm/src/com/nokia/maven/scm/provider/hg/repository/HgScmProviderRepository.java Wed Dec 23 19:29:07 2009 +0200 @@ -70,9 +70,12 @@ /** {@inheritDoc} */ public String toString() { - return "Hg Repository Interpreted from: " + orgUrl + ":\nProtocol: " + if (orgUrl != null) { + return "Hg Repository Interpreted from: " + orgUrl + ":\nProtocol: " + orgUrl.getProtocol() + "\nHost: " + getHost() + "\nPort: " + getPort() + "\nUsername: " + getUser() + "\nPassword: " + getPassword() + "\nPath: " + orgUrl.getPath(); + } + return "Hg Repository Interpreted from: " + url; } } diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/helium-antlib/scm/tests/abstract_unittest_scmtask.ant.xml --- a/buildframework/helium/external/helium-antlib/scm/tests/abstract_unittest_scmtask.ant.xml Wed Oct 28 14:39:48 2009 +0000 +++ b/buildframework/helium/external/helium-antlib/scm/tests/abstract_unittest_scmtask.ant.xml Wed Dec 23 19:29:07 2009 +0200 @@ -279,6 +279,15 @@ + + + + + + + + + Not in repo2 @@ -511,6 +520,11 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + content... + + + + + + + + + + + + + + + + + + + diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/helium-antlib/scm/tests/build.xml --- a/buildframework/helium/external/helium-antlib/scm/tests/build.xml Wed Oct 28 14:39:48 2009 +0000 +++ b/buildframework/helium/external/helium-antlib/scm/tests/build.xml Wed Dec 23 19:29:07 2009 +0200 @@ -23,15 +23,13 @@ Helium Antlib SCM unittests. - + + - - - - + diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/helium-antlib/signaling/src/com/nokia/helium/signal/Notifier.java --- a/buildframework/helium/external/helium-antlib/signaling/src/com/nokia/helium/signal/Notifier.java Wed Oct 28 14:39:48 2009 +0000 +++ b/buildframework/helium/external/helium-antlib/signaling/src/com/nokia/helium/signal/Notifier.java Wed Dec 23 19:29:07 2009 +0200 @@ -38,11 +38,13 @@ /** * Sends the data to the requested sender list with specified notifier * - * @param senderList - * sends the data to the list of requested user. + * @param signalName is the name of the signal that has been raised. + * @param failStatus indicates whether to fail the build or not + * @param notifierInput contains signal notifier info + * @param message is the message from the signal that has been raised. */ void sendData(String signalName, boolean failStatus, - NotifierInput notifierInput); + NotifierInput notifierInput, String message ); /** * Sends the data to the requested sender list with specified notifier diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/helium-antlib/signaling/src/com/nokia/helium/signal/SignalStatusList.java --- a/buildframework/helium/external/helium-antlib/signaling/src/com/nokia/helium/signal/SignalStatusList.java Wed Oct 28 14:39:48 2009 +0000 +++ b/buildframework/helium/external/helium-antlib/signaling/src/com/nokia/helium/signal/SignalStatusList.java Wed Dec 23 19:29:07 2009 +0200 @@ -69,7 +69,7 @@ statusBuffer.append(signalStatus); statusBuffer.append("\n"); } - log.debug("SignalStatusList:getErrorMsg:msg:" + statusBuffer.toString()); + log.debug("getErrorMsg:msg:" + statusBuffer.toString()); return statusBuffer.toString(); } @@ -79,7 +79,7 @@ * @return true if any signal are pending. */ public boolean hasSignalInList() { - log.debug("SignalStatusList:hasDeferMsgInList:size:" + log.debug("asDeferMsgInList:size:" + signals.size()); return signals.size() > 0; } @@ -88,10 +88,10 @@ * Clear all deferred signals. */ public void clearStatusList() { - log.debug("SignalStatusList:clearStatusList:size1:" + log.debug("clearStatusList:size1:" + signals.size()); signals.clear(); - log.debug("SignalStatusList:clearStatusList:size2:" + log.debug("clearStatusList:size2:" + signals.size()); } diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/helium-antlib/signaling/src/com/nokia/helium/signal/ant/SignalList.java --- a/buildframework/helium/external/helium-antlib/signaling/src/com/nokia/helium/signal/ant/SignalList.java Wed Oct 28 14:39:48 2009 +0000 +++ b/buildframework/helium/external/helium-antlib/signaling/src/com/nokia/helium/signal/ant/SignalList.java Wed Dec 23 19:29:07 2009 +0200 @@ -147,8 +147,8 @@ return targetsMap.get(targetName); } - protected void sendNotifications(Vector notifierList, String signalName) { - sendNotifications(notifierList, signalName, false, null); + protected void sendNotifications(Vector notifierList, String signalName, String errorMessage ) { + sendNotifications( notifierList, signalName, false, null, errorMessage ); } public void processForSignal(Project prj, SignalNotifierInput signalNotifierInput, String signalName, String targetName, @@ -165,7 +165,7 @@ } NotifierInput notifierInput = signalNotifierInput.getNotifierInput(); sendNotifications(notifierList, signalName, failBuild, - notifierInput); + notifierInput, errorMessage ); if (failBuild) { String failStatus = "now"; if (signalInput != null) { @@ -174,17 +174,17 @@ log.debug("Could not find config for signal: " + signalName); } if (failStatus == null || failStatus.equals("now")) { + log.debug("Adding now signal. Signal name is " + signalName); SignalStatusList.getNowSignalList().addSignalStatus(new SignalStatus(signalName, errorMessage, targetName, new Date())); throw new BuildException(new SignalStatus(signalName, errorMessage, targetName, new Date()).toString()); } else if (failStatus.equals("defer")) { - log.debug("SignalList:adding defer signal:"); - log.info("Signal " + signalName + " will be deferred."); + log.debug("Adding deffer signal. Signal " + signalName + " will be deferred."); SignalStatusList.getDeferredSignalList().addSignalStatus(new SignalStatus( signalName, errorMessage, targetName, new Date())); } else if (failStatus.equals("never")) { - log.debug("SignalList:adding never signal:"); + log.debug("Adding never signal. Signal name is " + signalName); SignalStatusList.getNeverSignalList().addSignalStatus(new SignalStatus(signalName, errorMessage, targetName, new Date())); } else if (!failStatus.equals("never")) { @@ -204,13 +204,13 @@ * @param notifierList */ protected void sendNotifications(Vector notifierList, String signalName, - boolean failStatus, NotifierInput notifierInput) { + boolean failStatus, NotifierInput notifierInput, String errorMessage ) { if (notifierList == null) { return; } for (Notifier notifier : notifierList) { if (notifier != null) { - notifier.sendData(signalName, failStatus, notifierInput); + notifier.sendData(signalName, failStatus, notifierInput, errorMessage ); } } } @@ -241,7 +241,7 @@ } processForSignal(prj, config.getSignalNotifierInput(), signalName, targetName, errorMessage, condition != null); - log.debug("SignalList:fail:signalName: " + signalName); + log.debug("checkAndNotifyFailure: SignalName: " + signalName); } } return retValue; @@ -251,7 +251,7 @@ Condition retCondition = null; Vector conditionList = targetCondition.getConditions(); for (Condition condition : conditionList) { - log.debug("SignalList:getErrorMessage:" + condition.eval()); + log.debug("getFailureCondition:" + condition.eval()); if (condition.eval()) { retCondition = condition; break; @@ -346,17 +346,17 @@ } log.debug("failStatus: " + failStatus); if (failStatus == null || failStatus.equals("now")) { + log.debug("Adding now signal. Signal name is " + signalName); SignalStatusList.getNowSignalList().addSignalStatus(new SignalStatus(signalName, errorMessage, targetName, new Date())); throw new BuildException(new SignalStatus(signalName, errorMessage, targetName, new Date()).toString()); } else if (failStatus.equals("defer")) { - log.debug("SignalList1:adding defer signal:"); - log.info("Signal " + signalName + " will be deferred."); + log.debug("Adding deffer signal. Signal name is " + signalName); SignalStatusList.getDeferredSignalList().addSignalStatus(new SignalStatus( signalName, errorMessage, targetName, new Date())); } else if (failStatus.equals("never")) { - log.debug("SignalList1:adding never signal:"); + log.debug("Adding never signal. Signal name is " + signalName); SignalStatusList.getNeverSignalList().addSignalStatus(new SignalStatus(signalName, errorMessage, targetName, new Date())); } else if (!failStatus.equals("never")) { @@ -365,7 +365,7 @@ throw new BuildException(new SignalStatus(signalName, errorMessage, targetName, new Date()).toString()); } else { - log.info("Signal " + signalName + log.debug("Signal " + signalName + " set to be ignored by the configuration."); } } @@ -396,7 +396,7 @@ if (configCurrent != null && configCurrent instanceof SignalConfig) { signalName = refid; } - log.debug("SignalList:fail:signalName: " + signalName); + log.debug("checkAndNotify:signalName: " + signalName); notifierList = config.getSignalInput().getSignalNotifierList(); if (notifierList == null) { Object obj = (Object) prj @@ -407,24 +407,24 @@ } } failStatus = config.getSignalInput().getFailBuild(); - log.debug("SignalList:failStatus:" + failStatus); + log.debug("checkAndNotify:failStatus:" + failStatus); buildFailed = condition != null; sendNotify(notifierList, signalName, buildFailed, fileList); } if (buildFailed) { if (failStatus == null || failStatus.equals("now")) { + log.debug("Adding now signal. Signal name is " + signalName); SignalStatusList.getNowSignalList().addSignalStatus(new SignalStatus(signalName, errorMessage, targetName, new Date())); throw new BuildException(new SignalStatus(signalName, errorMessage, targetName, new Date()).toString()); } else if (failStatus.equals("defer")) { - log.debug("SignalList1:adding defer signal:"); - log.info("Signal " + signalName + " will be deferred."); + log.debug("Signal " + signalName + " will be deferred."); SignalStatusList.getDeferredSignalList().addSignalStatus(new SignalStatus( signalName, errorMessage, targetName, new Date())); } else if (failStatus.equals("never")) { - log.debug("SignalList1:adding never signal:"); + log.debug("Adding never signal. Signal name is " + signalName); SignalStatusList.getNeverSignalList().addSignalStatus(new SignalStatus(signalName, errorMessage, targetName, new Date())); } else if (!failStatus.equals("never")) { @@ -433,7 +433,7 @@ throw new BuildException(new SignalStatus(signalName, errorMessage, targetName, new Date()).toString()); } else { - log.info("Signal " + signalName + log.debug("Signal " + signalName + " set to be ignored by the configuration."); } } diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/helium-antlib/signaling/src/com/nokia/helium/signal/ant/SignalListener.java --- a/buildframework/helium/external/helium-antlib/signaling/src/com/nokia/helium/signal/ant/SignalListener.java Wed Oct 28 14:39:48 2009 +0000 +++ b/buildframework/helium/external/helium-antlib/signaling/src/com/nokia/helium/signal/ant/SignalListener.java Wed Dec 23 19:29:07 2009 +0200 @@ -88,8 +88,7 @@ signalList.checkAndNotifyFailure(event.getTarget(),event.getProject()); //} } catch (Exception e) { - log.debug("SignalListenerException: ", e); - throw new BuildException(e.getMessage()); + throw new BuildException(e.getMessage(), e); } } diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/helium-antlib/signaling/src/com/nokia/helium/signal/ant/types/EMAILNotifier.java --- a/buildframework/helium/external/helium-antlib/signaling/src/com/nokia/helium/signal/ant/types/EMAILNotifier.java Wed Oct 28 14:39:48 2009 +0000 +++ b/buildframework/helium/external/helium-antlib/signaling/src/com/nokia/helium/signal/ant/types/EMAILNotifier.java Wed Dec 23 19:29:07 2009 +0200 @@ -151,13 +151,15 @@ /** * Rendering the template, and sending the result through email. * - * @param signalName - * - Name of the signal that has been raised. + * @param signalName - is the name of the signal that has been raised. + * @param failStatus - indicates whether to fail the build or not + * @param notifierInput - contains signal notifier info + * @param message - is the message from the signal that has been raised. */ @SuppressWarnings("unchecked") public void sendData(String signalName, boolean failStatus, - NotifierInput notifierInput) { + NotifierInput notifierInput, String message ) { if (notifyWhen != null && (notifyWhen.equals("always") || (notifyWhen.equals("fail") && failStatus) || (notifyWhen.equals("pass") && !failStatus))) { @@ -175,36 +177,43 @@ throw new HlmAntLibException(SignalListener.MODULE_NAME, "ldap attribute has not been defined."); } + + String smtpUpdated = getProject().replaceProperties(smtp); + String ldapUpdated = getProject().replaceProperties(ldap); + String rootdnUpdated = getProject().replaceProperties(rootdn); + String additionalRecipientsUpdated = getProject().replaceProperties(additionalRecipients); + log.debug("Sending data by e-mail."); EmailDataSender emailSender; - if (rootdn != null) + if (rootdnUpdated != null) { String[] to = null; - if (additionalRecipients != null) + if (additionalRecipientsUpdated != null) { - to = additionalRecipients.split(","); + to = additionalRecipientsUpdated.split(","); } - emailSender = new EmailDataSender(to, smtp, ldap, rootdn); + emailSender = new EmailDataSender(to, smtpUpdated, ldapUpdated, rootdnUpdated); } else { emailSender = new EmailDataSender( - additionalRecipients, smtp, ldap); + additionalRecipientsUpdated, smtpUpdated, ldapUpdated); } if (from != null) { emailSender.setFrom(from); } - log.debug("EmailNotifier:arlist: " + additionalRecipients); + log.debug("EmailNotifier:arlist: " + additionalRecipientsUpdated); Project subProject = getProject().createSubProject(); subProject.setProperty("signal.name", signalName); subProject.setProperty("signal.status", "" + failStatus); + subProject.setProperty("signal.message", "" + message); emailSender.addCurrentUserToAddressList(); String filePath = ""; File fileToSend = null; if (notifierInput != null) { - fileToSend = notifierInput.getFile(".html"); + fileToSend = notifierInput.getFile(".*.html"); if (fileToSend != null) { filePath = fileToSend.toString(); } @@ -224,6 +233,7 @@ Hashtable signalProperties = new Hashtable(); signalProperties.put("signal.name", signalName); signalProperties.put("signal.status", "" + failStatus); + signalProperties.put("signal.message", "" + message); sourceList.add(new PropertiesSource("signaling", signalProperties)); @@ -319,4 +329,4 @@ this.rootdn = rootdn; } -} \ No newline at end of file +} diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/helium-antlib/signaling/src/com/nokia/helium/signal/ant/types/ExecuteTaskNotifier.java --- a/buildframework/helium/external/helium-antlib/signaling/src/com/nokia/helium/signal/ant/types/ExecuteTaskNotifier.java Wed Oct 28 14:39:48 2009 +0000 +++ b/buildframework/helium/external/helium-antlib/signaling/src/com/nokia/helium/signal/ant/types/ExecuteTaskNotifier.java Wed Dec 23 19:29:07 2009 +0200 @@ -19,15 +19,17 @@ package com.nokia.helium.signal.ant.types; import java.util.ArrayList; +import java.util.List; import java.util.Vector; -import java.util.List; + import org.apache.log4j.Logger; import org.apache.tools.ant.BuildException; +import org.apache.tools.ant.BuildListener; import org.apache.tools.ant.Project; import org.apache.tools.ant.Task; -import org.apache.tools.ant.BuildListener; import org.apache.tools.ant.TaskContainer; import org.apache.tools.ant.types.DataType; + import com.nokia.helium.signal.Notifier; /** @@ -57,9 +59,17 @@ private Logger log = Logger.getLogger(ExecuteTaskNotifier.class); private List tasks = new ArrayList(); + /** + * Method executes a series of given tasks on raising of the specified signal. + * + * @param signalName is the name of the signal that has been raised. + * @param failStatus indicates whether to fail the build or not + * @param notifierInput contains signal notifier info + * @param message is the message from the signal that has been raised. + */ @SuppressWarnings("unchecked") public void sendData(String signalName, boolean failStatus, - NotifierInput notifierInput) { + NotifierInput notifierInput, String message ) { try { // Configure the project Project prj = getProject().createSubProject(); @@ -73,6 +83,7 @@ prj.setProperty("signal.name", signalName); prj.setProperty("signal.status", "" + failStatus); + prj.setProperty("signal.message", message ); // Converting the list of inputs into a string. String inputs = ""; if (notifierInput != null) { @@ -85,7 +96,8 @@ task.perform(); } } catch (BuildException e) { - log.debug(e); + // We are Ignoring the errors as no need to fail the build. + log.debug(e.toString(), e); } } diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/helium-antlib/signaling/src/com/nokia/helium/signal/ant/types/LogSourceList.java --- a/buildframework/helium/external/helium-antlib/signaling/src/com/nokia/helium/signal/ant/types/LogSourceList.java Wed Oct 28 14:39:48 2009 +0000 +++ b/buildframework/helium/external/helium-antlib/signaling/src/com/nokia/helium/signal/ant/types/LogSourceList.java Wed Dec 23 19:29:07 2009 +0200 @@ -20,9 +20,7 @@ import org.apache.tools.ant.types.DataType; import com.nokia.helium.core.LogSource; - -import com.nokia.helium.core.HlmAntLibException; -import com.nokia.helium.signal.ant.SignalListener; +import org.apache.tools.ant.BuildException; import java.util.Vector; @@ -67,7 +65,7 @@ */ public Vector getLogSourceList() { if (sourceList.isEmpty()) { - throw new HlmAntLibException(SignalListener.MODULE_NAME, "notifierlist is empty."); + throw new BuildException("Signal notifierlist is empty."); } return sourceList; } diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/helium-antlib/signaling/src/com/nokia/helium/signal/ant/types/NotifierInput.java --- a/buildframework/helium/external/helium-antlib/signaling/src/com/nokia/helium/signal/ant/types/NotifierInput.java Wed Oct 28 14:39:48 2009 +0000 +++ b/buildframework/helium/external/helium-antlib/signaling/src/com/nokia/helium/signal/ant/types/NotifierInput.java Wed Dec 23 19:29:07 2009 +0200 @@ -20,6 +20,8 @@ import java.io.File; +import java.util.List; +import java.util.ArrayList; import java.util.Vector; import org.apache.tools.ant.types.DataType; import org.apache.tools.ant.types.FileSet; @@ -55,29 +57,50 @@ } /** - * Updates the list of filelist from the input fileset. - * @param fileSetList input fileset list + * Return a file from the input fileset. + * @param pattern pattern to match from the input fileset * @return the matched files including the base dir. */ public File getFile(String pattern) { + File fileToReturn = null; if (file != null) { - return file; + if (file.toString().matches(pattern)) { + fileToReturn = file; + } + return fileToReturn; } - File fileFromList = null; for (FileSet fs : fileSetList) { DirectoryScanner ds = fs.getDirectoryScanner(getProject()); String[] includedFiles = ds.getIncludedFiles(); for ( String filePath : includedFiles ) { if (filePath.matches(pattern)) { - fileFromList = new File(ds.getBasedir(), filePath); - log.debug("matched file for pattern: " + pattern + ":" + fileFromList); + fileToReturn = new File(ds.getBasedir(), filePath); + log.debug("matched file for pattern: " + pattern + ":" + fileToReturn); break; } } } - return fileFromList; + return fileToReturn; } + /** + * Returns the list of filelist from the input fileset. + * @param pattern pattern to match from the input fileset + * @return the matched files including the base dir. + */ + public List getFileList(String pattern) { + List fileList = new ArrayList(); + for (FileSet fs : fileSetList) { + DirectoryScanner ds = fs.getDirectoryScanner(getProject()); + String[] includedFiles = ds.getIncludedFiles(); + for ( String filePath : includedFiles ) { + if (filePath.matches(pattern)) { + fileList.add(new File(ds.getBasedir(), filePath)); + } + } + } + return fileList; + } /** * Helper function called by ant to set the input file. diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/helium-antlib/signaling/src/com/nokia/helium/signal/ant/types/SMSNotifier.java --- a/buildframework/helium/external/helium-antlib/signaling/src/com/nokia/helium/signal/ant/types/SMSNotifier.java Wed Oct 28 14:39:48 2009 +0000 +++ b/buildframework/helium/external/helium-antlib/signaling/src/com/nokia/helium/signal/ant/types/SMSNotifier.java Wed Dec 23 19:29:07 2009 +0200 @@ -29,10 +29,14 @@ } /** * Sends the data to the requested sender list with specified notifier - * @param senderList sends the data to the list of requested user. + * + * @param signalName is the name of the signal that has been raised. + * @param failStatus indicates whether to fail the build or not + * @param notifierInput contains signal notifier info + * @param message is the message from the signal that has been raised. */ public void sendData(String signalName, boolean failStatus, - NotifierInput notifierInput) { + NotifierInput notifierInput, String message ) { } /** diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/helium-antlib/signaling/src/com/nokia/helium/signal/ant/types/SignalConfig.java --- a/buildframework/helium/external/helium-antlib/signaling/src/com/nokia/helium/signal/ant/types/SignalConfig.java Wed Oct 28 14:39:48 2009 +0000 +++ b/buildframework/helium/external/helium-antlib/signaling/src/com/nokia/helium/signal/ant/types/SignalConfig.java Wed Dec 23 19:29:07 2009 +0200 @@ -48,6 +48,8 @@ public class SignalConfig extends DataType { + private static boolean warningPrinted; + private Vector signalInputListRef = new Vector(); private HashMap targetConditionsMap = new HashMap(); private Vector targetConditions = new Vector(); @@ -55,15 +57,19 @@ private Vector sourceList = new Vector(); private String configID; - + + /** * {@inheritDoc} */ public void setProject(Project project) { super.setProject(project); - getProject().log("signalConfig element is now deprecated. Please consider moving to signalListenerConfig element or" + + if (!warningPrinted) { + getProject().log("signalConfig element is now deprecated. Please consider moving to signalListenerConfig element or" + " signal task nested element.", Project.MSG_WARN); + warningPrinted = true; + } } /** diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/helium-antlib/signaling/src/com/nokia/helium/signal/ant/types/SignalExceptionHandler.java --- a/buildframework/helium/external/helium-antlib/signaling/src/com/nokia/helium/signal/ant/types/SignalExceptionHandler.java Wed Oct 28 14:39:48 2009 +0000 +++ b/buildframework/helium/external/helium-antlib/signaling/src/com/nokia/helium/signal/ant/types/SignalExceptionHandler.java Wed Dec 23 19:29:07 2009 +0200 @@ -17,9 +17,8 @@ package com.nokia.helium.signal.ant.types; - +import net.sf.antcontrib.logic.RunTargetTask; import org.apache.tools.ant.Project; -import org.apache.tools.ant.types.Reference; import com.nokia.helium.core.ant.HlmExceptionHandler; import com.nokia.helium.signal.ant.taskdefs.*; import com.nokia.helium.signal.ant.SignalListener; @@ -38,19 +37,12 @@ * @throws BuildException */ public void handleException(Project project, String module, Exception e) { - log.debug("SignalExceptionHandler:handleException: start"); - String refId = project.getProperty("signals.buildexception.signalinput"); - if (refId != null) { - Signal signal = new Signal(); - SignalNotifierInput signalNotifierInput = new SignalNotifierInput(); - signal.add(signalNotifierInput); - Reference ref = new Reference(project, refId); - SignalInput signalInput = signalNotifierInput.createSignalInput(); - signalInput.setRefid(ref); - signal.setProject(project); - signal.setName("buildExceptionSignal"); - signal.setMessage(e.getMessage()); - signal.execute(); + String exceptionTarget = project.getProperty("exceptions.target"); + if (exceptionTarget != null) { + RunTargetTask runTargetTask = new RunTargetTask(); + runTargetTask.setProject(project); + runTargetTask.setTarget(exceptionTarget); + runTargetTask.execute(); } - } + } } \ No newline at end of file diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/helium-antlib/signaling/src/com/nokia/helium/signal/ant/types/SignalInput.java --- a/buildframework/helium/external/helium-antlib/signaling/src/com/nokia/helium/signal/ant/types/SignalInput.java Wed Oct 28 14:39:48 2009 +0000 +++ b/buildframework/helium/external/helium-antlib/signaling/src/com/nokia/helium/signal/ant/types/SignalInput.java Wed Dec 23 19:29:07 2009 +0200 @@ -22,13 +22,12 @@ import java.util.Vector; import org.apache.tools.ant.types.DataType; - -import com.nokia.helium.core.HlmAntLibException; import com.nokia.helium.core.ant.types.ReferenceType; import org.apache.log4j.Logger; import com.nokia.helium.signal.Notifier; -import com.nokia.helium.signal.ant.SignalListener; + +import org.apache.tools.ant.BuildException; /** * SignalInput class which is a type to store input for signals @@ -131,6 +130,6 @@ } return notifierList; } - throw new HlmAntLibException(SignalListener.MODULE_NAME, "No notifierlist reference"); + throw new BuildException("No signal notifierlist reference defined."); } } \ No newline at end of file diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/helium-antlib/signaling/src/com/nokia/helium/signal/ant/types/SignalNotifierInput.java --- a/buildframework/helium/external/helium-antlib/signaling/src/com/nokia/helium/signal/ant/types/SignalNotifierInput.java Wed Oct 28 14:39:48 2009 +0000 +++ b/buildframework/helium/external/helium-antlib/signaling/src/com/nokia/helium/signal/ant/types/SignalNotifierInput.java Wed Dec 23 19:29:07 2009 +0200 @@ -23,8 +23,6 @@ import org.apache.tools.ant.types.DataType; -import org.apache.log4j.Logger; - import org.apache.tools.ant.BuildException; @@ -42,8 +40,6 @@ private Vector notifierInputList = new Vector(); - private Logger log = Logger.getLogger(SignalInput.class); - /** * Helper function called by ant to create a new notifier for * this input. diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/helium-antlib/signaling/src/com/nokia/helium/signal/ant/types/SignalNotifierList.java --- a/buildframework/helium/external/helium-antlib/signaling/src/com/nokia/helium/signal/ant/types/SignalNotifierList.java Wed Oct 28 14:39:48 2009 +0000 +++ b/buildframework/helium/external/helium-antlib/signaling/src/com/nokia/helium/signal/ant/types/SignalNotifierList.java Wed Dec 23 19:29:07 2009 +0200 @@ -19,10 +19,9 @@ package com.nokia.helium.signal.ant.types; import org.apache.tools.ant.types.DataType; +import org.apache.tools.ant.BuildException; +import com.nokia.helium.signal.Notifier; -import com.nokia.helium.core.HlmAntLibException; -import com.nokia.helium.signal.Notifier; -import com.nokia.helium.signal.ant.SignalListener; import java.util.Vector; @@ -59,7 +58,7 @@ */ public Vector getNotifierList() { if (notifierlist.isEmpty()) { - throw new HlmAntLibException(SignalListener.MODULE_NAME, "notifierlist is empty."); + throw new BuildException(" Signal notifierlist is empty."); } return notifierlist; } diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/helium-antlib/signaling/src/com/nokia/helium/signal/ant/types/SignalStatusDef.java --- a/buildframework/helium/external/helium-antlib/signaling/src/com/nokia/helium/signal/ant/types/SignalStatusDef.java Wed Oct 28 14:39:48 2009 +0000 +++ b/buildframework/helium/external/helium-antlib/signaling/src/com/nokia/helium/signal/ant/types/SignalStatusDef.java Wed Dec 23 19:29:07 2009 +0200 @@ -38,9 +38,7 @@ * @throws BuildException */ public void execute(Project prj, String module, String[] targetNames) { - log.debug("SignalStatusDef:execute:"); if (SignalStatusList.getDeferredSignalList().hasSignalInList()) { - log.debug("SignalStatusDef:execute: Error message: " + SignalStatusList.getDeferredSignalList().getErrorMsg()); throw new BuildException(SignalStatusList.getDeferredSignalList().getErrorMsg()); } } diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/helium-antlib/signaling/tests/build.xml --- a/buildframework/helium/external/helium-antlib/signaling/tests/build.xml Wed Oct 28 14:39:48 2009 +0000 +++ b/buildframework/helium/external/helium-antlib/signaling/tests/build.xml Wed Dec 23 19:29:07 2009 +0200 @@ -22,16 +22,14 @@ --> Helium Antlib signaling tests. + - - - - + @@ -40,13 +38,7 @@ - - - - - - - + diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/helium-antlib/signaling/tests/src/com/nokia/helium/signaling/tests/TestEmailSender.java --- a/buildframework/helium/external/helium-antlib/signaling/tests/src/com/nokia/helium/signaling/tests/TestEmailSender.java Wed Oct 28 14:39:48 2009 +0000 +++ b/buildframework/helium/external/helium-antlib/signaling/tests/src/com/nokia/helium/signaling/tests/TestEmailSender.java Wed Dec 23 19:29:07 2009 +0200 @@ -49,7 +49,7 @@ en.setLdap("test"); NotifierInput input = new NotifierInput(); input.setFile(new File(System.getProperty("testdir") + "/tests/test_signal/data/test.log_status.html")); - en.sendData("test", true, input); + en.sendData("test", true, input, "Test Message"); } diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/helium-antlib/signaling/tests/test_signal/signaling_test.ant.xml --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/helium-antlib/signaling/tests/test_signal/signaling_test.ant.xml Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,272 @@ + + + + + Test all the helium signals + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/helium-antlib/signaling/tests/test_signal/test_signaling.ant.xml --- a/buildframework/helium/external/helium-antlib/signaling/tests/test_signal/test_signaling.ant.xml Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,262 +0,0 @@ - - - - - Test all the helium signals - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/helium-antlib/sysdef/bld.bat --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/helium-antlib/sysdef/bld.bat Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,60 @@ +@echo off + +rem +rem Copyright (c) 2009 Nokia Corporation and/or its subsidiary(-ies). +rem All rights reserved. +rem This component and the accompanying materials are made available +rem under the terms of the License "Eclipse Public License v1.0" +rem which accompanies this distribution, and is available +rem at the URL "http://www.eclipse.org/legal/epl-v10.html". +rem +rem Initial Contributors: +rem Nokia Corporation - initial contribution. +rem +rem Contributors: +rem +rem Description: +rem + +setlocal +if not defined JAVA_6_HOME ( +set TESTED_JAVA=C:\Apps\j2sdk_1.6.0_02 +) ELSE set TESTED_JAVA=%JAVA_6_HOME% +if exist %TESTED_JAVA% (set JAVA_HOME=%TESTED_JAVA%) + +REM Configure Ant +if not defined TESTED_ANT_HOME ( +set TESTED_ANT_HOME=C:\Apps\ant_1.7 +) +if exist %TESTED_ANT_HOME% (set ANT_HOME=%TESTED_ANT_HOME%) + +REM Configure the expected Ant Version details below +SET expMajorVer=1 +SET expMinorVer=7 + +rem *** Verify Ant Version *** +rem -- Run the 'ant -version' command and capture the output to a variable +for /f "tokens=*" %%a in ('ant -version') do (set antversion=%%a) +echo *** Installed Version : %antversion% + +rem -- Parse the version string obtained above and get the version number +for /f "tokens=4 delims= " %%a in ("%antversion%") do set val=%%a +rem -- Parse the version number delimiting the '.' and set the major and +rem minor versions +for /f "tokens=1-2 delims=." %%a in ("%val%") do ( +set /A majorVersion=%%a +set /A minorVersion=%%b +) +rem -- Check whether major version is greater than or equal to the expected. +if %majorVersion% geq %expMajorVer% ( +rem -- if major version is valid, check minor version. If minor version is less +rem than expected display message and abort the execution. +if %minorVersion% lss %expMinorVer% (echo *** Incorrect version of Ant found. Please check you have atleast Ant 1.7.0 & goto :errorstop ) +) + +ant %* +endlocal + +:errorstop +@echo *** Build aborted with error +exit /b 1 \ No newline at end of file diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/helium-antlib/sysdef/build.xml --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/helium-antlib/sysdef/build.xml Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,36 @@ + + + + Helium Antlib Sydef. + + + + + + + + + + + + diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/helium-antlib/sysdef/demo/build.bat --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/helium-antlib/sysdef/demo/build.bat Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,27 @@ +@echo off + +rem +rem Copyright (c) 2009 Nokia Corporation and/or its subsidiary(-ies). +rem All rights reserved. +rem This component and the accompanying materials are made available +rem under the terms of the License "Eclipse Public License v1.0" +rem which accompanies this distribution, and is available +rem at the URL "http://www.eclipse.org/legal/epl-v10.html". +rem +rem Initial Contributors: +rem Nokia Corporation - initial contribution. +rem +rem Contributors: +rem +rem Description: +rem + +setlocal +if not defined JAVA_6_HOME ( +set TESTED_JAVA=C:\Apps\j2sdk_1.6.0_02 +) ELSE set TESTED_JAVA=%JAVA_6_HOME% +if exist %TESTED_JAVA% (set JAVA_HOME=%TESTED_JAVA%) +set ANT_ARGS=-lib %CD%\..\lib -lib %CD%\..\..\bin\helium-sysdef.jar -lib %CD%\..\..\antlibs +ant %* +endlocal + diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/helium-antlib/sysdef/demo/build.xml --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/helium-antlib/sysdef/demo/build.xml Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,36 @@ + + + + Helium Antlib sysdef demo. + + + + + + + + + + + + diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/helium-antlib/sysdef/demo/data/layer1/package1/package_definition.xml --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/helium-antlib/sysdef/demo/data/layer1/package1/package_definition.xml Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,31 @@ + + + + + + + + + + + diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/helium-antlib/sysdef/demo/data/layer1/package2/package_definition.xml --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/helium-antlib/sysdef/demo/data/layer1/package2/package_definition.xml Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,31 @@ + + + + + + + + + + + diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/helium-antlib/sysdef/demo/data/layer2/package3/package_definition.xml --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/helium-antlib/sysdef/demo/data/layer2/package3/package_definition.xml Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,31 @@ + + + + + + + + + + + diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/helium-antlib/sysdef/demo/data/layer2/package4/package_definition.xml --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/helium-antlib/sysdef/demo/data/layer2/package4/package_definition.xml Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,31 @@ + + + + + + + + + + + diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/helium-antlib/sysdef/demo/data/layer3/package5/package_definition.xml --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/helium-antlib/sysdef/demo/data/layer3/package5/package_definition.xml Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,32 @@ + + + + + + + + + + + + diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/helium-antlib/sysdef/demo/data/root/system_definition_layer1.xml --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/helium-antlib/sysdef/demo/data/root/system_definition_layer1.xml Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,131 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +]> + + + + + + + + diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/helium-antlib/sysdef/demo/data/root/system_definition_layer2.xml --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/helium-antlib/sysdef/demo/data/root/system_definition_layer2.xml Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,129 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +]> + + + + + + + + diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/helium-antlib/sysdef/demo/data/root/system_definition_layer3.xml --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/helium-antlib/sysdef/demo/data/root/system_definition_layer3.xml Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,128 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +]> + + + + + + + diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/helium-antlib/sysdef/demo/data/root/system_model.xml --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/helium-antlib/sysdef/demo/data/root/system_model.xml Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,129 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +]> + + + + + + + + \ No newline at end of file diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/helium-antlib/sysdef/demo/data/sf/os/buildtools/bldsystemtools/buildsystemtools/filter-module.xsl --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/helium-antlib/sysdef/demo/data/sf/os/buildtools/bldsystemtools/buildsystemtools/filter-module.xsl Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,110 @@ + + + + + + + + + + + + + + + + + + + + + + x + + + hide + + + + + + + + + + + + + + + + + + + + + + x + x + + + + hide + + + + + + + + + + + + + + + + x + + + hide + + + + + + + + + + + + + + + + + + + + + + +

+ + + + + +

+ + + + + \ No newline at end of file diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/helium-antlib/sysdef/demo/data/sf/os/buildtools/bldsystemtools/buildsystemtools/filtersysdef.xsl --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/helium-antlib/sysdef/demo/data/sf/os/buildtools/bldsystemtools/buildsystemtools/filtersysdef.xsl Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,40 @@ + + + + + + +/os/deviceplatformrelease/foundation_system/system_model/system_definition.xml + +only + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + \ No newline at end of file diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/helium-antlib/sysdef/demo/data/sf/os/buildtools/bldsystemtools/buildsystemtools/joinsysdef-module.xsl --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/helium-antlib/sysdef/demo/data/sf/os/buildtools/bldsystemtools/buildsystemtools/joinsysdef-module.xsl Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,402 @@ + + + + + http://www.symbian.org/system-definition + + + + + Cannot process this document + + + + + + + + + + + +

+ + Linked ID "" () must match linking document "" () + + + + + + + + Cannot set "", already set + + + + + + + +

+ + + + + + + + + + + + + + + + + + + + + +

+ + + + + + + + + + +

+ + + +

+ + + + + +

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz + + + + + + + Cannot create namespace prefix for downstream default namespace + +

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + / + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Could not find namespace for + + + + + + + + + + + + + + + + Error + + + + + + + + +

+ + + + + + + + + + + + + + + + + + + + + + + + / + + + + + + + + + + + + + + + + + + + ../ + + + + + + + + + + + / + + + + +

+ + + + + + + + + + + + + + + / + + + + +

+ + + + + diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/helium-antlib/sysdef/demo/data/sf/os/buildtools/bldsystemtools/buildsystemtools/joinsysdef.xsl --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/helium-antlib/sysdef/demo/data/sf/os/buildtools/bldsystemtools/buildsystemtools/joinsysdef.xsl Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,45 @@ + + + + + + +/os/deviceplatformrelease/foundation_system/system_model/system_definition.xml + + + + + + + + + + + + + + + + + + diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/helium-antlib/sysdef/demo/data/sf/os/buildtools/bldsystemtools/buildsystemtools/mergesysdef-module.xsl --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/helium-antlib/sysdef/demo/data/sf/os/buildtools/bldsystemtools/buildsystemtools/mergesysdef-module.xsl Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,513 @@ + + + + +http://www.symbian.org/system-definition + + + Syntax not supported + + + Can only merge stand-alone system models + + + + + +

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + "" for + + + + + + + + + + + ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz + + + + + + + Cannot create namespace prefix for downstream default namespace + +

+ + + + + + + + + + + + + + + + + + + + + + Syntax not supported + + + Can only merge stand-alone system models + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

+ + + + + + + +

+ + +

+ + + + + + + + + + + + +

+ + + + + + + + + + + + + + + +

+ + + Note: levels differ "" vs "" + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Warning: "" moved in downstream model. Ignoring moved + + + + + + + + + + + + + + + Warning: All content in downstream "" is invalid. Ignoring + + + + + + + + + +

+ + + + + + + + + + + + + + + + + + + + + + + Warning: "" moved in downstream model. Ignoring moved + + + + + + + + + +

+ + + + + + + + + + + + + + + + diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/helium-antlib/sysdef/demo/data/sf/os/buildtools/bldsystemtools/buildsystemtools/mergesysdef.xsl --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/helium-antlib/sysdef/demo/data/sf/os/buildtools/bldsystemtools/buildsystemtools/mergesysdef.xsl Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,107 @@ + + + + mcl/System_Definition_Template.xml + + + + + + + + + Syntax not supported + + + + Upstream + + +

+ + + + + + + + Downstream + + +

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/helium-antlib/sysdef/demo/data/sf/os/buildtools/bldsystemtools/buildsystemtools/sysdefdowngrade.xsl --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/helium-antlib/sysdef/demo/data/sf/os/buildtools/bldsystemtools/buildsystemtools/sysdefdowngrade.xsl Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,397 @@ + + + + + + os/deviceplatformrelease/foundation_system/system_model + + + + + + + Cannot process this document + + + + + + + + + + + + + + + + + + + + Package definition cannot link another package + + + + + + + + + + + + + + + + + + +

+ + + + + + + + + + + + + + + +

+ + + + +

+ + + + + + + + + + + + + + + + + + + + +

+ + Error: IDs do not match: vs + + + +

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Excessive nesting of packages: Ignoring + + + + + + + + + + + + + + + + + + + + + Y + + + plugin + + placeholder + PC + + + + + + + + + + + + + + + + + + + + + + + Y + N + + + + + + + + + +

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

+ + + + + + + + + +

+ + + + + + + + + + +

+ +

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

+ + + + + + + /

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +]> +]]> + + diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/helium-antlib/sysdef/lib/serializer.jar Binary file buildframework/helium/external/helium-antlib/sysdef/lib/serializer.jar has changed diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/helium-antlib/sysdef/lib/xalan.jar Binary file buildframework/helium/external/helium-antlib/sysdef/lib/xalan.jar has changed diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/helium-antlib/sysdef/src/com/nokia/helium/sysdef/ant/antlib.xml --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/helium-antlib/sysdef/src/com/nokia/helium/sysdef/ant/antlib.xml Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,30 @@ + + + + + + + + + + diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/helium-antlib/sysdef/src/com/nokia/helium/sysdef/ant/helium.antlib.xml --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/helium-antlib/sysdef/src/com/nokia/helium/sysdef/ant/helium.antlib.xml Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,28 @@ + + + + + Ant task definition declarations. + + + diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/helium-antlib/sysdef/src/com/nokia/helium/sysdef/ant/taskdefs/AbstractSydefTask.java --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/helium-antlib/sysdef/src/com/nokia/helium/sysdef/ant/taskdefs/AbstractSydefTask.java Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,237 @@ +/* +* Copyright (c) 2007-2008 Nokia Corporation and/or its subsidiary(-ies). +* All rights reserved. +* This component and the accompanying materials are made available +* under the terms of the License "Eclipse Public License v1.0" +* which accompanies this distribution, and is available +* at the URL "http://www.eclipse.org/legal/epl-v10.html". +* +* Initial Contributors: +* Nokia Corporation - initial contribution. +* +* Contributors: +* +* Description: +* +*/ +package com.nokia.helium.sysdef.ant.taskdefs; + +import java.io.File; +import java.io.FileOutputStream; +import java.io.IOException; +import java.util.Map; + +import javax.xml.transform.ErrorListener; +import javax.xml.transform.Transformer; +import javax.xml.transform.TransformerException; +import javax.xml.transform.TransformerFactory; +import javax.xml.transform.stream.StreamResult; +import javax.xml.transform.stream.StreamSource; + +import org.apache.tools.ant.BuildException; +import org.apache.tools.ant.Project; +import org.apache.tools.ant.Task; + +/** + * This is the base class for manipulating Sysdef v3 files using XML Stylesheet. + * The implementation/interface is not frozen yet. It is morelikely going to + * change in the future, depending of the underlaying implementation. + * + */ +public abstract class AbstractSydefTask extends Task implements ErrorListener { + + private File srcFile; + private File destFile; + private File epocroot; + private boolean failOnError = true; + + /** + * Get the source file. + * @return + */ + public File getSrcFile() { + return srcFile; + } + + /** + * Defines the location of the source system definition file. + * @param srcfile + * @ant.required + */ + public void setSrcFile(File srcfile) { + this.srcFile = srcfile; + } + + /** + * Get the location of the output file. + * @return + */ + public File getDestFile() { + return destFile; + } + + /** + * The the name of the destination file. + * @param destfile + * @ant.required + */ + public void setDestFile(File destfile) { + this.destFile = destfile; + } + + /** + * Get the epocroot. + * If epocroot is not set by the user it return the value from the EPOCROOT environment variable. + * If the EPOCROOT environment variable is not defined then a BuildException is thrown. + * @return the epocroot location as a File object. + */ + public File getEpocroot() { + if (epocroot == null) { + if (System.getenv("EPOCROOT") != null) { + return new File(System.getenv("EPOCROOT")); + } + else { + throw new BuildException("'epocroot' attribute has not been defined."); + } + } + return epocroot; + } + + /** + * Location of the EPOCROOT. + * @ant.not-required By default the EPOCROOT environment variable is used. + * @param epocroot path to the epocroot. + */ + public void setEpocroot(File epocroot) { + this.epocroot = epocroot; + } + + /** + * Shall we fail the build on error. + * @return is the task should failonerror. + */ + public boolean isFailOnError() { + return failOnError; + } + + /** + * Defines if the file should fail on error. + * @param failonerror + * @ant.not-required Default is true. + */ + public void setFailOnError(boolean failonerror) { + this.failOnError = failonerror; + } + + /** + * This method should be defined by the implementing class + * to define the location of the XSLT file. + * @return the XSLT file location. + */ + abstract File getXsl(); + + /** + * Check if required attribute have been configured correctly. + * If not the method will raise a BuildException. + */ + protected void check() { + if (srcFile == null) { + throw new BuildException("'srcfile' attribute is not defined"); + } + if (destFile == null) { + throw new BuildException("'destfile' attribute is not defined"); + } + File xslt = getXsl(); + if (!xslt.exists()) { + throw new BuildException("Could not find " + xslt); + } + if (!srcFile.exists()) { + throw new BuildException("Could not find source file " + srcFile); + } + } + + /** + * Transform the srcfile using the stylesheet provided by getXsl. The data parameters are + * passed to the template engine. The result is save to the destfile. + * + * @param data a set of key/value to pass to the XSLT engine. + */ + public void transform(Map data) { + check(); + if (destFile.exists()) { + log("Deleting previous output file: " + destFile, Project.MSG_DEBUG); + destFile.delete(); + } + + FileOutputStream output = null; + try { + output = new FileOutputStream(destFile); + TransformerFactory factory = TransformerFactory.newInstance(); + Transformer transformer = factory.newTransformer(new StreamSource(getXsl())); + + transformer.setParameter("path", srcFile); + for (Map.Entry entry : data.entrySet()) { + transformer.setParameter(entry.getKey(), entry.getValue()); + } + transformer.setErrorListener(this); + transformer.transform(new StreamSource(srcFile), new StreamResult( + output)); + + } catch (Exception exc) { + // deleting the intermediate file in case of error. + if (destFile.exists()) { + // closing current output stream, so we can delete the file + try { + if (output != null) { + output.close(); + } + } catch (IOException ioe) { + // we should just ignore that error. + log(ioe, Project.MSG_DEBUG); + } + log("Deleting " + destFile + " because an error occured.", Project.MSG_INFO); + destFile.delete(); + } + // Raising the error to Ant. + throw new BuildException(exc.toString()); + } + } + + /** + * {@inheritDoc} + * Reports errors to the Ant logging system of throw the exception if the task + * is set to failonerror. + */ + @Override + public void error(TransformerException message) throws TransformerException { + if (this.isFailOnError()) { + throw message; + } else { + log("ERROR: " + message.getMessageAndLocation(), Project.MSG_ERR); + } + } + + /** + * {@inheritDoc} + * Fails the task in case of fatal error. The is nothing we can do about that. + */ + @Override + public void fatalError(TransformerException message) throws TransformerException { + log("ERROR: " + message.getMessageAndLocation(), Project.MSG_ERR); + throw message; + } + + /** + * {@inheritDoc} + * Reports errors to the Ant logging system of throw the exception if the task + * is set to failonerror. + */ + @Override + public void warning(TransformerException message) throws TransformerException { + if (this.isFailOnError()) { + throw message; + } else { + log("WARNING: " + message.getMessageAndLocation(), Project.MSG_WARN); + } + } +} diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/helium-antlib/sysdef/src/com/nokia/helium/sysdef/ant/taskdefs/DowngradeTask.java --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/helium-antlib/sysdef/src/com/nokia/helium/sysdef/ant/taskdefs/DowngradeTask.java Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,59 @@ +/* +* Copyright (c) 2007-2008 Nokia Corporation and/or its subsidiary(-ies). +* All rights reserved. +* This component and the accompanying materials are made available +* under the terms of the License "Eclipse Public License v1.0" +* which accompanies this distribution, and is available +* at the URL "http://www.eclipse.org/legal/epl-v10.html". +* +* Initial Contributors: +* Nokia Corporation - initial contribution. +* +* Contributors: +* +* Description: +* +*/ +package com.nokia.helium.sysdef.ant.taskdefs; + +import java.io.File; +import java.util.Hashtable; + +/** + *

This task allows to downgrade of a system definition file v3.0 into v2.0.

+ * + *

The following example shows how you can downgrade the X:\model.sysdef.xml as + * X:\model_2_0_1.sysdef.xml.

+ * + * E.g: + *

+ *   <hlm:downgradeSysdef epocroot="X:\" srcfile="X:\model.sysdef.xml" 
+ *                      destfile="X:\model_2_0_1.sysdef.xml" />
+ *

+ * + * For more information about system definition file v3.0 please check + * http://developer.symbian.org/wiki/index.php/System_Definition. + * + * @ant.task name="downgradeSysdef" category="Sysdef" + */ +public class DowngradeTask extends AbstractSydefTask { + private static final String XSLT = "sf/os/buildtools/bldsystemtools/buildsystemtools/sysdefdowngrade.xsl"; + + /** + * {@inheritDoc} + */ + public void execute() { + check(); + log("Downgrading " + this.getSrcFile() + " to 2.0.1 schema."); + log("Creating " + this.getDestFile()); + transform(new Hashtable()); + } + + /** + * {@inheritDoc} + */ + @Override + protected File getXsl() { + return new File(this.getEpocroot(), XSLT); + } +} diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/helium-antlib/sysdef/src/com/nokia/helium/sysdef/ant/taskdefs/JoinTask.java --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/helium-antlib/sysdef/src/com/nokia/helium/sysdef/ant/taskdefs/JoinTask.java Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,62 @@ +/* +* Copyright (c) 2007-2008 Nokia Corporation and/or its subsidiary(-ies). +* All rights reserved. +* This component and the accompanying materials are made available +* under the terms of the License "Eclipse Public License v1.0" +* which accompanies this distribution, and is available +* at the URL "http://www.eclipse.org/legal/epl-v10.html". +* +* Initial Contributors: +* Nokia Corporation - initial contribution. +* +* Contributors: +* +* Description: +* +*/ +package com.nokia.helium.sysdef.ant.taskdefs; + +import java.io.File; +import java.util.Hashtable; + +/** + *

This task allows to do the join operation on system definition file v3.0. + * Join operation consist in combining a distributed system definition file into + * a stand-alone version.

+ * + *

The following example shows how you can join the X:\layer.sysdef.xml under + * X:\joined_layer.sysdef.xml.

+ * + * E.g: + *

+ *   <hlm:joinSysdef epocroot="X:\" srcfile="X:\layer.sysdef.xml" 
+ *                      destfile="X:\joined_layer.sysdef.xml" />
+ *

+ * + * For more information about system definition file v3.0 please check + * http://developer.symbian.org/wiki/index.php/System_Definition. + * + * @ant.task name="joinSysdef" category="Sysdef" + */ + +public class JoinTask extends AbstractSydefTask { + private static final String XSLT = "sf/os/buildtools/bldsystemtools/buildsystemtools/joinsysdef.xsl"; + + /** + * {@inheritDoc} + */ + public void execute() { + check(); + log("Joining " + this.getSrcFile()); + log("Creating " + this.getDestFile()); + transform(new Hashtable()); + } + + /** + * {@inheritDoc} + */ + @Override + protected File getXsl() { + return new File(this.getEpocroot(), XSLT); + } +} diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/helium-antlib/sysdef/src/com/nokia/helium/sysdef/ant/taskdefs/MergeTask.java --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/helium-antlib/sysdef/src/com/nokia/helium/sysdef/ant/taskdefs/MergeTask.java Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,97 @@ +/* +* Copyright (c) 2007-2008 Nokia Corporation and/or its subsidiary(-ies). +* All rights reserved. +* This component and the accompanying materials are made available +* under the terms of the License "Eclipse Public License v1.0" +* which accompanies this distribution, and is available +* at the URL "http://www.eclipse.org/legal/epl-v10.html". +* +* Initial Contributors: +* Nokia Corporation - initial contribution. +* +* Contributors: +* +* Description: +* +*/ +package com.nokia.helium.sysdef.ant.taskdefs; + +import java.io.File; +import java.util.Hashtable; +import java.util.Map; + +import org.apache.tools.ant.BuildException; + +/** + *

This task allows to do the merge operation on system definition file v3.0. + * Merge operation consist in combining a the data of two models into one stand-alone + * system definition file (Also called canonical system definition file).

+ * + *

The following example shows how you can merge the X:\layer.sysdef.xml and X:\vendor.sysdef.xml + * as X:\joined_layer.sysdef.xml.

+ * + * E.g: + *

+ *   <hlm:mergeSysdef epocroot="X:\"
+ *                      srcfile="X:\layer.sysdef.xml" 
+ *                      downstreamfile="X:\vendor.sysdef.xml" 
+ *                      destfile="X:\joined_layer.sysdef.xml" />
+ *

+ * + * + * For more information about system definition file v3.0 please check + * http://developer.symbian.org/wiki/index.php/System_Definition. + * + * @ant.task name="mergeSysdef" category="Sysdef" + */ + +public class MergeTask extends AbstractSydefTask { + private static final String XSLT = "sf/os/buildtools/bldsystemtools/buildsystemtools/mergesysdef.xsl"; + private File downstreamFile; + + /** + * Get the downstream file for the merge. + * @return + */ + public File getDownstreamFile() { + return downstreamFile; + } + + /** + * Defines the location of the downstream file. + * @param downstreamfile + * @ant.required + */ + public void setDownstreamfile(File downstreamFile) { + this.downstreamFile = downstreamFile; + } + + + /** + * {@inheritDoc} + */ + public void execute() { + check(); + if (downstreamFile == null) { + throw new BuildException("'downstreamfile' attribute is not defined"); + } + if (!downstreamFile.exists()) { + throw new BuildException("Could not find downstream file " + downstreamFile); + } + + log("Merging " + this.getSrcFile()); + log("Downstream " + downstreamFile); + log("Creating " + this.getDestFile()); + Map data = new Hashtable(); + data.put("Downstream", downstreamFile.toString()); + transform(data); + } + + /** + * {@inheritDoc} + */ + @Override + protected File getXsl() { + return new File(this.getEpocroot(), XSLT); + } +} diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/helium-antlib/sysdef/tests/antunit/test_downgrade_sysdef.ant.xml --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/helium-antlib/sysdef/tests/antunit/test_downgrade_sysdef.ant.xml Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,74 @@ + + + + Helium antlib downgrade sysdef tests. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + \ No newline at end of file diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/helium-antlib/sysdef/tests/antunit/test_join_sysdef.ant.xml --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/helium-antlib/sysdef/tests/antunit/test_join_sysdef.ant.xml Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,86 @@ + + + + Helium antlib join sysdef tests. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + test-srcfile-destfile-wrong-epocroot + + + + + + + + test-wrong-content + + + + + + + + test-wrong-content + + + + + + + \ No newline at end of file diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/helium-antlib/sysdef/tests/antunit/test_merge_sysdef.ant.xml --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/helium-antlib/sysdef/tests/antunit/test_merge_sysdef.ant.xml Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,101 @@ + + + + Helium antlib merge sysdef tests. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + test-wrong-content + + + + + + + \ No newline at end of file diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/helium-antlib/sysdef/tests/bld.sh --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/helium-antlib/sysdef/tests/bld.sh Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,24 @@ +#!/bin/csh + +# +# Copyright (c) 2009 Nokia Corporation and/or its subsidiary(-ies). +# All rights reserved. +# This component and the accompanying materials are made available +# under the terms of the License "Eclipse Public License v1.0" +# which accompanies this distribution, and is available +# at the URL "http://www.eclipse.org/legal/epl-v10.html". +# +# Initial Contributors: +# Nokia Corporation - initial contribution. +# +# Contributors: +# +# Description: +# + + + +module load java/1.6.0 +module load mercurial +setenv ANT_ARGS "-lib ../lib -lib ../../lib -lib ../../bin/helium-core.jar -lib ../../bin/helium-sysdef.jar -lib ../../antlibs" +ant -Dant.executor.class="com.nokia.helium.core.ant.HeliumExecutor" $* diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/helium-antlib/sysdef/tests/build.bat --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/helium-antlib/sysdef/tests/build.bat Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,27 @@ +@echo off + +rem +rem Copyright (c) 2009 Nokia Corporation and/or its subsidiary(-ies). +rem All rights reserved. +rem This component and the accompanying materials are made available +rem under the terms of the License "Eclipse Public License v1.0" +rem which accompanies this distribution, and is available +rem at the URL "http://www.eclipse.org/legal/epl-v10.html". +rem +rem Initial Contributors: +rem Nokia Corporation - initial contribution. +rem +rem Contributors: +rem +rem Description: +rem + +setlocal +if not defined JAVA_6_HOME ( +set TESTED_JAVA=C:\Apps\j2sdk_1.6.0_02 +) ELSE set TESTED_JAVA=%JAVA_6_HOME% +if exist %TESTED_JAVA% (set JAVA_HOME=%TESTED_JAVA%) +set ANT_ARGS=-lib %CD%\..\lib -lib %CD%\..\..\lib -lib %CD%\..\..\bin\helium-core.jar -lib %CD%\..\..\bin\helium-sysdef.jar -lib %CD%\..\..\antlibs +ant -Dant.executor.class=com.nokia.helium.core.ant.HeliumExecutor %* +endlocal + diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/helium-antlib/sysdef/tests/build.xml --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/helium-antlib/sysdef/tests/build.xml Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,35 @@ + + + + Helium Antlib Sysdef unittests. + + + + + + + + + + + diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/helium-antlib/test-macros.ant.xml --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/helium-antlib/test-macros.ant.xml Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,46 @@ + + + + Helium Antlib test macro. + + + + + + + + + + + + + + + + + + + + + + \ No newline at end of file diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/bin/nosetests-script.py --- a/buildframework/helium/external/python/bin/nosetests-script.py Wed Oct 28 14:39:48 2009 +0000 +++ b/buildframework/helium/external/python/bin/nosetests-script.py Wed Dec 23 19:29:07 2009 +0200 @@ -5,5 +5,5 @@ from pkg_resources import load_entry_point sys.exit( - load_entry_point('nose==0.10.4', 'console_scripts', 'nosetests')() + load_entry_point('nose==0.11.1', 'console_scripts', 'nosetests')() ) diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/Amara-1.2.0.1-py2.5.egg Binary file buildframework/helium/external/python/lib/2.5/Amara-1.2.0.1-py2.5.egg has changed diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/Jinja-1.2-py2.5-win32.egg Binary file buildframework/helium/external/python/lib/2.5/Jinja-1.2-py2.5-win32.egg has changed diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/Jinja2-2.0rc1-py2.5-win32.egg Binary file buildframework/helium/external/python/lib/2.5/Jinja2-2.0rc1-py2.5-win32.egg has changed diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/Pygments-0.10-py2.5.egg Binary file buildframework/helium/external/python/lib/2.5/Pygments-0.10-py2.5.egg has changed diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/EGG-INFO/PKG-INFO --- a/buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/EGG-INFO/PKG-INFO Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,45 +0,0 @@ -Metadata-Version: 1.0 -Name: Sphinx -Version: 0.5.1 -Summary: Python documentation generator -Home-page: http://sphinx.pocoo.org/ -Author: Georg Brandl -Author-email: georg@python.org -License: BSD -Download-URL: http://pypi.python.org/pypi/Sphinx -Description: - Sphinx is a tool that makes it easy to create intelligent and beautiful - documentation for Python projects (or other documents consisting of - multiple reStructuredText sources), written by Georg Brandl. - It was originally created to translate the new Python documentation, - but has now been cleaned up in the hope that it will be useful to many - other projects. - - Sphinx uses reStructuredText as its markup language, and many of its strengths - come from the power and straightforwardness of reStructuredText and its - parsing and translating suite, the Docutils. - - Although it is still under constant development, the following features - are already present, work fine and can be seen "in action" in the Python docs: - - * Output formats: HTML (including Windows HTML Help), plain text and LaTeX, - for printable PDF versions - * Extensive cross-references: semantic markup and automatic links - for functions, classes, glossary terms and similar pieces of information - * Hierarchical structure: easy definition of a document tree, with automatic - links to siblings, parents and children - * Automatic indices: general index as well as a module index - * Code handling: automatic highlighting using the Pygments highlighter - * Various extensions are available, e.g. for automatic testing of snippets - and inclusion of appropriately formatted docstrings. - -Platform: any -Classifier: Development Status :: 4 - Beta -Classifier: Environment :: Console -Classifier: Environment :: Web Environment -Classifier: Intended Audience :: Developers -Classifier: License :: OSI Approved :: BSD License -Classifier: Operating System :: OS Independent -Classifier: Programming Language :: Python -Classifier: Topic :: Documentation -Classifier: Topic :: Utilities diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/EGG-INFO/SOURCES.txt --- a/buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/EGG-INFO/SOURCES.txt Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,216 +0,0 @@ -AUTHORS -CHANGES -EXAMPLES -LICENSE -MANIFEST.in -Makefile -README -TODO -babel.cfg -ez_setup.py -setup.cfg -setup.py -sphinx-build.py -sphinx-quickstart.py -Sphinx.egg-info/PKG-INFO -Sphinx.egg-info/SOURCES.txt -Sphinx.egg-info/dependency_links.txt -Sphinx.egg-info/entry_points.txt -Sphinx.egg-info/not-zip-safe -Sphinx.egg-info/requires.txt -Sphinx.egg-info/top_level.txt -doc/Makefile -doc/builders.rst -doc/changes.rst -doc/concepts.rst -doc/conf.py -doc/config.rst -doc/contents.rst -doc/examples.rst -doc/extensions.rst -doc/glossary.rst -doc/intro.rst -doc/rest.rst -doc/templating.rst -doc/_static/sphinx.png -doc/_templates/index.html -doc/_templates/indexsidebar.html -doc/_templates/layout.html -doc/ext/appapi.rst -doc/ext/autodoc.rst -doc/ext/builderapi.rst -doc/ext/coverage.rst -doc/ext/doctest.rst -doc/ext/ifconfig.rst -doc/ext/intersphinx.rst -doc/ext/math.rst -doc/ext/refcounting.rst -doc/ext/todo.rst -doc/markup/code.rst -doc/markup/desc.rst -doc/markup/index.rst -doc/markup/inline.rst -doc/markup/misc.rst -doc/markup/para.rst -sphinx/__init__.py -sphinx/_jinja.py -sphinx/addnodes.py -sphinx/application.py -sphinx/builder.py -sphinx/cmdline.py -sphinx/config.py -sphinx/environment.py -sphinx/highlighting.py -sphinx/htmlhelp.py -sphinx/htmlwriter.py -sphinx/latexwriter.py -sphinx/linkcheck.py -sphinx/quickstart.py -sphinx/roles.py -sphinx/search.py -sphinx/setup_command.py -sphinx/textwriter.py -sphinx/directives/__init__.py -sphinx/directives/code.py -sphinx/directives/desc.py -sphinx/directives/other.py -sphinx/ext/__init__.py -sphinx/ext/autodoc.py -sphinx/ext/coverage.py -sphinx/ext/doctest.py -sphinx/ext/ifconfig.py -sphinx/ext/intersphinx.py -sphinx/ext/jsmath.py -sphinx/ext/mathbase.py -sphinx/ext/pngmath.py -sphinx/ext/refcounting.py -sphinx/ext/todo.py -sphinx/locale/__init__.py -sphinx/locale/__init__.pyc -sphinx/locale/sphinx.pot -sphinx/locale/cs/LC_MESSAGES/sphinx.js -sphinx/locale/cs/LC_MESSAGES/sphinx.mo -sphinx/locale/cs/LC_MESSAGES/sphinx.po -sphinx/locale/de/LC_MESSAGES/sphinx.js -sphinx/locale/de/LC_MESSAGES/sphinx.mo -sphinx/locale/de/LC_MESSAGES/sphinx.po -sphinx/locale/es/LC_MESSAGES/sphinx.js -sphinx/locale/es/LC_MESSAGES/sphinx.mo -sphinx/locale/es/LC_MESSAGES/sphinx.po -sphinx/locale/fr/LC_MESSAGES/sphinx.js -sphinx/locale/fr/LC_MESSAGES/sphinx.mo -sphinx/locale/fr/LC_MESSAGES/sphinx.po -sphinx/locale/ja/LC_MESSAGES/sphinx.js -sphinx/locale/ja/LC_MESSAGES/sphinx.mo -sphinx/locale/ja/LC_MESSAGES/sphinx.po -sphinx/locale/nl/LC_MESSAGES/sphinx.js -sphinx/locale/nl/LC_MESSAGES/sphinx.mo -sphinx/locale/nl/LC_MESSAGES/sphinx.po -sphinx/locale/pl/LC_MESSAGES/sphinx.js -sphinx/locale/pl/LC_MESSAGES/sphinx.mo -sphinx/locale/pl/LC_MESSAGES/sphinx.po -sphinx/locale/pt_BR/LC_MESSAGES/sphinx.js -sphinx/locale/pt_BR/LC_MESSAGES/sphinx.mo -sphinx/locale/pt_BR/LC_MESSAGES/sphinx.po -sphinx/locale/sl/LC_MESSAGES/sphinx.js -sphinx/locale/sl/LC_MESSAGES/sphinx.mo -sphinx/locale/sl/LC_MESSAGES/sphinx.po -sphinx/locale/zh_TW/LC_MESSAGES/sphinx.js -sphinx/locale/zh_TW/LC_MESSAGES/sphinx.mo -sphinx/locale/zh_TW/LC_MESSAGES/sphinx.po -sphinx/static/contents.png -sphinx/static/default.css -sphinx/static/doctools.js -sphinx/static/file.png -sphinx/static/jquery.js -sphinx/static/minus.png -sphinx/static/navigation.png -sphinx/static/plus.png -sphinx/static/rightsidebar.css -sphinx/static/searchtools.js -sphinx/static/sphinxdoc.css -sphinx/static/stickysidebar.css -sphinx/static/traditional.css -sphinx/templates/defindex.html -sphinx/templates/genindex-single.html -sphinx/templates/genindex-split.html -sphinx/templates/genindex.html -sphinx/templates/layout.html -sphinx/templates/modindex.html -sphinx/templates/opensearch.xml -sphinx/templates/page.html -sphinx/templates/search.html -sphinx/templates/changes/frameset.html -sphinx/templates/changes/rstsource.html -sphinx/templates/changes/versionchanges.html -sphinx/texinputs/Makefile -sphinx/texinputs/fncychap.sty -sphinx/texinputs/howto.cls -sphinx/texinputs/manual.cls -sphinx/texinputs/python.ist -sphinx/texinputs/sphinx.sty -sphinx/texinputs/tabulary.sty -sphinx/util/__init__.py -sphinx/util/compat.py -sphinx/util/console.py -sphinx/util/jsdump.py -sphinx/util/png.py -sphinx/util/smartypants.py -sphinx/util/stemmer.py -sphinx/util/texescape.py -tests/path.py -tests/path.pyc -tests/run.py -tests/test_application.py -tests/test_application.pyc -tests/test_autodoc.py -tests/test_autodoc.pyc -tests/test_build.py -tests/test_build.pyc -tests/test_config.py -tests/test_config.pyc -tests/test_coverage.py -tests/test_coverage.pyc -tests/test_env.py -tests/test_env.pyc -tests/test_i18n.py -tests/test_i18n.pyc -tests/test_markup.py -tests/test_markup.pyc -tests/test_quickstart.py -tests/test_quickstart.pyc -tests/util.py -tests/util.pyc -tests/etree13/ElementPath.py -tests/etree13/ElementPath.pyc -tests/etree13/ElementTree.py -tests/etree13/ElementTree.pyc -tests/etree13/HTMLTreeBuilder.py -tests/etree13/__init__.py -tests/etree13/__init__.pyc -tests/root/Makefile -tests/root/autodoc.txt -tests/root/conf.py -tests/root/contents.txt -tests/root/desc.txt -tests/root/ext.py -tests/root/ext.pyc -tests/root/images.txt -tests/root/img.gif -tests/root/img.pdf -tests/root/img.png -tests/root/includes.txt -tests/root/literal.inc -tests/root/markup.txt -tests/root/math.txt -tests/root/wrongenc.inc -tests/root/_static/README -tests/root/_templates/layout.html -tests/root/special/api.h -tests/root/subdir/images.txt -tests/root/subdir/img.png -tests/root/subdir/include.inc -tests/root/subdir/simg.png -utils/check_sources.py -utils/pylintrc -utils/reindent.py \ No newline at end of file diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/EGG-INFO/dependency_links.txt --- a/buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/EGG-INFO/dependency_links.txt Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,1 +0,0 @@ - diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/EGG-INFO/entry_points.txt --- a/buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/EGG-INFO/entry_points.txt Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,7 +0,0 @@ -[console_scripts] -sphinx-build = sphinx:main -sphinx-quickstart = sphinx.quickstart:main - -[distutils.commands] -build_sphinx = sphinx.setup_command:BuildDoc - diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/EGG-INFO/not-zip-safe --- a/buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/EGG-INFO/not-zip-safe Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,1 +0,0 @@ - diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/EGG-INFO/requires.txt --- a/buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/EGG-INFO/requires.txt Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,3 +0,0 @@ -Pygments>=0.8 -Jinja>=1.1 -docutils>=0.4 \ No newline at end of file diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/EGG-INFO/top_level.txt --- a/buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/EGG-INFO/top_level.txt Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,1 +0,0 @@ -sphinx diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/__init__.py --- a/buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/__init__.py Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,48 +0,0 @@ -# -*- coding: utf-8 -*- -""" - Sphinx - ~~~~~~ - - The Sphinx documentation toolchain. - - :copyright: 2007-2008 by Georg Brandl. - :license: BSD. -""" - -import sys - -__revision__ = '$Revision$' -__version__ = '0.5.1' -__released__ = '0.5.1' - - -def main(argv=sys.argv): - if sys.version_info[:3] < (2, 4, 0): - print >>sys.stderr, \ - 'Error: Sphinx requires at least Python 2.4 to run.' - return 1 - - try: - from sphinx import cmdline - except ImportError, err: - errstr = str(err) - if errstr.lower().startswith('no module named'): - whichmod = errstr[16:] - if whichmod.startswith('docutils'): - whichmod = 'Docutils library' - elif whichmod.startswith('jinja'): - whichmod = 'Jinja library' - elif whichmod == 'roman': - whichmod = 'roman module (which is distributed with Docutils)' - else: - whichmod += ' module' - print >>sys.stderr, \ - 'Error: The %s cannot be found. Did you install Sphinx '\ - 'and its dependencies correctly?' % whichmod - return 1 - raise - return cmdline.main(argv) - - -if __name__ == '__main__': - sys.exit(main(sys.argv)) diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/_jinja.py --- a/buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/_jinja.py Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,113 +0,0 @@ -# -*- coding: utf-8 -*- -""" - sphinx._jinja - ~~~~~~~~~~~~~ - - Jinja glue. - - :copyright: 2007-2008 by Georg Brandl, Horst Gutmann. - :license: BSD. -""" - -import codecs -from os import path - -from sphinx.util import mtimes_of_files -from sphinx.application import TemplateBridge - -from jinja import Environment -from jinja.loaders import BaseLoader -from jinja.exceptions import TemplateNotFound - - -def babel_extract(fileobj, keywords, comment_tags, options): - """ - Simple extractor to get some basic Babel support. - """ - env = Environment() - for lineno, sg, pl in env.get_translations_for_string(fileobj.read()): - yield lineno, None, (sg, pl), '' - - -class SphinxFileSystemLoader(BaseLoader): - """ - A loader that loads templates either relative to one of a list of given - paths, or from an absolute path. - """ - - def __init__(self, basepath, extpaths): - self.basepath = path.abspath(basepath) - self.extpaths = map(path.abspath, extpaths) - self.searchpaths = self.extpaths + [self.basepath] - - def get_source(self, environment, name, parent): - name = name.replace('/', path.sep) - if name.startswith('!'): - name = name[1:] - if not path.exists(path.join(self.basepath, name)): - raise TemplateNotFound(name) - filename = path.join(self.basepath, name) - elif path.isabs(name): - if not path.exists(name): - raise TemplateNotFound(name) - filename = name - else: - for searchpath in self.searchpaths: - if path.exists(path.join(searchpath, name)): - filename = path.join(searchpath, name) - break - else: - raise TemplateNotFound(name) - f = codecs.open(filename, 'r', environment.template_charset) - try: - return f.read() - finally: - f.close() - - -class TranslatorEnvironment(Environment): - class _Translator(object): - def __init__(self, translator): - self.trans = translator - - def gettext(self, string): - return self.trans.ugettext(string) - - def ngettext(self, singular, plural, n): - return self.trans.ungettext(singular, plural, n) - - def __init__(self, *args, **kwargs): - self.translator = kwargs['translator'] - del kwargs['translator'] - super(TranslatorEnvironment, self).__init__(*args, **kwargs) - - def get_translator(self, context): - return TranslatorEnvironment._Translator(self.translator) - - -class BuiltinTemplates(TemplateBridge): - def init(self, builder): - self.templates = {} - base_templates_path = path.join(path.dirname(__file__), 'templates') - ext_templates_path = [path.join(builder.confdir, dir) - for dir in builder.config.templates_path] - self.templates_path = [base_templates_path] + ext_templates_path - loader = SphinxFileSystemLoader(base_templates_path, ext_templates_path) - if builder.translator is not None: - self.jinja_env = TranslatorEnvironment(loader=loader, - friendly_traceback=False, translator=builder.translator) - else: - self.jinja_env = Environment(loader=loader, - # disable traceback, more likely that something - # in the application is broken than in the templates - friendly_traceback=False) - - def newest_template_mtime(self): - return max(mtimes_of_files(self.templates_path, '.html')) - - def render(self, template, context): - if template in self.templates: - return self.templates[template].render(context) - templateobj = self.templates[template] = \ - self.jinja_env.get_template(template) - return templateobj.render(context) diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/addnodes.py --- a/buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/addnodes.py Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,97 +0,0 @@ -# -*- coding: utf-8 -*- -""" - sphinx.addnodes - ~~~~~~~~~~~~~~~ - - Additional docutils nodes. - - :copyright: 2007-2008 by Georg Brandl. - :license: BSD. -""" - -from docutils import nodes - -# index markup -class index(nodes.Invisible, nodes.Inline, nodes.TextElement): pass - -# description units (classdesc, funcdesc etc.) - -# parent node for signature and content -class desc(nodes.Admonition, nodes.Element): pass - -# additional name parts (module name, class name) -class desc_addname(nodes.Part, nodes.Inline, nodes.TextElement): pass -# compatibility alias -desc_classname = desc_addname -# return type (C); object type, e.g. -> annotation (Python) -class desc_type(nodes.Part, nodes.Inline, nodes.TextElement): pass -# main name of object -class desc_name(nodes.Part, nodes.Inline, nodes.TextElement): pass -# argument list -class desc_signature(nodes.Part, nodes.Inline, nodes.TextElement): pass -class desc_parameterlist(nodes.Part, nodes.Inline, nodes.TextElement): - child_text_separator = ', ' -class desc_parameter(nodes.Part, nodes.Inline, nodes.TextElement): pass -class desc_optional(nodes.Part, nodes.Inline, nodes.TextElement): - child_text_separator = ', ' - def astext(self): - return '[' + nodes.TextElement.astext(self) + ']' -# annotation (not Python 3-style annotations) -class desc_annotation(nodes.Part, nodes.Inline, nodes.TextElement): pass - -# node for content -class desc_content(nodes.General, nodes.Element): pass - -# \versionadded, \versionchanged, \deprecated -class versionmodified(nodes.Admonition, nodes.TextElement): pass - -# seealso -class seealso(nodes.Admonition, nodes.Element): pass - -# productionlist -class productionlist(nodes.Admonition, nodes.Element): pass -class production(nodes.Part, nodes.Inline, nodes.TextElement): pass - -# toc tree -class toctree(nodes.General, nodes.Element): pass - -# centered -class centered(nodes.Part, nodes.Element): pass - -# pending xref -class pending_xref(nodes.Element): pass - -# compact paragraph -- never makes a

-class compact_paragraph(nodes.paragraph): pass - -# for the ACKS list -class acks(nodes.Element): pass - -# sets the highlighting language for literal blocks -class highlightlang(nodes.Element): pass - -# like emphasis, but doesn't apply further text processors, e.g. smartypants -class literal_emphasis(nodes.emphasis): pass - -# glossary -class glossary(nodes.Element): pass - -# module declaration -class module(nodes.Element): pass - -# start of a file, used in the LaTeX builder only -class start_of_file(nodes.Element): pass - -# tabular column specification, used for the LaTeX writer -class tabular_col_spec(nodes.Element): pass - -# meta directive -- same as docutils' standard meta node, but pickleable -class meta(nodes.Special, nodes.PreBibliographic, nodes.Element): pass - -# make them known to docutils. this is needed, because the HTML writer -# will choke at some point if these are not added -nodes._add_node_class_names("""index desc desc_content desc_signature desc_type - desc_addname desc_name desc_parameterlist desc_parameter desc_optional - centered versionmodified seealso productionlist production toctree - pending_xref compact_paragraph highlightlang literal_emphasis - glossary acks module start_of_file tabular_col_spec meta""".split()) diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/application.py --- a/buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/application.py Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,325 +0,0 @@ -# -*- coding: utf-8 -*- -""" - sphinx.application - ~~~~~~~~~~~~~~~~~~ - - Sphinx application object. - - Gracefully adapted from the TextPress system by Armin. - - - :copyright: 2008 by Georg Brandl, Armin Ronacher. - :license: BSD. -""" - -import sys -import posixpath -from cStringIO import StringIO - -from docutils import nodes -from docutils.parsers.rst import directives, roles - -import sphinx -from sphinx.roles import xfileref_role, innernodetypes -from sphinx.config import Config -from sphinx.builder import builtin_builders, StandaloneHTMLBuilder -from sphinx.directives import desc_directive, target_directive, additional_xref_types -from sphinx.environment import SphinxStandaloneReader -from sphinx.util.console import bold - - -class SphinxError(Exception): - """ - Base class for Sphinx errors that are shown to the user in a nicer - way than normal exceptions. - """ - category = 'Sphinx error' - -class ExtensionError(SphinxError): - """Raised if something's wrong with the configuration.""" - category = 'Extension error' - - def __init__(self, message, orig_exc=None): - super(ExtensionError, self).__init__(message) - self.orig_exc = orig_exc - - def __repr__(self): - if self.orig_exc: - return '%s(%r, %r)' % (self.__class__.__name__, - self.message, self.orig_exc) - return '%s(%r)' % (self.__class__.__name__, self.message) - - def __str__(self): - parent_str = super(ExtensionError, self).__str__() - if self.orig_exc: - return '%s (exception: %s)' % (parent_str, self.orig_exc) - return parent_str - - -# List of all known core events. Maps name to arguments description. -events = { - 'builder-inited': '', - 'env-purge-doc': 'env, docname', - 'source-read': 'docname, source text', - 'doctree-read': 'the doctree before being pickled', - 'missing-reference': 'env, node, contnode', - 'doctree-resolved': 'doctree, docname', - 'env-updated': 'env', - 'html-page-context': 'pagename, context, doctree or None', - 'build-finished': 'exception', -} - -CONFIG_FILENAME = 'conf.py' - -class Sphinx(object): - - def __init__(self, srcdir, confdir, outdir, doctreedir, buildername, - confoverrides, status, warning=sys.stderr, freshenv=False): - self.next_listener_id = 0 - self._listeners = {} - self.builderclasses = builtin_builders.copy() - self.builder = None - - self.srcdir = srcdir - self.confdir = confdir - self.outdir = outdir - self.doctreedir = doctreedir - - if status is None: - self._status = StringIO() - self.quiet = True - else: - self._status = status - self.quiet = False - if warning is None: - self._warning = StringIO() - else: - self._warning = warning - self._warncount = 0 - - self._events = events.copy() - - # status code for command-line application - self.statuscode = 0 - - # read config - self.config = Config(confdir, CONFIG_FILENAME, confoverrides) - - # load all extension modules - for extension in self.config.extensions: - self.setup_extension(extension) - # the config file itself can be an extension - if self.config.setup: - self.config.setup(self) - - # now that we know all config values, collect them from conf.py - self.config.init_values() - - if buildername is None: - print >>status, 'No builder selected, using default: html' - buildername = 'html' - if buildername not in self.builderclasses: - raise SphinxError('Builder name %s not registered' % buildername) - - self.info(bold('Sphinx v%s, building %s' % (sphinx.__released__, - buildername))) - - builderclass = self.builderclasses[buildername] - self.builder = builderclass(self, freshenv=freshenv) - self.emit('builder-inited') - - def build(self, all_files, filenames): - try: - if all_files: - self.builder.build_all() - elif filenames: - self.builder.build_specific(filenames) - else: - self.builder.build_update() - except Exception, err: - self.emit('build-finished', err) - raise - else: - self.emit('build-finished', None) - - def warn(self, message): - self._warncount += 1 - try: - self._warning.write('WARNING: %s\n' % message) - except UnicodeEncodeError: - encoding = getattr(self._warning, 'encoding', 'ascii') - self._warning.write(('WARNING: %s\n' % message).encode(encoding, 'replace')) - - def info(self, message='', nonl=False): - try: - self._status.write(message) - except UnicodeEncodeError: - encoding = getattr(self._status, 'encoding', 'ascii') - self._status.write(message.encode(encoding, 'replace')) - if not nonl: - self._status.write('\n') - self._status.flush() - - # general extensibility interface - - def setup_extension(self, extension): - """Import and setup a Sphinx extension module.""" - try: - mod = __import__(extension, None, None, ['setup']) - except ImportError, err: - raise ExtensionError('Could not import extension %s' % extension, err) - if hasattr(mod, 'setup'): - mod.setup(self) - - def import_object(self, objname, source=None): - """Import an object from a 'module.name' string.""" - try: - module, name = objname.rsplit('.', 1) - except ValueError, err: - raise ExtensionError('Invalid full object name %s' % objname + - (source and ' (needed for %s)' % source or ''), err) - try: - return getattr(__import__(module, None, None, [name]), name) - except ImportError, err: - raise ExtensionError('Could not import %s' % module + - (source and ' (needed for %s)' % source or ''), err) - except AttributeError, err: - raise ExtensionError('Could not find %s' % objname + - (source and ' (needed for %s)' % source or ''), err) - - # event interface - - def _validate_event(self, event): - event = intern(event) - if event not in self._events: - raise ExtensionError('Unknown event name: %s' % event) - - def connect(self, event, callback): - self._validate_event(event) - listener_id = self.next_listener_id - if event not in self._listeners: - self._listeners[event] = {listener_id: callback} - else: - self._listeners[event][listener_id] = callback - self.next_listener_id += 1 - return listener_id - - def disconnect(self, listener_id): - for event in self._listeners.itervalues(): - event.pop(listener_id, None) - - def emit(self, event, *args): - result = [] - if event in self._listeners: - for _, callback in self._listeners[event].iteritems(): - result.append(callback(self, *args)) - return result - - def emit_firstresult(self, event, *args): - for result in self.emit(event, *args): - if result is not None: - return result - return None - - # registering addon parts - - def add_builder(self, builder): - if not hasattr(builder, 'name'): - raise ExtensionError('Builder class %s has no "name" attribute' % builder) - if builder.name in self.builderclasses: - raise ExtensionError('Builder %r already exists (in module %s)' % ( - builder.name, self.builderclasses[builder.name].__module__)) - self.builderclasses[builder.name] = builder - - def add_config_value(self, name, default, rebuild_env): - if name in self.config.values: - raise ExtensionError('Config value %r already present' % name) - self.config.values[name] = (default, rebuild_env) - - def add_event(self, name): - if name in self._events: - raise ExtensionError('Event %r already present' % name) - self._events[name] = '' - - def add_node(self, node, **kwds): - nodes._add_node_class_names([node.__name__]) - for key, val in kwds.iteritems(): - try: - visit, depart = val - except ValueError: - raise ExtensionError('Value for key %r must be a (visit, depart) ' - 'function tuple' % key) - if key == 'html': - from sphinx.htmlwriter import HTMLTranslator as translator - elif key == 'latex': - from sphinx.latexwriter import LaTeXTranslator as translator - elif key == 'text': - from sphinx.textwriter import TextTranslator as translator - else: - # ignore invalid keys for compatibility - continue - setattr(translator, 'visit_'+node.__name__, visit) - if depart: - setattr(translator, 'depart_'+node.__name__, depart) - - def add_directive(self, name, func, content, arguments, **options): - func.content = content - func.arguments = arguments - func.options = options - directives.register_directive(name, func) - - def add_role(self, name, role): - roles.register_canonical_role(name, role) - - def add_description_unit(self, directivename, rolename, indextemplate='', - parse_node=None, ref_nodeclass=None): - additional_xref_types[directivename] = (rolename, indextemplate, parse_node) - directives.register_directive(directivename, desc_directive) - roles.register_canonical_role(rolename, xfileref_role) - if ref_nodeclass is not None: - innernodetypes[rolename] = ref_nodeclass - - def add_crossref_type(self, directivename, rolename, indextemplate='', - ref_nodeclass=None): - additional_xref_types[directivename] = (rolename, indextemplate, None) - directives.register_directive(directivename, target_directive) - roles.register_canonical_role(rolename, xfileref_role) - if ref_nodeclass is not None: - innernodetypes[rolename] = ref_nodeclass - - def add_transform(self, transform): - SphinxStandaloneReader.transforms.append(transform) - - def add_javascript(self, filename): - StandaloneHTMLBuilder.script_files.append( - posixpath.join('_static', filename)) - - -class TemplateBridge(object): - """ - This class defines the interface for a "template bridge", that is, a class - that renders templates given a template name and a context. - """ - - def init(self, builder): - """ - Called by the builder to initialize the template system. *builder* - is the builder object; you'll probably want to look at the value of - ``builder.config.templates_path``. - """ - raise NotImplementedError('must be implemented in subclasses') - - def newest_template_mtime(self): - """ - Called by the builder to determine if output files are outdated - because of template changes. Return the mtime of the newest template - file that was changed. The default implementation returns ``0``. - """ - return 0 - - def render(self, template, context): - """ - Called by the builder to render a *template* with a specified - context (a Python dictionary). - """ - raise NotImplementedError('must be implemented in subclasses') diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/builder.py --- a/buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/builder.py Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,1272 +0,0 @@ -# -*- coding: utf-8 -*- -""" - sphinx.builder - ~~~~~~~~~~~~~~ - - Builder classes for different output formats. - - :copyright: 2007-2008 by Georg Brandl, Sebastian Wiesner, Horst Gutmann. - :license: BSD. -""" - -import os -import time -import codecs -import shutil -import gettext -import cPickle as pickle -from os import path -from cgi import escape - -from docutils import nodes -from docutils.io import StringOutput, FileOutput, DocTreeInput -from docutils.core import publish_parts -from docutils.utils import new_document -from docutils.frontend import OptionParser -from docutils.readers.doctree import Reader as DoctreeReader - -from sphinx import addnodes, locale, __version__ -from sphinx.util import ensuredir, relative_uri, SEP, os_path, texescape, ustrftime -from sphinx.htmlhelp import build_hhx -from sphinx.htmlwriter import HTMLWriter, HTMLTranslator, SmartyPantsHTMLTranslator -from sphinx.textwriter import TextWriter -from sphinx.latexwriter import LaTeXWriter -from sphinx.environment import BuildEnvironment, NoUri -from sphinx.highlighting import PygmentsBridge -from sphinx.util.console import bold, purple, darkgreen -from sphinx.search import js_index - -try: - import json -except ImportError: - try: - import simplejson as json - except ImportError: - json = None - -# side effect: registers roles and directives -from sphinx import roles -from sphinx import directives - -ENV_PICKLE_FILENAME = 'environment.pickle' -LAST_BUILD_FILENAME = 'last_build' -INVENTORY_FILENAME = 'objects.inv' - - -class Builder(object): - """ - Builds target formats from the reST sources. - """ - - # builder's name, for the -b command line options - name = '' - - def __init__(self, app, env=None, freshenv=False): - self.srcdir = app.srcdir - self.confdir = app.confdir - self.outdir = app.outdir - self.doctreedir = app.doctreedir - if not path.isdir(self.doctreedir): - os.makedirs(self.doctreedir) - - self.app = app - self.warn = app.warn - self.info = app.info - self.config = app.config - - self.load_i18n() - - # images that need to be copied over (source -> dest) - self.images = {} - - # if None, this is set in load_env() - self.env = env - self.freshenv = freshenv - - self.init() - self.load_env() - - # helper methods - - def init(self): - """Load necessary templates and perform initialization.""" - raise NotImplementedError - - def init_templates(self): - # Call this from init() if you need templates. - if self.config.template_bridge: - self.templates = self.app.import_object( - self.config.template_bridge, 'template_bridge setting')() - else: - from sphinx._jinja import BuiltinTemplates - self.templates = BuiltinTemplates() - self.templates.init(self) - - def get_target_uri(self, docname, typ=None): - """ - Return the target URI for a document name (typ can be used to qualify - the link characteristic for individual builders). - """ - raise NotImplementedError - - def get_relative_uri(self, from_, to, typ=None): - """ - Return a relative URI between two source filenames. May raise environment.NoUri - if there's no way to return a sensible URI. - """ - return relative_uri(self.get_target_uri(from_), - self.get_target_uri(to, typ)) - - def get_outdated_docs(self): - """ - Return an iterable of output files that are outdated, or a string describing - what an update build will build. - """ - raise NotImplementedError - - def status_iterator(self, iterable, summary, colorfunc=darkgreen): - l = -1 - for item in iterable: - if l == -1: - self.info(bold(summary), nonl=1) - l = 0 - self.info(colorfunc(item) + ' ', nonl=1) - yield item - if l == 0: - self.info() - - supported_image_types = [] - - def post_process_images(self, doctree): - """ - Pick the best candidate for all image URIs. - """ - for node in doctree.traverse(nodes.image): - if '?' in node['candidates']: - # don't rewrite nonlocal image URIs - continue - if '*' not in node['candidates']: - for imgtype in self.supported_image_types: - candidate = node['candidates'].get(imgtype, None) - if candidate: - break - else: - self.warn('%s:%s: no matching candidate for image URI %r' % - (node.source, getattr(node, 'lineno', ''), node['uri'])) - continue - node['uri'] = candidate - else: - candidate = node['uri'] - if candidate not in self.env.images: - # non-existing URI; let it alone - continue - self.images[candidate] = self.env.images[candidate][1] - - # build methods - - def load_i18n(self): - """ - Load translated strings from the configured localedirs if - enabled in the configuration. - """ - self.translator = None - if self.config.language is not None: - self.info(bold('loading translations [%s]... ' % self.config.language), - nonl=True) - locale_dirs = [path.join(path.dirname(__file__), 'locale')] + \ - [path.join(self.srcdir, x) for x in self.config.locale_dirs] - for dir_ in locale_dirs: - try: - trans = gettext.translation('sphinx', localedir=dir_, - languages=[self.config.language]) - if self.translator is None: - self.translator = trans - else: - self.translator._catalog.update(trans.catalog) - except Exception: - # Language couldn't be found in the specified path - pass - if self.translator is not None: - self.info('done') - else: - self.info('locale not available') - if self.translator is None: - self.translator = gettext.NullTranslations() - self.translator.install(unicode=True) - locale.init() # translate common labels - - def load_env(self): - """Set up the build environment.""" - if self.env: - return - if not self.freshenv: - try: - self.info(bold('loading pickled environment... '), nonl=True) - self.env = BuildEnvironment.frompickle(self.config, - path.join(self.doctreedir, ENV_PICKLE_FILENAME)) - self.info('done') - except Exception, err: - if type(err) is IOError and err.errno == 2: - self.info('not found') - else: - self.info('failed: %s' % err) - self.env = BuildEnvironment(self.srcdir, self.doctreedir, self.config) - self.env.find_files(self.config) - else: - self.env = BuildEnvironment(self.srcdir, self.doctreedir, self.config) - self.env.find_files(self.config) - self.env.set_warnfunc(self.warn) - - def build_all(self): - """Build all source files.""" - self.build(None, summary='all source files', method='all') - - def build_specific(self, filenames): - """Only rebuild as much as needed for changes in the source_filenames.""" - # bring the filenames to the canonical format, that is, - # relative to the source directory and without source_suffix. - dirlen = len(self.srcdir) + 1 - to_write = [] - suffix = self.config.source_suffix - for filename in filenames: - filename = path.abspath(filename)[dirlen:] - if filename.endswith(suffix): - filename = filename[:-len(suffix)] - filename = filename.replace(os.path.sep, SEP) - to_write.append(filename) - self.build(to_write, method='specific', - summary='%d source files given on command ' - 'line' % len(to_write)) - - def build_update(self): - """Only rebuild files changed or added since last build.""" - to_build = self.get_outdated_docs() - if isinstance(to_build, str): - self.build(['__all__'], to_build) - else: - to_build = list(to_build) - self.build(to_build, - summary='targets for %d source files that are ' - 'out of date' % len(to_build)) - - def build(self, docnames, summary=None, method='update'): - if summary: - self.info(bold('building [%s]: ' % self.name), nonl=1) - self.info(summary) - - updated_docnames = [] - # while reading, collect all warnings from docutils - warnings = [] - self.env.set_warnfunc(warnings.append) - self.info(bold('updating environment: '), nonl=1) - iterator = self.env.update(self.config, self.srcdir, self.doctreedir, self.app) - # the first item in the iterator is a summary message - self.info(iterator.next()) - for docname in self.status_iterator(iterator, 'reading sources... ', purple): - updated_docnames.append(docname) - # nothing further to do, the environment has already done the reading - for warning in warnings: - if warning.strip(): - self.warn(warning) - self.env.set_warnfunc(self.warn) - - if updated_docnames: - # save the environment - self.info(bold('pickling environment... '), nonl=True) - self.env.topickle(path.join(self.doctreedir, ENV_PICKLE_FILENAME)) - self.info('done') - - # global actions - self.info(bold('checking consistency... '), nonl=True) - self.env.check_consistency() - self.info('done') - else: - if method == 'update' and not docnames: - self.info(bold('no targets are out of date.')) - return - - # another indirection to support methods which don't build files - # individually - self.write(docnames, updated_docnames, method) - - # finish (write static files etc.) - self.finish() - status = self.app.statuscode == 0 and 'succeeded' or 'finished with problems' - if self.app._warncount: - self.info(bold('build %s, %s warning%s.' % - (status, self.app._warncount, - self.app._warncount != 1 and 's' or ''))) - else: - self.info(bold('build %s.' % status)) - - def write(self, build_docnames, updated_docnames, method='update'): - if build_docnames is None or build_docnames == ['__all__']: - # build_all - build_docnames = self.env.found_docs - if method == 'update': - # build updated ones as well - docnames = set(build_docnames) | set(updated_docnames) - else: - docnames = set(build_docnames) - - # add all toctree-containing files that may have changed - for docname in list(docnames): - for tocdocname in self.env.files_to_rebuild.get(docname, []): - docnames.add(tocdocname) - docnames.add(self.config.master_doc) - - self.info(bold('preparing documents... '), nonl=True) - self.prepare_writing(docnames) - self.info('done') - - # write target files - warnings = [] - self.env.set_warnfunc(warnings.append) - for docname in self.status_iterator(sorted(docnames), - 'writing output... ', darkgreen): - doctree = self.env.get_and_resolve_doctree(docname, self) - self.write_doc(docname, doctree) - for warning in warnings: - if warning.strip(): - self.warn(warning) - self.env.set_warnfunc(self.warn) - - def prepare_writing(self, docnames): - raise NotImplementedError - - def write_doc(self, docname, doctree): - raise NotImplementedError - - def finish(self): - raise NotImplementedError - - -class StandaloneHTMLBuilder(Builder): - """ - Builds standalone HTML docs. - """ - name = 'html' - copysource = True - out_suffix = '.html' - indexer_format = js_index - supported_image_types = ['image/svg+xml', 'image/png', 'image/gif', - 'image/jpeg'] - searchindex_filename = 'searchindex.js' - add_header_links = True - add_definition_links = True - - # This is a class attribute because it is mutated by Sphinx.add_javascript. - script_files = ['_static/jquery.js', '_static/doctools.js'] - - def init(self): - """Load templates.""" - self.init_templates() - self.init_translator_class() - if self.config.html_file_suffix: - self.out_suffix = self.config.html_file_suffix - - if self.config.language is not None: - jsfile = path.join(path.dirname(__file__), 'locale', self.config.language, - 'LC_MESSAGES', 'sphinx.js') - if path.isfile(jsfile): - self.script_files.append('_static/translations.js') - - def init_translator_class(self): - if self.config.html_translator_class: - self.translator_class = self.app.import_object( - self.config.html_translator_class, 'html_translator_class setting') - elif self.config.html_use_smartypants: - self.translator_class = SmartyPantsHTMLTranslator - else: - self.translator_class = HTMLTranslator - - def render_partial(self, node): - """Utility: Render a lone doctree node.""" - doc = new_document('') - doc.append(node) - return publish_parts( - doc, - source_class=DocTreeInput, - reader=DoctreeReader(), - writer=HTMLWriter(self), - settings_overrides={'output_encoding': 'unicode'} - ) - - def prepare_writing(self, docnames): - from sphinx.search import IndexBuilder - - self.indexer = IndexBuilder(self.env) - self.load_indexer(docnames) - self.docwriter = HTMLWriter(self) - self.docsettings = OptionParser( - defaults=self.env.settings, - components=(self.docwriter,)).get_default_values() - - # format the "last updated on" string, only once is enough since it - # typically doesn't include the time of day - lufmt = self.config.html_last_updated_fmt - if lufmt is not None: - self.last_updated = ustrftime(lufmt or _('%b %d, %Y')) - else: - self.last_updated = None - - logo = self.config.html_logo and \ - path.basename(self.config.html_logo) or '' - - favicon = self.config.html_favicon and \ - path.basename(self.config.html_favicon) or '' - if favicon and os.path.splitext(favicon)[1] != '.ico': - self.warn('html_favicon is not an .ico file') - - if not isinstance(self.config.html_use_opensearch, basestring): - self.warn('html_use_opensearch config value must now be a string') - - self.relations = self.env.collect_relations() - - rellinks = [] - if self.config.html_use_index: - rellinks.append(('genindex', _('General Index'), 'I', _('index'))) - if self.config.html_use_modindex and self.env.modules: - rellinks.append(('modindex', _('Global Module Index'), 'M', _('modules'))) - - self.globalcontext = dict( - project = self.config.project, - release = self.config.release, - version = self.config.version, - last_updated = self.last_updated, - copyright = self.config.copyright, - master_doc = self.config.master_doc, - style = self.config.html_style, - use_opensearch = self.config.html_use_opensearch, - docstitle = self.config.html_title, - shorttitle = self.config.html_short_title, - show_sphinx = self.config.html_show_sphinx, - has_source = self.config.html_copy_source, - file_suffix = self.out_suffix, - script_files = self.script_files, - sphinx_version = __version__, - rellinks = rellinks, - builder = self.name, - parents = [], - logo = logo, - favicon = favicon, - ) - self.globalcontext.update(self.config.html_context) - - def get_doc_context(self, docname, body, metatags): - """Collect items for the template context of a page.""" - # find out relations - prev = next = None - parents = [] - rellinks = self.globalcontext['rellinks'][:] - related = self.relations.get(docname) - titles = self.env.titles - if related and related[2]: - try: - next = {'link': self.get_relative_uri(docname, related[2]), - 'title': self.render_partial(titles[related[2]])['title']} - rellinks.append((related[2], next['title'], 'N', _('next'))) - except KeyError: - next = None - if related and related[1]: - try: - prev = {'link': self.get_relative_uri(docname, related[1]), - 'title': self.render_partial(titles[related[1]])['title']} - rellinks.append((related[1], prev['title'], 'P', _('previous'))) - except KeyError: - # the relation is (somehow) not in the TOC tree, handle that gracefully - prev = None - while related and related[0]: - try: - parents.append( - {'link': self.get_relative_uri(docname, related[0]), - 'title': self.render_partial(titles[related[0]])['title']}) - except KeyError: - pass - related = self.relations.get(related[0]) - if parents: - parents.pop() # remove link to the master file; we have a generic - # "back to index" link already - parents.reverse() - - # title rendered as HTML - title = titles.get(docname) - title = title and self.render_partial(title)['title'] or '' - # the name for the copied source - sourcename = self.config.html_copy_source and docname + '.txt' or '' - - # metadata for the document - meta = self.env.metadata.get(docname) - - return dict( - parents = parents, - prev = prev, - next = next, - title = title, - meta = meta, - body = body, - metatags = metatags, - rellinks = rellinks, - sourcename = sourcename, - toc = self.render_partial(self.env.get_toc_for(docname))['fragment'], - # only display a TOC if there's more than one item to show - display_toc = (self.env.toc_num_entries[docname] > 1), - ) - - def write_doc(self, docname, doctree): - self.post_process_images(doctree) - destination = StringOutput(encoding='utf-8') - doctree.settings = self.docsettings - - self.imgpath = relative_uri(self.get_target_uri(docname), '_images') - self.docwriter.write(doctree, destination) - self.docwriter.assemble_parts() - body = self.docwriter.parts['fragment'] - metatags = self.docwriter.clean_meta - - ctx = self.get_doc_context(docname, body, metatags) - self.index_page(docname, doctree, ctx.get('title', '')) - self.handle_page(docname, ctx, event_arg=doctree) - - def finish(self): - self.info(bold('writing additional files...'), nonl=1) - - # the global general index - - if self.config.html_use_index: - # the total count of lines for each index letter, used to distribute - # the entries into two columns - genindex = self.env.create_index(self) - indexcounts = [] - for _, entries in genindex: - indexcounts.append(sum(1 + len(subitems) - for _, (_, subitems) in entries)) - - genindexcontext = dict( - genindexentries = genindex, - genindexcounts = indexcounts, - split_index = self.config.html_split_index, - ) - self.info(' genindex', nonl=1) - - if self.config.html_split_index: - self.handle_page('genindex', genindexcontext, 'genindex-split.html') - self.handle_page('genindex-all', genindexcontext, 'genindex.html') - for (key, entries), count in zip(genindex, indexcounts): - ctx = {'key': key, 'entries': entries, 'count': count, - 'genindexentries': genindex} - self.handle_page('genindex-' + key, ctx, 'genindex-single.html') - else: - self.handle_page('genindex', genindexcontext, 'genindex.html') - - # the global module index - - if self.config.html_use_modindex and self.env.modules: - # the sorted list of all modules, for the global module index - modules = sorted(((mn, (self.get_relative_uri('modindex', fn) + - '#module-' + mn, sy, pl, dep)) - for (mn, (fn, sy, pl, dep)) in - self.env.modules.iteritems()), - key=lambda x: x[0].lower()) - # collect all platforms - platforms = set() - # sort out collapsable modules - modindexentries = [] - letters = [] - pmn = '' - num_toplevels = 0 - num_collapsables = 0 - cg = 0 # collapse group - fl = '' # first letter - for mn, (fn, sy, pl, dep) in modules: - pl = pl and pl.split(', ') or [] - platforms.update(pl) - if fl != mn[0].lower() and mn[0] != '_': - # heading - modindexentries.append(['', False, 0, False, - mn[0].upper(), '', [], False]) - letters.append(mn[0].upper()) - tn = mn.split('.')[0] - if tn != mn: - # submodule - if pmn == tn: - # first submodule - make parent collapsable - modindexentries[-1][1] = True - num_collapsables += 1 - elif not pmn.startswith(tn): - # submodule without parent in list, add dummy entry - cg += 1 - modindexentries.append([tn, True, cg, False, '', '', [], False]) - else: - num_toplevels += 1 - cg += 1 - modindexentries.append([mn, False, cg, (tn != mn), fn, sy, pl, dep]) - pmn = mn - fl = mn[0].lower() - platforms = sorted(platforms) - - # apply heuristics when to collapse modindex at page load: - # only collapse if number of toplevel modules is larger than - # number of submodules - collapse = len(modules) - num_toplevels < num_toplevels - - modindexcontext = dict( - modindexentries = modindexentries, - platforms = platforms, - letters = letters, - collapse_modindex = collapse, - ) - self.info(' modindex', nonl=1) - self.handle_page('modindex', modindexcontext, 'modindex.html') - - # the search page - if self.name != 'htmlhelp': - self.info(' search', nonl=1) - self.handle_page('search', {}, 'search.html') - - # additional pages from conf.py - for pagename, template in self.config.html_additional_pages.items(): - self.info(' '+pagename, nonl=1) - self.handle_page(pagename, {}, template) - - if self.config.html_use_opensearch and self.name != 'htmlhelp': - self.info(' opensearch', nonl=1) - fn = path.join(self.outdir, '_static', 'opensearch.xml') - self.handle_page('opensearch', {}, 'opensearch.xml', outfilename=fn) - - self.info() - - # copy image files - if self.images: - self.info(bold('copying images...'), nonl=True) - ensuredir(path.join(self.outdir, '_images')) - for src, dest in self.images.iteritems(): - self.info(' '+src, nonl=1) - shutil.copyfile(path.join(self.srcdir, src), - path.join(self.outdir, '_images', dest)) - self.info() - - # copy static files - self.info(bold('copying static files... '), nonl=True) - ensuredir(path.join(self.outdir, '_static')) - # first, create pygments style file - f = open(path.join(self.outdir, '_static', 'pygments.css'), 'w') - f.write(PygmentsBridge('html', self.config.pygments_style).get_stylesheet()) - f.close() - # then, copy translations JavaScript file - if self.config.language is not None: - jsfile = path.join(path.dirname(__file__), 'locale', self.config.language, - 'LC_MESSAGES', 'sphinx.js') - if path.isfile(jsfile): - shutil.copyfile(jsfile, path.join(self.outdir, '_static', - 'translations.js')) - # then, copy over all user-supplied static files - staticdirnames = [path.join(path.dirname(__file__), 'static')] + \ - [path.join(self.confdir, spath) - for spath in self.config.html_static_path] - for staticdirname in staticdirnames: - for filename in os.listdir(staticdirname): - if filename.startswith('.'): - continue - fullname = path.join(staticdirname, filename) - targetname = path.join(self.outdir, '_static', filename) - if path.isfile(fullname): - shutil.copyfile(fullname, targetname) - elif path.isdir(fullname): - if filename in self.config.exclude_dirnames: - continue - if path.exists(targetname): - shutil.rmtree(targetname) - shutil.copytree(fullname, targetname) - # last, copy logo file (handled differently) - if self.config.html_logo: - logobase = path.basename(self.config.html_logo) - shutil.copyfile(path.join(self.confdir, self.config.html_logo), - path.join(self.outdir, '_static', logobase)) - self.info('done') - - # dump the search index - self.handle_finish() - - def get_outdated_docs(self): - if self.templates: - template_mtime = self.templates.newest_template_mtime() - else: - template_mtime = 0 - for docname in self.env.found_docs: - if docname not in self.env.all_docs: - yield docname - continue - targetname = self.env.doc2path(docname, self.outdir, self.out_suffix) - try: - targetmtime = path.getmtime(targetname) - except Exception: - targetmtime = 0 - try: - srcmtime = max(path.getmtime(self.env.doc2path(docname)), - template_mtime) - if srcmtime > targetmtime: - yield docname - except EnvironmentError: - # source doesn't exist anymore - pass - - def load_indexer(self, docnames): - keep = set(self.env.all_docs) - set(docnames) - try: - f = open(path.join(self.outdir, self.searchindex_filename), 'rb') - try: - self.indexer.load(f, self.indexer_format) - finally: - f.close() - except (IOError, OSError, ValueError): - if keep: - self.warn("search index couldn't be loaded, but not all documents " - "will be built: the index will be incomplete.") - # delete all entries for files that will be rebuilt - self.indexer.prune(keep) - - def index_page(self, pagename, doctree, title): - # only index pages with title - if self.indexer is not None and title: - self.indexer.feed(pagename, title, doctree) - - # --------- these are overwritten by the serialization builder - - def get_target_uri(self, docname, typ=None): - return docname + self.out_suffix - - def handle_page(self, pagename, addctx, templatename='page.html', - outfilename=None, event_arg=None): - ctx = self.globalcontext.copy() - # current_page_name is backwards compatibility - ctx['pagename'] = ctx['current_page_name'] = pagename - - def pathto(otheruri, resource=False, - baseuri=self.get_target_uri(pagename)): - if not resource: - otheruri = self.get_target_uri(otheruri) - return relative_uri(baseuri, otheruri) - ctx['pathto'] = pathto - ctx['hasdoc'] = lambda name: name in self.env.all_docs - ctx['customsidebar'] = self.config.html_sidebars.get(pagename) - ctx.update(addctx) - - self.app.emit('html-page-context', pagename, templatename, ctx, event_arg) - - output = self.templates.render(templatename, ctx) - if not outfilename: - outfilename = path.join(self.outdir, os_path(pagename) + self.out_suffix) - ensuredir(path.dirname(outfilename)) # normally different from self.outdir - try: - f = codecs.open(outfilename, 'w', 'utf-8') - try: - f.write(output) - finally: - f.close() - except (IOError, OSError), err: - self.warn("Error writing file %s: %s" % (outfilename, err)) - if self.copysource and ctx.get('sourcename'): - # copy the source file for the "show source" link - source_name = path.join(self.outdir, '_sources', os_path(ctx['sourcename'])) - ensuredir(path.dirname(source_name)) - shutil.copyfile(self.env.doc2path(pagename), source_name) - - def handle_finish(self): - self.info(bold('dumping search index... '), nonl=True) - self.indexer.prune(self.env.all_docs) - f = open(path.join(self.outdir, self.searchindex_filename), 'wb') - try: - self.indexer.dump(f, self.indexer_format) - finally: - f.close() - self.info('done') - - self.info(bold('dumping object inventory... '), nonl=True) - f = open(path.join(self.outdir, INVENTORY_FILENAME), 'w') - try: - f.write('# Sphinx inventory version 1\n') - f.write('# Project: %s\n' % self.config.project.encode('utf-8')) - f.write('# Version: %s\n' % self.config.version) - for modname, info in self.env.modules.iteritems(): - f.write('%s mod %s\n' % (modname, self.get_target_uri(info[0]))) - for refname, (docname, desctype) in self.env.descrefs.iteritems(): - f.write('%s %s %s\n' % (refname, desctype, self.get_target_uri(docname))) - finally: - f.close() - self.info('done') - - -class SerializingHTMLBuilder(StandaloneHTMLBuilder): - """ - An abstract builder that serializes the HTML generated. - """ - #: the serializing implementation to use. Set this to a module that - #: implements a `dump`, `load`, `dumps` and `loads` functions - #: (pickle, simplejson etc.) - implementation = None - - #: the filename for the global context file - globalcontext_filename = None - - supported_image_types = ('image/svg+xml', 'image/png', 'image/gif', - 'image/jpeg') - - def init(self): - self.init_translator_class() - self.templates = None # no template bridge necessary - - def get_target_uri(self, docname, typ=None): - if docname == 'index': - return '' - if docname.endswith(SEP + 'index'): - return docname[:-5] # up to sep - return docname + SEP - - def handle_page(self, pagename, ctx, templatename='page.html', - outfilename=None, event_arg=None): - ctx['current_page_name'] = pagename - sidebarfile = self.config.html_sidebars.get(pagename) - if sidebarfile: - ctx['customsidebar'] = sidebarfile - - if not outfilename: - outfilename = path.join(self.outdir, os_path(pagename) + self.out_suffix) - - self.app.emit('html-page-context', pagename, templatename, ctx, event_arg) - - ensuredir(path.dirname(outfilename)) - f = open(outfilename, 'wb') - try: - self.implementation.dump(ctx, f, 2) - finally: - f.close() - - # if there is a source file, copy the source file for the - # "show source" link - if ctx.get('sourcename'): - source_name = path.join(self.outdir, '_sources', - os_path(ctx['sourcename'])) - ensuredir(path.dirname(source_name)) - shutil.copyfile(self.env.doc2path(pagename), source_name) - - def handle_finish(self): - # dump the global context - outfilename = path.join(self.outdir, self.globalcontext_filename) - f = open(outfilename, 'wb') - try: - self.implementation.dump(self.globalcontext, f, 2) - finally: - f.close() - - # super here to dump the search index - StandaloneHTMLBuilder.handle_finish(self) - - # copy the environment file from the doctree dir to the output dir - # as needed by the web app - shutil.copyfile(path.join(self.doctreedir, ENV_PICKLE_FILENAME), - path.join(self.outdir, ENV_PICKLE_FILENAME)) - - # touch 'last build' file, used by the web application to determine - # when to reload its environment and clear the cache - open(path.join(self.outdir, LAST_BUILD_FILENAME), 'w').close() - - -class PickleHTMLBuilder(SerializingHTMLBuilder): - """ - A Builder that dumps the generated HTML into pickle files. - """ - implementation = pickle - indexer_format = pickle - name = 'pickle' - out_suffix = '.fpickle' - globalcontext_filename = 'globalcontext.pickle' - searchindex_filename = 'searchindex.pickle' - - -class JSONHTMLBuilder(SerializingHTMLBuilder): - """ - A builder that dumps the generated HTML into JSON files. - """ - implementation = json - indexer_format = json - name = 'json' - out_suffix = '.fjson' - globalcontext_filename = 'globalcontext.json' - searchindex_filename = 'searchindex.json' - - def init(self): - if json is None: - from sphinx.application import SphinxError - raise SphinxError('The module simplejson (or json in Python >= 2.6) ' - 'is not available. The JSONHTMLBuilder builder ' - 'will not work.') - SerializingHTMLBuilder.init(self) - - -class HTMLHelpBuilder(StandaloneHTMLBuilder): - """ - Builder that also outputs Windows HTML help project, contents and index files. - Adapted from the original Doc/tools/prechm.py. - """ - name = 'htmlhelp' - - # don't copy the reST source - copysource = False - supported_image_types = ['image/png', 'image/gif', 'image/jpeg'] - - # don't add links - add_header_links = False - add_definition_links = False - - def init(self): - StandaloneHTMLBuilder.init(self) - # the output files for HTML help must be .html only - self.out_suffix = '.html' - - def handle_finish(self): - build_hhx(self, self.outdir, self.config.htmlhelp_basename) - - -class LaTeXBuilder(Builder): - """ - Builds LaTeX output to create PDF. - """ - name = 'latex' - supported_image_types = ['application/pdf', 'image/png', 'image/gif', - 'image/jpeg'] - - def init(self): - self.docnames = [] - self.document_data = [] - texescape.init() - - def get_outdated_docs(self): - return 'all documents' # for now - - def get_target_uri(self, docname, typ=None): - if typ == 'token': - # token references are always inside production lists and must be - # replaced by \token{} in LaTeX - return '@token' - if docname not in self.docnames: - raise NoUri - else: - return '' - - def init_document_data(self): - preliminary_document_data = map(list, self.config.latex_documents) - if not preliminary_document_data: - self.warn('No "latex_documents" config value found; no documents ' - 'will be written.') - return - # assign subdirs to titles - self.titles = [] - for entry in preliminary_document_data: - docname = entry[0] - if docname not in self.env.all_docs: - self.warn('"latex_documents" config value references unknown ' - 'document %s' % docname) - continue - self.document_data.append(entry) - if docname.endswith(SEP+'index'): - docname = docname[:-5] - self.titles.append((docname, entry[2])) - - def write(self, *ignored): - # first, assemble the "appendix" docs that are in every PDF - appendices = [] - for fname in self.config.latex_appendices: - appendices.append(self.env.get_doctree(fname)) - - docwriter = LaTeXWriter(self) - docsettings = OptionParser( - defaults=self.env.settings, - components=(docwriter,)).get_default_values() - - self.init_document_data() - - for entry in self.document_data: - docname, targetname, title, author, docclass = entry[:5] - toctree_only = False - if len(entry) > 5: - toctree_only = entry[5] - destination = FileOutput( - destination_path=path.join(self.outdir, targetname), - encoding='utf-8') - self.info("processing " + targetname + "... ", nonl=1) - doctree = self.assemble_doctree(docname, toctree_only, - appendices=(docclass == 'manual') and appendices or []) - self.post_process_images(doctree) - self.info("writing... ", nonl=1) - doctree.settings = docsettings - doctree.settings.author = author - doctree.settings.title = title - doctree.settings.docname = docname - doctree.settings.docclass = docclass - docwriter.write(doctree, destination) - self.info("done") - - def assemble_doctree(self, indexfile, toctree_only, appendices): - self.docnames = set([indexfile] + appendices) - self.info(darkgreen(indexfile) + " ", nonl=1) - def process_tree(docname, tree): - tree = tree.deepcopy() - for toctreenode in tree.traverse(addnodes.toctree): - newnodes = [] - includefiles = map(str, toctreenode['includefiles']) - for includefile in includefiles: - try: - self.info(darkgreen(includefile) + " ", nonl=1) - subtree = process_tree(includefile, - self.env.get_doctree(includefile)) - self.docnames.add(includefile) - except Exception: - self.warn('%s: toctree contains ref to nonexisting file %r' % - (docname, includefile)) - else: - sof = addnodes.start_of_file() - sof.children = subtree.children - newnodes.append(sof) - toctreenode.parent.replace(toctreenode, newnodes) - return tree - tree = self.env.get_doctree(indexfile) - if toctree_only: - # extract toctree nodes from the tree and put them in a fresh document - new_tree = new_document('') - new_sect = nodes.section() - new_sect += nodes.title(u'', u'') - new_tree += new_sect - for node in tree.traverse(addnodes.toctree): - new_sect += node - tree = new_tree - largetree = process_tree(indexfile, tree) - largetree.extend(appendices) - self.info() - self.info("resolving references...") - self.env.resolve_references(largetree, indexfile, self) - # resolve :ref:s to distant tex files -- we can't add a cross-reference, - # but append the document name - for pendingnode in largetree.traverse(addnodes.pending_xref): - docname = pendingnode['refdocname'] - sectname = pendingnode['refsectname'] - newnodes = [nodes.emphasis(sectname, sectname)] - for subdir, title in self.titles: - if docname.startswith(subdir): - newnodes.append(nodes.Text(_(' (in '), _(' (in '))) - newnodes.append(nodes.emphasis(title, title)) - newnodes.append(nodes.Text(')', ')')) - break - else: - pass - pendingnode.replace_self(newnodes) - return largetree - - def finish(self): - # copy image files - if self.images: - self.info(bold('copying images...'), nonl=1) - for src, dest in self.images.iteritems(): - self.info(' '+src, nonl=1) - shutil.copyfile(path.join(self.srcdir, src), - path.join(self.outdir, dest)) - self.info() - - # the logo is handled differently - if self.config.latex_logo: - logobase = path.basename(self.config.latex_logo) - shutil.copyfile(path.join(self.confdir, self.config.latex_logo), - path.join(self.outdir, logobase)) - - self.info(bold('copying TeX support files... '), nonl=True) - staticdirname = path.join(path.dirname(__file__), 'texinputs') - for filename in os.listdir(staticdirname): - if not filename.startswith('.'): - shutil.copyfile(path.join(staticdirname, filename), - path.join(self.outdir, filename)) - self.info('done') - - -class ChangesBuilder(Builder): - """ - Write a summary with all versionadded/changed directives. - """ - name = 'changes' - - def init(self): - self.init_templates() - - def get_outdated_docs(self): - return self.outdir - - typemap = { - 'versionadded': 'added', - 'versionchanged': 'changed', - 'deprecated': 'deprecated', - } - - def write(self, *ignored): - version = self.config.version - libchanges = {} - apichanges = [] - otherchanges = {} - if version not in self.env.versionchanges: - self.info(bold('no changes in this version.')) - return - self.info(bold('writing summary file...')) - for type, docname, lineno, module, descname, content in \ - self.env.versionchanges[version]: - ttext = self.typemap[type] - context = content.replace('\n', ' ') - if descname and docname.startswith('c-api'): - if not descname: - continue - if context: - entry = '%s: %s: %s' % (descname, ttext, context) - else: - entry = '%s: %s.' % (descname, ttext) - apichanges.append((entry, docname, lineno)) - elif descname or module: - if not module: - module = _('Builtins') - if not descname: - descname = _('Module level') - if context: - entry = '%s: %s: %s' % (descname, ttext, context) - else: - entry = '%s: %s.' % (descname, ttext) - libchanges.setdefault(module, []).append((entry, docname, lineno)) - else: - if not context: - continue - entry = '%s: %s' % (ttext.capitalize(), context) - title = self.env.titles[docname].astext() - otherchanges.setdefault((docname, title), []).append( - (entry, docname, lineno)) - - ctx = { - 'project': self.config.project, - 'version': version, - 'docstitle': self.config.html_title, - 'shorttitle': self.config.html_short_title, - 'libchanges': sorted(libchanges.iteritems()), - 'apichanges': sorted(apichanges), - 'otherchanges': sorted(otherchanges.iteritems()), - 'show_sphinx': self.config.html_show_sphinx, - } - f = open(path.join(self.outdir, 'index.html'), 'w') - try: - f.write(self.templates.render('changes/frameset.html', ctx)) - finally: - f.close() - f = open(path.join(self.outdir, 'changes.html'), 'w') - try: - f.write(self.templates.render('changes/versionchanges.html', ctx)) - finally: - f.close() - - hltext = ['.. versionadded:: %s' % version, - '.. versionchanged:: %s' % version, - '.. deprecated:: %s' % version] - - def hl(no, line): - line = ' ' % no + escape(line) - for x in hltext: - if x in line: - line = '%s' % line - break - return line - - self.info(bold('copying source files...')) - for docname in self.env.all_docs: - f = open(self.env.doc2path(docname)) - lines = f.readlines() - targetfn = path.join(self.outdir, 'rst', os_path(docname)) + '.html' - ensuredir(path.dirname(targetfn)) - f = codecs.open(targetfn, 'w', 'utf8') - try: - text = ''.join(hl(i+1, line) for (i, line) in enumerate(lines)) - ctx = {'filename': self.env.doc2path(docname, None), 'text': text} - f.write(self.templates.render('changes/rstsource.html', ctx)) - finally: - f.close() - shutil.copyfile(path.join(path.dirname(__file__), 'static', 'default.css'), - path.join(self.outdir, 'default.css')) - - def hl(self, text, version): - text = escape(text) - for directive in ['versionchanged', 'versionadded', 'deprecated']: - text = text.replace('.. %s:: %s' % (directive, version), - '.. %s:: %s' % (directive, version)) - return text - - def finish(self): - pass - - -class TextBuilder(Builder): - name = 'text' - out_suffix = '.txt' - - def init(self): - pass - - def get_outdated_docs(self): - for docname in self.env.found_docs: - if docname not in self.env.all_docs: - yield docname - continue - targetname = self.env.doc2path(docname, self.outdir, self.out_suffix) - try: - targetmtime = path.getmtime(targetname) - except Exception: - targetmtime = 0 - try: - srcmtime = path.getmtime(self.env.doc2path(docname)) - if srcmtime > targetmtime: - yield docname - except EnvironmentError: - # source doesn't exist anymore - pass - - def get_target_uri(self, docname, typ=None): - return '' - - def prepare_writing(self, docnames): - self.writer = TextWriter(self) - - def write_doc(self, docname, doctree): - destination = StringOutput(encoding='utf-8') - self.writer.write(doctree, destination) - outfilename = path.join(self.outdir, os_path(docname) + self.out_suffix) - ensuredir(path.dirname(outfilename)) # normally different from self.outdir - try: - f = codecs.open(outfilename, 'w', 'utf-8') - try: - f.write(self.writer.output) - finally: - f.close() - except (IOError, OSError), err: - self.warn("Error writing file %s: %s" % (outfilename, err)) - - def finish(self): - pass - - -# compatibility alias -WebHTMLBuilder = PickleHTMLBuilder - - -from sphinx.linkcheck import CheckExternalLinksBuilder - -builtin_builders = { - 'html': StandaloneHTMLBuilder, - 'pickle': PickleHTMLBuilder, - 'json': JSONHTMLBuilder, - 'web': PickleHTMLBuilder, - 'htmlhelp': HTMLHelpBuilder, - 'latex': LaTeXBuilder, - 'text': TextBuilder, - 'changes': ChangesBuilder, - 'linkcheck': CheckExternalLinksBuilder, -} diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/cmdline.py --- a/buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/cmdline.py Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,186 +0,0 @@ -# -*- coding: utf-8 -*- -""" - sphinx.cmdline - ~~~~~~~~~~~~~~ - - sphinx-build command-line handling. - - :copyright: 2008 by Georg Brandl. - :license: BSD. -""" - -import os -import sys -import getopt -import traceback -from os import path - -from docutils.utils import SystemMessage - -from sphinx import __version__ -from sphinx.application import Sphinx, SphinxError -from sphinx.util import format_exception_cut_frames, save_traceback -from sphinx.util.console import darkred, nocolor, color_terminal - - -def usage(argv, msg=None): - if msg: - print >>sys.stderr, msg - print >>sys.stderr - print >>sys.stderr, """\ -Sphinx v%s -Usage: %s [options] sourcedir outdir [filenames...] -Options: -b -- builder to use; default is html - -a -- write all files; default is to only write new and changed files - -E -- don't use a saved environment, always read all files - -d -- path for the cached environment and doctree files - (default: outdir/.doctrees) - -c -- path where configuration file (conf.py) is located - (default: same as sourcedir) - -C -- use no config file at all, only -D options - -D -- override a setting in configuration - -A -- pass a value into the templates, for HTML builder - -N -- do not do colored output - -q -- no output on stdout, just warnings on stderr - -Q -- no output at all, not even warnings - -P -- run Pdb on exception -Modi: -* without -a and without filenames, write new and changed files. -* with -a, write all files. -* with filenames, write these.""" % (__version__, argv[0]) - - -def main(argv): - if not sys.stdout.isatty() or not color_terminal(): - # Windows' poor cmd box doesn't understand ANSI sequences - nocolor() - - try: - opts, args = getopt.getopt(argv[1:], 'ab:d:c:CD:A:NEqP') - allopts = set(opt[0] for opt in opts) - srcdir = confdir = path.abspath(args[0]) - if not path.isdir(srcdir): - print >>sys.stderr, 'Error: Cannot find source directory.' - return 1 - if not path.isfile(path.join(srcdir, 'conf.py')) and \ - '-c' not in allopts and '-C' not in allopts: - print >>sys.stderr, 'Error: Source directory doesn\'t contain conf.py file.' - return 1 - outdir = path.abspath(args[1]) - if not path.isdir(outdir): - print >>sys.stderr, 'Making output directory...' - os.makedirs(outdir) - except (IndexError, getopt.error): - usage(argv) - return 1 - - filenames = args[2:] - err = 0 - for filename in filenames: - if not path.isfile(filename): - print >>sys.stderr, 'Cannot find file %r.' % filename - err = 1 - if err: - return 1 - - buildername = all_files = None - freshenv = use_pdb = False - status = sys.stdout - warning = sys.stderr - confoverrides = {} - htmlcontext = {} - doctreedir = path.join(outdir, '.doctrees') - for opt, val in opts: - if opt == '-b': - buildername = val - elif opt == '-a': - if filenames: - usage(argv, 'Cannot combine -a option and filenames.') - return 1 - all_files = True - elif opt == '-d': - doctreedir = path.abspath(val) - elif opt == '-c': - confdir = path.abspath(val) - if not path.isfile(path.join(confdir, 'conf.py')): - print >>sys.stderr, \ - 'Error: Configuration directory doesn\'t contain conf.py file.' - return 1 - elif opt == '-C': - confdir = None - elif opt == '-D': - try: - key, val = val.split('=') - except ValueError: - print >>sys.stderr, \ - 'Error: -D option argument must be in the form name=value.' - return 1 - try: - val = int(val) - except ValueError: - pass - confoverrides[key] = val - elif opt == '-A': - try: - key, val = val.split('=') - except ValueError: - print >>sys.stderr, \ - 'Error: -A option argument must be in the form name=value.' - return 1 - try: - val = int(val) - except ValueError: - pass - htmlcontext[key] = val - elif opt == '-N': - nocolor() - elif opt == '-E': - freshenv = True - elif opt == '-q': - status = None - elif opt == '-Q': - status = None - warning = None - elif opt == '-P': - use_pdb = True - confoverrides['html_context'] = htmlcontext - - try: - app = Sphinx(srcdir, confdir, outdir, doctreedir, buildername, - confoverrides, status, warning, freshenv) - app.build(all_files, filenames) - return app.statuscode - except KeyboardInterrupt: - if use_pdb: - import pdb - print >>sys.stderr, darkred('Interrupted while building, starting debugger:') - traceback.print_exc() - pdb.post_mortem(sys.exc_info()[2]) - return 1 - except Exception, err: - if use_pdb: - import pdb - print >>sys.stderr, darkred('Exception occurred while building, ' - 'starting debugger:') - traceback.print_exc() - pdb.post_mortem(sys.exc_info()[2]) - else: - if isinstance(err, SystemMessage): - print >>sys.stderr, darkred('reST markup error:') - print >>sys.stderr, err.args[0].encode('ascii', 'backslashreplace') - elif isinstance(err, SphinxError): - print >>sys.stderr, darkred('%s:' % err.category) - print >>sys.stderr, err - else: - print >>sys.stderr, darkred('Exception occurred:') - print >>sys.stderr, format_exception_cut_frames().rstrip() - tbpath = save_traceback() - print >>sys.stderr, darkred('The full traceback has been saved ' - 'in %s, if you want to report the ' - 'issue to the author.' % tbpath) - print >>sys.stderr, ('Please also report this if it was a user ' - 'error, so that a better error message ' - 'can be provided next time.') - print >>sys.stderr, ('Send reports to sphinx-dev@googlegroups.com. ' - 'Thanks!') - return 1 diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/config.py --- a/buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/config.py Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,140 +0,0 @@ -# -*- coding: utf-8 -*- -""" - sphinx.config - ~~~~~~~~~~~~~ - - Build configuration file handling. - - :copyright: 2008 by Georg Brandl. - :license: BSD license. -""" - -import os -from os import path - - -class Config(object): - """Configuration file abstraction.""" - - # the values are: (default, needs fresh doctrees if changed) - - # If you add a value here, don't forget to include it in the - # quickstart.py file template as well as in the docs! - - config_values = dict( - # general options - project = ('Python', True), - copyright = ('', False), - version = ('', True), - release = ('', True), - today = ('', True), - today_fmt = (None, True), # the real default is locale-dependent - - language = (None, True), - locale_dirs = ([], True), - - master_doc = ('contents', True), - source_suffix = ('.rst', True), - source_encoding = ('utf-8', True), - unused_docs = ([], True), - exclude_dirs = ([], True), - exclude_trees = ([], True), - exclude_dirnames = ([], True), - default_role = (None, True), - add_function_parentheses = (True, True), - add_module_names = (True, True), - show_authors = (False, True), - pygments_style = ('sphinx', False), - highlight_language = ('python', False), - templates_path = ([], False), - template_bridge = (None, False), - keep_warnings = (False, True), - - # HTML options - html_title = (lambda self: '%s v%s documentation' % - (self.project, self.release), - False), - html_short_title = (lambda self: self.html_title, False), - html_style = ('default.css', False), - html_logo = (None, False), - html_favicon = (None, False), - html_static_path = ([], False), - html_last_updated_fmt = (None, False), # the real default is locale-dependent - html_use_smartypants = (True, False), - html_translator_class = (None, False), - html_sidebars = ({}, False), - html_additional_pages = ({}, False), - html_use_modindex = (True, False), - html_use_index = (True, False), - html_split_index = (False, False), - html_copy_source = (True, False), - html_use_opensearch = ('', False), - html_file_suffix = (None, False), - html_show_sphinx = (True, False), - html_context = ({}, False), - - # HTML help only options - htmlhelp_basename = ('pydoc', False), - - # LaTeX options - latex_documents = ([], False), - latex_logo = (None, False), - latex_appendices = ([], False), - latex_use_parts = (False, False), - latex_use_modindex = (True, False), - # paper_size and font_size are still separate values - # so that you can give them easily on the command line - latex_paper_size = ('letter', False), - latex_font_size = ('10pt', False), - latex_elements = ({}, False), - # now deprecated - use latex_elements - latex_preamble = ('', False), - ) - - def __init__(self, dirname, filename, overrides): - self.overrides = overrides - self.values = Config.config_values.copy() - config = {} - if dirname is not None: - config['__file__'] = path.join(dirname, filename) - olddir = os.getcwd() - try: - os.chdir(dirname) - execfile(config['__file__'], config) - finally: - os.chdir(olddir) - self._raw_config = config - # these two must be preinitialized because extensions can add their - # own config values - self.setup = config.get('setup', None) - self.extensions = config.get('extensions', []) - - def init_values(self): - config = self._raw_config - config.update(self.overrides) - for name in config: - if name in self.values: - self.__dict__[name] = config[name] - del self._raw_config - - def __getattr__(self, name): - if name.startswith('_'): - raise AttributeError(name) - if name not in self.values: - raise AttributeError('No such config value: %s' % name) - default = self.values[name][0] - if callable(default): - return default(self) - return default - - def __getitem__(self, name): - return getattr(self, name) - - def __setitem__(self, name, value): - setattr(self, name, value) - - def __delitem__(self, name): - delattr(self, name) - - def __contains__(self, name): - return name in self.values diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/directives/__init__.py --- a/buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/directives/__init__.py Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,14 +0,0 @@ -# -*- coding: utf-8 -*- -""" - sphinx.directives - ~~~~~~~~~~~~~~~~~ - - Handlers for additional ReST directives. - - :copyright: 2008 by Georg Brandl. - :license: BSD. -""" - -from sphinx.directives.desc import * -from sphinx.directives.code import * -from sphinx.directives.other import * diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/directives/code.py --- a/buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/directives/code.py Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,99 +0,0 @@ -# -*- coding: utf-8 -*- -""" - sphinx.directives.code - ~~~~~~~~~~~~~~~~~~~~~~ - - :copyright: 2007-2008 by Georg Brandl. - :license: BSD. -""" - -import sys -import codecs -from os import path - -from docutils import nodes -from docutils.parsers.rst import directives - -from sphinx import addnodes - - -# ------ highlight directive -------------------------------------------------------- - -def highlightlang_directive(name, arguments, options, content, lineno, - content_offset, block_text, state, state_machine): - if 'linenothreshold' in options: - try: - linenothreshold = int(options['linenothreshold']) - except Exception: - linenothreshold = 10 - else: - linenothreshold = sys.maxint - return [addnodes.highlightlang(lang=arguments[0].strip(), - linenothreshold=linenothreshold)] - -highlightlang_directive.content = 0 -highlightlang_directive.arguments = (1, 0, 0) -highlightlang_directive.options = {'linenothreshold': directives.unchanged} -directives.register_directive('highlight', highlightlang_directive) -directives.register_directive('highlightlang', highlightlang_directive) # old name - - -# ------ code-block directive ------------------------------------------------------- - -def codeblock_directive(name, arguments, options, content, lineno, - content_offset, block_text, state, state_machine): - code = u'\n'.join(content) - literal = nodes.literal_block(code, code) - literal['language'] = arguments[0] - literal['linenos'] = 'linenos' in options - return [literal] - -codeblock_directive.content = 1 -codeblock_directive.arguments = (1, 0, 0) -codeblock_directive.options = {'linenos': directives.flag} -directives.register_directive('code-block', codeblock_directive) -directives.register_directive('sourcecode', codeblock_directive) - - -# ------ literalinclude directive --------------------------------------------------- - -def literalinclude_directive(name, arguments, options, content, lineno, - content_offset, block_text, state, state_machine): - """Like .. include:: :literal:, but only warns if the include file is not found.""" - if not state.document.settings.file_insertion_enabled: - return [state.document.reporter.warning('File insertion disabled', line=lineno)] - env = state.document.settings.env - rel_fn = arguments[0] - source_dir = path.dirname(path.abspath(state_machine.input_lines.source( - lineno - state_machine.input_offset - 1))) - fn = path.normpath(path.join(source_dir, rel_fn)) - - encoding = options.get('encoding', env.config.source_encoding) - try: - f = codecs.open(fn, 'r', encoding) - text = f.read() - f.close() - except (IOError, OSError): - retnode = state.document.reporter.warning( - 'Include file %r not found or reading it failed' % arguments[0], line=lineno) - except UnicodeError: - retnode = state.document.reporter.warning( - 'Encoding %r used for reading included file %r seems to ' - 'be wrong, try giving an :encoding: option' % - (encoding, arguments[0])) - else: - retnode = nodes.literal_block(text, text, source=fn) - retnode.line = 1 - if options.get('language', ''): - retnode['language'] = options['language'] - if 'linenos' in options: - retnode['linenos'] = True - state.document.settings.env.note_dependency(rel_fn) - return [retnode] - -literalinclude_directive.options = {'linenos': directives.flag, - 'language': directives.unchanged, - 'encoding': directives.encoding} -literalinclude_directive.content = 0 -literalinclude_directive.arguments = (1, 0, 0) -directives.register_directive('literalinclude', literalinclude_directive) diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/directives/desc.py --- a/buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/directives/desc.py Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,592 +0,0 @@ -# -*- coding: utf-8 -*- -""" - sphinx.directives.desc - ~~~~~~~~~~~~~~~~~~~~~~ - - :copyright: 2007-2008 by Georg Brandl. - :license: BSD. -""" - -import re -import string - -from docutils import nodes -from docutils.parsers.rst import directives - -from sphinx import addnodes -from sphinx.util import ws_re - - -# ------ information units --------------------------------------------------------- - -def desc_index_text(desctype, module, name, add_modules): - if desctype == 'function': - if not module: - return _('%s() (built-in function)') % name - return _('%s() (in module %s)') % (name, module) - elif desctype == 'data': - if not module: - return _('%s (built-in variable)') % name - return _('%s (in module %s)') % (name, module) - elif desctype == 'class': - if not module: - return _('%s (built-in class)') % name - return _('%s (class in %s)') % (name, module) - elif desctype == 'exception': - return name - elif desctype == 'method': - try: - clsname, methname = name.rsplit('.', 1) - except ValueError: - if module: - return _('%s() (in module %s)') % (name, module) - else: - return '%s()' % name - if module and add_modules: - return _('%s() (%s.%s method)') % (methname, module, clsname) - else: - return _('%s() (%s method)') % (methname, clsname) - elif desctype == 'staticmethod': - try: - clsname, methname = name.rsplit('.', 1) - except ValueError: - if module: - return _('%s() (in module %s)') % (name, module) - else: - return '%s()' % name - if module and add_modules: - return _('%s() (%s.%s static method)') % (methname, module, clsname) - else: - return _('%s() (%s static method)') % (methname, clsname) - elif desctype == 'attribute': - try: - clsname, attrname = name.rsplit('.', 1) - except ValueError: - if module: - return _('%s (in module %s)') % (name, module) - else: - return name - if module and add_modules: - return _('%s (%s.%s attribute)') % (attrname, module, clsname) - else: - return _('%s (%s attribute)') % (attrname, clsname) - elif desctype == 'cfunction': - return _('%s (C function)') % name - elif desctype == 'cmember': - return _('%s (C member)') % name - elif desctype == 'cmacro': - return _('%s (C macro)') % name - elif desctype == 'ctype': - return _('%s (C type)') % name - elif desctype == 'cvar': - return _('%s (C variable)') % name - else: - raise ValueError('unhandled descenv: %s' % desctype) - - -# ------ make field lists (like :param foo:) in desc bodies prettier - -_ = lambda x: x # make gettext extraction in constants possible - -doc_fields_with_arg = { - 'param': '%param', - 'parameter': '%param', - 'arg': '%param', - 'argument': '%param', - 'keyword': '%param', - 'kwarg': '%param', - 'kwparam': '%param', - 'type': '%type', - 'raises': _('Raises'), - 'raise': 'Raises', - 'exception': 'Raises', - 'except': 'Raises', - 'var': _('Variable'), - 'ivar': 'Variable', - 'cvar': 'Variable', - 'returns': _('Returns'), - 'return': 'Returns', -} - -doc_fields_with_linked_arg = ('raises', 'raise', 'exception', 'except') - -doc_fields_without_arg = { - 'returns': 'Returns', - 'return': 'Returns', - 'rtype': _('Return type'), -} - -del _ - - -def _is_only_paragraph(node): - # determine if the node only contains one paragraph (and system messages) - if len(node) == 0: - return False - elif len(node) > 1: - for subnode in node[1:]: - if not isinstance(subnode, nodes.system_message): - return False - if isinstance(node[0], nodes.paragraph): - return True - return False - - -def handle_doc_fields(node, env): - # don't traverse, only handle field lists that are immediate children - for child in node.children: - if not isinstance(child, nodes.field_list): - continue - params = None - param_nodes = {} - param_types = {} - new_list = nodes.field_list() - for field in child: - fname, fbody = field - try: - typ, obj = fname.astext().split(None, 1) - typdesc = _(doc_fields_with_arg[typ]) - if _is_only_paragraph(fbody): - children = fbody.children[0].children - else: - children = fbody.children - if typdesc == '%param': - if not params: - pfield = nodes.field() - pfield += nodes.field_name('', _('Parameters')) - pfield += nodes.field_body() - params = nodes.bullet_list() - pfield[1] += params - new_list += pfield - dlitem = nodes.list_item() - dlpar = nodes.paragraph() - dlpar += nodes.emphasis(obj, obj) - dlpar += nodes.Text(' -- ', ' -- ') - dlpar += children - param_nodes[obj] = dlpar - dlitem += dlpar - params += dlitem - elif typdesc == '%type': - typenodes = fbody.children - if _is_only_paragraph(fbody): - typenodes = [nodes.Text(' (')] + \ - typenodes[0].children + [nodes.Text(')')] - param_types[obj] = typenodes - else: - fieldname = typdesc + ' ' - nfield = nodes.field() - nfieldname = nodes.field_name(fieldname, fieldname) - nfield += nfieldname - node = nfieldname - if typ in doc_fields_with_linked_arg: - node = addnodes.pending_xref(obj, reftype='obj', - refcaption=False, - reftarget=obj, - modname=env.currmodule, - classname=env.currclass) - nfieldname += node - node += nodes.Text(obj, obj) - nfield += nodes.field_body() - nfield[1] += fbody.children - new_list += nfield - except (KeyError, ValueError): - fnametext = fname.astext() - try: - typ = _(doc_fields_without_arg[fnametext]) - except KeyError: - # at least capitalize the field name - typ = fnametext.capitalize() - fname[0] = nodes.Text(typ) - new_list += field - for param, type in param_types.iteritems(): - if param in param_nodes: - param_nodes[param][1:1] = type - child.replace_self(new_list) - - -# ------ functions to parse a Python or C signature and create desc_* nodes. - -py_sig_re = re.compile( - r'''^ ([\w.]*\.)? # class name(s) - (\w+) \s* # thing name - (?: $(.*)$ # optional arguments - (\s* -> \s* .*)? )? $ # optional return annotation - ''', re.VERBOSE) - -py_paramlist_re = re.compile(r'([\[\],])') # split at '[', ']' and ',' - -def parse_py_signature(signode, sig, desctype, module, env): - """ - Transform a python signature into RST nodes. - Return (fully qualified name of the thing, classname if any). - - If inside a class, the current class name is handled intelligently: - * it is stripped from the displayed name if present - * it is added to the full name (return value) if not present - """ - m = py_sig_re.match(sig) - if m is None: - raise ValueError - classname, name, arglist, retann = m.groups() - - if retann: - retann = u' \N{RIGHTWARDS ARROW} ' + retann.strip()[2:] - - if env.currclass: - add_module = False - if classname and classname.startswith(env.currclass): - fullname = classname + name - # class name is given again in the signature - classname = classname[len(env.currclass):].lstrip('.') - elif classname: - # class name is given in the signature, but different - # (shouldn't happen) - fullname = env.currclass + '.' + classname + name - else: - # class name is not given in the signature - fullname = env.currclass + '.' + name - else: - add_module = True - fullname = classname and classname + name or name - - if desctype == 'staticmethod': - signode += addnodes.desc_annotation('static ', 'static ') - - if classname: - signode += addnodes.desc_addname(classname, classname) - # exceptions are a special case, since they are documented in the - # 'exceptions' module. - elif add_module and env.config.add_module_names and \ - module and module != 'exceptions': - nodetext = module + '.' - signode += addnodes.desc_addname(nodetext, nodetext) - - signode += addnodes.desc_name(name, name) - if not arglist: - if desctype in ('function', 'method', 'staticmethod'): - # for callables, add an empty parameter list - signode += addnodes.desc_parameterlist() - if retann: - signode += addnodes.desc_type(retann, retann) - return fullname, classname - signode += addnodes.desc_parameterlist() - - stack = [signode[-1]] - for token in py_paramlist_re.split(arglist): - if token == '[': - opt = addnodes.desc_optional() - stack[-1] += opt - stack.append(opt) - elif token == ']': - try: - stack.pop() - except IndexError: - raise ValueError - elif not token or token == ',' or token.isspace(): - pass - else: - token = token.strip() - stack[-1] += addnodes.desc_parameter(token, token) - if len(stack) != 1: - raise ValueError - if retann: - signode += addnodes.desc_type(retann, retann) - return fullname, classname - - -c_sig_re = re.compile( - r'''^([^(]*?) # return type - ([\w:]+) \s* # thing name (colon allowed for C++ class names) - (?: $(.*)$ )? # optionally arguments - (\s+const)? $ # const specifier - ''', re.VERBOSE) -c_funcptr_sig_re = re.compile( - r'''^([^(]+?) # return type - ($ [^()]+ $) \s* # name in parentheses - $ (.*) $ # arguments - (\s+const)? $ # const specifier - ''', re.VERBOSE) -c_funcptr_name_re = re.compile(r'^$\s*\*\s*(.*?)\s*$$') - -# RE to split at word boundaries -wsplit_re = re.compile(r'(\W+)') - -# These C types aren't described in the reference, so don't try to create -# a cross-reference to them -stopwords = set(('const', 'void', 'char', 'int', 'long', 'FILE', 'struct')) - -def parse_c_type(node, ctype): - # add cross-ref nodes for all words - for part in filter(None, wsplit_re.split(ctype)): - tnode = nodes.Text(part, part) - if part[0] in string.letters+'_' and part not in stopwords: - pnode = addnodes.pending_xref( - '', reftype='ctype', reftarget=part, modname=None, classname=None) - pnode += tnode - node += pnode - else: - node += tnode - -def parse_c_signature(signode, sig, desctype): - """Transform a C (or C++) signature into RST nodes.""" - # first try the function pointer signature regex, it's more specific - m = c_funcptr_sig_re.match(sig) - if m is None: - m = c_sig_re.match(sig) - if m is None: - raise ValueError('no match') - rettype, name, arglist, const = m.groups() - - signode += addnodes.desc_type('', '') - parse_c_type(signode[-1], rettype) - try: - classname, funcname = name.split('::', 1) - classname += '::' - signode += addnodes.desc_addname(classname, classname) - signode += addnodes.desc_name(funcname, funcname) - # name (the full name) is still both parts - except ValueError: - signode += addnodes.desc_name(name, name) - # clean up parentheses from canonical name - m = c_funcptr_name_re.match(name) - if m: - name = m.group(1) - if not arglist: - if desctype == 'cfunction': - # for functions, add an empty parameter list - signode += addnodes.desc_parameterlist() - return name - - paramlist = addnodes.desc_parameterlist() - arglist = arglist.replace('`', '').replace('\\ ', '') # remove markup - # this messes up function pointer types, but not too badly ;) - args = arglist.split(',') - for arg in args: - arg = arg.strip() - param = addnodes.desc_parameter('', '', noemph=True) - try: - ctype, argname = arg.rsplit(' ', 1) - except ValueError: - # no argument name given, only the type - parse_c_type(param, arg) - else: - parse_c_type(param, ctype) - param += nodes.emphasis(' '+argname, ' '+argname) - paramlist += param - signode += paramlist - if const: - signode += addnodes.desc_addname(const, const) - return name - - -option_desc_re = re.compile( - r'((?:/|-|--)[-_a-zA-Z0-9]+)(\s*.*?)(?=,\s+(?:/|-|--)|$)') - -def parse_option_desc(signode, sig): - """Transform an option description into RST nodes.""" - count = 0 - firstname = '' - for m in option_desc_re.finditer(sig): - optname, args = m.groups() - if count: - signode += addnodes.desc_addname(', ', ', ') - signode += addnodes.desc_name(optname, optname) - signode += addnodes.desc_addname(args, args) - if not count: - firstname = optname - count += 1 - if not firstname: - raise ValueError - return firstname - - -strip_backslash_re = re.compile(r'\\(?=[^\\])') - -def desc_directive(desctype, arguments, options, content, lineno, - content_offset, block_text, state, state_machine): - env = state.document.settings.env - inode = addnodes.index(entries=[]) - node = addnodes.desc() - node['desctype'] = desctype - - noindex = ('noindex' in options) - node['noindex'] = noindex - # remove backslashes to support (dummy) escapes; helps Vim's highlighting - signatures = map(lambda s: strip_backslash_re.sub('', s.strip()), - arguments[0].split('\n')) - names = [] - clsname = None - module = options.get('module', env.currmodule) - for i, sig in enumerate(signatures): - # add a signature node for each signature in the current unit - # and add a reference target for it - sig = sig.strip() - signode = addnodes.desc_signature(sig, '') - signode['first'] = False - node.append(signode) - try: - if desctype in ('function', 'data', 'class', 'exception', - 'method', 'staticmethod', 'attribute'): - name, clsname = parse_py_signature(signode, sig, desctype, module, env) - elif desctype in ('cfunction', 'cmember', 'cmacro', 'ctype', 'cvar'): - name = parse_c_signature(signode, sig, desctype) - elif desctype == 'cmdoption': - optname = parse_option_desc(signode, sig) - if not noindex: - targetname = optname.replace('/', '-') - if env.currprogram: - targetname = '-' + env.currprogram + targetname - targetname = 'cmdoption' + targetname - signode['ids'].append(targetname) - state.document.note_explicit_target(signode) - inode['entries'].append( - ('pair', _('%scommand line option; %s') % - ((env.currprogram and env.currprogram + ' ' or ''), sig), - targetname, targetname)) - env.note_progoption(optname, targetname) - continue - elif desctype == 'describe': - signode.clear() - signode += addnodes.desc_name(sig, sig) - continue - else: - # another registered generic x-ref directive - rolename, indextemplate, parse_node = additional_xref_types[desctype] - if parse_node: - fullname = parse_node(env, sig, signode) - else: - signode.clear() - signode += addnodes.desc_name(sig, sig) - # normalize whitespace like xfileref_role does - fullname = ws_re.sub('', sig) - if not noindex: - targetname = '%s-%s' % (rolename, fullname) - signode['ids'].append(targetname) - state.document.note_explicit_target(signode) - if indextemplate: - indexentry = _(indextemplate) % (fullname,) - indextype = 'single' - colon = indexentry.find(':') - if colon != -1: - indextype = indexentry[:colon].strip() - indexentry = indexentry[colon+1:].strip() - inode['entries'].append((indextype, indexentry, - targetname, targetname)) - env.note_reftarget(rolename, fullname, targetname) - # don't use object indexing below - continue - except ValueError, err: - # signature parsing failed - signode.clear() - signode += addnodes.desc_name(sig, sig) - continue # we don't want an index entry here - # only add target and index entry if this is the first description of the - # function name in this desc block - if not noindex and name not in names: - fullname = (module and module + '.' or '') + name - # note target - if fullname not in state.document.ids: - signode['names'].append(fullname) - signode['ids'].append(fullname) - signode['first'] = (not names) - state.document.note_explicit_target(signode) - env.note_descref(fullname, desctype, lineno) - names.append(name) - - indextext = desc_index_text(desctype, module, name, - env.config.add_module_names) - inode['entries'].append(('single', indextext, fullname, fullname)) - - subnode = addnodes.desc_content() - # needed for automatic qualification of members - clsname_set = False - if desctype in ('class', 'exception') and names: - env.currclass = names[0] - clsname_set = True - elif desctype in ('method', 'staticmethod', 'attribute') and \ - clsname and not env.currclass: - env.currclass = clsname.strip('.') - clsname_set = True - # needed for association of version{added,changed} directives - if names: - env.currdesc = names[0] - state.nested_parse(content, content_offset, subnode) - handle_doc_fields(subnode, env) - if clsname_set: - env.currclass = None - env.currdesc = None - node.append(subnode) - return [inode, node] - -desc_directive.content = 1 -desc_directive.arguments = (1, 0, 1) -desc_directive.options = {'noindex': directives.flag, - 'module': directives.unchanged} - -desctypes = [ - # the Python ones - 'function', - 'data', - 'class', - 'method', - 'staticmethod', - 'attribute', - 'exception', - # the C ones - 'cfunction', - 'cmember', - 'cmacro', - 'ctype', - 'cvar', - # for command line options - 'cmdoption', - # the generic one - 'describe', - 'envvar', -] - -for _name in desctypes: - directives.register_directive(_name, desc_directive) - -_ = lambda x: x - -# Generic cross-reference types; they can be registered in the application; -# the directives are either desc_directive or target_directive -additional_xref_types = { - # directive name: (role name, index text, function to parse the desc node) - 'envvar': ('envvar', _('environment variable; %s'), None), -} - -del _ - - -# ------ target -------------------------------------------------------------------- - -def target_directive(targettype, arguments, options, content, lineno, - content_offset, block_text, state, state_machine): - """Generic target for user-defined cross-reference types.""" - env = state.document.settings.env - rolename, indextemplate, foo = additional_xref_types[targettype] - # normalize whitespace in fullname like xfileref_role does - fullname = ws_re.sub('', arguments[0].strip()) - targetname = '%s-%s' % (rolename, fullname) - node = nodes.target('', '', ids=[targetname]) - state.document.note_explicit_target(node) - ret = [node] - if indextemplate: - indexentry = indextemplate % (fullname,) - indextype = 'single' - colon = indexentry.find(':') - if colon != -1: - indextype = indexentry[:colon].strip() - indexentry = indexentry[colon+1:].strip() - inode = addnodes.index(entries=[(indextype, indexentry, targetname, targetname)]) - ret.insert(0, inode) - env.note_reftarget(rolename, fullname, targetname) - return ret - -target_directive.content = 0 -target_directive.arguments = (1, 0, 1) - -# note, the target directive is not registered here, it is used by the application -# when registering additional xref types diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/directives/other.py --- a/buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/directives/other.py Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,411 +0,0 @@ -# -*- coding: utf-8 -*- -""" - sphinx.directives.other - ~~~~~~~~~~~~~~~~~~~~~~~ - - :copyright: 2007-2008 by Georg Brandl. - :license: BSD. -""" - -import re -import posixpath - -from docutils import nodes -from docutils.parsers.rst import directives - -from sphinx import addnodes -from sphinx.locale import pairindextypes -from sphinx.util import patfilter, ws_re, caption_ref_re -from sphinx.util.compat import make_admonition - - -# ------ the TOC tree --------------------------------------------------------------- - -def toctree_directive(name, arguments, options, content, lineno, - content_offset, block_text, state, state_machine): - env = state.document.settings.env - suffix = env.config.source_suffix - dirname = posixpath.dirname(env.docname) - glob = 'glob' in options - - ret = [] - subnode = addnodes.toctree() - includefiles = [] - includetitles = {} - all_docnames = env.found_docs.copy() - # don't add the currently visited file in catch-all patterns - all_docnames.remove(env.docname) - for entry in content: - if not entry: - continue - if not glob: - # look for explicit titles and documents ("Some Title "). - m = caption_ref_re.match(entry) - if m: - docname = m.group(2) - includetitles[docname] = m.group(1) - else: - docname = entry - # remove suffixes (backwards compatibility) - if docname.endswith(suffix): - docname = docname[:-len(suffix)] - # absolutize filenames - docname = posixpath.normpath(posixpath.join(dirname, docname)) - if docname not in env.found_docs: - ret.append(state.document.reporter.warning( - 'toctree references unknown document %r' % docname, line=lineno)) - else: - includefiles.append(docname) - else: - patname = posixpath.normpath(posixpath.join(dirname, entry)) - docnames = sorted(patfilter(all_docnames, patname)) - for docname in docnames: - all_docnames.remove(docname) # don't include it again - includefiles.append(docname) - if not docnames: - ret.append(state.document.reporter.warning( - 'toctree glob pattern %r didn\'t match any documents' % entry, - line=lineno)) - subnode['includefiles'] = includefiles - subnode['includetitles'] = includetitles - subnode['maxdepth'] = options.get('maxdepth', -1) - subnode['glob'] = glob - ret.append(subnode) - return ret - -toctree_directive.content = 1 -toctree_directive.options = {'maxdepth': int, 'glob': directives.flag} -directives.register_directive('toctree', toctree_directive) - - -# ------ section metadata ---------------------------------------------------------- - -def module_directive(name, arguments, options, content, lineno, - content_offset, block_text, state, state_machine): - env = state.document.settings.env - modname = arguments[0].strip() - noindex = 'noindex' in options - env.currmodule = modname - env.note_module(modname, options.get('synopsis', ''), - options.get('platform', ''), - 'deprecated' in options) - modulenode = addnodes.module() - modulenode['modname'] = modname - modulenode['synopsis'] = options.get('synopsis', '') - targetnode = nodes.target('', '', ids=['module-' + modname]) - state.document.note_explicit_target(targetnode) - ret = [modulenode, targetnode] - if 'platform' in options: - modulenode['platform'] = options['platform'] - node = nodes.paragraph() - node += nodes.emphasis('', _('Platforms: ')) - node += nodes.Text(options['platform'], options['platform']) - ret.append(node) - # the synopsis isn't printed; in fact, it is only used in the modindex currently - if not noindex: - indextext = _('%s (module)') % modname - inode = addnodes.index(entries=[('single', indextext, - 'module-' + modname, modname)]) - ret.insert(0, inode) - return ret - -module_directive.arguments = (1, 0, 0) -module_directive.options = {'platform': lambda x: x, - 'synopsis': lambda x: x, - 'noindex': directives.flag, - 'deprecated': directives.flag} -directives.register_directive('module', module_directive) - - -def currentmodule_directive(name, arguments, options, content, lineno, - content_offset, block_text, state, state_machine): - # This directive is just to tell people that we're documenting - # stuff in module foo, but links to module foo won't lead here. - env = state.document.settings.env - modname = arguments[0].strip() - if modname == 'None': - env.currmodule = None - else: - env.currmodule = modname - return [] - -currentmodule_directive.arguments = (1, 0, 0) -directives.register_directive('currentmodule', currentmodule_directive) - - -def author_directive(name, arguments, options, content, lineno, - content_offset, block_text, state, state_machine): - # Show authors only if the show_authors option is on - env = state.document.settings.env - if not env.config.show_authors: - return [] - para = nodes.paragraph() - emph = nodes.emphasis() - para += emph - if name == 'sectionauthor': - text = _('Section author: ') - elif name == 'moduleauthor': - text = _('Module author: ') - else: - text = _('Author: ') - emph += nodes.Text(text, text) - inodes, messages = state.inline_text(arguments[0], lineno) - emph.extend(inodes) - return [para] + messages - -author_directive.arguments = (1, 0, 1) -directives.register_directive('sectionauthor', author_directive) -directives.register_directive('moduleauthor', author_directive) - - -def program_directive(name, arguments, options, content, lineno, - content_offset, block_text, state, state_machine): - env = state.document.settings.env - program = ws_re.sub('-', arguments[0].strip()) - if program == 'None': - env.currprogram = None - else: - env.currprogram = program - return [] - -program_directive.arguments = (1, 0, 1) -directives.register_directive('program', program_directive) - - -# ------ index markup -------------------------------------------------------------- - -indextypes = [ - 'single', 'pair', 'triple', -] - -def index_directive(name, arguments, options, content, lineno, - content_offset, block_text, state, state_machine): - arguments = arguments[0].split('\n') - env = state.document.settings.env - targetid = 'index-%s' % env.index_num - env.index_num += 1 - targetnode = nodes.target('', '', ids=[targetid]) - state.document.note_explicit_target(targetnode) - indexnode = addnodes.index() - indexnode['entries'] = ne = [] - for entry in arguments: - entry = entry.strip() - for type in pairindextypes: - if entry.startswith(type+':'): - value = entry[len(type)+1:].strip() - value = pairindextypes[type] + '; ' + value - ne.append(('pair', value, targetid, value)) - break - else: - for type in indextypes: - if entry.startswith(type+':'): - value = entry[len(type)+1:].strip() - ne.append((type, value, targetid, value)) - break - # shorthand notation for single entries - else: - for value in entry.split(','): - value = value.strip() - if not value: - continue - ne.append(('single', value, targetid, value)) - return [indexnode, targetnode] - -index_directive.arguments = (1, 0, 1) -directives.register_directive('index', index_directive) - -# ------ versionadded/versionchanged ----------------------------------------------- - -def version_directive(name, arguments, options, content, lineno, - content_offset, block_text, state, state_machine): - node = addnodes.versionmodified() - node['type'] = name - node['version'] = arguments[0] - if len(arguments) == 2: - inodes, messages = state.inline_text(arguments[1], lineno+1) - node.extend(inodes) - if content: - state.nested_parse(content, content_offset, node) - ret = [node] + messages - else: - ret = [node] - env = state.document.settings.env - env.note_versionchange(node['type'], node['version'], node, lineno) - return ret - -version_directive.arguments = (1, 1, 1) -version_directive.content = 1 - -directives.register_directive('deprecated', version_directive) -directives.register_directive('versionadded', version_directive) -directives.register_directive('versionchanged', version_directive) - - -# ------ see also ------------------------------------------------------------------ - -def seealso_directive(name, arguments, options, content, lineno, - content_offset, block_text, state, state_machine): - ret = make_admonition( - addnodes.seealso, name, [_('See also')], options, content, - lineno, content_offset, block_text, state, state_machine) - if arguments: - argnodes, msgs = state.inline_text(arguments[0], lineno) - para = nodes.paragraph() - para += argnodes - para += msgs - ret[0].insert(1, para) - return ret - -seealso_directive.content = 1 -seealso_directive.arguments = (0, 1, 1) -directives.register_directive('seealso', seealso_directive) - - -# ------ production list (for the reference) --------------------------------------- - -token_re = re.compile('`([a-z_]+)`') - -def token_xrefs(text, env): - retnodes = [] - pos = 0 - for m in token_re.finditer(text): - if m.start() > pos: - txt = text[pos:m.start()] - retnodes.append(nodes.Text(txt, txt)) - refnode = addnodes.pending_xref(m.group(1)) - refnode['reftype'] = 'token' - refnode['reftarget'] = m.group(1) - refnode['modname'] = env.currmodule - refnode['classname'] = env.currclass - refnode += nodes.literal(m.group(1), m.group(1), classes=['xref']) - retnodes.append(refnode) - pos = m.end() - if pos < len(text): - retnodes.append(nodes.Text(text[pos:], text[pos:])) - return retnodes - -def productionlist_directive(name, arguments, options, content, lineno, - content_offset, block_text, state, state_machine): - env = state.document.settings.env - node = addnodes.productionlist() - messages = [] - i = 0 - - for rule in arguments[0].split('\n'): - if i == 0 and ':' not in rule: - # production group - continue - i += 1 - try: - name, tokens = rule.split(':', 1) - except ValueError: - break - subnode = addnodes.production() - subnode['tokenname'] = name.strip() - if subnode['tokenname']: - idname = 'grammar-token-%s' % subnode['tokenname'] - if idname not in state.document.ids: - subnode['ids'].append(idname) - state.document.note_implicit_target(subnode, subnode) - env.note_reftarget('token', subnode['tokenname'], idname) - subnode.extend(token_xrefs(tokens, env)) - node.append(subnode) - return [node] + messages - -productionlist_directive.content = 0 -productionlist_directive.arguments = (1, 0, 1) -directives.register_directive('productionlist', productionlist_directive) - - -# ------ glossary directive --------------------------------------------------------- - -def glossary_directive(name, arguments, options, content, lineno, - content_offset, block_text, state, state_machine): - """Glossary with cross-reference targets for :term: roles.""" - env = state.document.settings.env - node = addnodes.glossary() - state.nested_parse(content, content_offset, node) - - # the content should be definition lists - dls = [child for child in node if isinstance(child, nodes.definition_list)] - # now, extract definition terms to enable cross-reference creation - for dl in dls: - dl['classes'].append('glossary') - for li in dl.children: - if not li.children or not isinstance(li[0], nodes.term): - continue - termtext = li.children[0].astext() - new_id = 'term-' + nodes.make_id(termtext) - if new_id in env.gloss_entries: - new_id = 'term-' + str(len(env.gloss_entries)) - env.gloss_entries.add(new_id) - li[0]['names'].append(new_id) - li[0]['ids'].append(new_id) - state.document.settings.env.note_reftarget('term', termtext.lower(), - new_id) - # add an index entry too - indexnode = addnodes.index() - indexnode['entries'] = [('single', termtext, new_id, termtext)] - li.insert(0, indexnode) - return [node] - -glossary_directive.content = 1 -glossary_directive.arguments = (0, 0, 0) -directives.register_directive('glossary', glossary_directive) - - -# ------ miscellaneous markup ------------------------------------------------------- - -def centered_directive(name, arguments, options, content, lineno, - content_offset, block_text, state, state_machine): - if not arguments: - return [] - subnode = addnodes.centered() - inodes, messages = state.inline_text(arguments[0], lineno) - subnode.extend(inodes) - return [subnode] + messages - -centered_directive.arguments = (1, 0, 1) -directives.register_directive('centered', centered_directive) - - -def acks_directive(name, arguments, options, content, lineno, - content_offset, block_text, state, state_machine): - node = addnodes.acks() - state.nested_parse(content, content_offset, node) - if len(node.children) != 1 or not isinstance(node.children[0], nodes.bullet_list): - return [state.document.reporter.warning('.. acks content is not a list', - line=lineno)] - return [node] - -acks_directive.content = 1 -acks_directive.arguments = (0, 0, 0) -directives.register_directive('acks', acks_directive) - - -def tabularcolumns_directive(name, arguments, options, content, lineno, - content_offset, block_text, state, state_machine): - # support giving explicit tabulary column definition to latex - node = addnodes.tabular_col_spec() - node['spec'] = arguments[0] - return [node] - -tabularcolumns_directive.content = 0 -tabularcolumns_directive.arguments = (1, 0, 1) -directives.register_directive('tabularcolumns', tabularcolumns_directive) - - -# register the standard rst class directive under a different name - -try: - # docutils 0.4 - from docutils.parsers.rst.directives.misc import class_directive - directives.register_directive('cssclass', class_directive) -except ImportError: - try: - # docutils 0.5 - from docutils.parsers.rst.directives.misc import Class - directives.register_directive('cssclass', Class) - except ImportError: - # whatever :) - pass diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/environment.py --- a/buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/environment.py Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,1387 +0,0 @@ -# -*- coding: utf-8 -*- -""" - sphinx.environment - ~~~~~~~~~~~~~~~~~~ - - Global creation environment. - - :copyright: 2007-2008 by Georg Brandl. - :license: BSD. -""" - -import re -import os -import time -import heapq -import types -import imghdr -import difflib -import cPickle as pickle -from os import path -from glob import glob -from string import uppercase -from itertools import izip, groupby -try: - import hashlib - md5 = hashlib.md5 -except ImportError: - # 2.4 compatibility - import md5 - md5 = md5.new - -from docutils import nodes -from docutils.io import FileInput, NullOutput -from docutils.core import Publisher -from docutils.utils import Reporter, relative_path -from docutils.readers import standalone -from docutils.parsers.rst import roles -from docutils.parsers.rst.languages import en as english -from docutils.parsers.rst.directives.html import MetaBody -from docutils.writers import UnfilteredWriter -from docutils.transforms import Transform -from docutils.transforms.parts import ContentsFilter - -from sphinx import addnodes -from sphinx.util import get_matching_docs, SEP, ustrftime -from sphinx.directives import additional_xref_types - -default_settings = { - 'embed_stylesheet': False, - 'cloak_email_addresses': True, - 'pep_base_url': 'http://www.python.org/dev/peps/', - 'rfc_base_url': 'http://rfc.net/', - 'input_encoding': 'utf-8', - 'doctitle_xform': False, - 'sectsubtitle_xform': False, -} - -# This is increased every time an environment attribute is added -# or changed to properly invalidate pickle files. -ENV_VERSION = 26 - - -default_substitutions = set([ - 'version', - 'release', - 'today', -]) - -dummy_reporter = Reporter('', 4, 4) - - -class RedirStream(object): - def __init__(self, writefunc): - self.writefunc = writefunc - def write(self, text): - if text.strip(): - self.writefunc(text) - - -class NoUri(Exception): - """Raised by get_relative_uri if there is no URI available.""" - pass - - -class DefaultSubstitutions(Transform): - """ - Replace some substitutions if they aren't defined in the document. - """ - # run before the default Substitutions - default_priority = 210 - - def apply(self): - config = self.document.settings.env.config - # only handle those not otherwise defined in the document - to_handle = default_substitutions - set(self.document.substitution_defs) - for ref in self.document.traverse(nodes.substitution_reference): - refname = ref['refname'] - if refname in to_handle: - text = config[refname] - if refname == 'today' and not text: - # special handling: can also specify a strftime format - text = ustrftime(config.today_fmt or _('%B %d, %Y')) - ref.replace_self(nodes.Text(text, text)) - - -class MoveModuleTargets(Transform): - """ - Move module targets to their nearest enclosing section title. - """ - default_priority = 210 - - def apply(self): - for node in self.document.traverse(nodes.target): - if not node['ids']: - continue - if node['ids'][0].startswith('module-') and \ - node.parent.__class__ is nodes.section: - node.parent['ids'] = node['ids'] - node.parent.remove(node) - - -class HandleCodeBlocks(Transform): - """ - Move doctest blocks out of blockquotes. - """ - default_priority = 210 - - def apply(self): - for node in self.document.traverse(nodes.block_quote): - if len(node.children) == 1 and isinstance(node.children[0], - nodes.doctest_block): - node.replace_self(node.children[0]) - -class CitationReferences(Transform): - """ - Handle citation references before the default docutils transform does. - """ - default_priority = 619 - - def apply(self): - for citnode in self.document.traverse(nodes.citation_reference): - cittext = citnode.astext() - refnode = addnodes.pending_xref(cittext, reftype='citation', - reftarget=cittext) - refnode += nodes.Text('[' + cittext + ']') - citnode.parent.replace(citnode, refnode) - - -class SphinxStandaloneReader(standalone.Reader): - """ - Add our own transforms. - """ - transforms = [CitationReferences, DefaultSubstitutions, MoveModuleTargets, - HandleCodeBlocks] - - def get_transforms(self): - return standalone.Reader.get_transforms(self) + self.transforms - - -class SphinxDummyWriter(UnfilteredWriter): - supported = ('html',) # needed to keep "meta" nodes - - def translate(self): - pass - - - -class SphinxContentsFilter(ContentsFilter): - """ - Used with BuildEnvironment.add_toc_from() to discard cross-file links - within table-of-contents link nodes. - """ - def visit_pending_xref(self, node): - text = node.astext() - self.parent.append(nodes.literal(text, text)) - raise nodes.SkipNode - - -class BuildEnvironment: - """ - The environment in which the ReST files are translated. - Stores an inventory of cross-file targets and provides doctree - transformations to resolve links to them. - """ - - # --------- ENVIRONMENT PERSISTENCE ---------------------------------------- - - @staticmethod - def frompickle(config, filename): - picklefile = open(filename, 'rb') - try: - env = pickle.load(picklefile) - finally: - picklefile.close() - env.config.values = config.values - if env.version != ENV_VERSION: - raise IOError('env version not current') - return env - - def topickle(self, filename): - # remove unpicklable attributes - warnfunc = self._warnfunc - self.set_warnfunc(None) - values = self.config.values - del self.config.values - picklefile = open(filename, 'wb') - # remove potentially pickling-problematic values from config - for key, val in vars(self.config).items(): - if key.startswith('_') or \ - isinstance(val, types.ModuleType) or \ - isinstance(val, types.FunctionType) or \ - isinstance(val, (type, types.ClassType)): - del self.config[key] - try: - pickle.dump(self, picklefile, pickle.HIGHEST_PROTOCOL) - finally: - picklefile.close() - # reset attributes - self.config.values = values - self.set_warnfunc(warnfunc) - - # --------- ENVIRONMENT INITIALIZATION ------------------------------------- - - def __init__(self, srcdir, doctreedir, config): - self.doctreedir = doctreedir - self.srcdir = srcdir - self.config = config - - # the application object; only set while update() runs - self.app = None - - # the docutils settings for building - self.settings = default_settings.copy() - self.settings['env'] = self - - # the function to write warning messages with - self._warnfunc = None - - # this is to invalidate old pickles - self.version = ENV_VERSION - - # All "docnames" here are /-separated and relative and exclude the source suffix. - - self.found_docs = set() # contains all existing docnames - self.all_docs = {} # docname -> mtime at the time of build - # contains all built docnames - self.dependencies = {} # docname -> set of dependent file names, relative to - # documentation root - - # File metadata - self.metadata = {} # docname -> dict of metadata items - - # TOC inventory - self.titles = {} # docname -> title node - self.tocs = {} # docname -> table of contents nodetree - self.toc_num_entries = {} # docname -> number of real entries - # used to determine when to show the TOC in a sidebar - # (don't show if it's only one item) - self.toctree_includes = {} # docname -> list of toctree includefiles - self.files_to_rebuild = {} # docname -> set of files (containing its TOCs) - # to rebuild too - self.glob_toctrees = set() # docnames that have :glob: toctrees - - # X-ref target inventory - self.descrefs = {} # fullname -> docname, desctype - self.filemodules = {} # docname -> [modules] - self.modules = {} # modname -> docname, synopsis, platform, deprecated - self.labels = {} # labelname -> docname, labelid, sectionname - self.anonlabels = {} # labelname -> docname, labelid - self.progoptions = {} # (program, name) -> docname, labelid - self.reftargets = {} # (type, name) -> docname, labelid - # where type is term, token, envvar, citation - - # Other inventories - self.indexentries = {} # docname -> list of - # (type, string, target, aliasname) - self.versionchanges = {} # version -> list of - # (type, docname, lineno, module, descname, content) - self.images = {} # absolute path -> (docnames, unique filename) - - # These are set while parsing a file - self.docname = None # current document name - self.currmodule = None # current module name - self.currclass = None # current class name - self.currdesc = None # current descref name - self.currprogram = None # current program name - self.index_num = 0 # autonumber for index targets - self.gloss_entries = set() # existing definition labels - - # Some magically present labels - self.labels['genindex'] = ('genindex', '', _('Index')) - self.labels['modindex'] = ('modindex', '', _('Module Index')) - self.labels['search'] = ('search', '', _('Search Page')) - - def set_warnfunc(self, func): - self._warnfunc = func - self.settings['warning_stream'] = RedirStream(func) - - def warn(self, docname, msg, lineno=None): - if docname: - if lineno is None: - lineno = '' - self._warnfunc('%s:%s: %s' % (self.doc2path(docname), lineno, msg)) - else: - self._warnfunc('GLOBAL:: ' + msg) - - def clear_doc(self, docname): - """Remove all traces of a source file in the inventory.""" - if docname in self.all_docs: - self.all_docs.pop(docname, None) - self.metadata.pop(docname, None) - self.dependencies.pop(docname, None) - self.titles.pop(docname, None) - self.tocs.pop(docname, None) - self.toc_num_entries.pop(docname, None) - self.toctree_includes.pop(docname, None) - self.filemodules.pop(docname, None) - self.indexentries.pop(docname, None) - self.glob_toctrees.discard(docname) - - for subfn, fnset in self.files_to_rebuild.items(): - fnset.discard(docname) - if not fnset: - del self.files_to_rebuild[subfn] - for fullname, (fn, _) in self.descrefs.items(): - if fn == docname: - del self.descrefs[fullname] - for modname, (fn, _, _, _) in self.modules.items(): - if fn == docname: - del self.modules[modname] - for labelname, (fn, _, _) in self.labels.items(): - if fn == docname: - del self.labels[labelname] - for key, (fn, _) in self.reftargets.items(): - if fn == docname: - del self.reftargets[key] - for key, (fn, _) in self.progoptions.items(): - if fn == docname: - del self.progoptions[key] - for version, changes in self.versionchanges.items(): - new = [change for change in changes if change[1] != docname] - changes[:] = new - for fullpath, (docs, _) in self.images.items(): - docs.discard(docname) - if not docs: - del self.images[fullpath] - - def doc2path(self, docname, base=True, suffix=None): - """ - Return the filename for the document name. - If base is True, return absolute path under self.srcdir. - If base is None, return relative path to self.srcdir. - If base is a path string, return absolute path under that. - If suffix is not None, add it instead of config.source_suffix. - """ - suffix = suffix or self.config.source_suffix - if base is True: - return path.join(self.srcdir, docname.replace(SEP, path.sep)) + suffix - elif base is None: - return docname.replace(SEP, path.sep) + suffix - else: - return path.join(base, docname.replace(SEP, path.sep)) + suffix - - def find_files(self, config): - """ - Find all source files in the source dir and put them in self.found_docs. - """ - exclude_dirs = [d.replace(SEP, path.sep) for d in config.exclude_dirs] - exclude_trees = [d.replace(SEP, path.sep) for d in config.exclude_trees] - self.found_docs = set(get_matching_docs( - self.srcdir, config.source_suffix, exclude_docs=set(config.unused_docs), - exclude_dirs=exclude_dirs, exclude_trees=exclude_trees, - exclude_dirnames=['_sources'] + config.exclude_dirnames)) - - def get_outdated_files(self, config_changed): - """ - Return (added, changed, removed) sets. - """ - # clear all files no longer present - removed = set(self.all_docs) - self.found_docs - - added = set() - changed = set() - - if config_changed: - # config values affect e.g. substitutions - added = self.found_docs - else: - for docname in self.found_docs: - if docname not in self.all_docs: - added.add(docname) - continue - # if the doctree file is not there, rebuild - if not path.isfile(self.doc2path(docname, self.doctreedir, - '.doctree')): - changed.add(docname) - continue - # check the mtime of the document - mtime = self.all_docs[docname] - newmtime = path.getmtime(self.doc2path(docname)) - if newmtime > mtime: - changed.add(docname) - continue - # finally, check the mtime of dependencies - for dep in self.dependencies.get(docname, ()): - try: - # this will do the right thing when dep is absolute too - deppath = path.join(self.srcdir, dep) - if not path.isfile(deppath): - changed.add(docname) - break - depmtime = path.getmtime(deppath) - if depmtime > mtime: - changed.add(docname) - break - except EnvironmentError: - # give it another chance - changed.add(docname) - break - - return added, changed, removed - - def update(self, config, srcdir, doctreedir, app=None): - """(Re-)read all files new or changed since last update. Yields a summary - and then docnames as it processes them. Store all environment docnames - in the canonical format (ie using SEP as a separator in place of - os.path.sep).""" - config_changed = False - if self.config is None: - msg = '[new config] ' - config_changed = True - else: - # check if a config value was changed that affects how doctrees are read - for key, descr in config.config_values.iteritems(): - if not descr[1]: - continue - if self.config[key] != config[key]: - msg = '[config changed] ' - config_changed = True - break - else: - msg = '' - # this value is not covered by the above loop because it is handled - # specially by the config class - if self.config.extensions != config.extensions: - msg = '[extensions changed] ' - config_changed = True - # the source and doctree directories may have been relocated - self.srcdir = srcdir - self.doctreedir = doctreedir - self.find_files(config) - - added, changed, removed = self.get_outdated_files(config_changed) - - # if files were added or removed, all documents with globbed toctrees - # must be reread - if added or removed: - changed.update(self.glob_toctrees) - - msg += '%s added, %s changed, %s removed' % (len(added), len(changed), - len(removed)) - yield msg - - self.config = config - self.app = app - - # clear all files no longer present - for docname in removed: - if app: - app.emit('env-purge-doc', self, docname) - self.clear_doc(docname) - - # read all new and changed files - for docname in sorted(added | changed): - yield docname - self.read_doc(docname, app=app) - - if config.master_doc not in self.all_docs: - self.warn(None, 'master file %s not found' % - self.doc2path(config.master_doc)) - - self.app = None - - # remove all non-existing images from inventory - for imgsrc in self.images.keys(): - if not os.access(path.join(self.srcdir, imgsrc), os.R_OK): - del self.images[imgsrc] - - if app: - app.emit('env-updated', self) - - - # --------- SINGLE FILE READING -------------------------------------------- - - def read_doc(self, docname, src_path=None, save_parsed=True, app=None): - """ - Parse a file and add/update inventory entries for the doctree. - If srcpath is given, read from a different source file. - """ - # remove all inventory entries for that file - if app: - app.emit('env-purge-doc', self, docname) - self.clear_doc(docname) - - if src_path is None: - src_path = self.doc2path(docname) - - if self.config.default_role: - role_fn, messages = roles.role(self.config.default_role, english, - 0, dummy_reporter) - if role_fn: - roles._roles[''] = role_fn - else: - self.warn(docname, 'default role %s not found' % - self.config.default_role) - - self.docname = docname - self.settings['input_encoding'] = self.config.source_encoding - - class SphinxSourceClass(FileInput): - def read(self): - data = FileInput.read(self) - if app: - arg = [data] - app.emit('source-read', docname, arg) - data = arg[0] - return data - - # publish manually - pub = Publisher(reader=SphinxStandaloneReader(), - writer=SphinxDummyWriter(), - source_class=SphinxSourceClass, - destination_class=NullOutput) - pub.set_components(None, 'restructuredtext', None) - pub.process_programmatic_settings(None, self.settings, None) - pub.set_source(None, src_path) - pub.set_destination(None, None) - try: - pub.publish() - doctree = pub.document - except UnicodeError, err: - from sphinx.application import SphinxError - raise SphinxError(err.message) - self.filter_messages(doctree) - self.process_dependencies(docname, doctree) - self.process_images(docname, doctree) - self.process_metadata(docname, doctree) - self.create_title_from(docname, doctree) - self.note_labels_from(docname, doctree) - self.note_indexentries_from(docname, doctree) - self.note_citations_from(docname, doctree) - self.build_toc_from(docname, doctree) - - # store time of reading, used to find outdated files - self.all_docs[docname] = time.time() - - if app: - app.emit('doctree-read', doctree) - - # make it picklable - doctree.reporter = None - doctree.transformer = None - doctree.settings.warning_stream = None - doctree.settings.env = None - doctree.settings.record_dependencies = None - for metanode in doctree.traverse(MetaBody.meta): - # docutils' meta nodes aren't picklable because the class is nested - metanode.__class__ = addnodes.meta - - # cleanup - self.docname = None - self.currmodule = None - self.currclass = None - self.gloss_entries = set() - - if save_parsed: - # save the parsed doctree - doctree_filename = self.doc2path(docname, self.doctreedir, '.doctree') - dirname = path.dirname(doctree_filename) - if not path.isdir(dirname): - os.makedirs(dirname) - f = open(doctree_filename, 'wb') - try: - pickle.dump(doctree, f, pickle.HIGHEST_PROTOCOL) - finally: - f.close() - else: - return doctree - - def filter_messages(self, doctree): - """ - Filter system messages from a doctree. - """ - filterlevel = self.config.keep_warnings and 2 or 5 - for node in doctree.traverse(nodes.system_message): - if node['level'] < filterlevel: - node.parent.remove(node) - - def process_dependencies(self, docname, doctree): - """ - Process docutils-generated dependency info. - """ - deps = doctree.settings.record_dependencies - if not deps: - return - docdir = path.dirname(self.doc2path(docname, base=None)) - for dep in deps.list: - dep = path.join(docdir, dep) - self.dependencies.setdefault(docname, set()).add(dep) - - def process_images(self, docname, doctree): - """ - Process and rewrite image URIs. - """ - existing_names = set(v[1] for v in self.images.itervalues()) - docdir = path.dirname(self.doc2path(docname, base=None)) - for node in doctree.traverse(nodes.image): - # Map the mimetype to the corresponding image. The writer may - # choose the best image from these candidates. The special key * is - # set if there is only single candiate to be used by a writer. - # The special key ? is set for nonlocal URIs. - node['candidates'] = candidates = {} - imguri = node['uri'] - if imguri.find('://') != -1: - self.warn(docname, 'Nonlocal image URI found: %s' % imguri, node.line) - candidates['?'] = imguri - continue - # imgpath is the image path *from srcdir* - imgpath = path.normpath(path.join(docdir, imguri)) - # set imgpath as default URI - node['uri'] = imgpath - if imgpath.endswith(os.extsep + '*'): - for filename in glob(path.join(self.srcdir, imgpath)): - new_imgpath = relative_path(self.srcdir, filename) - if filename.lower().endswith('.pdf'): - candidates['application/pdf'] = new_imgpath - elif filename.lower().endswith('.svg'): - candidates['image/svg+xml'] = new_imgpath - else: - try: - f = open(filename, 'rb') - try: - imgtype = imghdr.what(f) - finally: - f.close() - except (OSError, IOError): - self.warn(docname, 'Image file %s not readable' % filename) - if imgtype: - candidates['image/' + imgtype] = new_imgpath - else: - candidates['*'] = imgpath - # map image paths to unique image names (so that they can be put - # into a single directory) - for imgpath in candidates.itervalues(): - self.dependencies.setdefault(docname, set()).add(imgpath) - if not os.access(path.join(self.srcdir, imgpath), os.R_OK): - self.warn(docname, 'Image file not readable: %s' % imgpath, - node.line) - if imgpath in self.images: - self.images[imgpath][0].add(docname) - continue - uniquename = path.basename(imgpath) - base, ext = path.splitext(uniquename) - i = 0 - while uniquename in existing_names: - i += 1 - uniquename = '%s%s%s' % (base, i, ext) - self.images[imgpath] = (set([docname]), uniquename) - existing_names.add(uniquename) - - def process_metadata(self, docname, doctree): - """ - Process the docinfo part of the doctree as metadata. - """ - self.metadata[docname] = md = {} - try: - docinfo = doctree[0] - except IndexError: - # probably an empty document - return - if docinfo.__class__ is not nodes.docinfo: - # nothing to see here - return - for node in docinfo: - if node.__class__ is nodes.author: - # handled specially by docutils - md['author'] = node.astext() - elif node.__class__ is nodes.field: - name, body = node - md[name.astext()] = body.astext() - del doctree[0] - - def create_title_from(self, docname, document): - """ - Add a title node to the document (just copy the first section title), - and store that title in the environment. - """ - for node in document.traverse(nodes.section): - titlenode = nodes.title() - visitor = SphinxContentsFilter(document) - node[0].walkabout(visitor) - titlenode += visitor.get_entry_text() - self.titles[docname] = titlenode - return - - def note_labels_from(self, docname, document): - for name, explicit in document.nametypes.iteritems(): - if not explicit: - continue - labelid = document.nameids[name] - if labelid is None: - continue - node = document.ids[labelid] - if name.isdigit() or node.has_key('refuri') or \ - node.tagname.startswith('desc_'): - # ignore footnote labels, labels automatically generated from a - # link and description units - continue - if name in self.labels: - self.warn(docname, 'duplicate label %s, ' % name + - 'other instance in %s' % self.doc2path(self.labels[name][0]), - node.line) - self.anonlabels[name] = docname, labelid - if node.tagname == 'section': - sectname = node[0].astext() # node[0] == title node - elif node.tagname == 'figure': - for n in node: - if n.tagname == 'caption': - sectname = n.astext() - break - else: - continue - else: - # anonymous-only labels - continue - self.labels[name] = docname, labelid, sectname - - def note_indexentries_from(self, docname, document): - entries = self.indexentries[docname] = [] - for node in document.traverse(addnodes.index): - entries.extend(node['entries']) - - def note_citations_from(self, docname, document): - for node in document.traverse(nodes.citation): - label = node[0].astext() - if ('citation', label) in self.reftargets: - self.warn(docname, 'duplicate citation %s, ' % label + - 'other instance in %s' % self.doc2path( - self.reftargets['citation', label][0]), node.line) - self.reftargets['citation', label] = (docname, node['ids'][0]) - - def note_toctree(self, docname, toctreenode): - """Note a TOC tree directive in a document and gather information about - file relations from it.""" - if toctreenode['glob']: - self.glob_toctrees.add(docname) - includefiles = toctreenode['includefiles'] - for includefile in includefiles: - # note that if the included file is rebuilt, this one must be - # too (since the TOC of the included file could have changed) - self.files_to_rebuild.setdefault(includefile, set()).add(docname) - self.toctree_includes.setdefault(docname, []).extend(includefiles) - - def build_toc_from(self, docname, document): - """Build a TOC from the doctree and store it in the inventory.""" - numentries = [0] # nonlocal again... - - try: - maxdepth = int(self.metadata[docname].get('tocdepth', 0)) - except ValueError: - maxdepth = 0 - - def build_toc(node, depth=1): - entries = [] - for subnode in node: - if isinstance(subnode, addnodes.toctree): - # just copy the toctree node which is then resolved - # in self.get_and_resolve_doctree - item = subnode.copy() - entries.append(item) - # do the inventory stuff - self.note_toctree(docname, subnode) - continue - if not isinstance(subnode, nodes.section): - continue - title = subnode[0] - # copy the contents of the section title, but without references - # and unnecessary stuff - visitor = SphinxContentsFilter(document) - title.walkabout(visitor) - nodetext = visitor.get_entry_text() - if not numentries[0]: - # for the very first toc entry, don't add an anchor - # as it is the file's title anyway - anchorname = '' - else: - anchorname = '#' + subnode['ids'][0] - numentries[0] += 1 - reference = nodes.reference('', '', refuri=docname, - anchorname=anchorname, - *nodetext) - para = addnodes.compact_paragraph('', '', reference) - item = nodes.list_item('', para) - if maxdepth == 0 or depth < maxdepth: - item += build_toc(subnode, depth+1) - entries.append(item) - if entries: - return nodes.bullet_list('', *entries) - return [] - toc = build_toc(document) - if toc: - self.tocs[docname] = toc - else: - self.tocs[docname] = nodes.bullet_list('') - self.toc_num_entries[docname] = numentries[0] - - def get_toc_for(self, docname): - """Return a TOC nodetree -- for use on the same page only!""" - toc = self.tocs[docname].deepcopy() - for node in toc.traverse(nodes.reference): - node['refuri'] = node['anchorname'] - return toc - - # ------- - # these are called from docutils directives and therefore use self.docname - # - def note_descref(self, fullname, desctype, line): - if fullname in self.descrefs: - self.warn(self.docname, - 'duplicate canonical description name %s, ' % fullname + - 'other instance in %s' % self.doc2path(self.descrefs[fullname][0]), - line) - self.descrefs[fullname] = (self.docname, desctype) - - def note_module(self, modname, synopsis, platform, deprecated): - self.modules[modname] = (self.docname, synopsis, platform, deprecated) - self.filemodules.setdefault(self.docname, []).append(modname) - - def note_progoption(self, optname, labelid): - self.progoptions[self.currprogram, optname] = (self.docname, labelid) - - def note_reftarget(self, type, name, labelid): - self.reftargets[type, name] = (self.docname, labelid) - - def note_versionchange(self, type, version, node, lineno): - self.versionchanges.setdefault(version, []).append( - (type, self.docname, lineno, self.currmodule, self.currdesc, node.astext())) - - def note_dependency(self, filename): - basename = path.dirname(self.doc2path(self.docname, base=None)) - # this will do the right thing when filename is absolute too - filename = path.join(basename, filename) - self.dependencies.setdefault(self.docname, set()).add(filename) - # ------- - - # --------- RESOLVING REFERENCES AND TOCTREES ------------------------------ - - def get_doctree(self, docname): - """Read the doctree for a file from the pickle and return it.""" - doctree_filename = self.doc2path(docname, self.doctreedir, '.doctree') - f = open(doctree_filename, 'rb') - try: - doctree = pickle.load(f) - finally: - f.close() - doctree.settings.env = self - doctree.reporter = Reporter(self.doc2path(docname), 2, 4, - stream=RedirStream(self._warnfunc)) - return doctree - - - def get_and_resolve_doctree(self, docname, builder, doctree=None, - prune_toctrees=True): - """Read the doctree from the pickle, resolve cross-references and - toctrees and return it.""" - if doctree is None: - doctree = self.get_doctree(docname) - - # resolve all pending cross-references - self.resolve_references(doctree, docname, builder) - - # now, resolve all toctree nodes - for toctreenode in doctree.traverse(addnodes.toctree): - result = self.resolve_toctree(docname, builder, toctreenode, - prune=prune_toctrees) - if result is None: - toctreenode.replace_self([]) - else: - toctreenode.replace_self(result) - - return doctree - - def resolve_toctree(self, docname, builder, toctree, prune=True, maxdepth=0, - titles_only=False): - """ - Resolve a *toctree* node into individual bullet lists with titles - as items, returning None (if no containing titles are found) or - a new node. - - If *prune* is True, the tree is pruned to *maxdepth*, or if that is 0, - to the value of the *maxdepth* option on the *toctree* node. - If *titles_only* is True, only toplevel document titles will be in the - resulting tree. - """ - - def _walk_depth(node, depth, maxdepth, titleoverrides): - """Utility: Cut a TOC at a specified depth.""" - for subnode in node.children[:]: - if isinstance(subnode, (addnodes.compact_paragraph, nodes.list_item)): - subnode['classes'].append('toctree-l%d' % (depth-1)) - _walk_depth(subnode, depth, maxdepth, titleoverrides) - elif isinstance(subnode, nodes.bullet_list): - if maxdepth > 0 and depth > maxdepth: - subnode.parent.replace(subnode, []) - else: - _walk_depth(subnode, depth+1, maxdepth, titleoverrides) - - def _entries_from_toctree(toctreenode, separate=False): - """Return TOC entries for a toctree node.""" - includefiles = map(str, toctreenode['includefiles']) - - entries = [] - for includefile in includefiles: - try: - toc = self.tocs[includefile].deepcopy() - if not toc.children: - # empty toc means: no titles will show up in the toctree - self.warn(docname, 'toctree contains reference to document ' - '%r that doesn\'t have a title: no link will be ' - 'generated' % includefile) - except KeyError: - # this is raised if the included file does not exist - self.warn(docname, 'toctree contains reference to nonexisting ' - 'document %r' % includefile) - else: - # if titles_only is given, only keep the main title and - # sub-toctrees - if titles_only: - # delete everything but the toplevel title(s) and toctrees - for toplevel in toc: - # nodes with length 1 don't have any children anyway - if len(toplevel) > 1: - subtoctrees = toplevel.traverse(addnodes.toctree) - toplevel[1][:] = subtoctrees - # resolve all sub-toctrees - for toctreenode in toc.traverse(addnodes.toctree): - i = toctreenode.parent.index(toctreenode) + 1 - for item in _entries_from_toctree(toctreenode): - toctreenode.parent.insert(i, item) - i += 1 - toctreenode.parent.remove(toctreenode) - if separate: - entries.append(toc) - else: - entries.extend(toc.children) - return entries - - maxdepth = maxdepth or toctree.get('maxdepth', -1) - titleoverrides = toctree.get('includetitles', {}) - - tocentries = _entries_from_toctree(toctree, separate=True) - if not tocentries: - return None - - newnode = addnodes.compact_paragraph('', '', *tocentries) - newnode['toctree'] = True - # prune the tree to maxdepth and replace titles, also set level classes - _walk_depth(newnode, 1, prune and maxdepth or 0, titleoverrides) - # replace titles, if needed, and set the target paths in the - # toctrees (they are not known at TOC generation time) - for refnode in newnode.traverse(nodes.reference): - refnode['refuri'] = builder.get_relative_uri( - docname, refnode['refuri']) + refnode['anchorname'] - if titleoverrides and not refnode['anchorname'] \ - and refnode['refuri'] in titleoverrides: - newtitle = titleoverrides[refnode['refuri']] - refnode.children = [nodes.Text(newtitle)] - return newnode - - descroles = frozenset(('data', 'exc', 'func', 'class', 'const', 'attr', 'obj', - 'meth', 'cfunc', 'cmember', 'cdata', 'ctype', 'cmacro')) - - def resolve_references(self, doctree, fromdocname, builder): - reftarget_roles = set(('token', 'term', 'citation')) - # add all custom xref types too - reftarget_roles.update(i[0] for i in additional_xref_types.values()) - - for node in doctree.traverse(addnodes.pending_xref): - contnode = node[0].deepcopy() - newnode = None - - typ = node['reftype'] - target = node['reftarget'] - - try: - if typ == 'ref': - if node['refcaption']: - # reference to anonymous label; the reference uses the supplied - # link caption - docname, labelid = self.anonlabels.get(target, ('','')) - sectname = node.astext() - if not docname: - newnode = doctree.reporter.system_message( - 2, 'undefined label: %s' % target) - else: - # reference to the named label; the final node will contain the - # section name after the label - docname, labelid, sectname = self.labels.get(target, ('','','')) - if not docname: - newnode = doctree.reporter.system_message( - 2, 'undefined label: %s -- if you don\'t ' % target + - 'give a link caption the label must precede a section ' - 'header.') - if docname: - newnode = nodes.reference('', '') - innernode = nodes.emphasis(sectname, sectname) - if docname == fromdocname: - newnode['refid'] = labelid - else: - # set more info in contnode in case the get_relative_uri call - # raises NoUri, the builder will then have to resolve these - contnode = addnodes.pending_xref('') - contnode['refdocname'] = docname - contnode['refsectname'] = sectname - newnode['refuri'] = builder.get_relative_uri( - fromdocname, docname) - if labelid: - newnode['refuri'] += '#' + labelid - newnode.append(innernode) - elif typ == 'keyword': - # keywords are referenced by named labels - docname, labelid, _ = self.labels.get(target, ('','','')) - if not docname: - #self.warn(fromdocname, 'unknown keyword: %s' % target) - newnode = contnode - else: - newnode = nodes.reference('', '') - if docname == fromdocname: - newnode['refid'] = labelid - else: - newnode['refuri'] = builder.get_relative_uri( - fromdocname, docname) + '#' + labelid - newnode.append(contnode) - elif typ == 'option': - progname = node['refprogram'] - docname, labelid = self.progoptions.get((progname, target), ('', '')) - if not docname: - newnode = contnode - else: - newnode = nodes.reference('', '') - if docname == fromdocname: - newnode['refid'] = labelid - else: - newnode['refuri'] = builder.get_relative_uri( - fromdocname, docname) + '#' + labelid - newnode.append(contnode) - elif typ in reftarget_roles: - docname, labelid = self.reftargets.get((typ, target), ('', '')) - if not docname: - if typ == 'term': - self.warn(fromdocname, 'term not in glossary: %s' % target, - node.line) - elif typ == 'citation': - self.warn(fromdocname, 'citation not found: %s' % target, - node.line) - newnode = contnode - else: - newnode = nodes.reference('', '') - if docname == fromdocname: - newnode['refid'] = labelid - else: - newnode['refuri'] = builder.get_relative_uri( - fromdocname, docname, typ) + '#' + labelid - newnode.append(contnode) - elif typ == 'mod': - docname, synopsis, platform, deprecated = \ - self.modules.get(target, ('','','', '')) - if not docname: - newnode = builder.app.emit_firstresult('missing-reference', - self, node, contnode) - if not newnode: - newnode = contnode - elif docname == fromdocname: - # don't link to self - newnode = contnode - else: - newnode = nodes.reference('', '') - newnode['refuri'] = builder.get_relative_uri( - fromdocname, docname) + '#module-' + target - newnode['reftitle'] = '%s%s%s' % ( - (platform and '(%s) ' % platform), - synopsis, (deprecated and ' (deprecated)' or '')) - newnode.append(contnode) - elif typ in self.descroles: - # "descrefs" - modname = node['modname'] - clsname = node['classname'] - searchorder = node.hasattr('refspecific') and 1 or 0 - name, desc = self.find_desc(modname, clsname, - target, typ, searchorder) - if not desc: - newnode = builder.app.emit_firstresult('missing-reference', - self, node, contnode) - if not newnode: - newnode = contnode - else: - newnode = nodes.reference('', '') - if desc[0] == fromdocname: - newnode['refid'] = name - else: - newnode['refuri'] = ( - builder.get_relative_uri(fromdocname, desc[0]) - + '#' + name) - newnode['reftitle'] = name - newnode.append(contnode) - else: - raise RuntimeError('unknown xfileref node encountered: %s' % node) - except NoUri: - newnode = contnode - if newnode: - node.replace_self(newnode) - - # allow custom references to be resolved - builder.app.emit('doctree-resolved', doctree, fromdocname) - - def create_index(self, builder, _fixre=re.compile(r'(.*) ([(][^()]*[)])')): - """Create the real index from the collected index entries.""" - new = {} - - def add_entry(word, subword, dic=new): - entry = dic.get(word) - if not entry: - dic[word] = entry = [[], {}] - if subword: - add_entry(subword, '', dic=entry[1]) - else: - try: - entry[0].append(builder.get_relative_uri('genindex', fn) - + '#' + tid) - except NoUri: - pass - - for fn, entries in self.indexentries.iteritems(): - # new entry types must be listed in directives/other.py! - for type, string, tid, alias in entries: - if type == 'single': - try: - entry, subentry = string.split(';', 1) - except ValueError: - entry, subentry = string, '' - if not entry: - self.warn(fn, 'invalid index entry %r' % string) - continue - add_entry(entry.strip(), subentry.strip()) - elif type == 'pair': - try: - first, second = map(lambda x: x.strip(), - string.split(';', 1)) - if not first or not second: - raise ValueError - except ValueError: - self.warn(fn, 'invalid pair index entry %r' % string) - continue - add_entry(first, second) - add_entry(second, first) - elif type == 'triple': - try: - first, second, third = map(lambda x: x.strip(), - string.split(';', 2)) - if not first or not second or not third: - raise ValueError - except ValueError: - self.warn(fn, 'invalid triple index entry %r' % string) - continue - add_entry(first, second+' '+third) - add_entry(second, third+', '+first) - add_entry(third, first+' '+second) - else: - self.warn(fn, 'unknown index entry type %r' % type) - - newlist = new.items() - newlist.sort(key=lambda t: t[0].lower()) - - # fixup entries: transform - # func() (in module foo) - # func() (in module bar) - # into - # func() - # (in module foo) - # (in module bar) - oldkey = '' - oldsubitems = None - i = 0 - while i < len(newlist): - key, (targets, subitems) = newlist[i] - # cannot move if it hassubitems; structure gets too complex - if not subitems: - m = _fixre.match(key) - if m: - if oldkey == m.group(1): - # prefixes match: add entry as subitem of the previous entry - oldsubitems.setdefault(m.group(2), [[], {}])[0].extend(targets) - del newlist[i] - continue - oldkey = m.group(1) - else: - oldkey = key - oldsubitems = subitems - i += 1 - - # group the entries by letter - def keyfunc((k, v), ltrs=uppercase+'_'): - # hack: mutate the subitems dicts to a list in the keyfunc - v[1] = sorted((si, se) for (si, (se, void)) in v[1].iteritems()) - # now calculate the key - letter = k[0].upper() - if letter in ltrs: - return letter - else: - # get all other symbols under one heading - return 'Symbols' - return [(key, list(group)) for (key, group) in groupby(newlist, keyfunc)] - - def collect_relations(self): - relations = {} - getinc = self.toctree_includes.get - def collect(parents, docname, previous, next): - includes = getinc(docname) - # previous - if not previous: - # if no previous sibling, go to parent - previous = parents[0][0] - else: - # else, go to previous sibling, or if it has children, to - # the last of its children, or if that has children, to the - # last of those, and so forth - while 1: - previncs = getinc(previous) - if previncs: - previous = previncs[-1] - else: - break - # next - if includes: - # if it has children, go to first of them - next = includes[0] - elif next: - # else, if next sibling, go to it - pass - else: - # else, go to the next sibling of the parent, if present, - # else the grandparent's sibling, if present, and so forth - for parname, parindex in parents: - parincs = getinc(parname) - if parincs and parindex + 1 < len(parincs): - next = parincs[parindex+1] - break - # else it will stay None - # same for children - if includes: - for subindex, args in enumerate(izip(includes, [None] + includes, - includes[1:] + [None])): - collect([(docname, subindex)] + parents, *args) - relations[docname] = [parents[0][0], previous, next] - collect([(None, 0)], self.config.master_doc, None, None) - return relations - - def check_consistency(self): - """Do consistency checks.""" - - for docname in sorted(self.all_docs): - if docname not in self.files_to_rebuild: - if docname == self.config.master_doc: - # the master file is not included anywhere ;) - continue - self.warn(docname, 'document isn\'t included in any toctree') - - # --------- QUERYING ------------------------------------------------------- - - def find_desc(self, modname, classname, name, type, searchorder=0): - """Find a description node matching "name", perhaps using - the given module and/or classname.""" - # skip parens - if name[-2:] == '()': - name = name[:-2] - - if not name: - return None, None - - # don't add module and class names for C things - if type[0] == 'c' and type not in ('class', 'const'): - # skip trailing star and whitespace - name = name.rstrip(' *') - if name in self.descrefs and self.descrefs[name][1][0] == 'c': - return name, self.descrefs[name] - return None, None - - newname = None - if searchorder == 1: - if modname and classname and \ - modname + '.' + classname + '.' + name in self.descrefs: - newname = modname + '.' + classname + '.' + name - elif modname and modname + '.' + name in self.descrefs: - newname = modname + '.' + name - elif name in self.descrefs: - newname = name - else: - if name in self.descrefs: - newname = name - elif modname and modname + '.' + name in self.descrefs: - newname = modname + '.' + name - elif modname and classname and \ - modname + '.' + classname + '.' + name in self.descrefs: - newname = modname + '.' + classname + '.' + name - # special case: builtin exceptions have module "exceptions" set - elif type == 'exc' and '.' not in name and \ - 'exceptions.' + name in self.descrefs: - newname = 'exceptions.' + name - # special case: object methods - elif type in ('func', 'meth') and '.' not in name and \ - 'object.' + name in self.descrefs: - newname = 'object.' + name - if newname is None: - return None, None - return newname, self.descrefs[newname] - - def find_keyword(self, keyword, avoid_fuzzy=False, cutoff=0.6, n=20): - """ - Find keyword matches for a keyword. If there's an exact match, just return - it, else return a list of fuzzy matches if avoid_fuzzy isn't True. - - Keywords searched are: first modules, then descrefs. - - Returns: None if nothing found - (type, docname, anchorname) if exact match found - list of (quality, type, docname, anchorname, description) if fuzzy - """ - - if keyword in self.modules: - docname, title, system, deprecated = self.modules[keyword] - return 'module', docname, 'module-' + keyword - if keyword in self.descrefs: - docname, ref_type = self.descrefs[keyword] - return ref_type, docname, keyword - # special cases - if '.' not in keyword: - # exceptions are documented in the exceptions module - if 'exceptions.'+keyword in self.descrefs: - docname, ref_type = self.descrefs['exceptions.'+keyword] - return ref_type, docname, 'exceptions.'+keyword - # special methods are documented as object methods - if 'object.'+keyword in self.descrefs: - docname, ref_type = self.descrefs['object.'+keyword] - return ref_type, docname, 'object.'+keyword - - if avoid_fuzzy: - return - - # find fuzzy matches - s = difflib.SequenceMatcher() - s.set_seq2(keyword.lower()) - - def possibilities(): - for title, (fn, desc, _, _) in self.modules.iteritems(): - yield ('module', fn, 'module-'+title, desc) - for title, (fn, desctype) in self.descrefs.iteritems(): - yield (desctype, fn, title, '') - - def dotsearch(string): - parts = string.lower().split('.') - for idx in xrange(0, len(parts)): - yield '.'.join(parts[idx:]) - - result = [] - for type, docname, title, desc in possibilities(): - best_res = 0 - for part in dotsearch(title): - s.set_seq1(part) - if s.real_quick_ratio() >= cutoff and \ - s.quick_ratio() >= cutoff and \ - s.ratio() >= cutoff and \ - s.ratio() > best_res: - best_res = s.ratio() - if best_res: - result.append((best_res, type, docname, title, desc)) - - return heapq.nlargest(n, result) diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/ext/__init__.py --- a/buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/ext/__init__.py Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,10 +0,0 @@ -# -*- coding: utf-8 -*- -""" - sphinx.ext - ~~~~~~~~~~ - - Contains Sphinx features not activated by default. - - :copyright: 2008 by Georg Brandl. - :license: BSD. -""" diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/ext/autodoc.py --- a/buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/ext/autodoc.py Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,655 +0,0 @@ -# -*- coding: utf-8 -*- -""" - sphinx.ext.autodoc - ~~~~~~~~~~~~~~~~~~ - - Automatically insert docstrings for functions, classes or whole modules into - the doctree, thus avoiding duplication between docstrings and documentation - for those who like elaborate docstrings. - - :copyright: 2008 by Georg Brandl, Pauli Virtanen, Martin Hans. - :license: BSD. -""" - -import re -import sys -import types -import inspect -import linecache -from types import FunctionType, BuiltinMethodType, MethodType - -from docutils import nodes -from docutils.parsers.rst import directives -from docutils.statemachine import ViewList - -from sphinx.util import rpartition, nested_parse_with_titles -from sphinx.directives.desc import py_sig_re - -try: - base_exception = BaseException -except NameError: - base_exception = Exception - -_charset_re = re.compile(r'coding[:=]\s*([-\w.]+)') -_module_charsets = {} - - -class Options(object): - pass - - -def is_static_method(obj): - """Check if the object given is a static method.""" - if isinstance(obj, (FunctionType, classmethod)): - return True - elif isinstance(obj, BuiltinMethodType): - return obj.__self__ is not None - elif isinstance(obj, MethodType): - return obj.im_self is not None - return False - - -class AutodocReporter(object): - """ - A reporter replacement that assigns the correct source name - and line number to a system message, as recorded in a ViewList. - """ - def __init__(self, viewlist, reporter): - self.viewlist = viewlist - self.reporter = reporter - - def __getattr__(self, name): - return getattr(self.reporter, name) - - def system_message(self, level, message, *children, **kwargs): - if 'line' in kwargs: - try: - source, line = self.viewlist.items[kwargs['line']] - except IndexError: - pass - else: - kwargs['source'] = source - kwargs['line'] = line - return self.reporter.system_message(level, message, - *children, **kwargs) - - def debug(self, *args, **kwargs): - if self.reporter.debug_flag: - return self.system_message(0, *args, **kwargs) - - def info(self, *args, **kwargs): - return self.system_message(1, *args, **kwargs) - - def warning(self, *args, **kwargs): - return self.system_message(2, *args, **kwargs) - - def error(self, *args, **kwargs): - return self.system_message(3, *args, **kwargs) - - def severe(self, *args, **kwargs): - return self.system_message(4, *args, **kwargs) - - -# Some useful event listener factories for autodoc-process-docstring. - -def cut_lines(pre, post=0, what=None): - """ - Return a listener that removes the first *pre* and last *post* - lines of every docstring. If *what* is a sequence of strings, - only docstrings of a type in *what* will be processed. - - Use like this (e.g. in the ``setup()`` function of :file:`conf.py`):: - - from sphinx.ext.autodoc import cut_lines - app.connect('autodoc-process-docstring', cut_lines(4, what=['module'])) - - This can (and should) be used in place of :confval:`automodule_skip_lines`. - """ - def process(app, what_, name, obj, options, lines): - if what and what_ not in what: - return - del lines[:pre] - if post: - # remove one trailing blank line. - if lines and not lines[-1]: - lines.pop(-1) - del lines[-post:] - # make sure there is a blank line at the end - if lines and lines[-1]: - lines.append('') - return process - -def between(marker, what=None, keepempty=False): - """ - Return a listener that only keeps lines between lines that match the - *marker* regular expression. If no line matches, the resulting docstring - would be empty, so no change will be made unless *keepempty* is true. - - If *what* is a sequence of strings, only docstrings of a type in *what* will - be processed. - """ - marker_re = re.compile(marker) - def process(app, what_, name, obj, options, lines): - if what and what_ not in what: - return - deleted = 0 - delete = True - orig_lines = lines[:] - for i, line in enumerate(orig_lines): - if delete: - lines.pop(i - deleted) - deleted += 1 - if marker_re.match(line): - delete = not delete - if delete: - lines.pop(i - deleted) - deleted += 1 - if not lines and not keepempty: - lines[:] = orig_lines - # make sure there is a blank line at the end - if lines and lines[-1]: - lines.append('') - return process - - -def isdescriptor(x): - """Check if the object is some kind of descriptor.""" - for item in '__get__', '__set__', '__delete__': - if callable(getattr(x, item, None)): - return True - return False - - -def prepare_docstring(s): - """ - Convert a docstring into lines of parseable reST. Return it as a list of - lines usable for inserting into a docutils ViewList (used as argument - of nested_parse().) An empty line is added to act as a separator between - this docstring and following content. - """ - lines = s.expandtabs().splitlines() - # Find minimum indentation of any non-blank lines after first line. - margin = sys.maxint - for line in lines[1:]: - content = len(line.lstrip()) - if content: - indent = len(line) - content - margin = min(margin, indent) - # Remove indentation. - if lines: - lines[0] = lines[0].lstrip() - if margin < sys.maxint: - for i in range(1, len(lines)): lines[i] = lines[i][margin:] - # Remove any leading blank lines. - while lines and not lines[0]: - lines.pop(0) - # make sure there is an empty line at the end - if lines and lines[-1]: - lines.append('') - return lines - - -def get_module_charset(module): - """Return the charset of the given module (cached in _module_charsets).""" - if module in _module_charsets: - return _module_charsets[module] - try: - filename = __import__(module, None, None, ['foo']).__file__ - except (ImportError, AttributeError): - return None - if filename[-4:].lower() in ('.pyc', '.pyo'): - filename = filename[:-1] - for line in [linecache.getline(filename, x) for x in (1, 2)]: - match = _charset_re.search(line) - if match is not None: - charset = match.group(1) - break - else: - charset = 'ascii' - _module_charsets[module] = charset - return charset - - -class RstGenerator(object): - def __init__(self, options, document, lineno): - self.options = options - self.env = document.settings.env - self.reporter = document.reporter - self.lineno = lineno - self.filename_set = set() - self.warnings = [] - self.result = ViewList() - - def warn(self, msg): - self.warnings.append(self.reporter.warning(msg, line=self.lineno)) - - def get_doc(self, what, name, obj): - """Format and yield lines of the docstring(s) for the object.""" - docstrings = [] - if getattr(obj, '__doc__', None): - docstrings.append(obj.__doc__) - # skip some lines in module docstrings if configured - if what == 'module' and self.env.config.automodule_skip_lines and docstrings: - docstrings[0] = '\n'.join(docstrings[0].splitlines() - [self.env.config.automodule_skip_lines:]) - # for classes, what the "docstring" is can be controlled via an option - if what in ('class', 'exception'): - content = self.env.config.autoclass_content - if content in ('both', 'init'): - initdocstring = getattr(obj, '__init__', None).__doc__ - # for new-style classes, no __init__ means default __init__ - if initdocstring == object.__init__.__doc__: - initdocstring = None - if initdocstring: - if content == 'init': - docstrings = [initdocstring] - else: - docstrings.append(initdocstring) - # the default is only the class docstring - - # decode the docstrings using the module's source encoding - charset = None - module = getattr(obj, '__module__', None) - if module is not None: - charset = get_module_charset(module) - - for docstring in docstrings: - if isinstance(docstring, str): - if charset: - docstring = docstring.decode(charset) - else: - try: - # try decoding with utf-8, should only work for real UTF-8 - docstring = docstring.decode('utf-8') - except UnicodeError: - # last resort -- can't fail - docstring = docstring.decode('latin1') - docstringlines = prepare_docstring(docstring) - if self.env.app: - # let extensions preprocess docstrings - self.env.app.emit('autodoc-process-docstring', - what, name, obj, self.options, docstringlines) - for line in docstringlines: - yield line - - def resolve_name(self, what, name): - """ - Determine what module to import and what attribute to document. - - Returns a tuple of: the full name, the module name, a path of - names to get via getattr, the signature and return annotation. - """ - # first, parse the definition -- auto directives for classes and functions - # can contain a signature which is then used instead of an autogenerated one - try: - path, base, args, retann = py_sig_re.match(name).groups() - except: - self.warn('invalid signature for auto%s (%r)' % (what, name)) - return - # fullname is the fully qualified name, base the name after the last dot - fullname = (path or '') + base - - if what == 'module': - if args or retann: - self.warn('ignoring signature arguments and return annotation ' - 'for automodule %s' % fullname) - return fullname, fullname, [], None, None - - elif what in ('class', 'exception', 'function'): - if path: - mod = path.rstrip('.') - else: - mod = None - # if documenting a toplevel object without explicit module, it can - # be contained in another auto directive ... - if hasattr(self.env, 'autodoc_current_module'): - mod = self.env.autodoc_current_module - # ... or in the scope of a module directive - if not mod: - mod = self.env.currmodule - return fullname, mod, [base], args, retann - - else: - if path: - mod_cls = path.rstrip('.') - else: - mod_cls = None - # if documenting a class-level object without path, there must be a - # current class, either from a parent auto directive ... - if hasattr(self.env, 'autodoc_current_class'): - mod_cls = self.env.autodoc_current_class - # ... or from a class directive - if mod_cls is None: - mod_cls = self.env.currclass - # ... if still None, there's no way to know - if mod_cls is None: - return fullname, None, [], args, retann - mod, cls = rpartition(mod_cls, '.') - # if the module name is still missing, get it like above - if not mod and hasattr(self.env, 'autodoc_current_module'): - mod = self.env.autodoc_current_module - if not mod: - mod = self.env.currmodule - return fullname, mod, [cls, base], args, retann - - def format_signature(self, what, name, obj, args, retann): - """ - Return the signature of the object, formatted for display. - """ - if what not in ('class', 'method', 'function'): - return '' - - err = None - if args is not None: - # signature given explicitly - args = "(%s)" % args - else: - # try to introspect the signature - try: - args = None - getargs = True - if what == 'class': - # for classes, the relevant signature is the __init__ method's - obj = getattr(obj, '__init__', None) - # classes without __init__ method, default __init__ or - # __init__ written in C? - if obj is None or obj is object.__init__ or not \ - (inspect.ismethod(obj) or inspect.isfunction(obj)): - getargs = False - elif inspect.isbuiltin(obj) or inspect.ismethoddescriptor(obj): - # can never get arguments of a C function or method - getargs = False - if getargs: - argspec = inspect.getargspec(obj) - if what in ('class', 'method') and argspec[0] and \ - argspec[0][0] in ('cls', 'self'): - del argspec[0][0] - args = inspect.formatargspec(*argspec) - except Exception, e: - args = None - err = e - - result = self.env.app.emit_firstresult('autodoc-process-signature', what, - name, obj, self.options, args, retann) - if result: - args, retann = result - - if args is not None: - return '%s%s' % (args, retann or '') - elif err: - # re-raise the error for perusal of the handler in generate() - raise RuntimeError(err) - else: - return '' - - def generate(self, what, name, members, add_content, indent=u'', check_module=False): - """ - Generate reST for the object in self.result. - """ - fullname, mod, objpath, args, retann = self.resolve_name(what, name) - if not mod: - # need a module to import - self.warn('don\'t know which module to import for autodocumenting %r ' - '(try placing a "module" or "currentmodule" directive in the ' - 'document, or giving an explicit module name)' % fullname) - return - - # the name to put into the generated directive -- doesn't contain the module - name_in_directive = '.'.join(objpath) or mod - - # now, import the module and get object to document - try: - todoc = module = __import__(mod, None, None, ['foo']) - if hasattr(module, '__file__') and module.__file__: - modfile = module.__file__ - if modfile[-4:].lower() in ('.pyc', '.pyo'): - modfile = modfile[:-1] - self.filename_set.add(modfile) - else: - modfile = None # e.g. for builtin and C modules - for part in objpath: - todoc = getattr(todoc, part) - except (ImportError, AttributeError), err: - self.warn('autodoc can\'t import/find %s %r, it reported error: "%s", ' - 'please check your spelling and sys.path' % - (what, str(fullname), err)) - return - - # check __module__ of object if wanted (for members not given explicitly) - if check_module: - if hasattr(todoc, '__module__'): - if todoc.__module__ != mod: - return - - # format the object's signature, if any - try: - sig = self.format_signature(what, name, todoc, args, retann) - except Exception, err: - self.warn('error while formatting signature for %s: %s' % - (fullname, err)) - sig = '' - - # make sure that the result starts with an empty line. This is - # necessary for some situations where another directive preprocesses - # reST and no starting newline is present - self.result.append(u'', '') - - # now, create the directive header - directive = (what == 'method' and is_static_method(todoc)) \ - and 'staticmethod' or what - self.result.append(indent + u'.. %s:: %s%s' % - (directive, name_in_directive, sig), '') - if what == 'module': - # Add some module-specific options - if self.options.synopsis: - self.result.append(indent + u' :synopsis: ' + self.options.synopsis, - '') - if self.options.platform: - self.result.append(indent + u' :platform: ' + self.options.platform, - '') - if self.options.deprecated: - self.result.append(indent + u' :deprecated:', '') - else: - # Be explicit about the module, this is necessary since .. class:: doesn't - # support a prepended module name - self.result.append(indent + u' :module: %s' % mod, '') - if self.options.noindex: - self.result.append(indent + u' :noindex:', '') - self.result.append(u'', '') - - if self.options.show_inheritance and what in ('class', 'exception'): - if len(todoc.__bases__): - bases = [b.__module__ == '__builtin__' and - u':class:`%s`' % b.__name__ or - u':class:`%s.%s`' % (b.__module__, b.__name__) - for b in todoc.__bases__] - self.result.append(indent + u' Bases: %s' % ', '.join(bases), - '') - self.result.append(u'', '') - - # the module directive doesn't have content - if what != 'module': - indent += u' ' - - if modfile: - sourcename = '%s:docstring of %s' % (modfile, fullname) - else: - sourcename = 'docstring of %s' % fullname - - # add content from docstrings - for i, line in enumerate(self.get_doc(what, fullname, todoc)): - self.result.append(indent + line, sourcename, i) - - # add source content, if present - if add_content: - for line, src in zip(add_content.data, add_content.items): - self.result.append(indent + line, src[0], src[1]) - - # document members? - if not members or what in ('function', 'method', 'attribute'): - return - - # set current namespace for finding members - self.env.autodoc_current_module = mod - if objpath: - self.env.autodoc_current_class = objpath[0] - - # add members, if possible - _all = members == ['__all__'] - members_check_module = False - if _all: - # unqualified :members: given - if what == 'module': - if hasattr(todoc, '__all__'): - members_check_module = False - all_members = [] - for mname in todoc.__all__: - try: - all_members.append((mname, getattr(todoc, mname))) - except AttributeError: - self.warn('missing attribute mentioned in __all__: ' - 'module %s, attribute %s' % - (todoc.__name__, mname)) - else: - # for implicit module members, check __module__ to avoid - # documenting imported objects - members_check_module = True - all_members = inspect.getmembers(todoc) - else: - if self.options.inherited_members: - # getmembers() uses dir() which pulls in members from all - # base classes - all_members = inspect.getmembers(todoc) - else: - # __dict__ contains only the members directly defined in the class - all_members = sorted(todoc.__dict__.iteritems()) - else: - all_members = [(mname, getattr(todoc, mname)) for mname in members] - for (membername, member) in all_members: - # ignore members whose name starts with _ by default - if _all and membername.startswith('_'): - continue - - # ignore undocumented members if :undoc-members: is not given - doc = getattr(member, '__doc__', None) - skip = not self.options.undoc_members and not doc - # give the user a chance to decide whether this member should be skipped - if self.env.app: - # let extensions preprocess docstrings - skip_user = self.env.app.emit_firstresult( - 'autodoc-skip-member', what, membername, member, skip, self.options) - if skip_user is not None: - skip = skip_user - if skip: - continue - - if what == 'module': - if isinstance(member, (types.FunctionType, - types.BuiltinFunctionType)): - memberwhat = 'function' - elif isinstance(member, types.ClassType) or \ - isinstance(member, type): - if issubclass(member, base_exception): - memberwhat = 'exception' - else: - memberwhat = 'class' - else: - # XXX: todo -- attribute docs - continue - else: - if callable(member): - memberwhat = 'method' - elif isdescriptor(member): - memberwhat = 'attribute' - else: - # XXX: todo -- attribute docs - continue - full_membername = fullname + '.' + membername - self.generate(memberwhat, full_membername, ['__all__'], None, indent, - check_module=members_check_module) - - self.env.autodoc_current_module = None - self.env.autodoc_current_class = None - - -def _auto_directive(dirname, arguments, options, content, lineno, - content_offset, block_text, state, state_machine): - what = dirname[4:] # strip "auto" - name = arguments[0] - genopt = Options() - members = options.get('members', []) - genopt.inherited_members = 'inherited-members' in options - if genopt.inherited_members and not members: - # :inherited-members: implies :members: - members = ['__all__'] - genopt.undoc_members = 'undoc-members' in options - genopt.show_inheritance = 'show-inheritance' in options - genopt.noindex = 'noindex' in options - genopt.synopsis = options.get('synopsis', '') - genopt.platform = options.get('platform', '') - genopt.deprecated = 'deprecated' in options - - generator = RstGenerator(genopt, state.document, lineno) - generator.generate(what, name, members, content) - if not generator.result: - return generator.warnings - - # record all filenames as dependencies -- this will at least partially make - # automatic invalidation possible - for fn in generator.filename_set: - state.document.settings.env.note_dependency(fn) - - # use a custom reporter that correctly assigns lines to source and lineno - old_reporter = state.memo.reporter - state.memo.reporter = AutodocReporter(generator.result, state.memo.reporter) - if dirname == 'automodule': - node = nodes.section() - nested_parse_with_titles(state, generator.result, node) - else: - node = nodes.paragraph() - state.nested_parse(generator.result, 0, node) - state.memo.reporter = old_reporter - return generator.warnings + node.children - -def auto_directive(*args, **kwds): - return _auto_directive(*args, **kwds) - -def automodule_directive(*args, **kwds): - return _auto_directive(*args, **kwds) - -def autoclass_directive(*args, **kwds): - return _auto_directive(*args, **kwds) - - -def members_option(arg): - if arg is None: - return ['__all__'] - return [x.strip() for x in arg.split(',')] - - -def setup(app): - mod_options = {'members': members_option, 'undoc-members': directives.flag, - 'noindex': directives.flag, 'inherited-members': directives.flag, - 'show-inheritance': directives.flag, 'synopsis': lambda x: x, - 'platform': lambda x: x, 'deprecated': directives.flag} - cls_options = {'members': members_option, 'undoc-members': directives.flag, - 'noindex': directives.flag, 'inherited-members': directives.flag, - 'show-inheritance': directives.flag} - app.add_directive('automodule', automodule_directive, - 1, (1, 0, 1), **mod_options) - app.add_directive('autoclass', autoclass_directive, - 1, (1, 0, 1), **cls_options) - app.add_directive('autoexception', autoclass_directive, - 1, (1, 0, 1), **cls_options) - app.add_directive('autofunction', auto_directive, 1, (1, 0, 1), - noindex=directives.flag) - app.add_directive('automethod', auto_directive, 1, (1, 0, 1), - noindex=directives.flag) - app.add_directive('autoattribute', auto_directive, 1, (1, 0, 1), - noindex=directives.flag) - # deprecated: remove in some future version. - app.add_config_value('automodule_skip_lines', 0, True) - app.add_config_value('autoclass_content', 'class', True) - app.add_event('autodoc-process-docstring') - app.add_event('autodoc-process-signature') - app.add_event('autodoc-skip-member') diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/ext/coverage.py --- a/buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/ext/coverage.py Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,241 +0,0 @@ -# -*- coding: utf-8 -*- -""" - sphinx.ext.coverage - ~~~~~~~~~~~~~~~~~~~ - - Check Python modules and C API for coverage. Mostly written by Josip - Dzolonga for the Google Highly Open Participation contest. - - :copyright: 2008 by Josip Dzolonga, Georg Brandl. - :license: BSD. -""" - -import re -import glob -import inspect -import cPickle as pickle -from os import path - -from sphinx.builder import Builder - - -# utility -def write_header(f, text, char='-'): - f.write(text + '\n') - f.write(char * len(text) + '\n') - -def compile_regex_list(name, exps, warnfunc): - lst = [] - for exp in exps: - try: - lst.append(re.compile(exp)) - except Exception: - warnfunc('invalid regex %r in %s' % (exp, name)) - return lst - - -class CoverageBuilder(Builder): - - name = 'coverage' - - def init(self): - self.c_sourcefiles = [] - for pattern in self.config.coverage_c_path: - pattern = path.join(self.srcdir, pattern) - self.c_sourcefiles.extend(glob.glob(pattern)) - - self.c_regexes = [] - for (name, exp) in self.config.coverage_c_regexes.items(): - try: - self.c_regexes.append((name, re.compile(exp))) - except Exception: - self.warn('invalid regex %r in coverage_c_regexes' % exp) - - self.c_ignorexps = {} - for (name, exps) in self.config.coverage_ignore_c_items.iteritems(): - self.c_ignorexps[name] = compile_regex_list('coverage_ignore_c_items', - exps, self.warn) - self.mod_ignorexps = compile_regex_list('coverage_ignore_modules', - self.config.coverage_ignore_modules, - self.warn) - self.cls_ignorexps = compile_regex_list('coverage_ignore_classes', - self.config.coverage_ignore_classes, - self.warn) - self.fun_ignorexps = compile_regex_list('coverage_ignore_functions', - self.config.coverage_ignore_functions, - self.warn) - - def get_outdated_docs(self): - return 'coverage overview' - - def write(self, *ignored): - self.py_undoc = {} - self.build_py_coverage() - self.write_py_coverage() - - self.c_undoc = {} - self.build_c_coverage() - self.write_c_coverage() - - def build_c_coverage(self): - # Fetch all the info from the header files - for filename in self.c_sourcefiles: - undoc = [] - f = open(filename, 'r') - try: - for line in f: - for key, regex in self.c_regexes: - match = regex.match(line) - if match: - name = match.groups()[0] - if name not in self.env.descrefs: - for exp in self.c_ignorexps.get(key, ()): - if exp.match(name): - break - else: - undoc.append((key, name)) - continue - finally: - f.close() - if undoc: - self.c_undoc[filename] = undoc - - def write_c_coverage(self): - output_file = path.join(self.outdir, 'c.txt') - op = open(output_file, 'w') - try: - write_header(op, 'Undocumented C API elements', '=') - op.write('\n') - - for filename, undoc in self.c_undoc.iteritems(): - write_header(op, filename) - for typ, name in undoc: - op.write(' * %-50s [%9s]\n' % (name, typ)) - op.write('\n') - finally: - op.close() - - def build_py_coverage(self): - for mod_name in self.env.modules: - ignore = False - for exp in self.mod_ignorexps: - if exp.match(mod_name): - ignore = True - break - if ignore: - continue - - try: - mod = __import__(mod_name, fromlist=['foo']) - except ImportError, err: - self.warn('module %s could not be imported: %s' % (mod_name, err)) - self.py_undoc[mod_name] = {'error': err} - continue - - funcs = [] - classes = {} - - for name, obj in inspect.getmembers(mod): - # diverse module attributes are ignored: - if name[0] == '_': - # begins in an underscore - continue - if not hasattr(obj, '__module__'): - # cannot be attributed to a module - continue - if obj.__module__ != mod_name: - # is not defined in this module - continue - - full_name = '%s.%s' % (mod_name, name) - - if inspect.isfunction(obj): - if full_name not in self.env.descrefs: - for exp in self.fun_ignorexps: - if exp.match(name): - break - else: - funcs.append(name) - elif inspect.isclass(obj): - for exp in self.cls_ignorexps: - if exp.match(name): - break - else: - if full_name not in self.env.descrefs: - # not documented at all - classes[name] = [] - continue - - attrs = [] - - for attr_name, attr in inspect.getmembers(obj, inspect.ismethod): - if attr_name[0] == '_': - # starts with an underscore, ignore it - continue - - full_attr_name = '%s.%s' % (full_name, attr_name) - if full_attr_name not in self.env.descrefs: - attrs.append(attr_name) - - if attrs: - # some attributes are undocumented - classes[name] = attrs - - self.py_undoc[mod_name] = {'funcs': funcs, 'classes': classes} - - def write_py_coverage(self): - output_file = path.join(self.outdir, 'python.txt') - op = open(output_file, 'w') - failed = [] - try: - write_header(op, 'Undocumented Python objects', '=') - - keys = self.py_undoc.keys() - keys.sort() - for name in keys: - undoc = self.py_undoc[name] - if 'error' in undoc: - failed.append((name, undoc['error'])) - else: - if not undoc['classes'] and not undoc['funcs']: - continue - - write_header(op, name) - if undoc['funcs']: - op.write('Functions:\n') - op.writelines(' * %s\n' % x for x in undoc['funcs']) - op.write('\n') - if undoc['classes']: - op.write('Classes:\n') - for name, methods in undoc['classes'].iteritems(): - if not methods: - op.write(' * %s\n' % name) - else: - op.write(' * %s -- missing methods:\n' % name) - op.writelines(' - %s\n' % x for x in methods) - op.write('\n') - - if failed: - write_header(op, 'Modules that failed to import') - op.writelines(' * %s -- %s\n' % x for x in failed) - finally: - op.close() - - def finish(self): - # dump the coverage data to a pickle file too - picklepath = path.join(self.outdir, 'undoc.pickle') - dumpfile = open(picklepath, 'wb') - try: - pickle.dump((self.py_undoc, self.c_undoc), dumpfile) - finally: - dumpfile.close() - - -def setup(app): - app.add_builder(CoverageBuilder) - app.add_config_value('coverage_ignore_modules', [], False) - app.add_config_value('coverage_ignore_functions', [], False) - app.add_config_value('coverage_ignore_classes', [], False) - app.add_config_value('coverage_c_path', [], False) - app.add_config_value('coverage_c_regexes', {}, False) - app.add_config_value('coverage_ignore_c_items', {}, False) diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/ext/doctest.py --- a/buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/ext/doctest.py Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,337 +0,0 @@ -# -*- coding: utf-8 -*- -""" - sphinx.ext.doctest - ~~~~~~~~~~~~~~~~~~ - - Mimic doctest by automatically executing code snippets and checking - their results. - - :copyright: 2008 by Georg Brandl. - :license: BSD. -""" - -import re -import sys -import time -import codecs -import StringIO -from os import path -# circumvent relative import -doctest = __import__('doctest') - -from docutils import nodes -from docutils.parsers.rst import directives - -from sphinx.builder import Builder -from sphinx.util.console import bold - -blankline_re = re.compile(r'^\s*', re.MULTILINE) -doctestopt_re = re.compile(r'#\s*doctest:.+$', re.MULTILINE) - -# set up the necessary directives - -def test_directive(name, arguments, options, content, lineno, - content_offset, block_text, state, state_machine): - # use ordinary docutils nodes for test code: they get special attributes - # so that our builder recognizes them, and the other builders are happy. - code = '\n'.join(content) - test = None - if name == 'doctest': - if '' in code: - # convert s to ordinary blank lines for presentation - test = code - code = blankline_re.sub('', code) - if doctestopt_re.search(code): - if not test: - test = code - code = doctestopt_re.sub('', code) - nodetype = nodes.literal_block - if name == 'testsetup' or 'hide' in options: - nodetype = nodes.comment - if arguments: - groups = [x.strip() for x in arguments[0].split(',')] - else: - groups = ['default'] - node = nodetype(code, code, testnodetype=name, groups=groups) - node.line = lineno - if test is not None: - # only save if it differs from code - node['test'] = test - if name == 'testoutput': - # don't try to highlight output - node['language'] = 'none' - node['options'] = {} - if name in ('doctest', 'testoutput') and 'options' in options: - # parse doctest-like output comparison flags - option_strings = options['options'].replace(',', ' ').split() - for option in option_strings: - if (option[0] not in '+-' or option[1:] not in - doctest.OPTIONFLAGS_BY_NAME): - # XXX warn? - continue - flag = doctest.OPTIONFLAGS_BY_NAME[option[1:]] - node['options'][flag] = (option[0] == '+') - return [node] - -# need to have individual functions for each directive due to different -# options they accept - -def testsetup_directive(*args): - return test_directive(*args) - -def doctest_directive(*args): - return test_directive(*args) - -def testcode_directive(*args): - return test_directive(*args) - -def testoutput_directive(*args): - return test_directive(*args) - - -parser = doctest.DocTestParser() - -# helper classes - -class TestGroup(object): - def __init__(self, name): - self.name = name - self.setup = [] - self.tests = [] - - def add_code(self, code): - if code.type == 'testsetup': - self.setup.append(code) - elif code.type == 'doctest': - self.tests.append([code]) - elif code.type == 'testcode': - self.tests.append([code, None]) - elif code.type == 'testoutput': - if self.tests and len(self.tests[-1]) == 2: - self.tests[-1][1] = code - else: - raise RuntimeError('invalid TestCode type') - - def __repr__(self): - return 'TestGroup(name=%r, setup=%r, tests=%r)' % ( - self.name, self.setup, self.tests) - - -class TestCode(object): - def __init__(self, code, type, lineno, options=None): - self.code = code - self.type = type - self.lineno = lineno - self.options = options or {} - - def __repr__(self): - return 'TestCode(%r, %r, %r, options=%r)' % ( - self.code, self.type, self.lineno, self.options) - - -class SphinxDocTestRunner(doctest.DocTestRunner): - def summarize(self, out, verbose=None): - io = StringIO.StringIO() - old_stdout = sys.stdout - sys.stdout = io - try: - res = doctest.DocTestRunner.summarize(self, verbose) - finally: - sys.stdout = old_stdout - out(io.getvalue()) - return res - -# the new builder -- use sphinx-build.py -b doctest to run - -class DocTestBuilder(Builder): - """ - Runs test snippets in the documentation. - """ - name = 'doctest' - - def init(self): - # default options - self.opt = doctest.DONT_ACCEPT_TRUE_FOR_1 | doctest.ELLIPSIS | \ - doctest.IGNORE_EXCEPTION_DETAIL - - # HACK HACK HACK - # doctest compiles its snippets with type 'single'. That is nice - # for doctest examples but unusable for multi-statement code such - # as setup code -- to be able to use doctest error reporting with - # that code nevertheless, we monkey-patch the "compile" it uses. - doctest.compile = self.compile - - self.type = 'single' - - self.total_failures = 0 - self.total_tries = 0 - self.setup_failures = 0 - self.setup_tries = 0 - - date = time.strftime('%Y-%m-%d %H:%M:%S') - - self.outfile = codecs.open(path.join(self.outdir, 'output.txt'), - 'w', encoding='utf-8') - self.outfile.write('''\ -Results of doctest builder run on %s -==================================%s -''' % (date, '='*len(date))) - - def _out(self, text): - self.info(text, nonl=True) - self.outfile.write(text) - - def _warn_out(self, text): - self.info(text, nonl=True) - if self.app.quiet: - self.warn(text) - self.outfile.write(text) - - def get_target_uri(self, docname, typ=None): - return '' - - def get_outdated_docs(self): - return self.env.found_docs - - def finish(self): - # write executive summary - def s(v): - return v != 1 and 's' or '' - self._out(''' -Doctest summary -=============== -%5d test%s -%5d failure%s in tests -%5d failure%s in setup code -''' % (self.total_tries, s(self.total_tries), - self.total_failures, s(self.total_failures), - self.setup_failures, s(self.setup_failures))) - self.outfile.close() - - if self.total_failures or self.setup_failures: - self.app.statuscode = 1 - - sys.path[0:0] = self.config.doctest_path - - def write(self, build_docnames, updated_docnames, method='update'): - if build_docnames is None: - build_docnames = sorted(self.env.all_docs) - - self.info(bold('running tests...')) - for docname in build_docnames: - # no need to resolve the doctree - doctree = self.env.get_doctree(docname) - self.test_doc(docname, doctree) - - def test_doc(self, docname, doctree): - groups = {} - add_to_all_groups = [] - self.setup_runner = SphinxDocTestRunner(verbose=False, - optionflags=self.opt) - self.test_runner = SphinxDocTestRunner(verbose=False, - optionflags=self.opt) - if self.config.doctest_test_doctest_blocks: - def condition(node): - return (isinstance(node, (nodes.literal_block, nodes.comment)) - and node.has_key('testnodetype')) or \ - isinstance(node, nodes.doctest_block) - else: - def condition(node): - return isinstance(node, (nodes.literal_block, nodes.comment)) \ - and node.has_key('testnodetype') - for node in doctree.traverse(condition): - source = node.has_key('test') and node['test'] or node.astext() - if not source: - self.warn('no code/output in %s block at %s:%s' % - (node.get('testnodetype', 'doctest'), - self.env.doc2path(docname), node.line)) - code = TestCode(source, type=node.get('testnodetype', 'doctest'), - lineno=node.line, options=node.get('options')) - node_groups = node.get('groups', ['default']) - if '*' in node_groups: - add_to_all_groups.append(code) - continue - for groupname in node_groups: - if groupname not in groups: - groups[groupname] = TestGroup(groupname) - groups[groupname].add_code(code) - for code in add_to_all_groups: - for group in groups.itervalues(): - group.add_code(code) - if not groups: - return - - self._out('\nDocument: %s\n----------%s\n' % (docname, '-'*len(docname))) - for group in groups.itervalues(): - self.test_group(group, self.env.doc2path(docname, base=None)) - # Separately count results from setup code - res_f, res_t = self.setup_runner.summarize(self._out, verbose=False) - self.setup_failures += res_f - self.setup_tries += res_t - if self.test_runner.tries: - res_f, res_t = self.test_runner.summarize(self._out, verbose=True) - self.total_failures += res_f - self.total_tries += res_t - - def compile(self, code, name, type, flags, dont_inherit): - return compile(code, name, self.type, flags, dont_inherit) - - def test_group(self, group, filename): - ns = {} - examples = [] - for setup in group.setup: - examples.append(doctest.Example(setup.code, '', lineno=setup.lineno)) - if examples: - # simulate a doctest with the setup code - setup_doctest = doctest.DocTest(examples, {}, - '%s (setup code)' % group.name, - filename, 0, None) - setup_doctest.globs = ns - old_f = self.setup_runner.failures - self.type = 'exec' # the snippet may contain multiple statements - self.setup_runner.run(setup_doctest, out=self._warn_out, - clear_globs=False) - if self.setup_runner.failures > old_f: - # don't run the group - return - for code in group.tests: - if len(code) == 1: - test = parser.get_doctest(code[0].code, {}, - group.name, filename, code[0].lineno) - if not test.examples: - continue - for example in test.examples: - # apply directive's comparison options - new_opt = code[0].options.copy() - new_opt.update(example.options) - example.options = new_opt - self.type = 'single' # ordinary doctests - else: - output = code[1] and code[1].code or '' - options = code[1] and code[1].options or {} - # disable processing as it is not needed - options[doctest.DONT_ACCEPT_BLANKLINE] = True - example = doctest.Example(code[0].code, output, - lineno=code[0].lineno, - options=options) - test = doctest.DocTest([example], {}, group.name, - filename, code[0].lineno, None) - self.type = 'exec' # multiple statements again - # DocTest.__init__ copies the globs namespace, which we don't want - test.globs = ns - # also don't clear the globs namespace after running the doctest - self.test_runner.run(test, out=self._warn_out, clear_globs=False) - - -def setup(app): - app.add_directive('testsetup', testsetup_directive, 1, (0, 1, 1)) - app.add_directive('doctest', doctest_directive, 1, (0, 1, 1), - hide=directives.flag, options=directives.unchanged) - app.add_directive('testcode', testcode_directive, 1, (0, 1, 1), - hide=directives.flag) - app.add_directive('testoutput', testoutput_directive, 1, (0, 1, 1), - hide=directives.flag, options=directives.unchanged) - app.add_builder(DocTestBuilder) - # this config value adds to sys.path - app.add_config_value('doctest_path', [], False) - app.add_config_value('doctest_test_doctest_blocks', 'default', False) diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/ext/ifconfig.py --- a/buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/ext/ifconfig.py Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,62 +0,0 @@ -# -*- coding: utf-8 -*- -""" - sphinx.ext.ifconfig - ~~~~~~~~~~~~~~~~~~~ - - Provides the ``ifconfig`` directive that allows to write documentation - that is included depending on configuration variables. - - Usage:: - - .. ifconfig:: releaselevel in ('alpha', 'beta', 'rc') - - This stuff is only included in the built docs for unstable versions. - - The argument for ``ifconfig`` is a plain Python expression, evaluated in the - namespace of the project configuration (that is, all variables from ``conf.py`` - are available.) - - :copyright: 2008 by Georg Brandl. - :license: BSD. -""" - -from docutils import nodes - - -class ifconfig(nodes.Element): pass - - -def ifconfig_directive(name, arguments, options, content, lineno, - content_offset, block_text, state, state_machine): - node = ifconfig() - node.line = lineno - node['expr'] = arguments[0] - state.nested_parse(content, content_offset, node) - return [node] - - -def process_ifconfig_nodes(app, doctree, docname): - ns = app.config.__dict__.copy() - ns['builder'] = app.builder.name - for node in doctree.traverse(ifconfig): - try: - res = eval(node['expr'], ns) - except Exception, err: - # handle exceptions in a clean fashion - from traceback import format_exception_only - msg = ''.join(format_exception_only(err.__class__, err)) - newnode = doctree.reporter.error('Exception occured in ' - 'ifconfig expression: \n%s' % - msg, base_node=node) - node.replace_self(newnode) - else: - if not res: - node.replace_self([]) - else: - node.replace_self(node.children) - - -def setup(app): - app.add_node(ifconfig) - app.add_directive('ifconfig', ifconfig_directive, 1, (1, 0, 1)) - app.connect('doctree-resolved', process_ifconfig_nodes) diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/ext/intersphinx.py --- a/buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/ext/intersphinx.py Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,141 +0,0 @@ -# -*- coding: utf-8 -*- -""" - sphinx.ext.intersphinx - ~~~~~~~~~~~~~~~~~~~~~~ - - Insert links to Python objects documented in remote Sphinx documentation. - - This works as follows: - - * Each Sphinx HTML build creates a file named "objects.inv" that contains - a mapping from Python identifiers to URIs relative to the HTML set's root. - - * Projects using the Intersphinx extension can specify links to such mapping - files in the `intersphinx_mapping` config value. The mapping will then be - used to resolve otherwise missing references to Python objects into links - to the other documentation. - - * By default, the mapping file is assumed to be at the same location as the - rest of the documentation; however, the location of the mapping file can - also be specified individually, e.g. if the docs should be buildable - without Internet access. - - :copyright: 2008 by Georg Brandl. - :license: BSD. -""" - -import time -import urllib -import posixpath -from os import path - -from docutils import nodes - -from sphinx.builder import INVENTORY_FILENAME - - -def fetch_inventory(app, uri, inv): - """Fetch, parse and return an intersphinx inventory file.""" - invdata = {} - # both *uri* (base URI of the links to generate) and *inv* (actual - # location of the inventory file) can be local or remote URIs - localuri = uri.find('://') == -1 - try: - if inv.find('://') != -1: - f = urllib.urlopen(inv) - else: - f = open(path.join(app.srcdir, inv)) - except Exception, err: - app.warn('intersphinx inventory %r not fetchable due to ' - '%s: %s' % (inv, err.__class__, err)) - return - try: - line = f.next() - if line.rstrip() != '# Sphinx inventory version 1': - raise ValueError('unknown or unsupported inventory version') - line = f.next() - projname = line.rstrip()[11:].decode('utf-8') - line = f.next() - version = line.rstrip()[11:] - for line in f: - name, type, location = line.rstrip().split(None, 2) - if localuri: - location = path.join(uri, location) - else: - location = posixpath.join(uri, location) - invdata[name] = (type, projname, version, location) - f.close() - except Exception, err: - app.warn('intersphinx inventory %r not readable due to ' - '%s: %s' % (inv, err.__class__, err)) - else: - return invdata - - -def load_mappings(app): - """Load all intersphinx mappings into the environment.""" - now = int(time.time()) - cache_time = now - app.config.intersphinx_cache_limit * 86400 - env = app.builder.env - if not hasattr(env, 'intersphinx_cache'): - env.intersphinx_cache = {} - cache = env.intersphinx_cache - update = False - for uri, inv in app.config.intersphinx_mapping.iteritems(): - # we can safely assume that the uri<->inv mapping is not changed - # during partial rebuilds since a changed intersphinx_mapping - # setting will cause a full environment reread - if not inv: - inv = posixpath.join(uri, INVENTORY_FILENAME) - # decide whether the inventory must be read: always read local - # files; remote ones only if the cache time is expired - if '://' not in inv or uri not in cache \ - or cache[uri][0] < cache_time: - invdata = fetch_inventory(app, uri, inv) - cache[uri] = (now, invdata) - update = True - if update: - env.intersphinx_inventory = {} - for _, invdata in cache.itervalues(): - if invdata: - env.intersphinx_inventory.update(invdata) - - -def missing_reference(app, env, node, contnode): - """Attempt to resolve a missing reference via intersphinx references.""" - type = node['reftype'] - target = node['reftarget'] - if type == 'mod': - type, proj, version, uri = env.intersphinx_inventory.get(target, - ('','','','')) - if type != 'mod': - return None - target = 'module-' + target # for link anchor - else: - if target[-2:] == '()': - target = target[:-2] - target = target.rstrip(' *') - # special case: exceptions and object methods - if type == 'exc' and '.' not in target and \ - 'exceptions.' + target in env.intersphinx_inventory: - target = 'exceptions.' + target - elif type in ('func', 'meth') and '.' not in target and \ - 'object.' + target in env.intersphinx_inventory: - target = 'object.' + target - if target not in env.intersphinx_inventory: - return None - type, proj, version, uri = env.intersphinx_inventory[target] - print "Intersphinx hit:", target, uri - newnode = nodes.reference('', '') - newnode['refuri'] = uri + '#' + target - newnode['reftitle'] = '(in %s v%s)' % (proj, version) - newnode['class'] = 'external-xref' - newnode.append(contnode) - return newnode - - -def setup(app): - app.add_config_value('intersphinx_mapping', {}, True) - app.add_config_value('intersphinx_cache_limit', 5, False) - app.connect('missing-reference', missing_reference) - app.connect('builder-inited', load_mappings) diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/ext/jsmath.py --- a/buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/ext/jsmath.py Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,57 +0,0 @@ -# -*- coding: utf-8 -*- -""" - sphinx.ext.jsmath - ~~~~~~~~~~~~~~~~~ - - Set up everything for use of JSMath to display math in HTML - via JavaScript. - - :copyright: 2008 by Georg Brandl. - :license: BSD. -""" - -from docutils import nodes - -from sphinx.application import ExtensionError -from sphinx.ext.mathbase import setup as mathbase_setup - - -def html_visit_math(self, node): - self.body.append(self.starttag(node, 'span', '', CLASS='math')) - self.body.append(self.encode(node['latex']) + '') - raise nodes.SkipNode - -def html_visit_displaymath(self, node): - if node['nowrap']: - self.body.append(self.starttag(node, 'div', CLASS='math')) - self.body.append(node['latex']) - self.body.append('') - raise nodes.SkipNode - for i, part in enumerate(node['latex'].split('\n\n')): - part = self.encode(part) - if i == 0: - # necessary to e.g. set the id property correctly - if node['number']: - self.body.append('(%s)' % node['number']) - self.body.append(self.starttag(node, 'div', CLASS='math')) - else: - # but only once! - self.body.append('

') - if '&' in part or '\\\\' in part: - self.body.append('\\begin{split}' + part + '\\end{split}') - else: - self.body.append(part) - self.body.append('

\n') - raise nodes.SkipNode - -def builder_inited(app): - if not app.config.jsmath_path: - raise ExtensionError('jsmath_path config value must be set for the ' - 'jsmath extension to work') - app.add_javascript(app.config.jsmath_path) - - -def setup(app): - mathbase_setup(app, (html_visit_math, None), (html_visit_displaymath, None)) - app.add_config_value('jsmath_path', '', False) - app.connect('builder-inited', builder_inited) diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/ext/mathbase.py --- a/buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/ext/mathbase.py Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,139 +0,0 @@ -# -*- coding: utf-8 -*- -""" - sphinx.ext.mathbase - ~~~~~~~~~~~~~~~~~~~ - - Set up math support in source files and LaTeX/text output. - - :copyright: 2008 by Georg Brandl. - :license: BSD. -""" - -from docutils import nodes, utils -from docutils.parsers.rst import directives - - -class math(nodes.Inline, nodes.TextElement): - pass - -class displaymath(nodes.Part, nodes.Element): - pass - -class eqref(nodes.Inline, nodes.TextElement): - pass - - -def wrap_displaymath(math, label): - parts = math.split('\n\n') - ret = [] - for i, part in enumerate(parts): - if label is not None and i == 0: - ret.append('\\begin{split}%s\\end{split}' % part + - (label and '\\label{'+label+'}' or '')) - else: - ret.append('\\begin{split}%s\\end{split}\\notag' % part) - return '\\begin{gather}\n' + '\\\\'.join(ret) + '\n\\end{gather}' - - -def math_role(role, rawtext, text, lineno, inliner, options={}, content=[]): - latex = utils.unescape(text, restore_backslashes=True) - return [math(latex=latex)], [] - -def eq_role(role, rawtext, text, lineno, inliner, options={}, content=[]): - text = utils.unescape(text) - node = eqref('(?)', '(?)', target=text) - node['docname'] = inliner.document.settings.env.docname - return [node], [] - -def math_directive(name, arguments, options, content, lineno, - content_offset, block_text, state, state_machine): - latex = '\n'.join(content) - if arguments and arguments[0]: - latex = arguments[0] + '\n\n' + latex - node = displaymath() - node['latex'] = latex - node['label'] = options.get('label', None) - node['nowrap'] = 'nowrap' in options - node['docname'] = state.document.settings.env.docname - ret = [node] - if node['label']: - tnode = nodes.target('', '', ids=['equation-' + node['label']]) - state.document.note_explicit_target(tnode) - ret.insert(0, tnode) - return ret - - -def latex_visit_math(self, node): - self.body.append('$' + node['latex'] + '$') - raise nodes.SkipNode - -def latex_visit_displaymath(self, node): - if node['nowrap']: - self.body.append(node['latex']) - else: - label = node['label'] and node['docname'] + '-' + node['label'] or None - self.body.append(wrap_displaymath(node['latex'], label)) - raise nodes.SkipNode - -def latex_visit_eqref(self, node): - self.body.append('\\eqref{%s-%s}' % (node['docname'], node['target'])) - raise nodes.SkipNode - - -def text_visit_math(self, node): - self.add_text(node['latex']) - raise nodes.SkipNode - -def text_visit_displaymath(self, node): - self.new_state() - self.add_text(node['latex']) - self.end_state() - raise nodes.SkipNode - -def text_visit_eqref(self, node): - self.add_text(node['target']) - raise nodes.SkipNode - - -def html_visit_eqref(self, node): - self.body.append('' % node['target']) - -def html_depart_eqref(self, node): - self.body.append('') - - -def number_equations(app, doctree, docname): - num = 0 - numbers = {} - for node in doctree.traverse(displaymath): - if node['label'] is not None: - num += 1 - node['number'] = num - numbers[node['label']] = num - else: - node['number'] = None - for node in doctree.traverse(eqref): - if node['target'] not in numbers: - continue - num = '(%d)' % numbers[node['target']] - node[0] = nodes.Text(num, num) - - -def setup(app, htmlinlinevisitors, htmldisplayvisitors): - app.add_node(math, - latex=(latex_visit_math, None), - text=(text_visit_math, None), - html=htmlinlinevisitors) - app.add_node(displaymath, - latex=(latex_visit_displaymath, None), - text=(text_visit_displaymath, None), - html=htmldisplayvisitors) - app.add_node(eqref, - latex=(latex_visit_eqref, None), - text=(text_visit_eqref, None), - html=(html_visit_eqref, html_depart_eqref)) - app.add_role('math', math_role) - app.add_role('eq', eq_role) - app.add_directive('math', math_directive, 1, (0, 1, 1), - label=directives.unchanged, nowrap=directives.flag) - app.connect('doctree-resolved', number_equations) diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/ext/pngmath.py --- a/buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/ext/pngmath.py Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,224 +0,0 @@ -# -*- coding: utf-8 -*- -""" - sphinx.ext.pngmath - ~~~~~~~~~~~~~~~~~~ - - Render math in HTML via dvipng. - - :copyright: 2008 by Georg Brandl. - :license: BSD. -""" - -import re -import shutil -import tempfile -import posixpath -from os import path, getcwd, chdir -from subprocess import Popen, PIPE -try: - from hashlib import sha1 as sha -except ImportError: - from sha import sha - -from docutils import nodes - -from sphinx.util import ensuredir -from sphinx.util.png import read_png_depth, write_png_depth -from sphinx.application import SphinxError -from sphinx.ext.mathbase import setup as mathbase_setup, wrap_displaymath - -class MathExtError(SphinxError): - category = 'Math extension error' - - -DOC_HEAD = r''' -\documentclass[12pt]{article} -\usepackage[utf8]{inputenc} -\usepackage{amsmath} -\usepackage{amsthm} -\usepackage{amssymb} -\usepackage{amsfonts} -\usepackage{bm} -\pagestyle{empty} -''' - -DOC_BODY = r''' -\begin{document} -%s -\end{document} -''' - -DOC_BODY_PREVIEW = r''' -\usepackage[active]{preview} -\begin{document} -\begin{preview} -%s -\end{preview} -\end{document} -''' - -depth_re = re.compile(r'\[\d+ depth=(-?\d+)\]') - -def render_math(self, math): - """ - Render the LaTeX math expression *math* using latex and dvipng. - - Return the filename relative to the built document and the "depth", - that is, the distance of image bottom and baseline in pixels, if the - option to use preview_latex is switched on. - - Error handling may seem strange, but follows a pattern: if LaTeX or - dvipng aren't available, only a warning is generated (since that enables - people on machines without these programs to at least build the rest - of the docs successfully). If the programs are there, however, they - may not fail since that indicates a problem in the math source. - """ - use_preview = self.builder.config.pngmath_use_preview - - shasum = "%s.png" % sha(math.encode('utf-8')).hexdigest() - relfn = posixpath.join(self.builder.imgpath, 'math', shasum) - outfn = path.join(self.builder.outdir, '_images', 'math', shasum) - if path.isfile(outfn): - depth = read_png_depth(outfn) - return relfn, depth - - latex = DOC_HEAD + self.builder.config.pngmath_latex_preamble - latex += (use_preview and DOC_BODY_PREVIEW or DOC_BODY) % math - if isinstance(latex, unicode): - latex = latex.encode('utf-8') - - # use only one tempdir per build -- the use of a directory is cleaner - # than using temporary files, since we can clean up everything at once - # just removing the whole directory (see cleanup_tempdir) - if not hasattr(self.builder, '_mathpng_tempdir'): - tempdir = self.builder._mathpng_tempdir = tempfile.mkdtemp() - else: - tempdir = self.builder._mathpng_tempdir - - tf = open(path.join(tempdir, 'math.tex'), 'w') - tf.write(latex) - tf.close() - - # build latex command; old versions of latex don't have the - # --output-directory option, so we have to manually chdir to the - # temp dir to run it. - ltx_args = [self.builder.config.pngmath_latex, '--interaction=nonstopmode'] - # add custom args from the config file - ltx_args.extend(self.builder.config.pngmath_latex_args) - ltx_args.append('math.tex') - - curdir = getcwd() - chdir(tempdir) - - try: - try: - p = Popen(ltx_args, stdout=PIPE, stderr=PIPE) - except OSError, err: - if err.errno != 2: # No such file or directory - raise - if not hasattr(self.builder, '_mathpng_warned_latex'): - self.builder.warn('LaTeX command %r cannot be run (needed for math ' - 'display), check the pngmath_latex setting' % - self.builder.config.pngmath_latex) - self.builder._mathpng_warned_latex = True - return relfn, None - finally: - chdir(curdir) - - stdout, stderr = p.communicate() - if p.returncode != 0: - raise MathExtError('latex exited with error:\n[stderr]\n%s\n[stdout]\n%s' - % (stderr, stdout)) - - ensuredir(path.dirname(outfn)) - # use some standard dvipng arguments - dvipng_args = [self.builder.config.pngmath_dvipng] - dvipng_args += ['-o', outfn, '-T', 'tight', '-z9'] - # add custom ones from config value - dvipng_args.extend(self.builder.config.pngmath_dvipng_args) - if use_preview: - dvipng_args.append('--depth') - # last, the input file name - dvipng_args.append(path.join(tempdir, 'math.dvi')) - try: - p = Popen(dvipng_args, stdout=PIPE, stderr=PIPE) - except OSError, err: - if err.errno != 2: # No such file or directory - raise - if not hasattr(self.builder, '_mathpng_warned_dvipng'): - self.builder.warn('dvipng command %r cannot be run (needed for math ' - 'display), check the pngmath_dvipng setting' % - self.builder.config.pngmath_dvipng) - self.builder._mathpng_warned_dvipng = True - return relfn, None - stdout, stderr = p.communicate() - if p.returncode != 0: - raise MathExtError('dvipng exited with error:\n[stderr]\n%s\n[stdout]\n%s' - % (stderr, stdout)) - depth = None - if use_preview: - for line in stdout.splitlines(): - m = depth_re.match(line) - if m: - depth = int(m.group(1)) - write_png_depth(outfn, depth) - break - - return relfn, depth - -def cleanup_tempdir(app, exc): - if exc: - return - if not hasattr(app.builder, '_mathpng_tempdir'): - return - try: - shutil.rmtree(app.builder._mathpng_tempdir) - except Exception: - pass - -def html_visit_math(self, node): - try: - fname, depth = render_math(self, '$'+node['latex']+'$') - except MathExtError, exc: - sm = nodes.system_message(str(exc), type='WARNING', level=2, - backrefs=[], source=node['latex']) - sm.walkabout(self) - self.builder.warn('display latex %r: ' % node['latex'] + str(exc)) - raise nodes.SkipNode - self.body.append(' $%s$ ' % - (fname, self.encode(node['latex']).strip(), - depth and 'style="vertical-align: %dpx" ' % (-depth) or '')) - raise nodes.SkipNode - -def html_visit_displaymath(self, node): - if node['nowrap']: - latex = node['latex'] - else: - latex = wrap_displaymath(node['latex'], None) - try: - fname, depth = render_math(self, latex) - except MathExtError, exc: - sm = nodes.system_message(str(exc), type='WARNING', level=2, - backrefs=[], source=node['latex']) - sm.walkabout(self) - self.builder.warn('inline latex %r: ' % node['latex'] + str(exc)) - raise nodes.SkipNode - self.body.append(self.starttag(node, 'div', CLASS='math')) - self.body.append('

') - if node['number']: - self.body.append('(%s)' % node['number']) - self.body.append('\n' % - (fname, self.encode(node['latex']).strip())) - self.body.append('

') - raise nodes.SkipNode - - -def setup(app): - mathbase_setup(app, (html_visit_math, None), (html_visit_displaymath, None)) - app.add_config_value('pngmath_dvipng', 'dvipng', False) - app.add_config_value('pngmath_latex', 'latex', False) - app.add_config_value('pngmath_use_preview', False, False) - app.add_config_value('pngmath_dvipng_args', ['-gamma 1.5', '-D 110'], False) - app.add_config_value('pngmath_latex_args', [], False) - app.add_config_value('pngmath_latex_preamble', '', False) - app.connect('build-finished', cleanup_tempdir) diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/ext/refcounting.py --- a/buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/ext/refcounting.py Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,98 +0,0 @@ -# -*- coding: utf-8 -*- -""" - sphinx.ext.refcounting - ~~~~~~~~~~~~~~~~~~~~~~ - - Supports reference count annotations for C API functions. Based on - refcount.py and anno-api.py in the old Python documentation tools. - - Usage: Set the `refcount_file` config value to the path to the reference - count data file. - - :copyright: 2008 by Georg Brandl. - :license: BSD. -""" - -from os import path -from docutils import nodes - -from sphinx import addnodes - - -# refcount annotation -class refcount(nodes.emphasis): pass - - -class RCEntry: - def __init__(self, name): - self.name = name - self.args = [] - self.result_type = '' - self.result_refs = None - - -class Refcounts(dict): - @classmethod - def fromfile(cls, filename): - d = cls() - fp = open(filename, 'r') - try: - for line in fp: - line = line.strip() - if line[:1] in ("", "#"): - # blank lines and comments - continue - parts = line.split(":", 4) - if len(parts) != 5: - raise ValueError("Wrong field count in %r" % line) - function, type, arg, refcount, comment = parts - # Get the entry, creating it if needed: - try: - entry = d[function] - except KeyError: - entry = d[function] = RCEntry(function) - if not refcount or refcount == "null": - refcount = None - else: - refcount = int(refcount) - # Update the entry with the new parameter or the result information. - if arg: - entry.args.append((arg, type, refcount)) - else: - entry.result_type = type - entry.result_refs = refcount - finally: - fp.close() - return d - - def add_refcount_annotations(self, app, doctree): - for node in doctree.traverse(addnodes.desc_content): - par = node.parent - if par['desctype'] != 'cfunction': - continue - if not par[0].has_key('names') or not par[0]['names']: - continue - entry = self.get(par[0]['names'][0]) - if not entry: - continue - elif entry.result_type not in ("PyObject*", "PyVarObject*"): - continue - rc = 'Return value: ' - if entry.result_refs is None: - rc += "Always NULL." - else: - rc += (entry.result_refs and "New" or "Borrowed") + " reference." - node.insert(0, refcount(rc, rc)) - - -def init_refcounts(app): - if app.config.refcount_file: - refcounts = Refcounts.fromfile( - path.join(app.srcdir, app.config.refcount_file)) - app.connect('doctree-read', refcounts.add_refcount_annotations) - - -def setup(app): - app.add_node(refcount) - app.add_config_value('refcount_file', '', True) - app.connect('builder-inited', init_refcounts) diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/ext/todo.py --- a/buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/ext/todo.py Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,123 +0,0 @@ -# -*- coding: utf-8 -*- -""" - sphinx.ext.todo - ~~~~~~~~~~~~~~~ - - Allow todos to be inserted into your documentation. Inclusion of todos can - be switched of by a configuration variable. The todolist directive collects - all todos of your project and lists them along with a backlink to the - original location. - - :copyright: 2008 Daniel Bültmann. - :license: BSD. -""" - -from docutils import nodes - -from sphinx.util.compat import make_admonition - -class todo_node(nodes.Admonition, nodes.Element): pass -class todolist(nodes.General, nodes.Element): pass - - -def todo_directive(name, arguments, options, content, lineno, - content_offset, block_text, state, state_machine): - env = state.document.settings.env - - targetid = "todo-%s" % env.index_num - env.index_num += 1 - targetnode = nodes.target('', '', ids=[targetid]) - - ad = make_admonition(todo_node, name, [_('Todo')], options, content, lineno, - content_offset, block_text, state, state_machine) - - # Attach a list of all todos to the environment, - # the todolist works with the collected todo nodes - if not hasattr(env, 'todo_all_todos'): - env.todo_all_todos = [] - env.todo_all_todos.append({ - 'docname': env.docname, - 'lineno': lineno, - 'todo': ad[0].deepcopy(), - 'target': targetnode, - }) - - return [targetnode] + ad - - -def todolist_directive(name, arguments, options, content, lineno, - content_offset, block_text, state, state_machine): - # Simply insert an empty todolist node which will be replaced later - # when process_todo_nodes is called - return [todolist('')] - - -def process_todo_nodes(app, doctree, fromdocname): - if not app.config['todo_include_todos']: - for node in doctree.traverse(todo_node): - node.parent.remove(node) - - # Replace all todolist nodes with a list of the collected todos. - # Augment each todo with a backlink to the original location. - env = app.builder.env - - for node in doctree.traverse(todolist): - if not app.config['todo_include_todos']: - node.replace_self([]) - continue - - content = [] - - for todo_info in env.todo_all_todos: - para = nodes.paragraph() - filename = env.doc2path(todo_info['docname'], base=None) - description = ( - _('(The original entry is located in %s, line %d and can be found ') % - (filename, todo_info['lineno'])) - para += nodes.Text(description, description) - - # Create a reference - newnode = nodes.reference('', '') - innernode = nodes.emphasis(_('here'), _('here')) - newnode['refdocname'] = todo_info['docname'] - newnode['refuri'] = app.builder.get_relative_uri( - fromdocname, todo_info['docname']) - newnode['refuri'] += '#' + todo_info['target']['refid'] - newnode.append(innernode) - para += newnode - para += nodes.Text('.)', '.)') - - # Insert into the todolist - content.append(todo_info['todo']) - content.append(para) - - node.replace_self(content) - - -def purge_todos(app, env, docname): - if not hasattr(env, 'todo_all_todos'): - return - env.todo_all_todos = [todo for todo in env.todo_all_todos - if todo['docname'] != docname] - - -def visit_todo_node(self, node): - self.visit_admonition(node) - -def depart_todo_node(self, node): - self.depart_admonition(node) - -def setup(app): - app.add_config_value('todo_include_todos', False, False) - - app.add_node(todolist) - app.add_node(todo_node, - html=(visit_todo_node, depart_todo_node), - latex=(visit_todo_node, depart_todo_node), - text=(visit_todo_node, depart_todo_node)) - - app.add_directive('todo', todo_directive, 1, (0, 0, 1)) - app.add_directive('todolist', todolist_directive, 0, (0, 0, 0)) - app.connect('doctree-resolved', process_todo_nodes) - app.connect('env-purge-doc', purge_todos) - diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/highlighting.py --- a/buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/highlighting.py Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,195 +0,0 @@ -# -*- coding: utf-8 -*- -""" - sphinx.highlighting - ~~~~~~~~~~~~~~~~~~~ - - Highlight code blocks using Pygments. - - :copyright: 2007-2008 by Georg Brandl. - :license: BSD. -""" - -import sys -import cgi -import re -import parser - -from sphinx.util.texescape import tex_hl_escape_map - -try: - import pygments - from pygments import highlight - from pygments.lexers import PythonLexer, PythonConsoleLexer, CLexer, \ - TextLexer, RstLexer - from pygments.lexers import get_lexer_by_name, guess_lexer - from pygments.formatters import HtmlFormatter, LatexFormatter - from pygments.filters import ErrorToken - from pygments.style import Style - from pygments.styles import get_style_by_name - from pygments.styles.friendly import FriendlyStyle - from pygments.token import Generic, Comment, Number -except ImportError: - pygments = None -else: - class SphinxStyle(Style): - """ - Like friendly, but a bit darker to enhance contrast on the green - background. - """ - - background_color = '#eeffcc' - default_style = '' - - styles = FriendlyStyle.styles - styles.update({ - Generic.Output: '#333', - Comment: 'italic #408090', - Number: '#208050', - }) - - lexers = dict( - none = TextLexer(), - python = PythonLexer(), - pycon = PythonConsoleLexer(), - # the python3 option exists as of Pygments 0.12, but it doesn't - # do any harm in previous versions - pycon3 = PythonConsoleLexer(python3=True), - rest = RstLexer(), - c = CLexer(), - ) - for _lexer in lexers.values(): - _lexer.add_filter('raiseonerror') - - -escape_hl_chars = {ord(u'@'): u'@PYGZat[]', - ord(u'['): u'@PYGZlb[]', - ord(u']'): u'@PYGZrb[]'} - -# used if Pygments is not available -_LATEX_STYLES = r''' -\newcommand\PYGZat{@} -\newcommand\PYGZlb{[} -\newcommand\PYGZrb{]} -''' - - -parsing_exceptions = (SyntaxError, UnicodeEncodeError) -if sys.version_info < (2, 5): - # Python <= 2.4 raises MemoryError when parsing an - # invalid encoding cookie - parsing_exceptions += MemoryError, - - -class PygmentsBridge(object): - def __init__(self, dest='html', stylename='sphinx'): - self.dest = dest - if not pygments: - return - if stylename == 'sphinx': - style = SphinxStyle - elif '.' in stylename: - module, stylename = stylename.rsplit('.', 1) - style = getattr(__import__(module, None, None, ['']), stylename) - else: - style = get_style_by_name(stylename) - self.hfmter = {False: HtmlFormatter(style=style), - True: HtmlFormatter(style=style, linenos=True)} - self.lfmter = {False: LatexFormatter(style=style, commandprefix='PYG'), - True: LatexFormatter(style=style, linenos=True, - commandprefix='PYG')} - - def unhighlighted(self, source): - if self.dest == 'html': - return '

' + cgi.escape(source) + '

\n' - else: - # first, escape highlighting characters like Pygments does - source = source.translate(escape_hl_chars) - # then, escape all characters nonrepresentable in LaTeX - source = source.translate(tex_hl_escape_map) - return '\\begin{Verbatim}[commandchars=@\\[\\]]\n' + \ - source + '\\end{Verbatim}\n' - - def try_parse(self, src): - # Make sure it ends in a newline - src += '\n' - - # Replace "..." by a mark which is also a valid python expression - # (Note, the highlighter gets the original source, this is only done - # to allow "..." in code and still highlight it as Python code.) - mark = "__highlighting__ellipsis__" - src = src.replace("...", mark) - - # lines beginning with "..." are probably placeholders for suite - src = re.sub(r"(?m)^(\s*)" + mark + "(.)", r"\1"+ mark + r"# \2", src) - - # if we're using 2.5, use the with statement - if sys.version_info >= (2, 5): - src = 'from __future__ import with_statement\n' + src - - if isinstance(src, unicode): - # Non-ASCII chars will only occur in string literals - # and comments. If we wanted to give them to the parser - # correctly, we'd have to find out the correct source - # encoding. Since it may not even be given in a snippet, - # just replace all non-ASCII characters. - src = src.encode('ascii', 'replace') - - try: - parser.suite(src) - except parsing_exceptions: - return False - else: - return True - - def highlight_block(self, source, lang, linenos=False): - if not pygments: - return self.unhighlighted(source) - if lang in ('py', 'python'): - if source.startswith('>>>'): - # interactive session - lexer = lexers['pycon'] - else: - # maybe Python -- try parsing it - if self.try_parse(source): - lexer = lexers['python'] - else: - return self.unhighlighted(source) - elif lang in ('python3', 'py3') and source.startswith('>>>'): - # for py3, recognize interactive sessions, but do not try parsing... - lexer = lexers['pycon3'] - elif lang == 'guess': - try: - lexer = guess_lexer(source) - except Exception: - return self.unhighlighted(source) - else: - if lang in lexers: - lexer = lexers[lang] - else: - lexer = lexers[lang] = get_lexer_by_name(lang) - lexer.add_filter('raiseonerror') - try: - if self.dest == 'html': - return highlight(source, lexer, self.hfmter[bool(linenos)]) - else: - hlsource = highlight(source, lexer, self.lfmter[bool(linenos)]) - return hlsource.translate(tex_hl_escape_map) - except ErrorToken: - # this is most probably not the selected language, - # so let it pass unhighlighted - return self.unhighlighted(source) - - def get_stylesheet(self): - if not pygments: - if self.dest == 'latex': - return _LATEX_STYLES - # no HTML styles needed - return '' - if self.dest == 'html': - return self.hfmter[0].get_style_defs() - else: - styledefs = self.lfmter[0].get_style_defs() - # workaround for Pygments < 0.12 - if styledefs.startswith('\\newcommand\\at{@}'): - styledefs += _LATEX_STYLES - return styledefs diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/htmlhelp.py --- a/buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/htmlhelp.py Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,220 +0,0 @@ -# -*- coding: utf-8 -*- -""" - sphinx.htmlhelp - ~~~~~~~~~~~~~~~ - - Build HTML help support files. - Adapted from the original Doc/tools/prechm.py. - - :copyright: 2007-2008 by Georg Brandl. - :license: BSD. -""" - -import os -import cgi -from os import path - -from docutils import nodes - -from sphinx import addnodes - -# Project file (*.hhp) template. 'outname' is the file basename (like -# the pythlp in pythlp.hhp); 'version' is the doc version number (like -# the 2.2 in Python 2.2). -# The magical numbers in the long line under [WINDOWS] set most of the -# user-visible features (visible buttons, tabs, etc). -# About 0x10384e: This defines the buttons in the help viewer. The -# following defns are taken from htmlhelp.h. Not all possibilities -# actually work, and not all those that work are available from the Help -# Workshop GUI. In particular, the Zoom/Font button works and is not -# available from the GUI. The ones we're using are marked with 'x': -# -# 0x000002 Hide/Show x -# 0x000004 Back x -# 0x000008 Forward x -# 0x000010 Stop -# 0x000020 Refresh -# 0x000040 Home x -# 0x000080 Forward -# 0x000100 Back -# 0x000200 Notes -# 0x000400 Contents -# 0x000800 Locate x -# 0x001000 Options x -# 0x002000 Print x -# 0x004000 Index -# 0x008000 Search -# 0x010000 History -# 0x020000 Favorites -# 0x040000 Jump 1 -# 0x080000 Jump 2 -# 0x100000 Zoom/Font x -# 0x200000 TOC Next -# 0x400000 TOC Prev - -project_template = '''\ -[OPTIONS] -Binary TOC=Yes -Binary Index=No -Compiled file=%(outname)s.chm -Contents file=%(outname)s.hhc -Default Window=%(outname)s -Default topic=index.html -Display compile progress=No -Full text search stop list file=%(outname)s.stp -Full-text search=Yes -Index file=%(outname)s.hhk -Language=0x409 -Title=%(title)s - -[WINDOWS] -%(outname)s="%(title)s","%(outname)s.hhc","%(outname)s.hhk",\ -"index.html","index.html",,,,,0x63520,220,0x10384e,[0,0,1024,768],,,,,,,0 - -[FILES] -''' - -contents_header = '''\ - - - - - - -

-''' - -contents_footer = '''\ - -''' - -object_sitemap = '''\ -

-''' - -# List of words the full text search facility shouldn't index. This -# becomes file outname.stp. Note that this list must be pretty small! -# Different versions of the MS docs claim the file has a maximum size of -# 256 or 512 bytes (including \r\n at the end of each line). -# Note that "and", "or", "not" and "near" are operators in the search -# language, so no point indexing them even if we wanted to. -stopwords = """ -a and are as at -be but by -for -if in into is it -near no not -of on or -such -that the their then there these they this to -was will with -""".split() - - -def build_hhx(builder, outdir, outname): - builder.info('dumping stopword list...') - f = open(path.join(outdir, outname+'.stp'), 'w') - try: - for word in sorted(stopwords): - print >>f, word - finally: - f.close() - - builder.info('writing project file...') - f = open(path.join(outdir, outname+'.hhp'), 'w') - try: - f.write(project_template % {'outname': outname, - 'title': builder.config.html_title, - 'version': builder.config.version, - 'project': builder.config.project}) - if not outdir.endswith(os.sep): - outdir += os.sep - olen = len(outdir) - for root, dirs, files in os.walk(outdir): - staticdir = (root == path.join(outdir, '_static')) - for fn in files: - if (staticdir and not fn.endswith('.js')) or fn.endswith('.html'): - print >>f, path.join(root, fn)[olen:].replace(os.sep, '\\') - finally: - f.close() - - builder.info('writing TOC file...') - f = open(path.join(outdir, outname+'.hhc'), 'w') - try: - f.write(contents_header) - # special books - f.write('

' + object_sitemap % (builder.config.html_short_title, - 'index.html')) - if builder.config.html_use_modindex: - f.write('

' + object_sitemap % (_('Global Module Index'), - 'modindex.html')) - # the TOC - tocdoc = builder.env.get_and_resolve_doctree(builder.config.master_doc, builder, - prune_toctrees=False) - def write_toc(node, ullevel=0): - if isinstance(node, nodes.list_item): - f.write('

') - for subnode in node: - write_toc(subnode, ullevel) - elif isinstance(node, nodes.reference): - link = node['refuri'] - title = cgi.escape(node.astext()).replace('"','"') - item = object_sitemap % (title, link) - f.write(item.encode('ascii', 'xmlcharrefreplace')) - elif isinstance(node, nodes.bullet_list): - if ullevel != 0: - f.write('

\n') - for subnode in node: - write_toc(subnode, ullevel+1) - if ullevel != 0: - f.write('\n') - elif isinstance(node, addnodes.compact_paragraph): - for subnode in node: - write_toc(subnode, ullevel) - istoctree = lambda node: isinstance(node, addnodes.compact_paragraph) and \ - node.has_key('toctree') - for node in tocdoc.traverse(istoctree): - write_toc(node) - f.write(contents_footer) - finally: - f.close() - - builder.info('writing index file...') - index = builder.env.create_index(builder) - f = open(path.join(outdir, outname+'.hhk'), 'w') - try: - f.write('

\n') - write_param('Keyword', title) - if len(refs) == 0: - write_param('See Also', title) - elif len(refs) == 1: - write_param('Local', refs[0]) - else: - for i, ref in enumerate(refs): - write_param('Name', '[%d] %s' % (i, ref)) # XXX: better title? - write_param('Local', ref) - f.write('\n') - if subitems: - f.write('
') - for (key, group) in index: - for title, (refs, subitems) in group: - write_index(title, refs, subitems) - f.write('

\n') - finally: - f.close() diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/htmlwriter.py --- a/buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/htmlwriter.py Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,457 +0,0 @@ -# -*- coding: utf-8 -*- -""" - sphinx.htmlwriter - ~~~~~~~~~~~~~~~~~ - - docutils writers handling Sphinx' custom nodes. - - :copyright: 2007-2008 by Georg Brandl. - :license: BSD. -""" - -import sys -import posixpath -import os - -from docutils import nodes -from docutils.writers.html4css1 import Writer, HTMLTranslator as BaseTranslator - -from sphinx.locale import admonitionlabels, versionlabels -from sphinx.highlighting import PygmentsBridge -from sphinx.util.smartypants import sphinx_smarty_pants - -try: - import Image # check for the Python Imaging Library -except ImportError: - Image = None - -class HTMLWriter(Writer): - def __init__(self, builder): - Writer.__init__(self) - self.builder = builder - - def translate(self): - # sadly, this is mostly copied from parent class - self.visitor = visitor = self.builder.translator_class(self.builder, - self.document) - self.document.walkabout(visitor) - self.output = visitor.astext() - for attr in ('head_prefix', 'stylesheet', 'head', 'body_prefix', - 'body_pre_docinfo', 'docinfo', 'body', 'fragment', - 'body_suffix', 'meta', 'title', 'subtitle', 'header', - 'footer', 'html_prolog', 'html_head', 'html_title', - 'html_subtitle', 'html_body', ): - setattr(self, attr, getattr(visitor, attr, None)) - self.clean_meta = ''.join(visitor.meta[2:]) - - -class HTMLTranslator(BaseTranslator): - """ - Our custom HTML translator. - """ - - def __init__(self, builder, *args, **kwds): - BaseTranslator.__init__(self, *args, **kwds) - self.highlighter = PygmentsBridge('html', builder.config.pygments_style) - self.no_smarty = 0 - self.builder = builder - self.highlightlang = builder.config.highlight_language - self.highlightlinenothreshold = sys.maxint - self.protect_literal_text = 0 - - def visit_desc(self, node): - self.body.append(self.starttag(node, 'dl', CLASS=node['desctype'])) - def depart_desc(self, node): - self.body.append('\n\n') - - def visit_desc_signature(self, node): - # the id is set automatically - self.body.append(self.starttag(node, 'dt')) - # anchor for per-desc interactive data - if node.parent['desctype'] != 'describe' and node['ids'] and node['first']: - self.body.append('' % node['ids'][0]) - if node.parent['desctype'] in ('class', 'exception'): - self.body.append('%s ' % node.parent['desctype']) - def depart_desc_signature(self, node): - if node['ids'] and self.builder.add_definition_links: - self.body.append(u'\u00B6' % - _('Permalink to this definition')) - self.body.append('\n') - - def visit_desc_addname(self, node): - self.body.append(self.starttag(node, 'tt', '', CLASS='descclassname')) - def depart_desc_addname(self, node): - self.body.append('') - - def visit_desc_type(self, node): - pass - def depart_desc_type(self, node): - pass - - def visit_desc_name(self, node): - self.body.append(self.starttag(node, 'tt', '', CLASS='descname')) - def depart_desc_name(self, node): - self.body.append('') - - def visit_desc_parameterlist(self, node): - self.body.append('(') - self.first_param = 1 - def depart_desc_parameterlist(self, node): - self.body.append(')') - - def visit_desc_parameter(self, node): - if not self.first_param: - self.body.append(', ') - else: - self.first_param = 0 - if not node.hasattr('noemph'): - self.body.append('') - def depart_desc_parameter(self, node): - if not node.hasattr('noemph'): - self.body.append('') - - def visit_desc_optional(self, node): - self.body.append('[') - def depart_desc_optional(self, node): - self.body.append(']') - - def visit_desc_annotation(self, node): - self.body.append(self.starttag(node, 'em', CLASS='property')) - def depart_desc_annotation(self, node): - self.body.append('') - - def visit_desc_content(self, node): - self.body.append(self.starttag(node, 'dd', '')) - def depart_desc_content(self, node): - self.body.append('') - - def visit_refcount(self, node): - self.body.append(self.starttag(node, 'em', '', CLASS='refcount')) - def depart_refcount(self, node): - self.body.append('') - - def visit_versionmodified(self, node): - self.body.append(self.starttag(node, 'p')) - text = versionlabels[node['type']] % node['version'] - if len(node): - text += ': ' - else: - text += '.' - self.body.append('%s' % text) - def depart_versionmodified(self, node): - self.body.append('

') - - def visit_compact_paragraph(self, node): - pass - def depart_compact_paragraph(self, node): - pass - - def visit_highlightlang(self, node): - self.highlightlang = node['lang'] - self.highlightlinenothreshold = node['linenothreshold'] - def depart_highlightlang(self, node): - pass - - # overwritten - def visit_image(self, node): - olduri = node['uri'] - # rewrite the URI if the environment knows about it - if olduri in self.builder.images: - node['uri'] = posixpath.join(self.builder.imgpath, - self.builder.images[olduri]) - - if node.has_key('scale'): - if Image and not (node.has_key('width') - and node.has_key('height')): - try: - im = Image.open(os.path.join(self.builder.srcdir, - olduri)) - except (IOError, # Source image can't be found or opened - UnicodeError): # PIL doesn't like Unicode paths. - print olduri - pass - else: - if not node.has_key('width'): - node['width'] = str(im.size[0]) - if not node.has_key('height'): - node['height'] = str(im.size[1]) - del im - BaseTranslator.visit_image(self, node) - - def visit_toctree(self, node): - # this only happens when formatting a toc from env.tocs -- in this - # case we don't want to include the subtree - raise nodes.SkipNode - - def visit_index(self, node): - raise nodes.SkipNode - - def visit_tabular_col_spec(self, node): - raise nodes.SkipNode - - def visit_glossary(self, node): - pass - def depart_glossary(self, node): - pass - - def visit_acks(self, node): - pass - def depart_acks(self, node): - pass - - def visit_module(self, node): - pass - def depart_module(self, node): - pass - - def bulk_text_processor(self, text): - return text - - # overwritten - def visit_Text(self, node): - text = node.astext() - encoded = self.encode(text) - if self.protect_literal_text: - # moved here from base class's visit_literal to support - # more formatting in literal nodes - for token in self.words_and_spaces.findall(encoded): - if token.strip(): - # protect literal text from line wrapping - self.body.append('%s' % token) - elif token in ' \n': - # allow breaks at whitespace - self.body.append(token) - else: - # protect runs of multiple spaces; the last one can wrap - self.body.append(' ' * (len(token)-1) + ' ') - else: - if self.in_mailto and self.settings.cloak_email_addresses: - encoded = self.cloak_email(encoded) - else: - encoded = self.bulk_text_processor(encoded) - self.body.append(encoded) - - # these are all for docutils 0.5 compatibility - - def visit_note(self, node): - self.visit_admonition(node, 'note') - def depart_note(self, node): - self.depart_admonition(node) - - def visit_warning(self, node): - self.visit_admonition(node, 'warning') - def depart_warning(self, node): - self.depart_admonition(node) - - def visit_attention(self, node): - self.visit_admonition(node, 'attention') - - def depart_attention(self, node): - self.depart_admonition() - - def visit_caution(self, node): - self.visit_admonition(node, 'caution') - def depart_caution(self, node): - self.depart_admonition() - - def visit_danger(self, node): - self.visit_admonition(node, 'danger') - def depart_danger(self, node): - self.depart_admonition() - - def visit_error(self, node): - self.visit_admonition(node, 'error') - def depart_error(self, node): - self.depart_admonition() - - def visit_hint(self, node): - self.visit_admonition(node, 'hint') - def depart_hint(self, node): - self.depart_admonition() - - def visit_important(self, node): - self.visit_admonition(node, 'important') - def depart_important(self, node): - self.depart_admonition() - - def visit_tip(self, node): - self.visit_admonition(node, 'tip') - def depart_tip(self, node): - self.depart_admonition() - - # these are only handled specially in the SmartyPantsHTMLTranslator - def visit_literal_emphasis(self, node): - return self.visit_emphasis(node) - def depart_literal_emphasis(self, node): - return self.depart_emphasis(node) - - def depart_title(self, node): - close_tag = self.context[-1] - if self.builder.add_header_links and \ - (close_tag.startswith('\u00B6' % - _('Permalink to this headline')) - BaseTranslator.depart_title(self, node) - - def unknown_visit(self, node): - raise NotImplementedError('Unknown node: ' + node.__class__.__name__) - - -class SmartyPantsHTMLTranslator(HTMLTranslator): - """ - Handle ordinary text via smartypants, converting quotes and dashes - to the correct entities. - """ - - def __init__(self, *args, **kwds): - self.no_smarty = 0 - HTMLTranslator.__init__(self, *args, **kwds) - - def visit_literal(self, node): - self.no_smarty += 1 - try: - # this raises SkipNode - HTMLTranslator.visit_literal(self, node) - finally: - self.no_smarty -= 1 - - def visit_literal_emphasis(self, node): - self.no_smarty += 1 - self.visit_emphasis(node) - - def depart_literal_emphasis(self, node): - self.depart_emphasis(node) - self.no_smarty -= 1 - - def visit_desc_signature(self, node): - self.no_smarty += 1 - HTMLTranslator.visit_desc_signature(self, node) - - def depart_desc_signature(self, node): - self.no_smarty -= 1 - HTMLTranslator.depart_desc_signature(self, node) - - def visit_productionlist(self, node): - self.no_smarty += 1 - try: - HTMLTranslator.visit_productionlist(self, node) - finally: - self.no_smarty -= 1 - - def visit_option(self, node): - self.no_smarty += 1 - HTMLTranslator.visit_option(self, node) - def depart_option(self, node): - self.no_smarty -= 1 - HTMLTranslator.depart_option(self, node) - - def bulk_text_processor(self, text): - if self.no_smarty <= 0: - return sphinx_smarty_pants(text) - return text diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/latexwriter.py --- a/buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/latexwriter.py Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,1192 +0,0 @@ -# -*- coding: utf-8 -*- -""" - sphinx.latexwriter - ~~~~~~~~~~~~~~~~~~ - - Custom docutils writer for LaTeX. - - Much of this code is adapted from Dave Kuhlman's "docpy" writer from his - docutils sandbox. - - :copyright: 2007-2008 by Georg Brandl, Dave Kuhlman. - :license: BSD. -""" - -import re -import sys -from os import path - -from docutils import nodes, writers -from docutils.writers.latex2e import Babel - -from sphinx import addnodes -from sphinx import highlighting -from sphinx.locale import admonitionlabels, versionlabels -from sphinx.util import ustrftime -from sphinx.util.texescape import tex_escape_map -from sphinx.util.smartypants import educateQuotesLatex - -HEADER = r'''%% Generated by Sphinx. -\documentclass[%(papersize)s,%(pointsize)s%(classoptions)s]{%(docclass)s} -%(inputenc)s -%(fontenc)s -%(babel)s -%(fontpkg)s -%(fncychap)s -\usepackage{sphinx} -%(preamble)s - -\title{%(title)s} -\date{%(date)s} -\release{%(release)s} -\author{%(author)s} -\newcommand{\sphinxlogo}{%(logo)s} -\renewcommand{\releasename}{%(releasename)s} -%(makeindex)s -%(makemodindex)s -''' - -BEGIN_DOC = r''' -\begin{document} -%(shorthandoff)s -%(maketitle)s -%(tableofcontents)s -''' - -FOOTER = r''' -%(footer)s -\renewcommand{\indexname}{%(modindexname)s} -%(printmodindex)s -\renewcommand{\indexname}{%(indexname)s} -%(printindex)s -\end{document} -''' - - -class LaTeXWriter(writers.Writer): - - supported = ('sphinxlatex',) - - settings_spec = ('LaTeX writer options', '', ( - ('Document name', ['--docname'], {'default': ''}), - ('Document class', ['--docclass'], {'default': 'manual'}), - ('Author', ['--author'], {'default': ''}), - )) - settings_defaults = {} - - output = None - - def __init__(self, builder): - writers.Writer.__init__(self) - self.builder = builder - - def translate(self): - visitor = LaTeXTranslator(self.document, self.builder) - self.document.walkabout(visitor) - self.output = visitor.astext() - - -# Helper classes - -class ExtBabel(Babel): - def get_shorthandoff(self): - shortlang = self.language.split('_')[0] - if shortlang in ('de', 'sl', 'pt', 'es', 'nl', 'pl'): - return '\\shorthandoff{"}' - return '' - - _ISO639_TO_BABEL = Babel._ISO639_TO_BABEL.copy() - _ISO639_TO_BABEL['sl'] = 'slovene' - - -class Table(object): - def __init__(self): - self.col = 0 - self.colcount = 0 - self.colspec = None - self.had_head = False - self.has_verbatim = False - self.caption = None - - -class Desc(object): - def __init__(self, node): - self.env = LaTeXTranslator.desc_map.get(node['desctype'], 'describe') - self.type = self.cls = self.name = self.params = self.annotation = '' - self.count = 0 - - -class LaTeXTranslator(nodes.NodeVisitor): - sectionnames = ["part", "chapter", "section", "subsection", - "subsubsection", "paragraph", "subparagraph"] - - ignore_missing_images = False - - default_elements = { - 'docclass': 'manual', - 'papersize': 'letterpaper', - 'pointsize': '10pt', - 'classoptions': '', - 'inputenc': '\\usepackage[utf8]{inputenc}', - 'fontenc': '\\usepackage[T1]{fontenc}', - 'babel': '\\usepackage{babel}', - 'fontpkg': '\\usepackage{times}', - 'fncychap': '\\usepackage[Bjarne]{fncychap}', - 'preamble': '', - 'title': '', - 'date': '', - 'release': '', - 'author': '', - 'logo': '', - 'releasename': 'Release', - 'makeindex': '\\makeindex', - 'makemodindex': '\\makemodindex', - 'shorthandoff': '', - 'maketitle': '\\maketitle', - 'tableofcontents': '\\tableofcontents', - 'footer': '', - 'printmodindex': '\\printmodindex', - 'printindex': '\\printindex', - } - - def __init__(self, document, builder): - nodes.NodeVisitor.__init__(self, document) - self.builder = builder - self.body = [] - - # sort out some elements - papersize = builder.config.latex_paper_size + 'paper' - if papersize == 'paper': # e.g. command line "-D latex_paper_size=" - papersize = 'letterpaper' - - self.elements = self.default_elements.copy() - self.elements.update({ - 'docclass': document.settings.docclass, - 'papersize': papersize, - 'pointsize': builder.config.latex_font_size, - # if empty, the title is set to the first section title - 'title': document.settings.title, - 'date': ustrftime(builder.config.today_fmt or _('%B %d, %Y')), - 'release': builder.config.release, - 'author': document.settings.author, - 'releasename': _('Release'), - 'preamble': builder.config.latex_preamble, - 'modindexname': _('Module Index'), - 'indexname': _('Index'), - }) - if builder.config.latex_logo: - self.elements['logo'] = '\\includegraphics{%s}\\par' % \ - path.basename(builder.config.latex_logo) - if builder.config.language: - babel = ExtBabel(builder.config.language) - lang = babel.get_language() - if lang: - self.elements['classoptions'] += ',' + babel.get_language() - else: - self.builder.warn('no Babel option known for language %r' % - builder.config.language) - self.elements['shorthandoff'] = babel.get_shorthandoff() - self.elements['fncychap'] = '\\usepackage[Sonny]{fncychap}' - else: - self.elements['classoptions'] += ',english' - if not builder.config.latex_use_modindex: - self.elements['makemodindex'] = '' - self.elements['printmodindex'] = '' - # allow the user to override them all - self.elements.update(builder.config.latex_elements) - - self.highlighter = highlighting.PygmentsBridge( - 'latex', builder.config.pygments_style) - self.context = [] - self.descstack = [] - self.bibitems = [] - self.table = None - self.next_table_colspec = None - self.highlightlang = builder.config.highlight_language - self.highlightlinenothreshold = sys.maxint - self.written_ids = set() - self.footnotestack = [] - if self.elements['docclass'] == 'manual': - if builder.config.latex_use_parts: - self.top_sectionlevel = 0 - else: - self.top_sectionlevel = 1 - else: - self.top_sectionlevel = 2 - self.next_section_target = None - # flags - self.verbatim = None - self.in_title = 0 - self.in_production_list = 0 - self.first_document = 1 - self.this_is_the_title = 1 - self.literal_whitespace = 0 - self.no_contractions = 0 - - def astext(self): - return (HEADER % self.elements + self.highlighter.get_stylesheet() + - u''.join(self.body) + FOOTER % self.elements) - - def visit_document(self, node): - self.footnotestack.append(self.collect_footnotes(node)) - if self.first_document == 1: - # the first document is all the regular content ... - self.body.append(BEGIN_DOC % self.elements) - self.first_document = 0 - elif self.first_document == 0: - # ... and all others are the appendices - self.body.append('\n\\appendix\n') - self.first_document = -1 - # "- 1" because the level is increased before the title is visited - self.sectionlevel = self.top_sectionlevel - 1 - def depart_document(self, node): - if self.bibitems: - widest_label = "" - for bi in self.bibitems: - if len(widest_label) < len(bi[0]): - widest_label = bi[0] - self.body.append('\n\\begin{thebibliography}{%s}\n' % widest_label) - for bi in self.bibitems: - # cite_key: underscores must not be escaped - cite_key = bi[0].replace(r"\_", "_") - self.body.append('\\bibitem[%s]{%s}{%s}\n' % (bi[0], cite_key, bi[1])) - self.body.append('\\end{thebibliography}\n') - self.bibitems = [] - - def visit_start_of_file(self, node): - # This marks the begin of a new file; therefore the current module and - # class must be reset - self.body.append('\n\\resetcurrentobjects\n') - # and also, new footnotes - self.footnotestack.append(self.collect_footnotes(node)) - - def collect_footnotes(self, node): - fnotes = {} - def footnotes_under(n): - if isinstance(n, nodes.footnote): - yield n - else: - for c in n.children: - if isinstance(c, addnodes.start_of_file): - continue - for k in footnotes_under(c): - yield k - for fn in footnotes_under(node): - num = fn.children[0].astext().strip() - fnotes[num] = fn - fn.parent.remove(fn) - return fnotes - - def depart_start_of_file(self, node): - self.footnotestack.pop() - - def visit_highlightlang(self, node): - self.highlightlang = node['lang'] - self.highlightlinenothreshold = node['linenothreshold'] - raise nodes.SkipNode - - def visit_section(self, node): - if not self.this_is_the_title: - self.sectionlevel += 1 - self.body.append('\n\n') - if self.next_section_target: - self.body.append(r'\hypertarget{%s}{}' % self.next_section_target) - self.next_section_target = None - #if node.get('ids'): - # for id in node['ids']: - # if id not in self.written_ids: - # self.body.append(r'\hypertarget{%s}{}' % id) - # self.written_ids.add(id) - def depart_section(self, node): - self.sectionlevel = max(self.sectionlevel - 1, self.top_sectionlevel - 1) - - def visit_problematic(self, node): - self.body.append(r'{\color{red}\bfseries{}') - def depart_problematic(self, node): - self.body.append('}') - - def visit_topic(self, node): - self.body.append('\\setbox0\\vbox{\n' - '\\begin{minipage}{0.95\\textwidth}\n') - def depart_topic(self, node): - self.body.append('\\end{minipage}}\n' - '\\begin{center}\\setlength{\\fboxsep}{5pt}' - '\\shadowbox{\\box0}\\end{center}\n') - visit_sidebar = visit_topic - depart_sidebar = depart_topic - - def visit_glossary(self, node): - pass - def depart_glossary(self, node): - pass - - def visit_productionlist(self, node): - self.body.append('\n\n\\begin{productionlist}\n') - self.in_production_list = 1 - def depart_productionlist(self, node): - self.body.append('\\end{productionlist}\n\n') - self.in_production_list = 0 - - def visit_production(self, node): - if node['tokenname']: - self.body.append('\\production{%s}{' % self.encode(node['tokenname'])) - else: - self.body.append('\\productioncont{') - def depart_production(self, node): - self.body.append('}\n') - - def visit_transition(self, node): - self.body.append('\n\n\\bigskip\\hrule{}\\bigskip\n\n') - def depart_transition(self, node): - pass - - def visit_title(self, node): - parent = node.parent - if isinstance(parent, addnodes.seealso): - # the environment already handles this - raise nodes.SkipNode - elif self.this_is_the_title: - if len(node.children) != 1 and not isinstance(node.children[0], nodes.Text): - self.builder.warn('document title is not a single Text node') - if not self.elements['title']: - # text needs to be escaped since it is inserted into - # the output literally - self.elements['title'] = node.astext().translate(tex_escape_map) - self.this_is_the_title = 0 - raise nodes.SkipNode - elif isinstance(parent, nodes.section): - try: - self.body.append(r'\%s{' % self.sectionnames[self.sectionlevel]) - except IndexError: - from sphinx.application import SphinxError - raise SphinxError('too many nesting section levels for LaTeX, ' - 'at heading: %s' % node.astext()) - self.context.append('}\n') - elif isinstance(parent, (nodes.topic, nodes.sidebar)): - self.body.append(r'\textbf{') - self.context.append('}\n\n\medskip\n\n') - elif isinstance(parent, nodes.Admonition): - self.body.append('{') - self.context.append('}\n') - elif isinstance(parent, nodes.table): - self.table.caption = self.encode(node.astext()) - raise nodes.SkipNode - else: - self.builder.warn('encountered title node not in section, topic, ' - 'table, admonition or sidebar') - self.body.append('\\textbf{') - self.context.append('}\n') - self.in_title = 1 - def depart_title(self, node): - self.in_title = 0 - self.body.append(self.context.pop()) - - def visit_subtitle(self, node): - if isinstance(node.parent, nodes.sidebar): - self.body.append('~\\\\\n\\textbf{') - self.context.append('}\n\\smallskip\n') - else: - self.context.append('') - def depart_subtitle(self, node): - self.body.append(self.context.pop()) - - desc_map = { - 'function' : 'funcdesc', - 'class': 'classdesc', - 'method': 'methoddesc', - 'staticmethod': 'staticmethoddesc', - 'exception': 'excdesc', - 'data': 'datadesc', - 'attribute': 'memberdesc', - 'opcode': 'opcodedesc', - - 'cfunction': 'cfuncdesc', - 'cmember': 'cmemberdesc', - 'cmacro': 'csimplemacrodesc', - 'ctype': 'ctypedesc', - 'cvar': 'cvardesc', - - 'describe': 'describe', - # and all others are 'describe' too - } - - def visit_desc(self, node): - self.descstack.append(Desc(node)) - def depart_desc(self, node): - d = self.descstack.pop() - self.body.append("\\end{%s}\n" % d.env) - - def visit_desc_signature(self, node): - d = self.descstack[-1] - # reset these for every signature - d.type = d.cls = d.name = d.params = '' - def depart_desc_signature(self, node): - d = self.descstack[-1] - d.cls = d.cls.rstrip('.') - if node.parent['desctype'] != 'describe' and node['ids']: - hyper = '\\hypertarget{%s}{}' % node['ids'][0] - else: - hyper = '' - if d.count == 0: - t1 = "\n\n%s\\begin{%s}" % (hyper, d.env) - else: - t1 = "\n%s\\%sline" % (hyper, d.env[:-4]) - d.count += 1 - if d.env in ('funcdesc', 'classdesc', 'excclassdesc'): - t2 = "{%s}{%s}" % (d.name, d.params) - elif d.env in ('datadesc', 'excdesc', 'csimplemacrodesc'): - t2 = "{%s}" % (d.name) - elif d.env in ('methoddesc', 'staticmethoddesc'): - if d.cls: - t2 = "[%s]{%s}{%s}" % (d.cls, d.name, d.params) - else: - t2 = "{%s}{%s}" % (d.name, d.params) - elif d.env == 'memberdesc': - if d.cls: - t2 = "[%s]{%s}" % (d.cls, d.name) - else: - t2 = "{%s}" % d.name - elif d.env == 'cfuncdesc': - if d.cls: - # C++ class names - d.name = '%s::%s' % (d.cls, d.name) - t2 = "{%s}{%s}{%s}" % (d.type, d.name, d.params) - elif d.env == 'cmemberdesc': - try: - type, container = d.type.rsplit(' ', 1) - container = container.rstrip('.') - except ValueError: - container = '' - type = d.type - t2 = "{%s}{%s}{%s}" % (container, type, d.name) - elif d.env == 'cvardesc': - t2 = "{%s}{%s}" % (d.type, d.name) - elif d.env == 'ctypedesc': - t2 = "{%s}" % (d.name) - elif d.env == 'opcodedesc': - t2 = "{%s}{%s}" % (d.name, d.params) - elif d.env == 'describe': - t2 = "{%s}" % d.name - self.body.append(t1 + t2) - - def visit_desc_type(self, node): - d = self.descstack[-1] - if d.env == 'describe': - d.name += self.encode(node.astext()) - else: - self.descstack[-1].type = self.encode(node.astext().strip()) - raise nodes.SkipNode - - def visit_desc_name(self, node): - d = self.descstack[-1] - if d.env == 'describe': - d.name += self.encode(node.astext()) - else: - self.descstack[-1].name = self.encode(node.astext().strip()) - raise nodes.SkipNode - - def visit_desc_addname(self, node): - d = self.descstack[-1] - if d.env == 'describe': - d.name += self.encode(node.astext()) - else: - self.descstack[-1].cls = self.encode(node.astext().strip()) - raise nodes.SkipNode - - def visit_desc_parameterlist(self, node): - d = self.descstack[-1] - if d.env == 'describe': - d.name += self.encode(node.astext()) - else: - self.descstack[-1].params = self.encode(node.astext().strip()) - raise nodes.SkipNode - - def visit_desc_annotation(self, node): - d = self.descstack[-1] - if d.env == 'describe': - d.name += self.encode(node.astext()) - else: - self.descstack[-1].annotation = self.encode(node.astext().strip()) - raise nodes.SkipNode - - def visit_refcount(self, node): - self.body.append("\\emph{") - def depart_refcount(self, node): - self.body.append("}\\\\") - - def visit_desc_content(self, node): - if node.children and not isinstance(node.children[0], nodes.paragraph): - # avoid empty desc environment which causes a formatting bug - self.body.append('~') - def depart_desc_content(self, node): - pass - - def visit_seealso(self, node): - self.body.append("\n\n\\strong{%s:}\n\n" % admonitionlabels['seealso']) - def depart_seealso(self, node): - self.body.append("\n\n") - - def visit_rubric(self, node): - if len(node.children) == 1 and node.children[0].astext() == 'Footnotes': - raise nodes.SkipNode - self.body.append('\\paragraph{') - self.context.append('}\n') - def depart_rubric(self, node): - self.body.append(self.context.pop()) - - def visit_footnote(self, node): - pass - def depart_footnote(self, node): - pass - - def visit_label(self, node): - if isinstance(node.parent, nodes.citation): - self.bibitems[-1][0] = node.astext() - raise nodes.SkipNode - - def visit_tabular_col_spec(self, node): - self.next_table_colspec = node['spec'] - raise nodes.SkipNode - - def visit_table(self, node): - if self.table: - raise NotImplementedError('Nested tables are not supported.') - self.table = Table() - self.tablebody = [] - # Redirect body output until table is finished. - self._body = self.body - self.body = self.tablebody - def depart_table(self, node): - self.body = self._body - if self.table.caption is not None: - self.body.append('\n\\begin{threeparttable}\n' - '\\caption{%s}\n' % self.table.caption) - if self.table.has_verbatim: - self.body.append('\n\\begin{tabular}') - else: - self.body.append('\n\\begin{tabulary}{\\textwidth}') - if self.table.colspec: - self.body.append(self.table.colspec) - else: - if self.table.has_verbatim: - colwidth = 0.95 / self.table.colcount - colspec = ('p{%.3f\\textwidth}|' % colwidth) * self.table.colcount - self.body.append('{|' + colspec + '}\n') - else: - self.body.append('{|' + ('L|' * self.table.colcount) + '}\n') - self.body.extend(self.tablebody) - if self.table.has_verbatim: - self.body.append('\\end{tabular}\n\n') - else: - self.body.append('\\end{tabulary}\n\n') - if self.table.caption is not None: - self.body.append('\\end{threeparttable}\n\n') - self.table = None - self.tablebody = None - - def visit_colspec(self, node): - self.table.colcount += 1 - def depart_colspec(self, node): - pass - - def visit_tgroup(self, node): - pass - def depart_tgroup(self, node): - pass - - def visit_thead(self, node): - if self.next_table_colspec: - self.table.colspec = '{%s}\n' % self.next_table_colspec - self.next_table_colspec = None - self.body.append('\\hline\n') - self.table.had_head = True - def depart_thead(self, node): - self.body.append('\\hline\n') - - def visit_tbody(self, node): - if not self.table.had_head: - self.visit_thead(node) - def depart_tbody(self, node): - self.body.append('\\hline\n') - - def visit_row(self, node): - self.table.col = 0 - def depart_row(self, node): - self.body.append('\\\\\n') - - def visit_entry(self, node): - if node.has_key('morerows') or node.has_key('morecols'): - raise NotImplementedError('Column or row spanning cells are ' - 'not implemented.') - if self.table.col > 0: - self.body.append(' & ') - self.table.col += 1 - if isinstance(node.parent.parent, nodes.thead): - self.body.append('\\textbf{') - self.context.append('}') - else: - self.context.append('') - def depart_entry(self, node): - self.body.append(self.context.pop()) # header - - def visit_acks(self, node): - # this is a list in the source, but should be rendered as a - # comma-separated list here - self.body.append('\n\n') - self.body.append(', '.join(n.astext() for n in node.children[0].children) + '.') - self.body.append('\n\n') - raise nodes.SkipNode - - def visit_bullet_list(self, node): - self.body.append('\\begin{itemize}\n' ) - def depart_bullet_list(self, node): - self.body.append('\\end{itemize}\n' ) - - def visit_enumerated_list(self, node): - self.body.append('\\begin{enumerate}\n' ) - def depart_enumerated_list(self, node): - self.body.append('\\end{enumerate}\n' ) - - def visit_list_item(self, node): - # Append "{}" in case the next character is "[", which would break - # LaTeX's list environment (no numbering and the "[" is not printed). - self.body.append(r'\item {} ') - def depart_list_item(self, node): - self.body.append('\n') - - def visit_definition_list(self, node): - self.body.append('\\begin{description}\n') - def depart_definition_list(self, node): - self.body.append('\\end{description}\n') - - def visit_definition_list_item(self, node): - pass - def depart_definition_list_item(self, node): - pass - - def visit_term(self, node): - ctx = ']' - if node.has_key('ids') and node['ids']: - ctx += '\\hypertarget{%s}{}' % node['ids'][0] - self.body.append('\\item[') - self.context.append(ctx) - def depart_term(self, node): - self.body.append(self.context.pop()) - - def visit_classifier(self, node): - self.body.append('{[}') - def depart_classifier(self, node): - self.body.append('{]}') - - def visit_definition(self, node): - pass - def depart_definition(self, node): - self.body.append('\n') - - def visit_field_list(self, node): - self.body.append('\\begin{quote}\\begin{description}\n') - def depart_field_list(self, node): - self.body.append('\\end{description}\\end{quote}\n') - - def visit_field(self, node): - pass - def depart_field(self, node): - pass - - visit_field_name = visit_term - depart_field_name = depart_term - - visit_field_body = visit_definition - depart_field_body = depart_definition - - def visit_paragraph(self, node): - self.body.append('\n') - def depart_paragraph(self, node): - self.body.append('\n') - - def visit_centered(self, node): - self.body.append('\n\\begin{centering}') - def depart_centered(self, node): - self.body.append('\n\\end{centering}') - - def visit_module(self, node): - modname = node['modname'] - self.body.append('\n\\declaremodule[%s]{}{%s}' % (modname.replace('_', ''), - self.encode(modname))) - self.body.append('\n\\modulesynopsis{%s}' % self.encode(node['synopsis'])) - if node.has_key('platform'): - self.body.append('\\platform{%s}' % self.encode(node['platform'])) - def depart_module(self, node): - pass - - def latex_image_length(self, width_str): - match = re.match('(\d*\.?\d*)\s*(\S*)', width_str) - if not match: - # fallback - return width_str - res = width_str - amount, unit = match.groups()[:2] - if not unit or unit == "px": - # pixels: let LaTeX alone - return None - elif unit == "%": - res = "%.3f\\linewidth" % (float(amount) / 100.0) - return res - - def visit_image(self, node): - attrs = node.attributes - pre = [] # in reverse order - post = [] - include_graphics_options = [] - inline = isinstance(node.parent, nodes.TextElement) - if attrs.has_key('scale'): - # Could also be done with ``scale`` option to - # ``\includegraphics``; doing it this way for consistency. - pre.append('\\scalebox{%f}{' % (attrs['scale'] / 100.0,)) - post.append('}') - if attrs.has_key('width'): - w = self.latex_image_length(attrs['width']) - if w: - include_graphics_options.append('width=%s' % w) - if attrs.has_key('height'): - h = self.latex_image_length(attrs['height']) - if h: - include_graphics_options.append('height=%s' % h) - if attrs.has_key('align'): - align_prepost = { - # By default latex aligns the top of an image. - (1, 'top'): ('', ''), - (1, 'middle'): ('\\raisebox{-0.5\\height}{', '}'), - (1, 'bottom'): ('\\raisebox{-\\height}{', '}'), - (0, 'center'): ('{\\hfill', '\\hfill}'), - # These 2 don't exactly do the right thing. The image should - # be floated alongside the paragraph. See - # http://www.w3.org/TR/html4/struct/objects.html#adef-align-IMG - (0, 'left'): ('{', '\\hfill}'), - (0, 'right'): ('{\\hfill', '}'),} - try: - pre.append(align_prepost[inline, attrs['align']][0]) - post.append(align_prepost[inline, attrs['align']][1]) - except KeyError: - pass # XXX complain here? - if not inline: - pre.append('\n') - post.append('\n') - pre.reverse() - if node['uri'] in self.builder.images: - uri = self.builder.images[node['uri']] - else: - # missing image! - if self.ignore_missing_images: - return - uri = node['uri'] - if uri.find('://') != -1: - # ignore remote images - return - self.body.extend(pre) - options = '' - if include_graphics_options: - options = '[%s]' % ','.join(include_graphics_options) - self.body.append('\\includegraphics%s{%s}' % (options, uri)) - self.body.extend(post) - def depart_image(self, node): - pass - - def visit_figure(self, node): - if (not node.attributes.has_key('align') or - node.attributes['align'] == 'center'): - # centering does not add vertical space like center. - align = '\n\\centering' - align_end = '' - else: - # TODO non vertical space for other alignments. - align = '\\begin{flush%s}' % node.attributes['align'] - align_end = '\\end{flush%s}' % node.attributes['align'] - self.body.append('\\begin{figure}[htbp]%s\n' % align) - self.context.append('%s\\end{figure}\n' % align_end) - def depart_figure(self, node): - self.body.append(self.context.pop()) - - def visit_caption(self, node): - self.body.append('\\caption{') - def depart_caption(self, node): - self.body.append('}') - - def visit_legend(self, node): - self.body.append('{\\small ') - def depart_legend(self, node): - self.body.append('}') - - def visit_admonition(self, node): - self.body.append('\n\\begin{notice}{note}') - def depart_admonition(self, node): - self.body.append('\\end{notice}\n') - - def _make_visit_admonition(name): - def visit_admonition(self, node): - self.body.append('\n\\begin{notice}{%s}{%s:}' % - (name, admonitionlabels[name])) - return visit_admonition - def _depart_named_admonition(self, node): - self.body.append('\\end{notice}\n') - - visit_attention = _make_visit_admonition('attention') - depart_attention = _depart_named_admonition - visit_caution = _make_visit_admonition('caution') - depart_caution = _depart_named_admonition - visit_danger = _make_visit_admonition('danger') - depart_danger = _depart_named_admonition - visit_error = _make_visit_admonition('error') - depart_error = _depart_named_admonition - visit_hint = _make_visit_admonition('hint') - depart_hint = _depart_named_admonition - visit_important = _make_visit_admonition('important') - depart_important = _depart_named_admonition - visit_note = _make_visit_admonition('note') - depart_note = _depart_named_admonition - visit_tip = _make_visit_admonition('tip') - depart_tip = _depart_named_admonition - visit_warning = _make_visit_admonition('warning') - depart_warning = _depart_named_admonition - - def visit_versionmodified(self, node): - intro = versionlabels[node['type']] % node['version'] - if node.children: - intro += ': ' - else: - intro += '.' - self.body.append(intro) - def depart_versionmodified(self, node): - pass - - def visit_target(self, node): - def add_target(id): - # indexing uses standard LaTeX index markup, so the targets - # will be generated differently - if not id.startswith('index-'): - self.body.append(r'\hypertarget{%s}{}' % id) - - if node.has_key('refid') and node['refid'] not in self.written_ids: - parindex = node.parent.index(node) - try: - next = node.parent[parindex+1] - if isinstance(next, nodes.section): - self.next_section_target = node['refid'] - return - except IndexError: - pass - add_target(node['refid']) - self.written_ids.add(node['refid']) - def depart_target(self, node): - pass - - def visit_attribution(self, node): - self.body.append('\n\\begin{flushright}\n') - self.body.append('---') - def depart_attribution(self, node): - self.body.append('\n\\end{flushright}\n') - - def visit_index(self, node, scre=re.compile(r';\s*')): - entries = node['entries'] - for type, string, tid, _ in entries: - if type == 'single': - self.body.append(r'\index{%s}' % scre.sub('!', self.encode(string))) - elif type == 'pair': - parts = tuple(self.encode(x.strip()) for x in string.split(';', 1)) - try: - self.body.append(r'\indexii{%s}{%s}' % parts) - except TypeError: - self.builder.warn('invalid pair index entry %r' % string) - elif type == 'triple': - parts = tuple(self.encode(x.strip()) for x in string.split(';', 2)) - try: - self.body.append(r'\indexiii{%s}{%s}{%s}' % parts) - except TypeError: - self.builder.warn('invalid triple index entry %r' % string) - else: - self.builder.warn('unknown index entry type %s found' % type) - raise nodes.SkipNode - - def visit_raw(self, node): - if 'latex' in node.get('format', '').split(): - self.body.append(node.astext()) - raise nodes.SkipNode - - def visit_reference(self, node): - uri = node.get('refuri', '') - if self.in_title or not uri: - self.context.append('') - elif uri.startswith('mailto:') or uri.startswith('http:') or \ - uri.startswith('https:') or uri.startswith('ftp:'): - self.body.append('\\href{%s}{' % self.encode(uri)) - self.context.append('}') - elif uri.startswith('#'): - self.body.append('\\hyperlink{%s}{' % uri[1:]) - self.context.append('}') - elif uri.startswith('@token'): - if self.in_production_list: - self.body.append('\\token{') - else: - self.body.append('\\grammartoken{') - self.context.append('}') - else: - self.builder.warn('unusable reference target found: %s' % uri) - self.context.append('') - def depart_reference(self, node): - self.body.append(self.context.pop()) - - def visit_pending_xref(self, node): - pass - def depart_pending_xref(self, node): - pass - - def visit_emphasis(self, node): - self.body.append(r'\emph{') - def depart_emphasis(self, node): - self.body.append('}') - - def visit_literal_emphasis(self, node): - self.body.append(r'\emph{\texttt{') - self.no_contractions += 1 - def depart_literal_emphasis(self, node): - self.body.append('}}') - self.no_contractions -= 1 - - def visit_strong(self, node): - self.body.append(r'\textbf{') - def depart_strong(self, node): - self.body.append('}') - - def visit_title_reference(self, node): - self.body.append(r'\emph{') - def depart_title_reference(self, node): - self.body.append('}') - - def visit_citation(self, node): - # TODO maybe use cite bibitems - self.bibitems.append(['', '']) - self.context.append(len(self.body)) - def depart_citation(self, node): - size = self.context.pop() - text = ''.join(self.body[size:]) - del self.body[size:] - self.bibitems[-1][1] = text - - def visit_citation_reference(self, node): - citeid = node.astext() - self.body.append('\\cite{%s}' % citeid) - raise nodes.SkipNode - - def visit_literal(self, node): - content = self.encode(node.astext().strip()) - if self.in_title: - self.body.append(r'\texttt{%s}' % content) - elif node.has_key('role') and node['role'] == 'samp': - self.body.append(r'\samp{%s}' % content) - else: - self.body.append(r'\code{%s}' % content) - raise nodes.SkipNode - - def visit_footnote_reference(self, node): - num = node.astext().strip() - try: - fn = self.footnotestack[-1][num] - except (KeyError, IndexError): - raise nodes.SkipNode - self.body.append('\\footnote{') - fn.walkabout(self) - raise nodes.SkipChildren - def depart_footnote_reference(self, node): - self.body.append('}') - - def visit_literal_block(self, node): - self.verbatim = '' - def depart_literal_block(self, node): - code = self.verbatim.rstrip('\n') - lang = self.highlightlang - linenos = code.count('\n') >= self.highlightlinenothreshold - 1 - if node.has_key('language'): - # code-block directives - lang = node['language'] - if node.has_key('linenos'): - linenos = node['linenos'] - hlcode = self.highlighter.highlight_block(code, lang, linenos) - # workaround for Unicode issue - hlcode = hlcode.replace(u'€', u'@texteuro[]') - # must use original Verbatim environment and "tabular" environment - if self.table: - hlcode = hlcode.replace('\\begin{Verbatim}', - '\\begin{OriginalVerbatim}') - self.table.has_verbatim = True - # get consistent trailer - hlcode = hlcode.rstrip()[:-14] # strip \end{Verbatim} - hlcode = hlcode.rstrip() + '\n' - self.body.append('\n' + hlcode + '\\end{%sVerbatim}\n' % - (self.table and 'Original' or '')) - self.verbatim = None - visit_doctest_block = visit_literal_block - depart_doctest_block = depart_literal_block - - def visit_line_block(self, node): - """line-block: - * whitespace (including linebreaks) is significant - * inline markup is supported. - * serif typeface - """ - self.body.append('{\\raggedright{}') - self.literal_whitespace = 1 - def depart_line_block(self, node): - self.literal_whitespace = 0 - # remove the last \\ - del self.body[-1] - self.body.append('}\n') - - def visit_line(self, node): - self._line_start = len(self.body) - def depart_line(self, node): - if self._line_start == len(self.body): - # no output in this line -- add a nonbreaking space, else the - # \\ command will give an error - self.body.append('~') - if self.table is not None: - self.body.append('\\newline\n') - else: - self.body.append('\\\\\n') - - def visit_block_quote(self, node): - # If the block quote contains a single object and that object - # is a list, then generate a list not a block quote. - # This lets us indent lists. - done = 0 - if len(node.children) == 1: - child = node.children[0] - if isinstance(child, nodes.bullet_list) or \ - isinstance(child, nodes.enumerated_list): - done = 1 - if not done: - self.body.append('\\begin{quote}\n') - def depart_block_quote(self, node): - done = 0 - if len(node.children) == 1: - child = node.children[0] - if isinstance(child, nodes.bullet_list) or \ - isinstance(child, nodes.enumerated_list): - done = 1 - if not done: - self.body.append('\\end{quote}\n') - - # option node handling copied from docutils' latex writer - - def visit_option(self, node): - if self.context[-1]: - # this is not the first option - self.body.append(', ') - def depart_option(self, node): - # flag that the first option is done. - self.context[-1] += 1 - - def visit_option_argument(self, node): - """The delimiter betweeen an option and its argument.""" - self.body.append(node.get('delimiter', ' ')) - def depart_option_argument(self, node): - pass - - def visit_option_group(self, node): - self.body.append('\\item [') - # flag for first option - self.context.append(0) - def depart_option_group(self, node): - self.context.pop() # the flag - self.body.append('] ') - - def visit_option_list(self, node): - self.body.append('\\begin{optionlist}{3cm}\n') - def depart_option_list(self, node): - self.body.append('\\end{optionlist}\n') - - def visit_option_list_item(self, node): - pass - def depart_option_list_item(self, node): - pass - - def visit_option_string(self, node): - ostring = node.astext() - self.body.append(self.encode(ostring.replace('--', u'-{-}'))) - raise nodes.SkipNode - - def visit_description(self, node): - self.body.append( ' ' ) - def depart_description(self, node): - pass - - def visit_superscript(self, node): - self.body.append('$^{\\text{') - def depart_superscript(self, node): - self.body.append('}}$') - - def visit_subscript(self, node): - self.body.append('$_{\\text{') - def depart_subscript(self, node): - self.body.append('}}$') - - def visit_substitution_definition(self, node): - raise nodes.SkipNode - - def visit_substitution_reference(self, node): - raise nodes.SkipNode - - def visit_generated(self, node): - pass - def depart_generated(self, node): - pass - - def visit_compound(self, node): - pass - def depart_compound(self, node): - pass - - def visit_container(self, node): - pass - def depart_container(self, node): - pass - - def visit_decoration(self, node): - pass - def depart_decoration(self, node): - pass - - # text handling - - def encode(self, text): - text = unicode(text).translate(tex_escape_map) - if self.literal_whitespace: - # Insert a blank before the newline, to avoid - # ! LaTeX Error: There's no line here to end. - text = text.replace(u'\n', u'~\\\\\n').replace(u' ', u'~') - if self.no_contractions: - text = text.replace('--', u'-{-}') - return text - - def visit_Text(self, node): - if self.verbatim is not None: - self.verbatim += node.astext() - else: - text = self.encode(node.astext()) - self.body.append(educateQuotesLatex(text)) - def depart_Text(self, node): - pass - - def visit_comment(self, node): - raise nodes.SkipNode - - def visit_meta(self, node): - # only valid for HTML - raise nodes.SkipNode - - def visit_system_message(self, node): - pass - def depart_system_message(self, node): - self.body.append('\n') - - def unknown_visit(self, node): - raise NotImplementedError('Unknown node: ' + node.__class__.__name__) diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/linkcheck.py --- a/buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/linkcheck.py Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,130 +0,0 @@ -# -*- coding: utf-8 -*- -""" - sphinx.linkcheck - ~~~~~~~~~~~~~~~~ - - The CheckExternalLinksBuilder class. - - :copyright: 2008 by Georg Brandl, Thomas Lamb. - :license: BSD. -""" - -import socket -from os import path -from urllib2 import build_opener, HTTPError - -from docutils import nodes - -from sphinx.builder import Builder -from sphinx.util.console import purple, red, darkgreen - -# create an opener that will simulate a browser user-agent -opener = build_opener() -opener.addheaders = [('User-agent', 'Mozilla/5.0')] - - -class CheckExternalLinksBuilder(Builder): - """ - Checks for broken external links. - """ - name = 'linkcheck' - - def init(self): - self.good = set() - self.broken = {} - self.redirected = {} - # set a timeout for non-responding servers - socket.setdefaulttimeout(5.0) - # create output file - open(path.join(self.outdir, 'output.txt'), 'w').close() - - def get_target_uri(self, docname, typ=None): - return '' - - def get_outdated_docs(self): - return self.env.found_docs - - def prepare_writing(self, docnames): - return - - def write_doc(self, docname, doctree): - self.info() - for node in doctree.traverse(nodes.reference): - try: - self.check(node, docname) - except KeyError: - continue - - def check(self, node, docname): - uri = node['refuri'] - - if '#' in uri: - uri = uri.split('#')[0] - - if uri in self.good: - return - - lineno = None - while lineno is None and node: - node = node.parent - lineno = node.line - - if uri[0:5] == 'http:' or uri[0:6] == 'https:': - self.info(uri, nonl=1) - - if uri in self.broken: - (r, s) = self.broken[uri] - elif uri in self.redirected: - (r, s) = self.redirected[uri] - else: - (r, s) = self.resolve(uri) - - if r == 0: - self.info(' - ' + darkgreen('working')) - self.good.add(uri) - elif r == 2: - self.info(' - ' + red('broken: ') + s) - self.write_entry('broken', docname, lineno, uri + ': ' + s) - self.broken[uri] = (r, s) - if self.app.quiet: - self.warn('%s:%s: broken link: %s' % (docname, lineno, uri)) - else: - self.info(' - ' + purple('redirected') + ' to ' + s) - self.write_entry('redirected', docname, lineno, uri + ' to ' + s) - self.redirected[uri] = (r, s) - elif len(uri) == 0 or uri[0:7] == 'mailto:' or uri[0:4] == 'ftp:': - return - else: - self.warn(uri + ' - ' + red('malformed!')) - self.write_entry('malformed', docname, lineno, uri) - if self.app.quiet: - self.warn('%s:%s: malformed link: %s' % (docname, lineno, uri)) - self.app.statuscode = 1 - - if self.broken: - self.app.statuscode = 1 - - def write_entry(self, what, docname, line, uri): - output = open(path.join(self.outdir, 'output.txt'), 'a') - output.write("%s:%s: [%s] %s\n" % (self.env.doc2path(docname, None), - line, what, uri)) - output.close() - - def resolve(self, uri): - try: - f = opener.open(uri) - f.close() - except HTTPError, err: - #if err.code == 403 and uri.startswith('http://en.wikipedia.org/'): - # # Wikipedia blocks requests from urllib User-Agent - # return (0, 0) - return (2, str(err)) - except Exception, err: - return (2, str(err)) - if f.url.rstrip('/') == uri.rstrip('/'): - return (0, 0) - else: - return (1, f.url) - - def finish(self): - return diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/locale/__init__.py --- a/buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/locale/__init__.py Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,48 +0,0 @@ -# -*- coding: utf-8 -*- -""" - sphinx.locale - ~~~~~~~~~~~~~ - - Locale utilities. - - :copyright: 2008 by Georg Brandl. - :license: BSD. -""" - -_ = lambda x: x - -admonitionlabels = { - 'attention': _('Attention'), - 'caution': _('Caution'), - 'danger': _('Danger'), - 'error': _('Error'), - 'hint': _('Hint'), - 'important': _('Important'), - 'note': _('Note'), - 'seealso': _('See Also'), - 'tip': _('Tip'), - 'warning': _('Warning'), -} - -versionlabels = { - 'versionadded': _('New in version %s'), - 'versionchanged': _('Changed in version %s'), - 'deprecated': _('Deprecated since version %s'), -} - -pairindextypes = { - 'module': _('module'), - 'keyword': _('keyword'), - 'operator': _('operator'), - 'object': _('object'), - 'exception': _('exception'), - 'statement': _('statement'), - 'builtin': _('built-in function'), -} - -del _ - -def init(): - for dct in (admonitionlabels, versionlabels, pairindextypes): - for key in dct: - dct[key] = _(dct[key]) diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/locale/cs/LC_MESSAGES/sphinx.js --- a/buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/locale/cs/LC_MESSAGES/sphinx.js Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,1 +0,0 @@ -Documentation.addTranslations({"locale": "cs", "plural_expr": "(n%10==1 && n%100!=11 ? 0 : n%10>=2 && n%10<=4 && (n%100<10 || n%100>=20) ? 1 : 2)", "messages": {"module, in ": "modul", "Preparing search...": "", "Your search did not match any documents. Please make sure that all words are spelled correctly and that you've selected enough categories.": "", "Search finished, found %s page(s) matching the search query.": "", ", in ": "", "Permalink to this headline": "Trval\u00fd odkaz na tento nadpis", "Searching": "hledej", "Permalink to this definition": "Trval\u00fd odkaz na tuto definici", "Hide Search Matches": "", "Search Results": "V\u00fdsledky hled\u00e1n\u00ed"}}); \ No newline at end of file diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/locale/cs/LC_MESSAGES/sphinx.mo Binary file buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/locale/cs/LC_MESSAGES/sphinx.mo has changed diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/locale/cs/LC_MESSAGES/sphinx.po --- a/buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/locale/cs/LC_MESSAGES/sphinx.po Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,604 +0,0 @@ -# Czech translations for Sphinx. -# Copyright (C) 2008 ORGANIZATION -# This file is distributed under the same license as the Sphinx project. -# FIRST AUTHOR , 2008. -# -msgid "" -msgstr "" -"Project-Id-Version: Sphinx 0.5\n" -"Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" -"POT-Creation-Date: 2008-08-10 11:43+0000\n" -"PO-Revision-Date: 2008-11-27 18:40+0100\n" -"Last-Translator: Pavel Kosina \n" -"Language-Team: Pavel Kosina \n" -"Plural-Forms: nplurals=3; plural=(n%10==1 && n%100!=11 ? 0 : n%10>=2 && " -"n%10<=4 && (n%100<10 || n%100>=20) ? 1 : 2)\n" -"MIME-Version: 1.0\n" -"Content-Type: text/plain; charset=utf-8\n" -"Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 0.9.4\n" - -#: sphinx/builder.py:408 -#, python-format -msgid "%b %d, %Y" -msgstr "%d.%m.%Y" - -#: sphinx/builder.py:427 sphinx/templates/defindex.html:21 -msgid "General Index" -msgstr "Rejstřík indexů" - -#: sphinx/builder.py:427 -msgid "index" -msgstr "index" - -#: sphinx/builder.py:429 sphinx/htmlhelp.py:156 -#: sphinx/templates/defindex.html:19 sphinx/templates/modindex.html:2 -#: sphinx/templates/modindex.html:13 -msgid "Global Module Index" -msgstr "Rejstřík modulů" - -#: sphinx/builder.py:429 -msgid "modules" -msgstr "moduly" - -#: sphinx/builder.py:466 -msgid "next" -msgstr "další" - -#: sphinx/builder.py:473 -msgid "previous" -msgstr "předchozí" - -#: sphinx/builder.py:1054 -msgid " (in " -msgstr "" - -#: sphinx/builder.py:1129 -msgid "Builtins" -msgstr "Vestavěné funkce" - -#: sphinx/builder.py:1131 -msgid "Module level" -msgstr "Úroveň modulů" - -#: sphinx/environment.py:102 sphinx/latexwriter.py:169 -#, python-format -msgid "%B %d, %Y" -msgstr "%d.%m.%Y" - -#: sphinx/environment.py:291 sphinx/latexwriter.py:175 -#: sphinx/templates/genindex-single.html:2 -#: sphinx/templates/genindex-split.html:2 -#: sphinx/templates/genindex-split.html:5 sphinx/templates/genindex.html:2 -#: sphinx/templates/genindex.html:5 sphinx/templates/genindex.html:48 -#: sphinx/templates/layout.html:130 -msgid "Index" -msgstr "Index" - -#: sphinx/environment.py:292 sphinx/latexwriter.py:174 -#, fuzzy -msgid "Module Index" -msgstr "Rejstřík modulů" - -#: sphinx/environment.py:293 sphinx/templates/defindex.html:16 -#, fuzzy -msgid "Search Page" -msgstr "Vyhledávací stránka" - -#: sphinx/htmlwriter.py:79 sphinx/static/doctools.js:145 -msgid "Permalink to this definition" -msgstr "Trvalý odkaz na tuto definici" - -#: sphinx/htmlwriter.py:399 sphinx/static/doctools.js:139 -msgid "Permalink to this headline" -msgstr "Trvalý odkaz na tento nadpis" - -#: sphinx/latexwriter.py:172 -msgid "Release" -msgstr "Vydání" - -#: sphinx/roles.py:53 sphinx/directives/desc.py:537 -#, python-format -msgid "environment variable; %s" -msgstr "promměná prostředí, %s" - -#: sphinx/roles.py:60 -#, python-format -msgid "Python Enhancement Proposals!PEP %s" -msgstr "Python Enhancement Proposals!PEP %s" - -#: sphinx/textwriter.py:166 -#, python-format -msgid "Platform: %s" -msgstr "Platforma: %s" - -#: sphinx/textwriter.py:422 -msgid "[image]" -msgstr "[obrázek]" - -#: sphinx/directives/desc.py:25 -#, python-format -msgid "%s() (built-in function)" -msgstr "%s() (vestavěná funkce)" - -#: sphinx/directives/desc.py:26 sphinx/directives/desc.py:42 -#: sphinx/directives/desc.py:54 -#, python-format -msgid "%s() (in module %s)" -msgstr "%s() (v modulu %s)" - -#: sphinx/directives/desc.py:29 -#, python-format -msgid "%s (built-in variable)" -msgstr "%s() (vestavěná proměnná)" - -#: sphinx/directives/desc.py:30 sphinx/directives/desc.py:66 -#, python-format -msgid "%s (in module %s)" -msgstr "%s() (v modulu %s)" - -#: sphinx/directives/desc.py:33 -#, fuzzy, python-format -msgid "%s (built-in class)" -msgstr "%s() (vestavěná proměnná)" - -#: sphinx/directives/desc.py:34 -#, python-format -msgid "%s (class in %s)" -msgstr "%s() (třída v %s)" - -#: sphinx/directives/desc.py:46 -#, python-format -msgid "%s() (%s.%s method)" -msgstr "%s() (metoda %s.%s)" - -#: sphinx/directives/desc.py:48 -#, python-format -msgid "%s() (%s method)" -msgstr "%s() (metoda %s)" - -#: sphinx/directives/desc.py:58 -#, python-format -msgid "%s() (%s.%s static method)" -msgstr "%s() (statická metoda %s.%s)" - -#: sphinx/directives/desc.py:60 -#, python-format -msgid "%s() (%s static method)" -msgstr "%s() (statická metoda %s)" - -#: sphinx/directives/desc.py:70 -#, python-format -msgid "%s (%s.%s attribute)" -msgstr "%s() (atribut %s.%s)" - -#: sphinx/directives/desc.py:72 -#, python-format -msgid "%s (%s attribute)" -msgstr "%s() (atribut %s)" - -#: sphinx/directives/desc.py:74 -#, python-format -msgid "%s (C function)" -msgstr "%s (C funkce)" - -#: sphinx/directives/desc.py:76 -#, python-format -msgid "%s (C member)" -msgstr "%s (člen C)" - -#: sphinx/directives/desc.py:78 -#, python-format -msgid "%s (C macro)" -msgstr "%s (C makro)" - -#: sphinx/directives/desc.py:80 -#, python-format -msgid "%s (C type)" -msgstr "%s (C typ)" - -#: sphinx/directives/desc.py:82 -#, python-format -msgid "%s (C variable)" -msgstr "%s (C proměnná)" - -#: sphinx/directives/desc.py:100 -msgid "Raises" -msgstr "Vyvolá" - -#: sphinx/directives/desc.py:104 -msgid "Variable" -msgstr "Proměnná" - -#: sphinx/directives/desc.py:107 -msgid "Returns" -msgstr "Vrací" - -#: sphinx/directives/desc.py:116 -msgid "Return type" -msgstr "Typ navrácené hodnoty" - -#: sphinx/directives/desc.py:143 -msgid "Parameters" -msgstr "Parametry" - -#: sphinx/directives/desc.py:423 -#, fuzzy, python-format -msgid "%scommand line option; %s" -msgstr "%sparametry příkazového řádku; %s" - -#: sphinx/directives/other.py:101 -msgid "Platforms: " -msgstr "Platformy: " - -#: sphinx/directives/other.py:106 -#, python-format -msgid "%s (module)" -msgstr "%s (module)" - -#: sphinx/directives/other.py:146 -msgid "Section author: " -msgstr "Autor sekce: " - -#: sphinx/directives/other.py:148 -msgid "Module author: " -msgstr "Autor modulu: " - -#: sphinx/directives/other.py:150 -msgid "Author: " -msgstr "Autor: " - -#: sphinx/directives/other.py:246 -msgid "See also" -msgstr "Viz také" - -#: sphinx/ext/todo.py:31 -msgid "Todo" -msgstr "" - -#: sphinx/ext/todo.py:75 -#, python-format -msgid "(The original entry is located in %s, line %d and can be found " -msgstr "" - -#: sphinx/ext/todo.py:81 -msgid "here" -msgstr "" - -#: sphinx/locale/__init__.py:15 -msgid "Attention" -msgstr "Výstraha" - -#: sphinx/locale/__init__.py:16 -msgid "Caution" -msgstr "Upozornění" - -#: sphinx/locale/__init__.py:17 -msgid "Danger" -msgstr "Nebezpečí" - -#: sphinx/locale/__init__.py:18 -msgid "Error" -msgstr "Chyba" - -#: sphinx/locale/__init__.py:19 -msgid "Hint" -msgstr "Rada" - -#: sphinx/locale/__init__.py:20 -msgid "Important" -msgstr "Důležité" - -#: sphinx/locale/__init__.py:21 -msgid "Note" -msgstr "Poznámka" - -#: sphinx/locale/__init__.py:22 -msgid "See Also" -msgstr "Viz také" - -#: sphinx/locale/__init__.py:23 -msgid "Tip" -msgstr "Tip" - -#: sphinx/locale/__init__.py:24 -msgid "Warning" -msgstr "Varování" - -#: sphinx/locale/__init__.py:28 -#, python-format -msgid "New in version %s" -msgstr "Nové ve verzi %s" - -#: sphinx/locale/__init__.py:29 -#, python-format -msgid "Changed in version %s" -msgstr "Změněno ve verzi %s" - -#: sphinx/locale/__init__.py:30 -#, python-format -msgid "Deprecated since version %s" -msgstr "Zastaralé od verze %s" - -#: sphinx/locale/__init__.py:34 -msgid "module" -msgstr "modul" - -#: sphinx/locale/__init__.py:35 -msgid "keyword" -msgstr "klíčové slovo" - -#: sphinx/locale/__init__.py:36 -msgid "operator" -msgstr "operátor" - -#: sphinx/locale/__init__.py:37 -msgid "object" -msgstr "objekt" - -#: sphinx/locale/__init__.py:38 -msgid "exception" -msgstr "výjimka" - -#: sphinx/locale/__init__.py:39 -msgid "statement" -msgstr "příkaz" - -#: sphinx/locale/__init__.py:40 -msgid "built-in function" -msgstr "vestavěná funkce" - -#: sphinx/static/doctools.js:174 -msgid "Hide Search Matches" -msgstr "" - -#: sphinx/static/searchtools.js:274 -#, fuzzy -msgid "Searching" -msgstr "hledej" - -#: sphinx/static/searchtools.js:279 -msgid "Preparing search..." -msgstr "" - -#: sphinx/static/searchtools.js:338 -#, fuzzy -msgid "module, in " -msgstr "modul" - -#: sphinx/static/searchtools.js:347 -msgid ", in " -msgstr "" - -#: sphinx/static/searchtools.js:447 sphinx/templates/search.html:18 -msgid "Search Results" -msgstr "Výsledky hledání" - -#: sphinx/static/searchtools.js:449 -msgid "" -"Your search did not match any documents. Please make sure that all words " -"are spelled correctly and that you've selected enough categories." -msgstr "" - -#: sphinx/static/searchtools.js:451 -#, python-format -msgid "Search finished, found %s page(s) matching the search query." -msgstr "" - -#: sphinx/templates/defindex.html:2 -msgid "Overview" -msgstr "Přehled" - -#: sphinx/templates/defindex.html:11 -msgid "Indices and tables:" -msgstr "Rejstříky a tabulky:" - -#: sphinx/templates/defindex.html:14 -msgid "Complete Table of Contents" -msgstr "Celkový obsah" - -#: sphinx/templates/defindex.html:15 -msgid "lists all sections and subsections" -msgstr "seznam všech sekcí a podsekcí" - -#: sphinx/templates/defindex.html:17 -msgid "search this documentation" -msgstr "prohledej tuto dokumentaci" - -#: sphinx/templates/defindex.html:20 -msgid "quick access to all modules" -msgstr "rychlý přístup ke všem modulům" - -#: sphinx/templates/defindex.html:22 -msgid "all functions, classes, terms" -msgstr "všechny funkce, třídy, termíny" - -#: sphinx/templates/genindex-single.html:5 -#, python-format -msgid "Index – %(key)s" -msgstr "Index – %(key)s" - -#: sphinx/templates/genindex-single.html:44 -#: sphinx/templates/genindex-split.html:14 -#: sphinx/templates/genindex-split.html:27 sphinx/templates/genindex.html:54 -msgid "Full index on one page" -msgstr "Plný index na jedné stránce" - -#: sphinx/templates/genindex-split.html:7 -msgid "Index pages by letter" -msgstr "Index podle písmene" - -#: sphinx/templates/genindex-split.html:15 -msgid "can be huge" -msgstr "může být obrovský" - -#: sphinx/templates/layout.html:9 -msgid "Navigation" -msgstr "Navigace" - -#: sphinx/templates/layout.html:40 -msgid "Table Of Contents" -msgstr "Obsah" - -#: sphinx/templates/layout.html:46 -msgid "Previous topic" -msgstr "Přechozí téma" - -#: sphinx/templates/layout.html:47 -msgid "previous chapter" -msgstr "předchozí kapitola" - -#: sphinx/templates/layout.html:50 -msgid "Next topic" -msgstr "Další téma" - -#: sphinx/templates/layout.html:51 -msgid "next chapter" -msgstr "další kapitola" - -#: sphinx/templates/layout.html:55 -msgid "This Page" -msgstr "Tato stránka" - -#: sphinx/templates/layout.html:59 -msgid "Suggest Change" -msgstr "Návrh změnu" - -#: sphinx/templates/layout.html:60 sphinx/templates/layout.html:62 -msgid "Show Source" -msgstr "Ukázat zdroj" - -#: sphinx/templates/layout.html:71 -msgid "Quick search" -msgstr "Rychlé vyhledávání" - -#: sphinx/templates/layout.html:71 -msgid "Keyword search" -msgstr "Hledání dle klíče" - -#: sphinx/templates/layout.html:73 -msgid "Go" -msgstr "hledej" - -#: sphinx/templates/layout.html:78 -msgid "Enter a module, class or function name." -msgstr "Zadej jméno modulu, třídy nebo funkce." - -#: sphinx/templates/layout.html:119 -#, python-format -msgid "Search within %(docstitle)s" -msgstr "Hledání uvnitř %(docstitle)s" - -#: sphinx/templates/layout.html:128 -msgid "About these documents" -msgstr "O těchto dokumentech" - -#: sphinx/templates/layout.html:131 sphinx/templates/search.html:2 -#: sphinx/templates/search.html:5 -msgid "Search" -msgstr "Hledání" - -#: sphinx/templates/layout.html:133 -msgid "Copyright" -msgstr "Veškerá práva vyhrazena" - -#: sphinx/templates/layout.html:178 -#, python-format -msgid "© Copyright %(copyright)s." -msgstr "© Copyright %(copyright)s." - -#: sphinx/templates/layout.html:180 -#, python-format -msgid "© Copyright %(copyright)s." -msgstr "© Copyright %(copyright)s." - -#: sphinx/templates/layout.html:183 -#, python-format -msgid "Last updated on %(last_updated)s." -msgstr "Naposledy aktualizováno dne %(last_updated)s." - -#: sphinx/templates/layout.html:186 -#, python-format -msgid "" -"Created using Sphinx " -"%(sphinx_version)s." -msgstr "" -"Vytvořeno pomocí Sphinx " -"%(sphinx_version)s." - -#: sphinx/templates/modindex.html:15 -msgid "Most popular modules:" -msgstr "Nejpopulárnější moduly:" - -#: sphinx/templates/modindex.html:24 -msgid "Show modules only available on these platforms" -msgstr "Zobrazit moduly dostupné na této platformě" - -#: sphinx/templates/modindex.html:56 -msgid "Deprecated" -msgstr "Zastaralé" - -#: sphinx/templates/opensearch.xml:4 -#, python-format -msgid "Search %(docstitle)s" -msgstr "Prohledat %(docstitle)s" - -#: sphinx/templates/page.html:8 -msgid "" -"Note: You requested an out-of-date URL from this server." -" We've tried to redirect you to the new location of this page, but it may" -" not be the right one." -msgstr "" -"Poznámka: Stránka, kterou hledáte, " -"neexistuje.
Snažili jsme se najít nové umístění této stránky, ale " -"nepovedlo se." - -#: sphinx/templates/search.html:7 -#, fuzzy -msgid "" -"From here you can search these documents. Enter your search\n" -" words into the box below and click \"search\". Note that the search\n" -" function will automatically search for all of the words. Pages\n" -" containing fewer words won't appear in the result list." -msgstr "" -"Toto je vyhledávací stránka. Zadejte klíčová slova do pole níže a " -"klikněte na \"hledej\". \n" -"Prohledávání funkcí hledá automaticky všechna slova. Stránky obsahující" -" slov méně, nebudou nalezeny." - -#: sphinx/templates/search.html:14 -msgid "search" -msgstr "hledej" - -#: sphinx/templates/search.html:20 -msgid "Your search did not match any results." -msgstr "Nic jsme nenašli." - -#: sphinx/templates/changes/frameset.html:5 -#: sphinx/templates/changes/versionchanges.html:12 -#, python-format -msgid "Changes in Version %(version)s — %(docstitle)s" -msgstr "Změny ve verzi %(version)s — %(docstitle)s" - -#: sphinx/templates/changes/rstsource.html:5 -#, python-format -msgid "%(filename)s — %(docstitle)s" -msgstr "%(filename)s — %(docstitle)s" - -#: sphinx/templates/changes/versionchanges.html:17 -#, python-format -msgid "Automatically generated list of changes in version %(version)s" -msgstr "Automaticky generovaný seznam změn ve verzi %(version)s" - -#: sphinx/templates/changes/versionchanges.html:18 -msgid "Library changes" -msgstr "Změny v knihovnách" - -#: sphinx/templates/changes/versionchanges.html:23 -msgid "C API changes" -msgstr "Změny API" - -#: sphinx/templates/changes/versionchanges.html:25 -msgid "Other changes" -msgstr "Ostatní změny" - diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/locale/de/LC_MESSAGES/sphinx.js --- a/buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/locale/de/LC_MESSAGES/sphinx.js Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,1 +0,0 @@ -Documentation.addTranslations({"locale": "de", "plural_expr": "(n != 1)", "messages": {"module, in ": "Modul, in ", "Preparing search...": "Suche wird vorbereitet...", "Your search did not match any documents. Please make sure that all words are spelled correctly and that you've selected enough categories.": "Es wurden keine Dokumente gefunden. Haben Sie alle Suchworte richtig geschrieben und gen\u00fcgend Kategorien ausgew\u00e4hlt?", "Search finished, found %s page(s) matching the search query.": "Suche beendet, %s Seite(n) mit Ergebnissen wurden gefunden.", ", in ": "", "Permalink to this headline": "Permalink zu dieser \u00dcberschrift", "Searching": "Suchen...", "Permalink to this definition": "Permalink zu dieser Definition", "Hide Search Matches": "Suchergebnisse ausblenden", "Search Results": "Suchergebnisse"}}); \ No newline at end of file diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/locale/de/LC_MESSAGES/sphinx.mo Binary file buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/locale/de/LC_MESSAGES/sphinx.mo has changed diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/locale/de/LC_MESSAGES/sphinx.po --- a/buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/locale/de/LC_MESSAGES/sphinx.po Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,601 +0,0 @@ -# German translations for Sphinx. -# Copyright (C) 2008 Translators. -# This file is distributed under the same license as the Sphinx project. -# -msgid "" -msgstr "" -"Project-Id-Version: PROJECT VERSION\n" -"Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" -"POT-Creation-Date: 2008-08-07 21:40+0200\n" -"PO-Revision-Date: 2008-11-27 18:40+0100\n" -"Last-Translator: Horst Gutmann \n" -"Language-Team: de \n" -"Plural-Forms: nplurals=2; plural=(n != 1)\n" -"MIME-Version: 1.0\n" -"Content-Type: text/plain; charset=utf-8\n" -"Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 0.9.4\n" - -#: sphinx/builder.py:408 -#, python-format -msgid "%b %d, %Y" -msgstr "%d. %m. %Y" - -#: sphinx/builder.py:427 sphinx/templates/defindex.html:21 -msgid "General Index" -msgstr "Allgemeiner Index" - -#: sphinx/builder.py:427 -msgid "index" -msgstr "Index" - -#: sphinx/builder.py:429 sphinx/htmlhelp.py:156 -#: sphinx/templates/defindex.html:19 sphinx/templates/modindex.html:2 -#: sphinx/templates/modindex.html:13 -msgid "Global Module Index" -msgstr "Globaler Modulindex" - -#: sphinx/builder.py:429 -msgid "modules" -msgstr "Module" - -#: sphinx/builder.py:466 -msgid "next" -msgstr "weiter" - -#: sphinx/builder.py:473 -msgid "previous" -msgstr "zurück" - -#: sphinx/builder.py:1054 -msgid " (in " -msgstr "" - -#: sphinx/builder.py:1129 -msgid "Builtins" -msgstr "Builtins" - -#: sphinx/builder.py:1131 -msgid "Module level" -msgstr "Modulebene" - -#: sphinx/environment.py:102 sphinx/latexwriter.py:169 -#, python-format -msgid "%B %d, %Y" -msgstr "%d. %m. %Y" - -#: sphinx/environment.py:291 sphinx/latexwriter.py:175 -#: sphinx/templates/genindex-single.html:2 -#: sphinx/templates/genindex-split.html:2 -#: sphinx/templates/genindex-split.html:5 sphinx/templates/genindex.html:2 -#: sphinx/templates/genindex.html:5 sphinx/templates/genindex.html:48 -#: sphinx/templates/layout.html:130 -msgid "Index" -msgstr "Stichwortverzeichnis" - -#: sphinx/environment.py:292 sphinx/latexwriter.py:174 -msgid "Module Index" -msgstr "Modulindex" - -#: sphinx/environment.py:293 sphinx/templates/defindex.html:16 -msgid "Search Page" -msgstr "Suche" - -#: sphinx/htmlwriter.py:79 sphinx/static/doctools.js:145 -msgid "Permalink to this definition" -msgstr "Permalink zu dieser Definition" - -#: sphinx/htmlwriter.py:399 sphinx/static/doctools.js:139 -msgid "Permalink to this headline" -msgstr "Permalink zu dieser Überschrift" - -#: sphinx/latexwriter.py:172 -msgid "Release" -msgstr "Release" - -#: sphinx/roles.py:53 sphinx/directives/desc.py:537 -#, python-format -msgid "environment variable; %s" -msgstr "Umgebungsvariable; %s" - -#: sphinx/roles.py:60 -#, python-format -msgid "Python Enhancement Proposals!PEP %s" -msgstr "Python Enhancement Proposals!PEP %s" - -#: sphinx/textwriter.py:166 -#, python-format -msgid "Platform: %s" -msgstr "Plattform: %s" - -#: sphinx/textwriter.py:422 -msgid "[image]" -msgstr "[Bild]" - -#: sphinx/directives/desc.py:25 -#, python-format -msgid "%s() (built-in function)" -msgstr "%s() (eingebaute Funktion)" - -#: sphinx/directives/desc.py:26 sphinx/directives/desc.py:42 -#: sphinx/directives/desc.py:54 -#, python-format -msgid "%s() (in module %s)" -msgstr "%s() (in Modul %s)" - -#: sphinx/directives/desc.py:29 -#, python-format -msgid "%s (built-in variable)" -msgstr "%s (eingebaute Variable)" - -#: sphinx/directives/desc.py:30 sphinx/directives/desc.py:66 -#, python-format -msgid "%s (in module %s)" -msgstr "%s (in Modul %s)" - -#: sphinx/directives/desc.py:33 -#, python-format -msgid "%s (built-in class)" -msgstr "%s (eingebaute Klasse)" - -#: sphinx/directives/desc.py:34 -#, python-format -msgid "%s (class in %s)" -msgstr "%s (Klasse in %s)" - -#: sphinx/directives/desc.py:46 -#, python-format -msgid "%s() (%s.%s method)" -msgstr "%s() (Methode von %s.%s)" - -#: sphinx/directives/desc.py:48 -#, python-format -msgid "%s() (%s method)" -msgstr "%s() (Methode von %s)" - -#: sphinx/directives/desc.py:58 -#, python-format -msgid "%s() (%s.%s static method)" -msgstr "%s() (statische Methode von %s.%s)" - -#: sphinx/directives/desc.py:60 -#, python-format -msgid "%s() (%s static method)" -msgstr "%s() (statische Methode von %s)" - -#: sphinx/directives/desc.py:70 -#, python-format -msgid "%s (%s.%s attribute)" -msgstr "%s (Attribut von %s.%s)" - -#: sphinx/directives/desc.py:72 -#, python-format -msgid "%s (%s attribute)" -msgstr "%s (Attribut von %s)" - -#: sphinx/directives/desc.py:74 -#, python-format -msgid "%s (C function)" -msgstr "%s (C-Funktion)" - -#: sphinx/directives/desc.py:76 -#, python-format -msgid "%s (C member)" -msgstr "%s (C-Member)" - -#: sphinx/directives/desc.py:78 -#, python-format -msgid "%s (C macro)" -msgstr "%s (C-Makro)" - -#: sphinx/directives/desc.py:80 -#, python-format -msgid "%s (C type)" -msgstr "%s (C-Typ)" - -#: sphinx/directives/desc.py:82 -#, python-format -msgid "%s (C variable)" -msgstr "%s (C-Variable)" - -#: sphinx/directives/desc.py:100 -msgid "Raises" -msgstr "Verursacht:" - -#: sphinx/directives/desc.py:104 -msgid "Variable" -msgstr "Variable" - -#: sphinx/directives/desc.py:107 -msgid "Returns" -msgstr "Rückgabe" - -#: sphinx/directives/desc.py:116 -msgid "Return type" -msgstr "Rückgabetyp" - -#: sphinx/directives/desc.py:143 -msgid "Parameters" -msgstr "Parameter" - -#: sphinx/directives/desc.py:423 -#, python-format -msgid "%scommand line option; %s" -msgstr "%sKommandozeilenoption; %s" - -#: sphinx/directives/other.py:101 -msgid "Platforms: " -msgstr "Plattformen: " - -#: sphinx/directives/other.py:106 -#, python-format -msgid "%s (module)" -msgstr "%s (Modul)" - -#: sphinx/directives/other.py:146 -msgid "Section author: " -msgstr "Autor des Abschnitts: " - -#: sphinx/directives/other.py:148 -msgid "Module author: " -msgstr "Autor des Moduls: " - -#: sphinx/directives/other.py:150 -msgid "Author: " -msgstr "Autor: " - -#: sphinx/directives/other.py:246 -msgid "See also" -msgstr "Siehe auch" - -#: sphinx/ext/todo.py:31 -msgid "Todo" -msgstr "" - -#: sphinx/ext/todo.py:75 -#, python-format -msgid "(The original entry is located in %s, line %d and can be found " -msgstr "" - -#: sphinx/ext/todo.py:81 -msgid "here" -msgstr "" - -#: sphinx/locale/__init__.py:15 -msgid "Attention" -msgstr "Achtung" - -#: sphinx/locale/__init__.py:16 -msgid "Caution" -msgstr "Vorsicht" - -#: sphinx/locale/__init__.py:17 -msgid "Danger" -msgstr "Gefahr" - -#: sphinx/locale/__init__.py:18 -msgid "Error" -msgstr "Fehler" - -#: sphinx/locale/__init__.py:19 -msgid "Hint" -msgstr "Hinweis" - -#: sphinx/locale/__init__.py:20 -msgid "Important" -msgstr "Wichtig" - -#: sphinx/locale/__init__.py:21 -msgid "Note" -msgstr "Bemerkung" - -#: sphinx/locale/__init__.py:22 -msgid "See Also" -msgstr "Siehe auch" - -#: sphinx/locale/__init__.py:23 -msgid "Tip" -msgstr "Tipp" - -#: sphinx/locale/__init__.py:24 -msgid "Warning" -msgstr "Warnung" - -#: sphinx/locale/__init__.py:28 -#, python-format -msgid "New in version %s" -msgstr "Neu in Version %s" - -#: sphinx/locale/__init__.py:29 -#, python-format -msgid "Changed in version %s" -msgstr "Geändert in Version %s" - -#: sphinx/locale/__init__.py:30 -#, python-format -msgid "Deprecated since version %s" -msgstr "Veraltet ab Version %s" - -#: sphinx/locale/__init__.py:34 -msgid "module" -msgstr "Module" - -#: sphinx/locale/__init__.py:35 -msgid "keyword" -msgstr "Schlüsselwort" - -#: sphinx/locale/__init__.py:36 -msgid "operator" -msgstr "Operator" - -#: sphinx/locale/__init__.py:37 -msgid "object" -msgstr "Objekt" - -#: sphinx/locale/__init__.py:38 -msgid "exception" -msgstr "Exception" - -#: sphinx/locale/__init__.py:39 -msgid "statement" -msgstr "Statement" - -#: sphinx/locale/__init__.py:40 -msgid "built-in function" -msgstr "eingebaute Funktion" - -#: sphinx/static/doctools.js:174 -msgid "Hide Search Matches" -msgstr "Suchergebnisse ausblenden" - -#: sphinx/static/searchtools.js:274 -msgid "Searching" -msgstr "Suchen..." - -#: sphinx/static/searchtools.js:279 -msgid "Preparing search..." -msgstr "Suche wird vorbereitet..." - -#: sphinx/static/searchtools.js:338 -msgid "module, in " -msgstr "Modul, in " - -#: sphinx/static/searchtools.js:347 -msgid ", in " -msgstr "" - -#: sphinx/static/searchtools.js:447 sphinx/templates/search.html:18 -msgid "Search Results" -msgstr "Suchergebnisse" - -#: sphinx/static/searchtools.js:449 -msgid "" -"Your search did not match any documents. Please make sure that all words " -"are spelled correctly and that you've selected enough categories." -msgstr "" -"Es wurden keine Dokumente gefunden. Haben Sie alle Suchworte richtig " -"geschrieben und genügend Kategorien ausgewählt?" - -#: sphinx/static/searchtools.js:451 -#, python-format -msgid "Search finished, found %s page(s) matching the search query." -msgstr "Suche beendet, %s Seite(n) mit Ergebnissen wurden gefunden." - -#: sphinx/templates/defindex.html:2 -msgid "Overview" -msgstr "Übersicht" - -#: sphinx/templates/defindex.html:11 -msgid "Indices and tables:" -msgstr "Indizes und Tabellen:" - -#: sphinx/templates/defindex.html:14 -msgid "Complete Table of Contents" -msgstr "Vollständiges Inhaltsverzeichnis" - -#: sphinx/templates/defindex.html:15 -msgid "lists all sections and subsections" -msgstr "Liste aller Kapitel und Unterkapitel" - -#: sphinx/templates/defindex.html:17 -msgid "search this documentation" -msgstr "Durchsuche diese Dokumentation" - -#: sphinx/templates/defindex.html:20 -msgid "quick access to all modules" -msgstr "Schneller Zugriff auf alle Module" - -#: sphinx/templates/defindex.html:22 -msgid "all functions, classes, terms" -msgstr "Alle Funktionen, Klassen, Begriffe" - -#: sphinx/templates/genindex-single.html:5 -#, python-format -msgid "Index – %(key)s" -msgstr "Stichwortverzeichnis – %(key)s" - -#: sphinx/templates/genindex-single.html:44 -#: sphinx/templates/genindex-split.html:14 -#: sphinx/templates/genindex-split.html:27 sphinx/templates/genindex.html:54 -msgid "Full index on one page" -msgstr "Gesamtes Stichwortverzeichnis auf einer Seite" - -#: sphinx/templates/genindex-split.html:7 -msgid "Index pages by letter" -msgstr "Stichwortverzeichnis nach Anfangsbuchstabe" - -#: sphinx/templates/genindex-split.html:15 -msgid "can be huge" -msgstr "kann groß sein" - -#: sphinx/templates/layout.html:9 -msgid "Navigation" -msgstr "Navigation" - -#: sphinx/templates/layout.html:40 -msgid "Table Of Contents" -msgstr "Inhalt" - -#: sphinx/templates/layout.html:46 -msgid "Previous topic" -msgstr "Vorheriges Thema" - -#: sphinx/templates/layout.html:47 -msgid "previous chapter" -msgstr "vorheriges Kapitel" - -#: sphinx/templates/layout.html:50 -msgid "Next topic" -msgstr "Nächstes Thema" - -#: sphinx/templates/layout.html:51 -msgid "next chapter" -msgstr "nächstes Kapitel" - -#: sphinx/templates/layout.html:55 -msgid "This Page" -msgstr "Diese Seite" - -#: sphinx/templates/layout.html:59 -msgid "Suggest Change" -msgstr "Änderung vorschlagen" - -#: sphinx/templates/layout.html:60 sphinx/templates/layout.html:62 -msgid "Show Source" -msgstr "Quelltext anzeigen" - -#: sphinx/templates/layout.html:71 -msgid "Quick search" -msgstr "Schnellsuche" - -#: sphinx/templates/layout.html:71 -msgid "Keyword search" -msgstr "Stichwortsuche" - -#: sphinx/templates/layout.html:73 -msgid "Go" -msgstr "Los" - -#: sphinx/templates/layout.html:78 -msgid "Enter a module, class or function name." -msgstr "Gib einen Modul-, Klassen- oder Funktionsnamen an." - -#: sphinx/templates/layout.html:119 -#, python-format -msgid "Search within %(docstitle)s" -msgstr "Suche in %(docstitle)s" - -#: sphinx/templates/layout.html:128 -msgid "About these documents" -msgstr "Über diese Dokumentation" - -#: sphinx/templates/layout.html:131 sphinx/templates/search.html:2 -#: sphinx/templates/search.html:5 -msgid "Search" -msgstr "Suche" - -#: sphinx/templates/layout.html:133 -msgid "Copyright" -msgstr "Copyright" - -#: sphinx/templates/layout.html:178 -#, python-format -msgid "© Copyright %(copyright)s." -msgstr "© Copyright %(copyright)s." - -#: sphinx/templates/layout.html:180 -#, python-format -msgid "© Copyright %(copyright)s." -msgstr "© Copyright %(copyright)s." - -#: sphinx/templates/layout.html:183 -#, python-format -msgid "Last updated on %(last_updated)s." -msgstr "Zuletzt aktualisiert am %(last_updated)s." - -#: sphinx/templates/layout.html:186 -#, python-format -msgid "" -"Created using Sphinx " -"%(sphinx_version)s." -msgstr "" -"Mit Sphinx %(sphinx_version)s " -"erstellt." - -#: sphinx/templates/modindex.html:15 -msgid "Most popular modules:" -msgstr "Beliebteste Module:" - -#: sphinx/templates/modindex.html:24 -msgid "Show modules only available on these platforms" -msgstr "Zeige nur Module, die auf diesen Plattformen verfügbar sind" - -#: sphinx/templates/modindex.html:56 -msgid "Deprecated" -msgstr "Veraltet" - -#: sphinx/templates/opensearch.xml:4 -#, python-format -msgid "Search %(docstitle)s" -msgstr "Suche in %(docstitle)s" - -#: sphinx/templates/page.html:8 -msgid "" -"Note: You requested an out-of-date URL from this server." -" We've tried to redirect you to the new location of this page, but it may" -" not be the right one." -msgstr "" -"Anmerkung: Du hast eine nicht länger gültige URL von " -"diesem Server angefragt. Wir haben versucht dich auf die neue Adresse " -"dieser Seite umzuleiten, aber dies muss nicht die richtige Seite sein." - -#: sphinx/templates/search.html:7 -#, fuzzy -msgid "" -"From here you can search these documents. Enter your search\n" -" words into the box below and click \"search\". Note that the search\n" -" function will automatically search for all of the words. Pages\n" -" containing fewer words won't appear in the result list." -msgstr "" -"Von hier aus kannst du die Dokumentation durchsuchen. Gib deine " -"Suchbegriffe in das untenstehende Feld ein und klicke auf \"suchen\". " -"Bitte beachte, dass die Suchfunktion automatisch nach all diesen Worten " -"suchen wird. Seiten, die nicht alle Worte enthalten, werden nicht in der " -"Ergebnisliste erscheinen." - -#: sphinx/templates/search.html:14 -msgid "search" -msgstr "suchen" - -#: sphinx/templates/search.html:20 -msgid "Your search did not match any results." -msgstr "Deine Suche ergab leider keine Treffer." - -#: sphinx/templates/changes/frameset.html:5 -#: sphinx/templates/changes/versionchanges.html:12 -#, python-format -msgid "Changes in Version %(version)s — %(docstitle)s" -msgstr "Änderungen in Version %(version)s — %(docstitle)s" - -#: sphinx/templates/changes/rstsource.html:5 -#, python-format -msgid "%(filename)s — %(docstitle)s" -msgstr "%(filename)s — %(docstitle)s" - -#: sphinx/templates/changes/versionchanges.html:17 -#, python-format -msgid "Automatically generated list of changes in version %(version)s" -msgstr "Automatisch generierte Liste der Änderungen in Version %(version)s" - -#: sphinx/templates/changes/versionchanges.html:18 -msgid "Library changes" -msgstr "Bibliotheksänderungen" - -#: sphinx/templates/changes/versionchanges.html:23 -msgid "C API changes" -msgstr "C API-Änderungen" - -#: sphinx/templates/changes/versionchanges.html:25 -msgid "Other changes" -msgstr "Andere Änderungen" - diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/locale/es/LC_MESSAGES/sphinx.js --- a/buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/locale/es/LC_MESSAGES/sphinx.js Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,1 +0,0 @@ -Documentation.addTranslations({"locale": "es", "plural_expr": "(n != 1)", "messages": {"module, in ": "m\u00f3dulo", "Preparing search...": "Preparando la b\u00fasqueda", "Your search did not match any documents. Please make sure that all words are spelled correctly and that you've selected enough categories.": "La b\u00fasqueda no dio ning\u00fan resultado. Por favor aseg\u00farese que escribi\u00f3 todas las palabras correctamente y que ha seleccionado suficientes categor\u00edas", "Search finished, found %s page(s) matching the search query.": "B\u00fasqueda finalizada, se han encontrado %s p\u00e1gina(s) que concuerdan con su consulta", ", in ": "", "Permalink to this headline": "Enlazar permanentemente con este t\u00edtulo", "Searching": "Buscando", "Permalink to this definition": "Enlazar permanentemente con esta definici\u00f3n", "Hide Search Matches": "Coincidencias de la b\u00fasqueda", "Search Results": "Resultados de la b\u00fasqueda"}}); \ No newline at end of file diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/locale/es/LC_MESSAGES/sphinx.mo Binary file buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/locale/es/LC_MESSAGES/sphinx.mo has changed diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/locale/es/LC_MESSAGES/sphinx.po --- a/buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/locale/es/LC_MESSAGES/sphinx.po Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,611 +0,0 @@ -# Spanish translations for Sphinx. -# Copyright (C) 2008 ORGANIZATION -# This file is distributed under the same license as the Sphinx project. -# FIRST AUTHOR , 2008. -# -msgid "" -msgstr "" -"Project-Id-Version: Sphinx 0.5\n" -"Report-Msgid-Bugs-To: guillem@torroja.dmt.upm.es\n" -"POT-Creation-Date: 2008-09-11 23:58+0200\n" -"PO-Revision-Date: 2008-11-27 18:40+0100\n" -"Last-Translator: Guillem Borrell \n" -"Language-Team: es \n" -"Plural-Forms: nplurals=2; plural=(n != 1)\n" -"MIME-Version: 1.0\n" -"Content-Type: text/plain; charset=utf-8\n" -"Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 0.9.4\n" - -#: sphinx/builder.py:408 -#, python-format -msgid "%b %d, %Y" -msgstr "%d %b, %Y" - -#: sphinx/builder.py:427 sphinx/templates/defindex.html:21 -msgid "General Index" -msgstr "Índice General" - -#: sphinx/builder.py:427 -msgid "index" -msgstr "índice" - -#: sphinx/builder.py:429 sphinx/htmlhelp.py:156 -#: sphinx/templates/defindex.html:19 sphinx/templates/modindex.html:2 -#: sphinx/templates/modindex.html:13 -msgid "Global Module Index" -msgstr "Índice Global de Módulos" - -#: sphinx/builder.py:429 -msgid "modules" -msgstr "módulos" - -#: sphinx/builder.py:466 -msgid "next" -msgstr "siguiente" - -#: sphinx/builder.py:473 -msgid "previous" -msgstr "anterior" - -#: sphinx/builder.py:1054 -msgid " (in " -msgstr "" - -#: sphinx/builder.py:1129 -#, fuzzy -msgid "Builtins" -msgstr "Funciones de base" - -#: sphinx/builder.py:1131 -#, fuzzy -msgid "Module level" -msgstr "Módulos" - -#: sphinx/environment.py:102 sphinx/latexwriter.py:169 -#, fuzzy, python-format -msgid "%B %d, %Y" -msgstr "%d de %B de %Y" - -#: sphinx/environment.py:291 sphinx/latexwriter.py:175 -#: sphinx/templates/genindex-single.html:2 -#: sphinx/templates/genindex-split.html:2 -#: sphinx/templates/genindex-split.html:5 sphinx/templates/genindex.html:2 -#: sphinx/templates/genindex.html:5 sphinx/templates/genindex.html:48 -#: sphinx/templates/layout.html:130 -msgid "Index" -msgstr "Índice" - -#: sphinx/environment.py:292 sphinx/latexwriter.py:174 -msgid "Module Index" -msgstr "Índice de Módulos" - -#: sphinx/environment.py:293 sphinx/templates/defindex.html:16 -msgid "Search Page" -msgstr "Página de Búsqueda" - -#: sphinx/htmlwriter.py:79 sphinx/static/doctools.js:145 -msgid "Permalink to this definition" -msgstr "Enlazar permanentemente con esta definición" - -#: sphinx/htmlwriter.py:399 sphinx/static/doctools.js:139 -msgid "Permalink to this headline" -msgstr "Enlazar permanentemente con este título" - -#: sphinx/latexwriter.py:172 -#, fuzzy -msgid "Release" -msgstr "Versión" - -#: sphinx/roles.py:53 sphinx/directives/desc.py:537 -#, python-format -msgid "environment variable; %s" -msgstr "variables de entorno; %s" - -#: sphinx/roles.py:60 -#, python-format -msgid "Python Enhancement Proposals!PEP %s" -msgstr "Python Enhancement Proposals!PEP %s" - -#: sphinx/textwriter.py:166 -#, python-format -msgid "Platform: %s" -msgstr "Plataforma: %s" - -#: sphinx/textwriter.py:422 -msgid "[image]" -msgstr "[imagen]" - -#: sphinx/directives/desc.py:25 -#, fuzzy, python-format -msgid "%s() (built-in function)" -msgstr "%s() (función de base)" - -#: sphinx/directives/desc.py:26 sphinx/directives/desc.py:42 -#: sphinx/directives/desc.py:54 -#, python-format -msgid "%s() (in module %s)" -msgstr "%s() (en el módulo %s)" - -#: sphinx/directives/desc.py:29 -#, fuzzy, python-format -msgid "%s (built-in variable)" -msgstr "%s (variable de base)" - -#: sphinx/directives/desc.py:30 sphinx/directives/desc.py:66 -#, python-format -msgid "%s (in module %s)" -msgstr "%s (en el módulo %s)" - -#: sphinx/directives/desc.py:33 -#, fuzzy, python-format -msgid "%s (built-in class)" -msgstr "%s (variable de base)" - -#: sphinx/directives/desc.py:34 -#, python-format -msgid "%s (class in %s)" -msgstr "%s (clase en %s)" - -#: sphinx/directives/desc.py:46 -#, python-format -msgid "%s() (%s.%s method)" -msgstr "%s() (%s.%s método)" - -#: sphinx/directives/desc.py:48 -#, python-format -msgid "%s() (%s method)" -msgstr "%s() (%s método)" - -#: sphinx/directives/desc.py:58 -#, python-format -msgid "%s() (%s.%s static method)" -msgstr "%s() (%s.%s método estático)" - -#: sphinx/directives/desc.py:60 -#, python-format -msgid "%s() (%s static method)" -msgstr "%s() (%s método estático)" - -#: sphinx/directives/desc.py:70 -#, python-format -msgid "%s (%s.%s attribute)" -msgstr "%s (%s.%s atributo)" - -#: sphinx/directives/desc.py:72 -#, python-format -msgid "%s (%s attribute)" -msgstr "%s (%s atributo)" - -#: sphinx/directives/desc.py:74 -#, python-format -msgid "%s (C function)" -msgstr "%s (función C)" - -#: sphinx/directives/desc.py:76 -#, python-format -msgid "%s (C member)" -msgstr "%s (miembro C)" - -#: sphinx/directives/desc.py:78 -#, python-format -msgid "%s (C macro)" -msgstr "%s (macro C)" - -#: sphinx/directives/desc.py:80 -#, python-format -msgid "%s (C type)" -msgstr "%s (tipo C)" - -#: sphinx/directives/desc.py:82 -#, python-format -msgid "%s (C variable)" -msgstr "%s (variable C)" - -#: sphinx/directives/desc.py:100 -msgid "Raises" -msgstr "Muestra" - -#: sphinx/directives/desc.py:104 -msgid "Variable" -msgstr "Variable" - -#: sphinx/directives/desc.py:107 -msgid "Returns" -msgstr "Devuelve" - -#: sphinx/directives/desc.py:116 -#, fuzzy -msgid "Return type" -msgstr "Tipo del argumento devuelto" - -#: sphinx/directives/desc.py:143 -msgid "Parameters" -msgstr "Parámetros" - -#: sphinx/directives/desc.py:423 -#, fuzzy, python-format -msgid "%scommand line option; %s" -msgstr "%sOpciones en línea de comandos; %s" - -#: sphinx/directives/other.py:101 -msgid "Platforms: " -msgstr "Plataformas:" - -#: sphinx/directives/other.py:106 -#, python-format -msgid "%s (module)" -msgstr "%s (módulo)" - -#: sphinx/directives/other.py:146 -msgid "Section author: " -msgstr "Autor de la sección" - -#: sphinx/directives/other.py:148 -msgid "Module author: " -msgstr "Autor del módulo" - -#: sphinx/directives/other.py:150 -msgid "Author: " -msgstr "Autor:" - -#: sphinx/directives/other.py:246 -msgid "See also" -msgstr "Ver también" - -#: sphinx/ext/todo.py:31 -msgid "Todo" -msgstr "" - -#: sphinx/ext/todo.py:75 -#, python-format -msgid "(The original entry is located in %s, line %d and can be found " -msgstr "" - -#: sphinx/ext/todo.py:81 -msgid "here" -msgstr "" - -#: sphinx/locale/__init__.py:15 -msgid "Attention" -msgstr "Atención" - -#: sphinx/locale/__init__.py:16 -msgid "Caution" -msgstr "Prudencia" - -#: sphinx/locale/__init__.py:17 -msgid "Danger" -msgstr "Peligro" - -#: sphinx/locale/__init__.py:18 -msgid "Error" -msgstr "Error" - -#: sphinx/locale/__init__.py:19 -msgid "Hint" -msgstr "Consejo" - -#: sphinx/locale/__init__.py:20 -msgid "Important" -msgstr "Importante" - -#: sphinx/locale/__init__.py:21 -msgid "Note" -msgstr "Nota" - -#: sphinx/locale/__init__.py:22 -msgid "See Also" -msgstr "Ver También" - -#: sphinx/locale/__init__.py:23 -msgid "Tip" -msgstr "Truco" - -#: sphinx/locale/__init__.py:24 -msgid "Warning" -msgstr "Advertencia" - -#: sphinx/locale/__init__.py:28 -#, python-format -msgid "New in version %s" -msgstr "Nuevo en la versión %s" - -#: sphinx/locale/__init__.py:29 -#, python-format -msgid "Changed in version %s" -msgstr "Distinto en la versión %s" - -#: sphinx/locale/__init__.py:30 -#, python-format -msgid "Deprecated since version %s" -msgstr "Obsoleto desde la versión %s" - -#: sphinx/locale/__init__.py:34 -msgid "module" -msgstr "módulo" - -#: sphinx/locale/__init__.py:35 -msgid "keyword" -msgstr "palabra clave" - -#: sphinx/locale/__init__.py:36 -msgid "operator" -msgstr "operador" - -#: sphinx/locale/__init__.py:37 -msgid "object" -msgstr "objeto" - -#: sphinx/locale/__init__.py:38 -msgid "exception" -msgstr "excepción" - -#: sphinx/locale/__init__.py:39 -msgid "statement" -msgstr "sentencia" - -#: sphinx/locale/__init__.py:40 -#, fuzzy -msgid "built-in function" -msgstr "función de base" - -#: sphinx/static/doctools.js:174 -#, fuzzy -msgid "Hide Search Matches" -msgstr "Coincidencias de la búsqueda" - -#: sphinx/static/searchtools.js:274 -msgid "Searching" -msgstr "Buscando" - -#: sphinx/static/searchtools.js:279 -msgid "Preparing search..." -msgstr "Preparando la búsqueda" - -#: sphinx/static/searchtools.js:338 -#, fuzzy -msgid "module, in " -msgstr "módulo" - -#: sphinx/static/searchtools.js:347 -msgid ", in " -msgstr "" - -#: sphinx/static/searchtools.js:447 sphinx/templates/search.html:18 -msgid "Search Results" -msgstr "Resultados de la búsqueda" - -#: sphinx/static/searchtools.js:449 -msgid "" -"Your search did not match any documents. Please make sure that all words " -"are spelled correctly and that you've selected enough categories." -msgstr "" -"La búsqueda no dio ningún resultado. Por favor asegúrese que escribió " -"todas las palabras correctamente y que ha seleccionado suficientes " -"categorías" - -#: sphinx/static/searchtools.js:451 -#, python-format -msgid "Search finished, found %s page(s) matching the search query." -msgstr "" -"Búsqueda finalizada, se han encontrado %s página(s) que concuerdan con su" -" consulta" - -#: sphinx/templates/defindex.html:2 -msgid "Overview" -msgstr "Resumen" - -#: sphinx/templates/defindex.html:11 -msgid "Indices and tables:" -msgstr "Índices y tablas:" - -#: sphinx/templates/defindex.html:14 -msgid "Complete Table of Contents" -msgstr "Índice de contenidos completo" - -#: sphinx/templates/defindex.html:15 -msgid "lists all sections and subsections" -msgstr "Muestra todas las secciones" - -#: sphinx/templates/defindex.html:17 -msgid "search this documentation" -msgstr "buscar en esta documentación" - -#: sphinx/templates/defindex.html:20 -msgid "quick access to all modules" -msgstr "acceso rápido a todos los módulos" - -#: sphinx/templates/defindex.html:22 -msgid "all functions, classes, terms" -msgstr "todas las funciones, clases, términos" - -#: sphinx/templates/genindex-single.html:5 -#, python-format -msgid "Index – %(key)s" -msgstr "Índice – %(key)s" - -#: sphinx/templates/genindex-single.html:44 -#: sphinx/templates/genindex-split.html:14 -#: sphinx/templates/genindex-split.html:27 sphinx/templates/genindex.html:54 -msgid "Full index on one page" -msgstr "Índice completo en una página" - -#: sphinx/templates/genindex-split.html:7 -msgid "Index pages by letter" -msgstr "Índice alfabético" - -#: sphinx/templates/genindex-split.html:15 -msgid "can be huge" -msgstr "puede ser muy grande" - -#: sphinx/templates/layout.html:9 -msgid "Navigation" -msgstr "Navegación" - -#: sphinx/templates/layout.html:40 -msgid "Table Of Contents" -msgstr "Contenidos" - -#: sphinx/templates/layout.html:46 -msgid "Previous topic" -msgstr "Tema anterior" - -#: sphinx/templates/layout.html:47 -msgid "previous chapter" -msgstr "Capítulo anterior" - -#: sphinx/templates/layout.html:50 -msgid "Next topic" -msgstr "Próximo tema" - -#: sphinx/templates/layout.html:51 -msgid "next chapter" -msgstr "Próximo capítulo" - -#: sphinx/templates/layout.html:55 -msgid "This Page" -msgstr "Esta página" - -#: sphinx/templates/layout.html:59 -msgid "Suggest Change" -msgstr "Sugerir una modificación" - -#: sphinx/templates/layout.html:60 sphinx/templates/layout.html:62 -msgid "Show Source" -msgstr "Enseñar el código" - -#: sphinx/templates/layout.html:71 -msgid "Quick search" -msgstr "Búsqueda rápida" - -#: sphinx/templates/layout.html:71 -msgid "Keyword search" -msgstr "Búsqueda por palabras clave" - -#: sphinx/templates/layout.html:73 -msgid "Go" -msgstr "Ir a" - -#: sphinx/templates/layout.html:78 -msgid "Enter a module, class or function name." -msgstr "Introducir en nombre de un módulo, clase o función" - -#: sphinx/templates/layout.html:119 -#, python-format -msgid "Search within %(docstitle)s" -msgstr "Buscar en %(docstitle)s" - -#: sphinx/templates/layout.html:128 -msgid "About these documents" -msgstr "Sobre este documento" - -#: sphinx/templates/layout.html:131 sphinx/templates/search.html:2 -#: sphinx/templates/search.html:5 -msgid "Search" -msgstr "Búsqueda" - -#: sphinx/templates/layout.html:133 -msgid "Copyright" -msgstr "Copyright" - -#: sphinx/templates/layout.html:178 -#, python-format -msgid "© Copyright %(copyright)s." -msgstr "© Copyright %(copyright)s." - -#: sphinx/templates/layout.html:180 -#, python-format -msgid "© Copyright %(copyright)s." -msgstr "© Copyright %(copyright)s." - -#: sphinx/templates/layout.html:183 -#, python-format -msgid "Last updated on %(last_updated)s." -msgstr "Actualizado por última vez en %(last_updated)s." - -#: sphinx/templates/layout.html:186 -#, python-format -msgid "" -"Created using Sphinx " -"%(sphinx_version)s." -msgstr "" -"Creado con Sphinx " -"%(sphinx_version)s." - -#: sphinx/templates/modindex.html:15 -msgid "Most popular modules:" -msgstr "Módulos más comunes:" - -#: sphinx/templates/modindex.html:24 -msgid "Show modules only available on these platforms" -msgstr "Mostrar sólo los módulos disponibles en estas plataformas" - -#: sphinx/templates/modindex.html:56 -msgid "Deprecated" -msgstr "Obsoleto" - -#: sphinx/templates/opensearch.xml:4 -#, python-format -msgid "Search %(docstitle)s" -msgstr "Buscar en %(docstitle)s" - -#: sphinx/templates/page.html:8 -msgid "" -"Note: You requested an out-of-date URL from this server." -" We've tried to redirect you to the new location of this page, but it may" -" not be the right one." -msgstr "" -"Nota: Has solicitado una dirección desactualizada a este" -" servidor. Hemos intentado redirigirte a la nueva dirección de la misma " -"página pero puede no ser la correcta." - -#: sphinx/templates/search.html:7 -#, fuzzy -msgid "" -"From here you can search these documents. Enter your search\n" -" words into the box below and click \"search\". Note that the search\n" -" function will automatically search for all of the words. Pages\n" -" containing fewer words won't appear in the result list." -msgstr "" -"Este es el diálogo de búsqueda. Introduce los términos en el diálogo " -"siguiente y pulsa \"buscar\". El asistente buscará automáticamente todas" -" las palabras. Las páginas que contengan menos palabras no aparecerán en" -" la lista de resultados." - -#: sphinx/templates/search.html:14 -msgid "search" -msgstr "buscar" - -#: sphinx/templates/search.html:20 -msgid "Your search did not match any results." -msgstr "Tu consulta no obtuvo ningún resultado" - -#: sphinx/templates/changes/frameset.html:5 -#: sphinx/templates/changes/versionchanges.html:12 -#, python-format -msgid "Changes in Version %(version)s — %(docstitle)s" -msgstr "Cambios en la versión %(version)s — %(docstitle)s" - -#: sphinx/templates/changes/rstsource.html:5 -#, python-format -msgid "%(filename)s — %(docstitle)s" -msgstr "%(filename)s — %(docstitle)s" - -#: sphinx/templates/changes/versionchanges.html:17 -#, python-format -msgid "Automatically generated list of changes in version %(version)s" -msgstr "Lista de cambios generada automáticamente en la versión %(version)s" - -#: sphinx/templates/changes/versionchanges.html:18 -msgid "Library changes" -msgstr "Cambios en la biblioteca" - -#: sphinx/templates/changes/versionchanges.html:23 -msgid "C API changes" -msgstr "Cambios en la API C" - -#: sphinx/templates/changes/versionchanges.html:25 -msgid "Other changes" -msgstr "Otros cambios" - diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/locale/fr/LC_MESSAGES/sphinx.js --- a/buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/locale/fr/LC_MESSAGES/sphinx.js Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,1 +0,0 @@ -Documentation.addTranslations({"locale": "fr", "plural_expr": "(n > 1)", "messages": {"module, in ": "module, dans", "Preparing search...": "Pr\u00e9paration de la recherche...", "Your search did not match any documents. Please make sure that all words are spelled correctly and that you've selected enough categories.": "Votre recherche ne correspond \u00e0 aucun document. V\u00e9rifiez l'orthographe des termes de recherche et que vous avez s\u00e9lectionn\u00e9 suffisamment de cat\u00e9gories.", "Search finished, found %s page(s) matching the search query.": "La recherche est termin\u00e9e, %s page(s) correspond(ent) \u00e0 la requ\u00eate.", ", in ": ", dans", "Permalink to this headline": "Lien permanent vers ce titre", "Searching": "En cours de recherche", "Permalink to this definition": "Lien permanent vers cette d\u00e9finition", "Hide Search Matches": "Cacher les r\u00e9sultats de la recherche", "Search Results": "R\u00e9sultats de la recherche"}}); \ No newline at end of file diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/locale/fr/LC_MESSAGES/sphinx.mo Binary file buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/locale/fr/LC_MESSAGES/sphinx.mo has changed diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/locale/fr/LC_MESSAGES/sphinx.po --- a/buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/locale/fr/LC_MESSAGES/sphinx.po Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,606 +0,0 @@ -# French translations for Sphinx. -# Copyright (C) 2008 ORGANIZATION -# This file is distributed under the same license as the Sphinx project. -# David Larlet , 2008. -# Sebastien Douche , 2008. -# -msgid "" -msgstr "" -"Project-Id-Version: Sphinx 0.5\n" -"Report-Msgid-Bugs-To: larlet@gmail.com\n" -"POT-Creation-Date: 2008-08-08 12:39+0000\n" -"PO-Revision-Date: 2008-11-27 18:40+0100\n" -"Last-Translator: Sébastien Douche \n" -"Language-Team: French Translation Team \n" -"Plural-Forms: nplurals=2; plural=(n > 1)\n" -"MIME-Version: 1.0\n" -"Content-Type: text/plain; charset=utf-8\n" -"Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 0.9.4\n" - -#: sphinx/builder.py:408 -#, python-format -msgid "%b %d, %Y" -msgstr "%d %b %Y" - -#: sphinx/builder.py:427 sphinx/templates/defindex.html:21 -msgid "General Index" -msgstr "Index général" - -#: sphinx/builder.py:427 -msgid "index" -msgstr "index" - -#: sphinx/builder.py:429 sphinx/htmlhelp.py:156 -#: sphinx/templates/defindex.html:19 sphinx/templates/modindex.html:2 -#: sphinx/templates/modindex.html:13 -msgid "Global Module Index" -msgstr "Index général des modules" - -#: sphinx/builder.py:429 -msgid "modules" -msgstr "modules" - -#: sphinx/builder.py:466 -msgid "next" -msgstr "suivant" - -#: sphinx/builder.py:473 -msgid "previous" -msgstr "précédent" - -#: sphinx/builder.py:1054 -msgid " (in " -msgstr "(dans" - -#: sphinx/builder.py:1129 -msgid "Builtins" -msgstr "Fonctions de base" - -#: sphinx/builder.py:1131 -msgid "Module level" -msgstr "Module" - -#: sphinx/environment.py:102 sphinx/latexwriter.py:169 -#, python-format -msgid "%B %d, %Y" -msgstr "%d %B %Y" - -#: sphinx/environment.py:291 sphinx/latexwriter.py:175 -#: sphinx/templates/genindex-single.html:2 -#: sphinx/templates/genindex-split.html:2 -#: sphinx/templates/genindex-split.html:5 sphinx/templates/genindex.html:2 -#: sphinx/templates/genindex.html:5 sphinx/templates/genindex.html:48 -#: sphinx/templates/layout.html:130 -msgid "Index" -msgstr "Index" - -#: sphinx/environment.py:292 sphinx/latexwriter.py:174 -msgid "Module Index" -msgstr "Index du module" - -#: sphinx/environment.py:293 sphinx/templates/defindex.html:16 -msgid "Search Page" -msgstr "Page de recherche" - -#: sphinx/htmlwriter.py:79 sphinx/static/doctools.js:145 -msgid "Permalink to this definition" -msgstr "Lien permanent vers cette définition" - -#: sphinx/htmlwriter.py:399 sphinx/static/doctools.js:139 -msgid "Permalink to this headline" -msgstr "Lien permanent vers ce titre" - -#: sphinx/latexwriter.py:172 -msgid "Release" -msgstr "Version" - -#: sphinx/roles.py:53 sphinx/directives/desc.py:537 -#, python-format -msgid "environment variable; %s" -msgstr "variable d'environnement; %s" - -#: sphinx/roles.py:60 -#, python-format -msgid "Python Enhancement Proposals!PEP %s" -msgstr "Python Enhancement Proposals!PEP %s" - -#: sphinx/textwriter.py:166 -#, python-format -msgid "Platform: %s" -msgstr "Plateforme : %s" - -#: sphinx/textwriter.py:422 -msgid "[image]" -msgstr "[image]" - -#: sphinx/directives/desc.py:25 -#, python-format -msgid "%s() (built-in function)" -msgstr "%s() (fonction de base)" - -#: sphinx/directives/desc.py:26 sphinx/directives/desc.py:42 -#: sphinx/directives/desc.py:54 -#, python-format -msgid "%s() (in module %s)" -msgstr "%s() (dans le module %s)" - -#: sphinx/directives/desc.py:29 -#, python-format -msgid "%s (built-in variable)" -msgstr "%s (variable de base)" - -#: sphinx/directives/desc.py:30 sphinx/directives/desc.py:66 -#, python-format -msgid "%s (in module %s)" -msgstr "%s (dans le module %s)" - -#: sphinx/directives/desc.py:33 -#, python-format -msgid "%s (built-in class)" -msgstr "%s (classe de base)" - -#: sphinx/directives/desc.py:34 -#, python-format -msgid "%s (class in %s)" -msgstr "%s (classe dans %s)" - -#: sphinx/directives/desc.py:46 -#, python-format -msgid "%s() (%s.%s method)" -msgstr "%s() (méthode %s.%s)" - -#: sphinx/directives/desc.py:48 -#, python-format -msgid "%s() (%s method)" -msgstr "%s() (méthode %s)" - -#: sphinx/directives/desc.py:58 -#, python-format -msgid "%s() (%s.%s static method)" -msgstr "%s() (méthode statique %s.%s)" - -#: sphinx/directives/desc.py:60 -#, python-format -msgid "%s() (%s static method)" -msgstr "%s() (méthode statique %s)" - -#: sphinx/directives/desc.py:70 -#, python-format -msgid "%s (%s.%s attribute)" -msgstr "%s (attribut %s.%s)" - -#: sphinx/directives/desc.py:72 -#, python-format -msgid "%s (%s attribute)" -msgstr "%s (attribut %s)" - -#: sphinx/directives/desc.py:74 -#, python-format -msgid "%s (C function)" -msgstr "%s (fonction C)" - -#: sphinx/directives/desc.py:76 -#, python-format -msgid "%s (C member)" -msgstr "%s (membre C)" - -#: sphinx/directives/desc.py:78 -#, python-format -msgid "%s (C macro)" -msgstr "%s (macro C)" - -#: sphinx/directives/desc.py:80 -#, python-format -msgid "%s (C type)" -msgstr "%s (type C)" - -#: sphinx/directives/desc.py:82 -#, python-format -msgid "%s (C variable)" -msgstr "%s (variable C)" - -#: sphinx/directives/desc.py:100 -msgid "Raises" -msgstr "Lève" - -#: sphinx/directives/desc.py:104 -msgid "Variable" -msgstr "Variable" - -#: sphinx/directives/desc.py:107 -msgid "Returns" -msgstr "Retourne" - -#: sphinx/directives/desc.py:116 -msgid "Return type" -msgstr "Type retourné" - -#: sphinx/directives/desc.py:143 -msgid "Parameters" -msgstr "Paramètres" - -#: sphinx/directives/desc.py:423 -#, python-format -msgid "%scommand line option; %s" -msgstr "%soption de ligne de commande; %s" - -#: sphinx/directives/other.py:101 -msgid "Platforms: " -msgstr "Plateformes : " - -#: sphinx/directives/other.py:106 -#, python-format -msgid "%s (module)" -msgstr "%s (module)" - -#: sphinx/directives/other.py:146 -msgid "Section author: " -msgstr "Auteur de la section : " - -#: sphinx/directives/other.py:148 -msgid "Module author: " -msgstr "Auteur du module : " - -#: sphinx/directives/other.py:150 -msgid "Author: " -msgstr "Auteur : " - -#: sphinx/directives/other.py:246 -msgid "See also" -msgstr "Voir aussi" - -#: sphinx/ext/todo.py:31 -msgid "Todo" -msgstr "A faire" - -#: sphinx/ext/todo.py:75 -#, python-format -msgid "(The original entry is located in %s, line %d and can be found " -msgstr "(L'entrée orginale se trouve dans %s, à la ligne %d et peut être trouvé" - -#: sphinx/ext/todo.py:81 -msgid "here" -msgstr "ici" - -#: sphinx/locale/__init__.py:15 -msgid "Attention" -msgstr "Attention" - -#: sphinx/locale/__init__.py:16 -msgid "Caution" -msgstr "Prudence" - -#: sphinx/locale/__init__.py:17 -msgid "Danger" -msgstr "Danger" - -#: sphinx/locale/__init__.py:18 -msgid "Error" -msgstr "Erreur" - -#: sphinx/locale/__init__.py:19 -msgid "Hint" -msgstr "Indice" - -#: sphinx/locale/__init__.py:20 -msgid "Important" -msgstr "Important" - -#: sphinx/locale/__init__.py:21 -msgid "Note" -msgstr "Note" - -#: sphinx/locale/__init__.py:22 -msgid "See Also" -msgstr "Voir aussi" - -#: sphinx/locale/__init__.py:23 -msgid "Tip" -msgstr "Astuce" - -#: sphinx/locale/__init__.py:24 -msgid "Warning" -msgstr "Warning" - -#: sphinx/locale/__init__.py:28 -#, python-format -msgid "New in version %s" -msgstr "Introduit dans la version %s" - -#: sphinx/locale/__init__.py:29 -#, python-format -msgid "Changed in version %s" -msgstr "Modifié dans la version %s" - -#: sphinx/locale/__init__.py:30 -#, python-format -msgid "Deprecated since version %s" -msgstr "Obsolète depuis la version %s" - -#: sphinx/locale/__init__.py:34 -msgid "module" -msgstr "module" - -#: sphinx/locale/__init__.py:35 -msgid "keyword" -msgstr "mot-clé" - -#: sphinx/locale/__init__.py:36 -msgid "operator" -msgstr "opérateur" - -#: sphinx/locale/__init__.py:37 -msgid "object" -msgstr "objet" - -#: sphinx/locale/__init__.py:38 -msgid "exception" -msgstr "exception" - -#: sphinx/locale/__init__.py:39 -msgid "statement" -msgstr "état" - -#: sphinx/locale/__init__.py:40 -msgid "built-in function" -msgstr "fonction de base" - -#: sphinx/static/doctools.js:174 -msgid "Hide Search Matches" -msgstr "Cacher les résultats de la recherche" - -#: sphinx/static/searchtools.js:274 -msgid "Searching" -msgstr "En cours de recherche" - -#: sphinx/static/searchtools.js:279 -msgid "Preparing search..." -msgstr "Préparation de la recherche..." - -#: sphinx/static/searchtools.js:338 -msgid "module, in " -msgstr "module, dans" - -#: sphinx/static/searchtools.js:347 -msgid ", in " -msgstr ", dans" - -#: sphinx/static/searchtools.js:447 sphinx/templates/search.html:18 -msgid "Search Results" -msgstr "Résultats de la recherche" - -#: sphinx/static/searchtools.js:449 -msgid "" -"Your search did not match any documents. Please make sure that all words " -"are spelled correctly and that you've selected enough categories." -msgstr "" -"Votre recherche ne correspond à aucun document. Vérifiez l'orthographe " -"des termes de recherche et que vous avez sélectionné suffisamment de " -"catégories." - -#: sphinx/static/searchtools.js:451 -#, python-format -msgid "Search finished, found %s page(s) matching the search query." -msgstr "La recherche est terminée, %s page(s) correspond(ent) à la requête." - -#: sphinx/templates/defindex.html:2 -msgid "Overview" -msgstr "Résumé" - -#: sphinx/templates/defindex.html:11 -msgid "Indices and tables:" -msgstr "Indices et tables :" - -#: sphinx/templates/defindex.html:14 -msgid "Complete Table of Contents" -msgstr "Table des matières complète" - -#: sphinx/templates/defindex.html:15 -msgid "lists all sections and subsections" -msgstr "lister l'ensemble des sections et sous-sections" - -#: sphinx/templates/defindex.html:17 -msgid "search this documentation" -msgstr "rechercher dans cette documentation" - -#: sphinx/templates/defindex.html:20 -msgid "quick access to all modules" -msgstr "accès rapide à l'ensemble des modules" - -#: sphinx/templates/defindex.html:22 -msgid "all functions, classes, terms" -msgstr "toutes les fonctions, classes, termes" - -#: sphinx/templates/genindex-single.html:5 -#, python-format -msgid "Index – %(key)s" -msgstr "Index – %(key)s" - -#: sphinx/templates/genindex-single.html:44 -#: sphinx/templates/genindex-split.html:14 -#: sphinx/templates/genindex-split.html:27 sphinx/templates/genindex.html:54 -msgid "Full index on one page" -msgstr "Index complet sur une seule page" - -#: sphinx/templates/genindex-split.html:7 -msgid "Index pages by letter" -msgstr "Indexer les pages par lettre" - -#: sphinx/templates/genindex-split.html:15 -msgid "can be huge" -msgstr "peut être énorme" - -#: sphinx/templates/layout.html:9 -msgid "Navigation" -msgstr "Navigation" - -#: sphinx/templates/layout.html:40 -msgid "Table Of Contents" -msgstr "Table des matières" - -#: sphinx/templates/layout.html:46 -msgid "Previous topic" -msgstr "Sujet précédent" - -#: sphinx/templates/layout.html:47 -msgid "previous chapter" -msgstr "Chapitre précédent" - -#: sphinx/templates/layout.html:50 -msgid "Next topic" -msgstr "Sujet suivant" - -#: sphinx/templates/layout.html:51 -msgid "next chapter" -msgstr "Chapitre suivant" - -#: sphinx/templates/layout.html:55 -msgid "This Page" -msgstr "Cette page" - -#: sphinx/templates/layout.html:59 -msgid "Suggest Change" -msgstr "Suggérer une modification" - -#: sphinx/templates/layout.html:60 sphinx/templates/layout.html:62 -msgid "Show Source" -msgstr "Montrer la source" - -#: sphinx/templates/layout.html:71 -msgid "Quick search" -msgstr "Recherche rapide" - -#: sphinx/templates/layout.html:71 -msgid "Keyword search" -msgstr "Recherche par mot-clé" - -#: sphinx/templates/layout.html:73 -msgid "Go" -msgstr "Go" - -#: sphinx/templates/layout.html:78 -msgid "Enter a module, class or function name." -msgstr "Saisissez un nom de module, classe ou fonction." - -#: sphinx/templates/layout.html:119 -#, python-format -msgid "Search within %(docstitle)s" -msgstr "Recherchez dans %(docstitle)s" - -#: sphinx/templates/layout.html:128 -msgid "About these documents" -msgstr "À propos de ces documents" - -#: sphinx/templates/layout.html:131 sphinx/templates/search.html:2 -#: sphinx/templates/search.html:5 -msgid "Search" -msgstr "Recherche" - -#: sphinx/templates/layout.html:133 -msgid "Copyright" -msgstr "Copyright" - -#: sphinx/templates/layout.html:178 -#, python-format -msgid "© Copyright %(copyright)s." -msgstr "© Copyright %(copyright)s." - -#: sphinx/templates/layout.html:180 -#, python-format -msgid "© Copyright %(copyright)s." -msgstr "© Copyright %(copyright)s." - -#: sphinx/templates/layout.html:183 -#, python-format -msgid "Last updated on %(last_updated)s." -msgstr "Mis à jour le %(last_updated)s." - -#: sphinx/templates/layout.html:186 -#, python-format -msgid "" -"Created using Sphinx " -"%(sphinx_version)s." -msgstr "" -"Créé avec Sphinx " -"%(sphinx_version)s." - -#: sphinx/templates/modindex.html:15 -msgid "Most popular modules:" -msgstr "Modules les plus utilisés :" - -#: sphinx/templates/modindex.html:24 -msgid "Show modules only available on these platforms" -msgstr "N'afficher que les modules disponibles sur ces plateformes" - -#: sphinx/templates/modindex.html:56 -msgid "Deprecated" -msgstr "Obsolète" - -#: sphinx/templates/opensearch.xml:4 -#, python-format -msgid "Search %(docstitle)s" -msgstr "Rechercher %(docstitle)s" - -#: sphinx/templates/page.html:8 -msgid "" -"Note: You requested an out-of-date URL from this server." -" We've tried to redirect you to the new location of this page, but it may" -" not be the right one." -msgstr "" -"Note : Vous tentez d'accéder à une ancienne URL de ce " -"serveur. Nous avons essayé de vous rediriger vers la nouvelle adresse de " -"cette page, mais ce n'est peut-être pas la bonne." - -#: sphinx/templates/search.html:7 -#, fuzzy -msgid "" -"From here you can search these documents. Enter your search\n" -" words into the box below and click \"search\". Note that the search\n" -" function will automatically search for all of the words. Pages\n" -" containing fewer words won't appear in the result list." -msgstr "" -"Vous pouvez effectuer une recherche au sein des documents. Saisissez les " -"termes\n" -" de votre recherche dans le champs ci-dessous et cliquez sur " -"\"rechercher\". Notez que la fonctionnalité de recherche\n" -" va automatique chercher pour tous les mots. Les pages\n" -" contenant moins de mots n'apparaîtront pas dans la liste des " -"résultats." - -#: sphinx/templates/search.html:14 -msgid "search" -msgstr "rechercher" - -#: sphinx/templates/search.html:20 -msgid "Your search did not match any results." -msgstr "Votre recherche n'a retourné aucun résultat" - -#: sphinx/templates/changes/frameset.html:5 -#: sphinx/templates/changes/versionchanges.html:12 -#, python-format -msgid "Changes in Version %(version)s — %(docstitle)s" -msgstr "Modifications dans la version %(version)s — %(docstitle)s" - -#: sphinx/templates/changes/rstsource.html:5 -#, python-format -msgid "%(filename)s — %(docstitle)s" -msgstr "%(filename)s — %(docstitle)s" - -#: sphinx/templates/changes/versionchanges.html:17 -#, python-format -msgid "Automatically generated list of changes in version %(version)s" -msgstr "Liste auto-générée des modifications dans la version %(version)s" - -#: sphinx/templates/changes/versionchanges.html:18 -msgid "Library changes" -msgstr "Modifications de la bibliothèque" - -#: sphinx/templates/changes/versionchanges.html:23 -msgid "C API changes" -msgstr "Modifications de l'API C" - -#: sphinx/templates/changes/versionchanges.html:25 -msgid "Other changes" -msgstr "Autres modifications" - diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/locale/ja/LC_MESSAGES/sphinx.js --- a/buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/locale/ja/LC_MESSAGES/sphinx.js Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,1 +0,0 @@ -Documentation.addTranslations({"locale": "ja", "plural_expr": "0", "messages": {"module, in ": "\u30e2\u30b8\u30e5\u30fc\u30eb", "Preparing search...": "\u691c\u7d22\u306e\u6e96\u5099\u4e2d...", "Your search did not match any documents. Please make sure that all words are spelled correctly and that you've selected enough categories.": "\u691c\u7d22\u6761\u4ef6\u306b\u4e00\u81f4\u3059\u308b\u30c9\u30ad\u30e5\u30e1\u30f3\u30c8\u306f\u3042\u308a\u307e\u305b\u3093\u3067\u3057\u305f\u3002\u691c\u7d22\u3057\u305f\u3044\u8a00\u8449\u3092\u6b63\u3057\u3044\u3064\u3065\u308a\u3067\u5165\u529b\u3057\u3066\u3044\u308b\u304b\u78ba\u8a8d\u3057\u3066\u304f\u3060\u3055\u3044\u3002\u307e\u305f\u3001\u6b63\u3057\u3044\u30ab\u30c6\u30b4\u30ea\u306e\u691c\u7d22\u3092\u884c\u3063\u3066\u3044\u308b\u304b\u78ba\u8a8d\u3057\u3066\u304f\u3060\u3055\u3044\u3002", "Search finished, found %s page(s) matching the search query.": "\u691c\u7d22\u304c\u7d42\u4e86\u3057\u3001\u6761\u4ef6\u306b\u4e00\u81f4\u3059\u308b\u30da\u30fc\u30b8\u304c %s \u500b\u307f\u3064\u304b\u308a\u307e\u3057\u305f\u3002", ", in ": "", "Permalink to this headline": "\u3053\u306e\u30d8\u30c3\u30c9\u30e9\u30a4\u30f3\u3078\u306e\u30d1\u30fc\u30de\u30ea\u30f3\u30af", "Searching": "\u691c\u7d22\u4e2d", "Permalink to this definition": "\u3053\u306e\u5b9a\u7fa9\u3078\u306e\u30d1\u30fc\u30de\u30ea\u30f3\u30af", "Hide Search Matches": "\u691c\u7d22\u7d50\u679c\u3092\u96a0\u3059", "Search Results": "\u691c\u7d22\u7d50\u679c"}}); \ No newline at end of file diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/locale/ja/LC_MESSAGES/sphinx.mo Binary file buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/locale/ja/LC_MESSAGES/sphinx.mo has changed diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/locale/ja/LC_MESSAGES/sphinx.po --- a/buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/locale/ja/LC_MESSAGES/sphinx.po Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,595 +0,0 @@ -# Japanese translations for Sphinx. -# Copyright (C) 2008 ORGANIZATION -# This file is distributed under the same license as the Sphinx project. -# Yasushi Masuda , 2008. -# -msgid "" -msgstr "" -"Project-Id-Version: Sphinx 0.5\n" -"Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" -"POT-Creation-Date: 2008-09-11 23:58+0200\n" -"PO-Revision-Date: 2008-11-27 18:40+0100\n" -"Last-Translator: Yasushi MASUDA \n" -"Language-Team: ja \n" -"Plural-Forms: nplurals=1; plural=0\n" -"MIME-Version: 1.0\n" -"Content-Type: text/plain; charset=utf-8\n" -"Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 0.9.4\n" - -#: sphinx/builder.py:408 -#, python-format -msgid "%b %d, %Y" -msgstr "%Y 年 %m 月 %d 日" - -#: sphinx/builder.py:427 sphinx/templates/defindex.html:21 -msgid "General Index" -msgstr "総合索引" - -#: sphinx/builder.py:427 -msgid "index" -msgstr "索引" - -#: sphinx/builder.py:429 sphinx/htmlhelp.py:156 -#: sphinx/templates/defindex.html:19 sphinx/templates/modindex.html:2 -#: sphinx/templates/modindex.html:13 -msgid "Global Module Index" -msgstr "モジュール総索引" - -#: sphinx/builder.py:429 -msgid "modules" -msgstr "モジュール" - -#: sphinx/builder.py:466 -msgid "next" -msgstr "次へ" - -#: sphinx/builder.py:473 -msgid "previous" -msgstr "前へ" - -#: sphinx/builder.py:1054 -msgid " (in " -msgstr "" - -#: sphinx/builder.py:1129 -msgid "Builtins" -msgstr "組み込み" - -#: sphinx/builder.py:1131 -msgid "Module level" -msgstr "モジュールレベル" - -#: sphinx/environment.py:102 sphinx/latexwriter.py:169 -#, python-format -msgid "%B %d, %Y" -msgstr "%Y 年 %m 月 %d 日" - -#: sphinx/environment.py:291 sphinx/latexwriter.py:175 -#: sphinx/templates/genindex-single.html:2 -#: sphinx/templates/genindex-split.html:2 -#: sphinx/templates/genindex-split.html:5 sphinx/templates/genindex.html:2 -#: sphinx/templates/genindex.html:5 sphinx/templates/genindex.html:48 -#: sphinx/templates/layout.html:130 -msgid "Index" -msgstr "索引" - -#: sphinx/environment.py:292 sphinx/latexwriter.py:174 -msgid "Module Index" -msgstr "モジュール索引" - -#: sphinx/environment.py:293 sphinx/templates/defindex.html:16 -msgid "Search Page" -msgstr "検索ページ" - -#: sphinx/htmlwriter.py:79 sphinx/static/doctools.js:145 -msgid "Permalink to this definition" -msgstr "この定義へのパーマリンク" - -#: sphinx/htmlwriter.py:399 sphinx/static/doctools.js:139 -msgid "Permalink to this headline" -msgstr "このヘッドラインへのパーマリンク" - -#: sphinx/latexwriter.py:172 -msgid "Release" -msgstr "リリース" - -#: sphinx/roles.py:53 sphinx/directives/desc.py:537 -#, python-format -msgid "environment variable; %s" -msgstr "環境変数; %s" - -#: sphinx/roles.py:60 -#, python-format -msgid "Python Enhancement Proposals!PEP %s" -msgstr "Python Enhancement Proposals!PEP %s" - -#: sphinx/textwriter.py:166 -#, python-format -msgid "Platform: %s" -msgstr "プラットフォーム: %s" - -#: sphinx/textwriter.py:422 -msgid "[image]" -msgstr "[画像]" - -#: sphinx/directives/desc.py:25 -#, python-format -msgid "%s() (built-in function)" -msgstr "%s() (組み込み関数)" - -#: sphinx/directives/desc.py:26 sphinx/directives/desc.py:42 -#: sphinx/directives/desc.py:54 -#, python-format -msgid "%s() (in module %s)" -msgstr "%s() (%s モジュール)" - -#: sphinx/directives/desc.py:29 -#, python-format -msgid "%s (built-in variable)" -msgstr "%s (組み込み変数)" - -#: sphinx/directives/desc.py:30 sphinx/directives/desc.py:66 -#, python-format -msgid "%s (in module %s)" -msgstr "%s (%s モジュール)" - -#: sphinx/directives/desc.py:33 -#, fuzzy, python-format -msgid "%s (built-in class)" -msgstr "%s (組み込み変数)" - -#: sphinx/directives/desc.py:34 -#, python-format -msgid "%s (class in %s)" -msgstr "%s (%s のクラス)" - -#: sphinx/directives/desc.py:46 -#, python-format -msgid "%s() (%s.%s method)" -msgstr "%s() (%s.%s のメソッド)" - -#: sphinx/directives/desc.py:48 -#, python-format -msgid "%s() (%s method)" -msgstr "%s() (%s のメソッド)" - -#: sphinx/directives/desc.py:58 -#, python-format -msgid "%s() (%s.%s static method)" -msgstr "%s() (%s.%s の静的メソッド)" - -#: sphinx/directives/desc.py:60 -#, python-format -msgid "%s() (%s static method)" -msgstr "%s() (%s の静的メソッド)" - -#: sphinx/directives/desc.py:70 -#, python-format -msgid "%s (%s.%s attribute)" -msgstr "%s (%s.%s の属性)" - -#: sphinx/directives/desc.py:72 -#, python-format -msgid "%s (%s attribute)" -msgstr "%s (%s の属性)" - -#: sphinx/directives/desc.py:74 -#, python-format -msgid "%s (C function)" -msgstr "%s (C の関数)" - -#: sphinx/directives/desc.py:76 -#, python-format -msgid "%s (C member)" -msgstr "%s (C のメンバ変数)" - -#: sphinx/directives/desc.py:78 -#, python-format -msgid "%s (C macro)" -msgstr "%s (C のマクロ)" - -#: sphinx/directives/desc.py:80 -#, python-format -msgid "%s (C type)" -msgstr "%s (C のデータ型)" - -#: sphinx/directives/desc.py:82 -#, python-format -msgid "%s (C variable)" -msgstr "%s (C の変数)" - -#: sphinx/directives/desc.py:100 -msgid "Raises" -msgstr "例外" - -#: sphinx/directives/desc.py:104 -msgid "Variable" -msgstr "変数" - -#: sphinx/directives/desc.py:107 -msgid "Returns" -msgstr "戻り値" - -#: sphinx/directives/desc.py:116 -msgid "Return type" -msgstr "戻り値の型" - -#: sphinx/directives/desc.py:143 -msgid "Parameters" -msgstr "パラメタ" - -#: sphinx/directives/desc.py:423 -#, fuzzy, python-format -msgid "%scommand line option; %s" -msgstr "%sコマンドラインオプション; %s" - -#: sphinx/directives/other.py:101 -msgid "Platforms: " -msgstr "プラットフォーム: " - -#: sphinx/directives/other.py:106 -#, python-format -msgid "%s (module)" -msgstr "%s (モジュール)" - -#: sphinx/directives/other.py:146 -msgid "Section author: " -msgstr "この節の作者: " - -#: sphinx/directives/other.py:148 -msgid "Module author: " -msgstr "モジュールの作者: " - -#: sphinx/directives/other.py:150 -msgid "Author: " -msgstr "作者: " - -#: sphinx/directives/other.py:246 -msgid "See also" -msgstr "参考" - -#: sphinx/ext/todo.py:31 -msgid "Todo" -msgstr "" - -#: sphinx/ext/todo.py:75 -#, python-format -msgid "(The original entry is located in %s, line %d and can be found " -msgstr "" - -#: sphinx/ext/todo.py:81 -msgid "here" -msgstr "" - -#: sphinx/locale/__init__.py:15 -msgid "Attention" -msgstr "注意" - -#: sphinx/locale/__init__.py:16 -msgid "Caution" -msgstr "ご用心" - -#: sphinx/locale/__init__.py:17 -msgid "Danger" -msgstr "危険" - -#: sphinx/locale/__init__.py:18 -msgid "Error" -msgstr "エラー" - -#: sphinx/locale/__init__.py:19 -msgid "Hint" -msgstr "ヒント" - -#: sphinx/locale/__init__.py:20 -msgid "Important" -msgstr "重要" - -#: sphinx/locale/__init__.py:21 -msgid "Note" -msgstr "ノート" - -#: sphinx/locale/__init__.py:22 -msgid "See Also" -msgstr "参考" - -#: sphinx/locale/__init__.py:23 -msgid "Tip" -msgstr "ちなみに" - -#: sphinx/locale/__init__.py:24 -msgid "Warning" -msgstr "警告" - -#: sphinx/locale/__init__.py:28 -#, python-format -msgid "New in version %s" -msgstr "バージョン %s で追加" - -#: sphinx/locale/__init__.py:29 -#, python-format -msgid "Changed in version %s" -msgstr "バージョン %s で変更" - -#: sphinx/locale/__init__.py:30 -#, python-format -msgid "Deprecated since version %s" -msgstr "バージョン %s で撤廃" - -#: sphinx/locale/__init__.py:34 -msgid "module" -msgstr "モジュール" - -#: sphinx/locale/__init__.py:35 -msgid "keyword" -msgstr "キーワード" - -#: sphinx/locale/__init__.py:36 -msgid "operator" -msgstr "演算子" - -#: sphinx/locale/__init__.py:37 -msgid "object" -msgstr "オブジェクト" - -#: sphinx/locale/__init__.py:38 -msgid "exception" -msgstr "例外" - -#: sphinx/locale/__init__.py:39 -msgid "statement" -msgstr "文" - -#: sphinx/locale/__init__.py:40 -msgid "built-in function" -msgstr "組み込み関数" - -#: sphinx/static/doctools.js:174 -msgid "Hide Search Matches" -msgstr "検索結果を隠す" - -#: sphinx/static/searchtools.js:274 -msgid "Searching" -msgstr "検索中" - -#: sphinx/static/searchtools.js:279 -msgid "Preparing search..." -msgstr "検索の準備中..." - -#: sphinx/static/searchtools.js:338 -#, fuzzy -msgid "module, in " -msgstr "モジュール" - -#: sphinx/static/searchtools.js:347 -msgid ", in " -msgstr "" - -#: sphinx/static/searchtools.js:447 sphinx/templates/search.html:18 -msgid "Search Results" -msgstr "検索結果" - -#: sphinx/static/searchtools.js:449 -msgid "" -"Your search did not match any documents. Please make sure that all words " -"are spelled correctly and that you've selected enough categories." -msgstr "検索条件に一致するドキュメントはありませんでした。検索したい言葉を正しいつづりで入力しているか確認してください。また、正しいカテゴリの検索を行っているか確認してください。" - -#: sphinx/static/searchtools.js:451 -#, python-format -msgid "Search finished, found %s page(s) matching the search query." -msgstr "検索が終了し、条件に一致するページが %s 個みつかりました。" - -#: sphinx/templates/defindex.html:2 -msgid "Overview" -msgstr "概要" - -#: sphinx/templates/defindex.html:11 -msgid "Indices and tables:" -msgstr "索引と表一覧:" - -#: sphinx/templates/defindex.html:14 -msgid "Complete Table of Contents" -msgstr "総合目次" - -#: sphinx/templates/defindex.html:15 -msgid "lists all sections and subsections" -msgstr "章／節一覧" - -#: sphinx/templates/defindex.html:17 -msgid "search this documentation" -msgstr "ドキュメントを検索" - -#: sphinx/templates/defindex.html:20 -msgid "quick access to all modules" -msgstr "全モジュール早見表" - -#: sphinx/templates/defindex.html:22 -msgid "all functions, classes, terms" -msgstr "関数、クラスおよび用語総覧" - -#: sphinx/templates/genindex-single.html:5 -#, python-format -msgid "Index – %(key)s" -msgstr "索引 – %(key)s" - -#: sphinx/templates/genindex-single.html:44 -#: sphinx/templates/genindex-split.html:14 -#: sphinx/templates/genindex-split.html:27 sphinx/templates/genindex.html:54 -msgid "Full index on one page" -msgstr "総索引" - -#: sphinx/templates/genindex-split.html:7 -msgid "Index pages by letter" -msgstr "頭文字別索引" - -#: sphinx/templates/genindex-split.html:15 -msgid "can be huge" -msgstr "大きい場合があるので注意" - -#: sphinx/templates/layout.html:9 -msgid "Navigation" -msgstr "ナビゲーション" - -#: sphinx/templates/layout.html:40 -msgid "Table Of Contents" -msgstr "目次" - -#: sphinx/templates/layout.html:46 -msgid "Previous topic" -msgstr "前のトピックへ" - -#: sphinx/templates/layout.html:47 -msgid "previous chapter" -msgstr "前の章へ" - -#: sphinx/templates/layout.html:50 -msgid "Next topic" -msgstr "次のトピックへ" - -#: sphinx/templates/layout.html:51 -msgid "next chapter" -msgstr "次の章へ" - -#: sphinx/templates/layout.html:55 -msgid "This Page" -msgstr "このページ" - -#: sphinx/templates/layout.html:59 -msgid "Suggest Change" -msgstr "変更のサジェスト" - -#: sphinx/templates/layout.html:60 sphinx/templates/layout.html:62 -msgid "Show Source" -msgstr "ソースコードを表示" - -#: sphinx/templates/layout.html:71 -msgid "Quick search" -msgstr "クイック検索" - -#: sphinx/templates/layout.html:71 -msgid "Keyword search" -msgstr "キーワード検索" - -#: sphinx/templates/layout.html:73 -msgid "Go" -msgstr "検索" - -#: sphinx/templates/layout.html:78 -msgid "Enter a module, class or function name." -msgstr "モジュール、クラス、または関数名を入力してください" - -#: sphinx/templates/layout.html:119 -#, python-format -msgid "Search within %(docstitle)s" -msgstr "%(docstitle)s 内を検索" - -#: sphinx/templates/layout.html:128 -msgid "About these documents" -msgstr "このドキュメントについて" - -#: sphinx/templates/layout.html:131 sphinx/templates/search.html:2 -#: sphinx/templates/search.html:5 -msgid "Search" -msgstr "検索" - -#: sphinx/templates/layout.html:133 -msgid "Copyright" -msgstr "著作権" - -#: sphinx/templates/layout.html:178 -#, python-format -msgid "© Copyright %(copyright)s." -msgstr "© Copyright %(copyright)s." - -#: sphinx/templates/layout.html:180 -#, python-format -msgid "© Copyright %(copyright)s." -msgstr "© Copyright %(copyright)s." - -#: sphinx/templates/layout.html:183 -#, python-format -msgid "Last updated on %(last_updated)s." -msgstr "最終更新: %(last_updated)s" - -#: sphinx/templates/layout.html:186 -#, python-format -msgid "" -"Created using Sphinx " -"%(sphinx_version)s." -msgstr "" -"このドキュメントは Sphinx " -"%(sphinx_version)s で生成しました。" - -#: sphinx/templates/modindex.html:15 -msgid "Most popular modules:" -msgstr "よく参照されているモジュール:" - -#: sphinx/templates/modindex.html:24 -msgid "Show modules only available on these platforms" -msgstr "このプラットフォームで利用可能なモジュールだけを表示する" - -#: sphinx/templates/modindex.html:56 -msgid "Deprecated" -msgstr "撤廃" - -#: sphinx/templates/opensearch.xml:4 -#, python-format -msgid "Search %(docstitle)s" -msgstr "%(docstitle)s 内を検索" - -#: sphinx/templates/page.html:8 -msgid "" -"Note: You requested an out-of-date URL from this server." -" We've tried to redirect you to the new location of this page, but it may" -" not be the right one." -msgstr "" -"注意: あなたが表示しようとしているのは古い URL です。このページに対応する新しい URL " -"へのリダイレクトを試みますが、適切なリダイレクト先でないかもしれないので注意してください。" - -#: sphinx/templates/search.html:7 -#, fuzzy -msgid "" -"From here you can search these documents. Enter your search\n" -" words into the box below and click \"search\". Note that the search\n" -" function will automatically search for all of the words. Pages\n" -" containing fewer words won't appear in the result list." -msgstr "このページからドキュメントを検索できます。キーワードを下のボックスに入力して、「検索」をクリックしてください。入力された全てのキーワードを含むページが検索されます。一部のキーワードしか含まないページは検索結果に表示されないので注意してください。" - -#: sphinx/templates/search.html:14 -msgid "search" -msgstr "検索" - -#: sphinx/templates/search.html:20 -msgid "Your search did not match any results." -msgstr "検索条件に一致する項目がありませんでした。" - -#: sphinx/templates/changes/frameset.html:5 -#: sphinx/templates/changes/versionchanges.html:12 -#, python-format -msgid "Changes in Version %(version)s — %(docstitle)s" -msgstr "バージョン %(version)s の変更点 — %(docstitle)s" - -#: sphinx/templates/changes/rstsource.html:5 -#, python-format -msgid "%(filename)s — %(docstitle)s" -msgstr "%(filename)s — %(docstitle)s" - -#: sphinx/templates/changes/versionchanges.html:17 -#, python-format -msgid "Automatically generated list of changes in version %(version)s" -msgstr "バージョン %(version)s の変更点（このリストは自動生成されています）" - -#: sphinx/templates/changes/versionchanges.html:18 -msgid "Library changes" -msgstr "ライブラリに関する変更" - -#: sphinx/templates/changes/versionchanges.html:23 -msgid "C API changes" -msgstr "C API に関する変更" - -#: sphinx/templates/changes/versionchanges.html:25 -msgid "Other changes" -msgstr "その多の変更" - diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/locale/nl/LC_MESSAGES/sphinx.js --- a/buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/locale/nl/LC_MESSAGES/sphinx.js Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,1 +0,0 @@ -Documentation.addTranslations({"locale": "nl", "plural_expr": "(n != 1)", "messages": {"module, in ": "module", "Preparing search...": "Het zoeken wordt voorbereid", "Your search did not match any documents. Please make sure that all words are spelled correctly and that you've selected enough categories.": "Uw zoekopdracht leverde geen resultaten op. Controleer of alle woordencorrect gespeld zijn en dat u genoeg categori\u00ebn hebt geselecteerd.", "Search finished, found %s page(s) matching the search query.": "Zoeken voltooid, %s pagina(s) gevonden.", ", in ": "", "Permalink to this headline": "Permanente link naar deze titel", "Searching": "Zoeken", "Permalink to this definition": "Permanente link naar deze definitie", "Hide Search Matches": "Zoekresultaten verbergen", "Search Results": "Zoekresultaten"}}); \ No newline at end of file diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/locale/nl/LC_MESSAGES/sphinx.mo Binary file buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/locale/nl/LC_MESSAGES/sphinx.mo has changed diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/locale/nl/LC_MESSAGES/sphinx.po --- a/buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/locale/nl/LC_MESSAGES/sphinx.po Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,603 +0,0 @@ -# Copyright (C) 2008 ORGANIZATION -# This file is distributed under the same license as the Sphinx project. -# FIRST AUTHOR , 2008. -# -msgid "" -msgstr "" -"Project-Id-Version: Sphinx 0.5\n" -"Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" -"POT-Creation-Date: 2008-09-11 23:58+0200\n" -"PO-Revision-Date: 2008-11-27 18:40+0100\n" -"Last-Translator: FULL NAME \n" -"Language-Team: nl \n" -"Plural-Forms: nplurals=2; plural=(n != 1)\n" -"MIME-Version: 1.0\n" -"Content-Type: text/plain; charset=utf-8\n" -"Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 0.9.4\n" - -#: sphinx/builder.py:408 -#, python-format -msgid "%b %d, %Y" -msgstr "%d.%b.%Y" - -#: sphinx/builder.py:427 sphinx/templates/defindex.html:21 -msgid "General Index" -msgstr "Algemene index" - -#: sphinx/builder.py:427 -msgid "index" -msgstr "Index" - -#: sphinx/builder.py:429 sphinx/htmlhelp.py:156 -#: sphinx/templates/defindex.html:19 sphinx/templates/modindex.html:2 -#: sphinx/templates/modindex.html:13 -msgid "Global Module Index" -msgstr "Globale Module-index" - -#: sphinx/builder.py:429 -msgid "modules" -msgstr "modules" - -#: sphinx/builder.py:466 -msgid "next" -msgstr "volgende" - -#: sphinx/builder.py:473 -msgid "previous" -msgstr "vorige" - -#: sphinx/builder.py:1054 -msgid " (in " -msgstr "" - -#: sphinx/builder.py:1129 -msgid "Builtins" -msgstr "Builtins" - -#: sphinx/builder.py:1131 -msgid "Module level" -msgstr "Moduleniveau" - -#: sphinx/environment.py:102 sphinx/latexwriter.py:169 -#, python-format -msgid "%B %d, %Y" -msgstr "%d. %B %Y" - -#: sphinx/environment.py:291 sphinx/latexwriter.py:175 -#: sphinx/templates/genindex-single.html:2 -#: sphinx/templates/genindex-split.html:2 -#: sphinx/templates/genindex-split.html:5 sphinx/templates/genindex.html:2 -#: sphinx/templates/genindex.html:5 sphinx/templates/genindex.html:48 -#: sphinx/templates/layout.html:130 -msgid "Index" -msgstr "Index" - -#: sphinx/environment.py:292 sphinx/latexwriter.py:174 -msgid "Module Index" -msgstr "Module-index" - -#: sphinx/environment.py:293 sphinx/templates/defindex.html:16 -msgid "Search Page" -msgstr "Zoekpagina" - -#: sphinx/htmlwriter.py:79 sphinx/static/doctools.js:145 -msgid "Permalink to this definition" -msgstr "Permanente link naar deze definitie" - -#: sphinx/htmlwriter.py:399 sphinx/static/doctools.js:139 -msgid "Permalink to this headline" -msgstr "Permanente link naar deze titel" - -#: sphinx/latexwriter.py:172 -msgid "Release" -msgstr "Release" - -#: sphinx/roles.py:53 sphinx/directives/desc.py:537 -#, python-format -msgid "environment variable; %s" -msgstr "Omgevingsvariabele; %s" - -#: sphinx/roles.py:60 -#, python-format -msgid "Python Enhancement Proposals!PEP %s" -msgstr "Python Enhancement Proposals!PEP %s" - -#: sphinx/textwriter.py:166 -#, python-format -msgid "Platform: %s" -msgstr "Platform: %s" - -#: sphinx/textwriter.py:422 -msgid "[image]" -msgstr "[afbeelding]" - -#: sphinx/directives/desc.py:25 -#, python-format -msgid "%s() (built-in function)" -msgstr "%s() (geïntegreerde functie)" - -#: sphinx/directives/desc.py:26 sphinx/directives/desc.py:42 -#: sphinx/directives/desc.py:54 -#, python-format -msgid "%s() (in module %s)" -msgstr "%s() (in module %s)" - -#: sphinx/directives/desc.py:29 -#, python-format -msgid "%s (built-in variable)" -msgstr "%s (geïntegreerde variabele)" - -#: sphinx/directives/desc.py:30 sphinx/directives/desc.py:66 -#, python-format -msgid "%s (in module %s)" -msgstr "%s (in module %s)" - -#: sphinx/directives/desc.py:33 -#, fuzzy, python-format -msgid "%s (built-in class)" -msgstr "%s (geïntegreerde variabele)" - -#: sphinx/directives/desc.py:34 -#, python-format -msgid "%s (class in %s)" -msgstr "%s (klasse in %s)" - -#: sphinx/directives/desc.py:46 -#, python-format -msgid "%s() (%s.%s method)" -msgstr "%s() (%s.%s methode)" - -#: sphinx/directives/desc.py:48 -#, python-format -msgid "%s() (%s method)" -msgstr "%s() (%s methode)" - -#: sphinx/directives/desc.py:58 -#, python-format -msgid "%s() (%s.%s static method)" -msgstr "%s() (%s.%s statische methode)" - -#: sphinx/directives/desc.py:60 -#, python-format -msgid "%s() (%s static method)" -msgstr "%s() (%s statische methode)" - -#: sphinx/directives/desc.py:70 -#, python-format -msgid "%s (%s.%s attribute)" -msgstr "%s (%s.%s attribuut)" - -#: sphinx/directives/desc.py:72 -#, python-format -msgid "%s (%s attribute)" -msgstr "%s (%s attribuut)" - -#: sphinx/directives/desc.py:74 -#, python-format -msgid "%s (C function)" -msgstr "%s (C-functie)" - -#: sphinx/directives/desc.py:76 -#, python-format -msgid "%s (C member)" -msgstr "%s (C member)" - -#: sphinx/directives/desc.py:78 -#, python-format -msgid "%s (C macro)" -msgstr "%s (C-macro)" - -#: sphinx/directives/desc.py:80 -#, python-format -msgid "%s (C type)" -msgstr "%s (C type)" - -#: sphinx/directives/desc.py:82 -#, python-format -msgid "%s (C variable)" -msgstr "%s (C-variabele)" - -#: sphinx/directives/desc.py:100 -msgid "Raises" -msgstr "Veroorzaakt" - -#: sphinx/directives/desc.py:104 -msgid "Variable" -msgstr "Variabele" - -#: sphinx/directives/desc.py:107 -msgid "Returns" -msgstr "Returns" - -#: sphinx/directives/desc.py:116 -msgid "Return type" -msgstr "Return type" - -#: sphinx/directives/desc.py:143 -msgid "Parameters" -msgstr "Parameters" - -#: sphinx/directives/desc.py:423 -#, fuzzy, python-format -msgid "%scommand line option; %s" -msgstr "%scommandolijn optie; %s" - -#: sphinx/directives/other.py:101 -msgid "Platforms: " -msgstr "Platformen: " - -#: sphinx/directives/other.py:106 -#, python-format -msgid "%s (module)" -msgstr "%s (module)" - -#: sphinx/directives/other.py:146 -msgid "Section author: " -msgstr "Auteur van deze sectie: " - -#: sphinx/directives/other.py:148 -msgid "Module author: " -msgstr "Auteur van deze module: " - -#: sphinx/directives/other.py:150 -msgid "Author: " -msgstr "Auteur: " - -#: sphinx/directives/other.py:246 -msgid "See also" -msgstr "Zie ook" - -#: sphinx/ext/todo.py:31 -msgid "Todo" -msgstr "" - -#: sphinx/ext/todo.py:75 -#, python-format -msgid "(The original entry is located in %s, line %d and can be found " -msgstr "" - -#: sphinx/ext/todo.py:81 -msgid "here" -msgstr "" - -#: sphinx/locale/__init__.py:15 -msgid "Attention" -msgstr "Let op!" - -#: sphinx/locale/__init__.py:16 -msgid "Caution" -msgstr "Pas op!" - -#: sphinx/locale/__init__.py:17 -msgid "Danger" -msgstr "Gevaar" - -#: sphinx/locale/__init__.py:18 -msgid "Error" -msgstr "Fout" - -#: sphinx/locale/__init__.py:19 -msgid "Hint" -msgstr "Hint" - -#: sphinx/locale/__init__.py:20 -msgid "Important" -msgstr "Belangrijk" - -#: sphinx/locale/__init__.py:21 -msgid "Note" -msgstr "Notitie" - -#: sphinx/locale/__init__.py:22 -msgid "See Also" -msgstr "Zie Ook" - -#: sphinx/locale/__init__.py:23 -msgid "Tip" -msgstr "Tip" - -#: sphinx/locale/__init__.py:24 -msgid "Warning" -msgstr "Waarschuwing" - -#: sphinx/locale/__init__.py:28 -#, python-format -msgid "New in version %s" -msgstr "Nieuw in versie %s" - -#: sphinx/locale/__init__.py:29 -#, python-format -msgid "Changed in version %s" -msgstr "Veranderd in versie %s" - -#: sphinx/locale/__init__.py:30 -#, python-format -msgid "Deprecated since version %s" -msgstr "Verouderd sinds versie %s" - -#: sphinx/locale/__init__.py:34 -msgid "module" -msgstr "module" - -#: sphinx/locale/__init__.py:35 -msgid "keyword" -msgstr "trefwoord" - -#: sphinx/locale/__init__.py:36 -msgid "operator" -msgstr "operator" - -#: sphinx/locale/__init__.py:37 -msgid "object" -msgstr "object" - -#: sphinx/locale/__init__.py:38 -msgid "exception" -msgstr "foutmelding" - -#: sphinx/locale/__init__.py:39 -msgid "statement" -msgstr "statement" - -#: sphinx/locale/__init__.py:40 -msgid "built-in function" -msgstr "geïntegreerde functie" - -#: sphinx/static/doctools.js:174 -msgid "Hide Search Matches" -msgstr "Zoekresultaten verbergen" - -#: sphinx/static/searchtools.js:274 -msgid "Searching" -msgstr "Zoeken" - -#: sphinx/static/searchtools.js:279 -msgid "Preparing search..." -msgstr "Het zoeken wordt voorbereid" - -#: sphinx/static/searchtools.js:338 -#, fuzzy -msgid "module, in " -msgstr "module" - -#: sphinx/static/searchtools.js:347 -msgid ", in " -msgstr "" - -#: sphinx/static/searchtools.js:447 sphinx/templates/search.html:18 -msgid "Search Results" -msgstr "Zoekresultaten" - -#: sphinx/static/searchtools.js:449 -msgid "" -"Your search did not match any documents. Please make sure that all words " -"are spelled correctly and that you've selected enough categories." -msgstr "" -"Uw zoekopdracht leverde geen resultaten op. Controleer of alle " -"woordencorrect gespeld zijn en dat u genoeg categoriën hebt geselecteerd." - -#: sphinx/static/searchtools.js:451 -#, python-format -msgid "Search finished, found %s page(s) matching the search query." -msgstr "Zoeken voltooid, %s pagina(s) gevonden." - -#: sphinx/templates/defindex.html:2 -msgid "Overview" -msgstr "Overzicht" - -#: sphinx/templates/defindex.html:11 -msgid "Indices and tables:" -msgstr "Indices en tabellen:" - -#: sphinx/templates/defindex.html:14 -msgid "Complete Table of Contents" -msgstr "Volledige inhoudstafel" - -#: sphinx/templates/defindex.html:15 -msgid "lists all sections and subsections" -msgstr "geeft alle secties en subsecties weer" - -#: sphinx/templates/defindex.html:17 -msgid "search this documentation" -msgstr "zoeken in deze documentatie" - -#: sphinx/templates/defindex.html:20 -msgid "quick access to all modules" -msgstr "sneltoegang naar alle modules" - -#: sphinx/templates/defindex.html:22 -msgid "all functions, classes, terms" -msgstr "alle functies, klasses en begrippen" - -#: sphinx/templates/genindex-single.html:5 -#, python-format -msgid "Index – %(key)s" -msgstr "Index – %(key)s" - -#: sphinx/templates/genindex-single.html:44 -#: sphinx/templates/genindex-split.html:14 -#: sphinx/templates/genindex-split.html:27 sphinx/templates/genindex.html:54 -msgid "Full index on one page" -msgstr "Volledige index op een pagina" - -#: sphinx/templates/genindex-split.html:7 -msgid "Index pages by letter" -msgstr "Index pagineerd per letter" - -#: sphinx/templates/genindex-split.html:15 -msgid "can be huge" -msgstr "kan heel groot zijn" - -#: sphinx/templates/layout.html:9 -msgid "Navigation" -msgstr "Navigatie" - -#: sphinx/templates/layout.html:40 -msgid "Table Of Contents" -msgstr "Inhoudstafel" - -#: sphinx/templates/layout.html:46 -msgid "Previous topic" -msgstr "Vorig onderwerp" - -#: sphinx/templates/layout.html:47 -msgid "previous chapter" -msgstr "Vorig hoofdstuk" - -#: sphinx/templates/layout.html:50 -msgid "Next topic" -msgstr "Volgend onderwerp" - -#: sphinx/templates/layout.html:51 -msgid "next chapter" -msgstr "volgend hoofdstuk" - -#: sphinx/templates/layout.html:55 -msgid "This Page" -msgstr "Deze Pagina" - -#: sphinx/templates/layout.html:59 -msgid "Suggest Change" -msgstr "Wijziging Voorstellen" - -#: sphinx/templates/layout.html:60 sphinx/templates/layout.html:62 -msgid "Show Source" -msgstr "Broncode weergeven" - -#: sphinx/templates/layout.html:71 -msgid "Quick search" -msgstr "Snel zoeken" - -#: sphinx/templates/layout.html:71 -msgid "Keyword search" -msgstr "Trefwoord opzoeken" - -#: sphinx/templates/layout.html:73 -msgid "Go" -msgstr "Go" - -#: sphinx/templates/layout.html:78 -msgid "Enter a module, class or function name." -msgstr "Geef de naam van een module, klasse of functie." - -#: sphinx/templates/layout.html:119 -#, python-format -msgid "Search within %(docstitle)s" -msgstr "Zoeken in %(docstitle)s" - -#: sphinx/templates/layout.html:128 -msgid "About these documents" -msgstr "Over deze documenten" - -#: sphinx/templates/layout.html:131 sphinx/templates/search.html:2 -#: sphinx/templates/search.html:5 -msgid "Search" -msgstr "Zoeken" - -#: sphinx/templates/layout.html:133 -msgid "Copyright" -msgstr "Copyright" - -#: sphinx/templates/layout.html:178 -#, python-format -msgid "© Copyright %(copyright)s." -msgstr "© Copyright %(copyright)s." - -#: sphinx/templates/layout.html:180 -#, python-format -msgid "© Copyright %(copyright)s." -msgstr "© Copyright %(copyright)s." - -#: sphinx/templates/layout.html:183 -#, python-format -msgid "Last updated on %(last_updated)s." -msgstr "Laatste aanpassing op %(last_updated)s." - -#: sphinx/templates/layout.html:186 -#, python-format -msgid "" -"Created using Sphinx " -"%(sphinx_version)s." -msgstr "" -"Aangemaakt met Sphinx " -"%(sphinx_version)s." - -#: sphinx/templates/modindex.html:15 -msgid "Most popular modules:" -msgstr "Populairste modules:" - -#: sphinx/templates/modindex.html:24 -msgid "Show modules only available on these platforms" -msgstr "Enkel modules weergeven die op deze platformen beschikbaar zijn" - -#: sphinx/templates/modindex.html:56 -msgid "Deprecated" -msgstr "Verouderd" - -#: sphinx/templates/opensearch.xml:4 -#, python-format -msgid "Search %(docstitle)s" -msgstr "Zoeken %(docstitle)s" - -#: sphinx/templates/page.html:8 -msgid "" -"Note: You requested an out-of-date URL from this server." -" We've tried to redirect you to the new location of this page, but it may" -" not be the right one." -msgstr "" -"Opgelet: U heeft een verouderde URL aangevraagd op deze " -"server. Wij hebben probeerd u door te verwijzen naar de nieuwe locatie " -"van deze pagina, maar dat is misschien niet gelukt." - -#: sphinx/templates/search.html:7 -#, fuzzy -msgid "" -"From here you can search these documents. Enter your search\n" -" words into the box below and click \"search\". Note that the search\n" -" function will automatically search for all of the words. Pages\n" -" containing fewer words won't appear in the result list." -msgstr "" -"Hier kan u de documenten doorzoeken. Geef enkele trefwoorden\n" -" in het veld hieronder en klik \"zoeken\". Merk op dat de zoekfunctie" -"\n" -" steeds naar alle woorden zoekt. Pagina's die minder woorden bevatten" -"\n" -" zullen niet tussen de resultaten verschijnen." - -#: sphinx/templates/search.html:14 -msgid "search" -msgstr "zoeken" - -#: sphinx/templates/search.html:20 -msgid "Your search did not match any results." -msgstr "Uw zoekopdracht leverde geen resultaten op." - -#: sphinx/templates/changes/frameset.html:5 -#: sphinx/templates/changes/versionchanges.html:12 -#, python-format -msgid "Changes in Version %(version)s — %(docstitle)s" -msgstr "Veranderingen in versie %(version)s — %(docstitle)s" - -#: sphinx/templates/changes/rstsource.html:5 -#, python-format -msgid "%(filename)s — %(docstitle)s" -msgstr "%(filename)s — %(docstitle)s" - -#: sphinx/templates/changes/versionchanges.html:17 -#, python-format -msgid "Automatically generated list of changes in version %(version)s" -msgstr "Automatisch genereerde lijst van veranderingen in versie %(version)s" - -#: sphinx/templates/changes/versionchanges.html:18 -msgid "Library changes" -msgstr "Veranderingen in de bibliotheek" - -#: sphinx/templates/changes/versionchanges.html:23 -msgid "C API changes" -msgstr "Veranderingen in de C-API" - -#: sphinx/templates/changes/versionchanges.html:25 -msgid "Other changes" -msgstr "Andere veranderingen" - diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/locale/pl/LC_MESSAGES/sphinx.js --- a/buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/locale/pl/LC_MESSAGES/sphinx.js Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,1 +0,0 @@ -Documentation.addTranslations({"locale": "pl", "plural_expr": "(n==1 ? 0 : n%10>=2 && n%10<=4 && (n%100<10 || n%100>=20) ? 1 : 2)", "messages": {"module, in ": "modu\u0142", "Preparing search...": "Przygotowanie wyszukiwania...", "Your search did not match any documents. Please make sure that all words are spelled correctly and that you've selected enough categories.": "Nie znaleziono \u017cadnych pasuj\u0105cych dokument\u00f3w. Upewnij si\u0119, \u017ce wszystkie s\u0142owa s\u0105 poprawnie wpisane i \u017ce wybra\u0142e\u015b wystarczaj\u0105c\u0105liczb\u0119 kategorii.", "Search finished, found %s page(s) matching the search query.": "Przeszukiwanie zako\u0144czone, znaleziono %s pasuj\u0105cych stron.", ", in ": "", "Permalink to this headline": "Sta\u0142y odno\u015bnik do tego nag\u0142\u00f3wka", "Searching": "Wyszukiwanie", "Permalink to this definition": "Sta\u0142y odno\u015bnik do tej definicji", "Hide Search Matches": "Ukryj wyniki wyszukiwania", "Search Results": "Wyniki wyszukiwania"}}); \ No newline at end of file diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/locale/pl/LC_MESSAGES/sphinx.mo Binary file buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/locale/pl/LC_MESSAGES/sphinx.mo has changed diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/locale/pl/LC_MESSAGES/sphinx.po --- a/buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/locale/pl/LC_MESSAGES/sphinx.po Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,600 +0,0 @@ - -msgid "" -msgstr "" -"Project-Id-Version: Sphinx 0.5\n" -"Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" -"POT-Creation-Date: 2008-08-10 11:43+0000\n" -"PO-Revision-Date: 2008-11-27 18:40+0100\n" -"Last-Translator: Michał Kandulski \n" -"Language-Team: \n" -"Plural-Forms: nplurals=3; plural=(n==1 ? 0 : n%10>=2 && n%10<=4 && " -"(n%100<10 || n%100>=20) ? 1 : 2)\n" -"MIME-Version: 1.0\n" -"Content-Type: text/plain; charset=utf-8\n" -"Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 0.9.4\n" - -#: sphinx/builder.py:408 -#, python-format -msgid "%b %d, %Y" -msgstr "%b %d %Y" - -#: sphinx/builder.py:427 sphinx/templates/defindex.html:21 -msgid "General Index" -msgstr "Indeks ogólny" - -#: sphinx/builder.py:427 -msgid "index" -msgstr "indeks" - -#: sphinx/builder.py:429 sphinx/htmlhelp.py:156 -#: sphinx/templates/defindex.html:19 sphinx/templates/modindex.html:2 -#: sphinx/templates/modindex.html:13 -msgid "Global Module Index" -msgstr "Indeks modułów" - -#: sphinx/builder.py:429 -msgid "modules" -msgstr "moduły" - -#: sphinx/builder.py:466 -msgid "next" -msgstr "dalej" - -#: sphinx/builder.py:473 -msgid "previous" -msgstr "wstecz" - -#: sphinx/builder.py:1054 -msgid " (in " -msgstr "" - -#: sphinx/builder.py:1129 -msgid "Builtins" -msgstr "Wbudowane" - -#: sphinx/builder.py:1131 -msgid "Module level" -msgstr "Poziom modułu" - -#: sphinx/environment.py:102 sphinx/latexwriter.py:169 -#, python-format -msgid "%B %d, %Y" -msgstr "%B %d %Y" - -#: sphinx/environment.py:291 sphinx/latexwriter.py:175 -#: sphinx/templates/genindex-single.html:2 -#: sphinx/templates/genindex-split.html:2 -#: sphinx/templates/genindex-split.html:5 sphinx/templates/genindex.html:2 -#: sphinx/templates/genindex.html:5 sphinx/templates/genindex.html:48 -#: sphinx/templates/layout.html:130 -msgid "Index" -msgstr "Indeks" - -#: sphinx/environment.py:292 sphinx/latexwriter.py:174 -msgid "Module Index" -msgstr "Indeks modułów" - -#: sphinx/environment.py:293 sphinx/templates/defindex.html:16 -msgid "Search Page" -msgstr "Wyszukiwanie" - -#: sphinx/htmlwriter.py:79 sphinx/static/doctools.js:145 -msgid "Permalink to this definition" -msgstr "Stały odnośnik do tej definicji" - -#: sphinx/htmlwriter.py:399 sphinx/static/doctools.js:139 -msgid "Permalink to this headline" -msgstr "Stały odnośnik do tego nagłówka" - -#: sphinx/latexwriter.py:172 -msgid "Release" -msgstr "Wydanie" - -#: sphinx/roles.py:53 sphinx/directives/desc.py:537 -#, python-format -msgid "environment variable; %s" -msgstr "zmienna środowiskowa; %s" - -#: sphinx/roles.py:60 -#, python-format -msgid "Python Enhancement Proposals!PEP %s" -msgstr "Python Enhancement Proposals!PEP %s" - -#: sphinx/textwriter.py:166 -#, python-format -msgid "Platform: %s" -msgstr "Platforma: %s" - -#: sphinx/textwriter.py:422 -msgid "[image]" -msgstr "[obrazek]" - -#: sphinx/directives/desc.py:25 -#, python-format -msgid "%s() (built-in function)" -msgstr "%s() (funkcja wbudowana)" - -#: sphinx/directives/desc.py:26 sphinx/directives/desc.py:42 -#: sphinx/directives/desc.py:54 -#, python-format -msgid "%s() (in module %s)" -msgstr "%s() (w module %s)" - -#: sphinx/directives/desc.py:29 -#, python-format -msgid "%s (built-in variable)" -msgstr "%s (zmienna wbudowana)" - -#: sphinx/directives/desc.py:30 sphinx/directives/desc.py:66 -#, python-format -msgid "%s (in module %s)" -msgstr "%s (w module %s)" - -#: sphinx/directives/desc.py:33 -#, fuzzy, python-format -msgid "%s (built-in class)" -msgstr "%s (zmienna wbudowana)" - -#: sphinx/directives/desc.py:34 -#, python-format -msgid "%s (class in %s)" -msgstr "%s (w klasie %s)" - -#: sphinx/directives/desc.py:46 -#, python-format -msgid "%s() (%s.%s method)" -msgstr "%s() (%s.%s metoda)" - -#: sphinx/directives/desc.py:48 -#, python-format -msgid "%s() (%s method)" -msgstr "%s() (%s metoda)" - -#: sphinx/directives/desc.py:58 -#, python-format -msgid "%s() (%s.%s static method)" -msgstr "%s() (%s.%s statyczna metoda)" - -#: sphinx/directives/desc.py:60 -#, python-format -msgid "%s() (%s static method)" -msgstr "%s() (%s statyczna metoda)" - -#: sphinx/directives/desc.py:70 -#, python-format -msgid "%s (%s.%s attribute)" -msgstr "%s (%s.%s atrybut)" - -#: sphinx/directives/desc.py:72 -#, python-format -msgid "%s (%s attribute)" -msgstr "%s (%s atrybut)" - -#: sphinx/directives/desc.py:74 -#, python-format -msgid "%s (C function)" -msgstr "%s (funkcja C)" - -#: sphinx/directives/desc.py:76 -#, python-format -msgid "%s (C member)" -msgstr "%s (pole C)" - -#: sphinx/directives/desc.py:78 -#, python-format -msgid "%s (C macro)" -msgstr "%s (makro C)" - -#: sphinx/directives/desc.py:80 -#, python-format -msgid "%s (C type)" -msgstr "%s (typ C)" - -#: sphinx/directives/desc.py:82 -#, python-format -msgid "%s (C variable)" -msgstr "%s (zmienna C)" - -#: sphinx/directives/desc.py:100 -msgid "Raises" -msgstr "Wyrzuca" - -#: sphinx/directives/desc.py:104 -msgid "Variable" -msgstr "Zmienna" - -#: sphinx/directives/desc.py:107 -msgid "Returns" -msgstr "Zwraca" - -#: sphinx/directives/desc.py:116 -msgid "Return type" -msgstr "Typ zwracany" - -#: sphinx/directives/desc.py:143 -msgid "Parameters" -msgstr "Parametry" - -#: sphinx/directives/desc.py:423 -#, fuzzy, python-format -msgid "%scommand line option; %s" -msgstr "%sopcja linii komend; %s" - -#: sphinx/directives/other.py:101 -msgid "Platforms: " -msgstr "Platformy: " - -#: sphinx/directives/other.py:106 -#, python-format -msgid "%s (module)" -msgstr "%s (moduł)" - -#: sphinx/directives/other.py:146 -msgid "Section author: " -msgstr "Autor rozdziału: " - -#: sphinx/directives/other.py:148 -msgid "Module author: " -msgstr "Autor modułu: " - -#: sphinx/directives/other.py:150 -msgid "Author: " -msgstr "Autor: " - -#: sphinx/directives/other.py:246 -msgid "See also" -msgstr "Zobacz także" - -#: sphinx/ext/todo.py:31 -msgid "Todo" -msgstr "" - -#: sphinx/ext/todo.py:75 -#, python-format -msgid "(The original entry is located in %s, line %d and can be found " -msgstr "" - -#: sphinx/ext/todo.py:81 -msgid "here" -msgstr "" - -#: sphinx/locale/__init__.py:15 -msgid "Attention" -msgstr "Uwaga" - -#: sphinx/locale/__init__.py:16 -msgid "Caution" -msgstr "Ostrożnie" - -#: sphinx/locale/__init__.py:17 -msgid "Danger" -msgstr "Niebezpieczeństwo" - -#: sphinx/locale/__init__.py:18 -msgid "Error" -msgstr "Błąd" - -#: sphinx/locale/__init__.py:19 -msgid "Hint" -msgstr "Podpowiedź" - -#: sphinx/locale/__init__.py:20 -msgid "Important" -msgstr "Ważne" - -#: sphinx/locale/__init__.py:21 -msgid "Note" -msgstr "Uwaga" - -#: sphinx/locale/__init__.py:22 -msgid "See Also" -msgstr "Zobacz także" - -#: sphinx/locale/__init__.py:23 -msgid "Tip" -msgstr "Wskazówka" - -#: sphinx/locale/__init__.py:24 -msgid "Warning" -msgstr "Ostrzeżenie" - -#: sphinx/locale/__init__.py:28 -#, python-format -msgid "New in version %s" -msgstr "Nowe w wersji %s" - -#: sphinx/locale/__init__.py:29 -#, python-format -msgid "Changed in version %s" -msgstr "Zmienione w wersji %s" - -#: sphinx/locale/__init__.py:30 -#, python-format -msgid "Deprecated since version %s" -msgstr "Niezalecane od wersji %s" - -#: sphinx/locale/__init__.py:34 -msgid "module" -msgstr "moduł" - -#: sphinx/locale/__init__.py:35 -msgid "keyword" -msgstr "słowo kluczowe" - -#: sphinx/locale/__init__.py:36 -msgid "operator" -msgstr "operator" - -#: sphinx/locale/__init__.py:37 -msgid "object" -msgstr "obiekt" - -#: sphinx/locale/__init__.py:38 -msgid "exception" -msgstr "wyjątek" - -#: sphinx/locale/__init__.py:39 -msgid "statement" -msgstr "instrukcja" - -#: sphinx/locale/__init__.py:40 -msgid "built-in function" -msgstr "funkcja wbudowana" - -#: sphinx/static/doctools.js:174 -msgid "Hide Search Matches" -msgstr "Ukryj wyniki wyszukiwania" - -#: sphinx/static/searchtools.js:274 -msgid "Searching" -msgstr "Wyszukiwanie" - -#: sphinx/static/searchtools.js:279 -msgid "Preparing search..." -msgstr "Przygotowanie wyszukiwania..." - -#: sphinx/static/searchtools.js:338 -#, fuzzy -msgid "module, in " -msgstr "moduł" - -#: sphinx/static/searchtools.js:347 -msgid ", in " -msgstr "" - -#: sphinx/static/searchtools.js:447 sphinx/templates/search.html:18 -msgid "Search Results" -msgstr "Wyniki wyszukiwania" - -#: sphinx/static/searchtools.js:449 -msgid "" -"Your search did not match any documents. Please make sure that all words " -"are spelled correctly and that you've selected enough categories." -msgstr "" -"Nie znaleziono żadnych pasujących dokumentów. Upewnij się, że wszystkie " -"słowa są poprawnie wpisane i że wybrałeś wystarczającąliczbę kategorii." - -#: sphinx/static/searchtools.js:451 -#, python-format -msgid "Search finished, found %s page(s) matching the search query." -msgstr "Przeszukiwanie zakończone, znaleziono %s pasujących stron." - -#: sphinx/templates/defindex.html:2 -msgid "Overview" -msgstr "Przegląd" - -#: sphinx/templates/defindex.html:11 -msgid "Indices and tables:" -msgstr "Indeksy i tablice:" - -#: sphinx/templates/defindex.html:14 -msgid "Complete Table of Contents" -msgstr "Kompletny spis treści" - -#: sphinx/templates/defindex.html:15 -msgid "lists all sections and subsections" -msgstr "wymień wszystkie rozdziały i podrozdziały" - -#: sphinx/templates/defindex.html:17 -msgid "search this documentation" -msgstr "wyszukaj w dokumentacji" - -#: sphinx/templates/defindex.html:20 -msgid "quick access to all modules" -msgstr "szybki dostęp do wszystkich modułów" - -#: sphinx/templates/defindex.html:22 -msgid "all functions, classes, terms" -msgstr "wszystkie funkcje, klasy, terminy" - -#: sphinx/templates/genindex-single.html:5 -#, python-format -msgid "Index – %(key)s" -msgstr "Indeks – %(key)s" - -#: sphinx/templates/genindex-single.html:44 -#: sphinx/templates/genindex-split.html:14 -#: sphinx/templates/genindex-split.html:27 sphinx/templates/genindex.html:54 -msgid "Full index on one page" -msgstr "Cały indeks na jednej stronie" - -#: sphinx/templates/genindex-split.html:7 -msgid "Index pages by letter" -msgstr "Strony indeksu alfabetycznie" - -#: sphinx/templates/genindex-split.html:15 -msgid "can be huge" -msgstr "może być ogromny" - -#: sphinx/templates/layout.html:9 -msgid "Navigation" -msgstr "Nawigacja" - -#: sphinx/templates/layout.html:40 -msgid "Table Of Contents" -msgstr "Spis treści" - -#: sphinx/templates/layout.html:46 -msgid "Previous topic" -msgstr "Poprzedni temat" - -#: sphinx/templates/layout.html:47 -msgid "previous chapter" -msgstr "poprzedni rozdział" - -#: sphinx/templates/layout.html:50 -msgid "Next topic" -msgstr "Następny temat" - -#: sphinx/templates/layout.html:51 -msgid "next chapter" -msgstr "następny rozdział" - -#: sphinx/templates/layout.html:55 -msgid "This Page" -msgstr "Ta strona" - -#: sphinx/templates/layout.html:59 -msgid "Suggest Change" -msgstr "Zasugeruj zmianę" - -#: sphinx/templates/layout.html:60 sphinx/templates/layout.html:62 -msgid "Show Source" -msgstr "Pokaż źródło" - -#: sphinx/templates/layout.html:71 -msgid "Quick search" -msgstr "Szybkie wyszukiwanie" - -#: sphinx/templates/layout.html:71 -msgid "Keyword search" -msgstr "Szukanie wg słowa kluczowego" - -#: sphinx/templates/layout.html:73 -msgid "Go" -msgstr "Szukaj" - -#: sphinx/templates/layout.html:78 -msgid "Enter a module, class or function name." -msgstr "Wprowadź nazwę modułu, klasy lub funkcji." - -#: sphinx/templates/layout.html:119 -#, python-format -msgid "Search within %(docstitle)s" -msgstr "Szukaj pośród %(docstitle)s" - -#: sphinx/templates/layout.html:128 -msgid "About these documents" -msgstr "O tych dokumentach" - -#: sphinx/templates/layout.html:131 sphinx/templates/search.html:2 -#: sphinx/templates/search.html:5 -msgid "Search" -msgstr "Szukaj" - -#: sphinx/templates/layout.html:133 -msgid "Copyright" -msgstr "Copyright" - -#: sphinx/templates/layout.html:178 -#, python-format -msgid "© Copyright %(copyright)s." -msgstr "© Copyright %(copyright)s." - -#: sphinx/templates/layout.html:180 -#, python-format -msgid "© Copyright %(copyright)s." -msgstr "© Copyright %(copyright)s." - -#: sphinx/templates/layout.html:183 -#, python-format -msgid "Last updated on %(last_updated)s." -msgstr "Ostatnia modyfikacja %(last_updated)s." - -#: sphinx/templates/layout.html:186 -#, python-format -msgid "" -"Created using Sphinx " -"%(sphinx_version)s." -msgstr "" -"Utworzone przy pomocy Sphinx'a " -"%(sphinx_version)s." - -#: sphinx/templates/modindex.html:15 -msgid "Most popular modules:" -msgstr "Najbardziej popularne moduły:" - -#: sphinx/templates/modindex.html:24 -msgid "Show modules only available on these platforms" -msgstr "Pokaż moduły dostępne tylko na tych platformach" - -#: sphinx/templates/modindex.html:56 -msgid "Deprecated" -msgstr "Niezalecane" - -#: sphinx/templates/opensearch.xml:4 -#, python-format -msgid "Search %(docstitle)s" -msgstr "Przeszukaj %(docstitle)s" - -#: sphinx/templates/page.html:8 -msgid "" -"Note: You requested an out-of-date URL from this server." -" We've tried to redirect you to the new location of this page, but it may" -" not be the right one." -msgstr "" -"Uwaga: Zażądano przedawnionego URL'a z tego serwera. " -"Nastąpiła próba przekierowania do nowej lokalizacji, ale może ona być " -"niewłaściwa." - -#: sphinx/templates/search.html:7 -#, fuzzy -msgid "" -"From here you can search these documents. Enter your search\n" -" words into the box below and click \"search\". Note that the search\n" -" function will automatically search for all of the words. Pages\n" -" containing fewer words won't appear in the result list." -msgstr "" -"Stąd możesz przeszukać dokumentację. Wprowadź szukane\n" -" słowa w poniższym okienku i kliknij \"Szukaj\". Zwróć uwagę, że\n" -" funkcja szukająca będzie automatycznie szukała wszystkich słów. " -"Strony nie zawierające wszystkich słów nie znajdą się na wynikowej " -"liście." - -#: sphinx/templates/search.html:14 -msgid "search" -msgstr "Szukaj" - -#: sphinx/templates/search.html:20 -msgid "Your search did not match any results." -msgstr "Nie znaleziono żadnych pasujących stron." - -#: sphinx/templates/changes/frameset.html:5 -#: sphinx/templates/changes/versionchanges.html:12 -#, python-format -msgid "Changes in Version %(version)s — %(docstitle)s" -msgstr "Zmiany w wesji %(version)s — %(docstitle)s" - -#: sphinx/templates/changes/rstsource.html:5 -#, python-format -msgid "%(filename)s — %(docstitle)s" -msgstr "%(filename)s — %(docstitle)s" - -#: sphinx/templates/changes/versionchanges.html:17 -#, python-format -msgid "Automatically generated list of changes in version %(version)s" -msgstr "Automatycznie wygenerowana lista zmian w wersji %(version)s" - -#: sphinx/templates/changes/versionchanges.html:18 -msgid "Library changes" -msgstr "Zmiany w bibliotekach" - -#: sphinx/templates/changes/versionchanges.html:23 -msgid "C API changes" -msgstr "Zmiany w C API" - -#: sphinx/templates/changes/versionchanges.html:25 -msgid "Other changes" -msgstr "Inne zmiany" - diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/locale/pt_BR/LC_MESSAGES/sphinx.js --- a/buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/locale/pt_BR/LC_MESSAGES/sphinx.js Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,1 +0,0 @@ -Documentation.addTranslations({"locale": "pt_BR", "plural_expr": "(n > 1)", "messages": {"module, in ": "m\u00f3dulo, em ", "Preparing search...": "Preparando pesquisa...", "Your search did not match any documents. Please make sure that all words are spelled correctly and that you've selected enough categories.": "Sua pesquisa n\u00e3o encontrou nenhum documento. Por favor assegure-se de que todas as palavras foram digitadas corretamente e de que voc\u00ea tenha selecionado o m\u00ednimo de categorias.", "Search finished, found %s page(s) matching the search query.": "Pesquisa finalizada, foram encontrada(s) %s p\u00e1gina(s) que conferem com o crit\u00e9rio de pesquisa.", ", in ": ", em ", "Permalink to this headline": "Link permanente para este t\u00edtulo", "Searching": "Pesquisando", "Permalink to this definition": "Link permanente para esta defini\u00e7\u00e3o", "Hide Search Matches": "Esconder Resultados da Pesquisa", "Search Results": "Resultados da Pesquisa"}}); \ No newline at end of file diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/locale/pt_BR/LC_MESSAGES/sphinx.mo Binary file buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/locale/pt_BR/LC_MESSAGES/sphinx.mo has changed diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/locale/pt_BR/LC_MESSAGES/sphinx.po --- a/buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/locale/pt_BR/LC_MESSAGES/sphinx.po Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,606 +0,0 @@ -# Portuguese (Brazil) translations for Sphinx. -# Copyright (C) 2008 ORGANIZATION -# This file is distributed under the same license as the Sphinx project. -# FIRST AUTHOR , 2008. -# -msgid "" -msgstr "" -"Project-Id-Version: Sphinx 0.5\n" -"Report-Msgid-Bugs-To: roger.demetrescu@gmail.com\n" -"POT-Creation-Date: 2008-11-09 19:46+0100\n" -"PO-Revision-Date: 2008-11-27 18:40+0100\n" -"Last-Translator: Roger Demetrescu \n" -"Language-Team: pt_BR \n" -"Plural-Forms: nplurals=2; plural=(n > 1)\n" -"MIME-Version: 1.0\n" -"Content-Type: text/plain; charset=utf-8\n" -"Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 0.9.4\n" - -#: sphinx/builder.py:408 -#, python-format -msgid "%b %d, %Y" -msgstr "%d/%m/%Y" - -#: sphinx/builder.py:427 sphinx/templates/defindex.html:21 -msgid "General Index" -msgstr "Índice Geral" - -#: sphinx/builder.py:427 -msgid "index" -msgstr "índice" - -#: sphinx/builder.py:429 sphinx/htmlhelp.py:156 -#: sphinx/templates/defindex.html:19 sphinx/templates/modindex.html:2 -#: sphinx/templates/modindex.html:13 -msgid "Global Module Index" -msgstr "Índice Global de Módulos" - -#: sphinx/builder.py:429 -msgid "modules" -msgstr "módulos" - -#: sphinx/builder.py:466 -msgid "next" -msgstr "próximo" - -#: sphinx/builder.py:473 -msgid "previous" -msgstr "anterior" - -#: sphinx/builder.py:1054 -msgid " (in " -msgstr " (em " - -#: sphinx/builder.py:1129 -msgid "Builtins" -msgstr "Internos" - -#: sphinx/builder.py:1131 -msgid "Module level" -msgstr "Módulo" - -#: sphinx/environment.py:102 sphinx/latexwriter.py:169 -#, python-format -msgid "%B %d, %Y" -msgstr "%d/%m/%Y" - -#: sphinx/environment.py:291 sphinx/latexwriter.py:175 -#: sphinx/templates/genindex-single.html:2 -#: sphinx/templates/genindex-split.html:2 -#: sphinx/templates/genindex-split.html:5 sphinx/templates/genindex.html:2 -#: sphinx/templates/genindex.html:5 sphinx/templates/genindex.html:48 -#: sphinx/templates/layout.html:130 -msgid "Index" -msgstr "Índice" - -#: sphinx/environment.py:292 sphinx/latexwriter.py:174 -msgid "Module Index" -msgstr "Índice do Módulo" - -#: sphinx/environment.py:293 sphinx/templates/defindex.html:16 -msgid "Search Page" -msgstr "Página de Pesquisa" - -#: sphinx/htmlwriter.py:79 sphinx/static/doctools.js:145 -msgid "Permalink to this definition" -msgstr "Link permanente para esta definição" - -#: sphinx/htmlwriter.py:399 sphinx/static/doctools.js:139 -msgid "Permalink to this headline" -msgstr "Link permanente para este título" - -#: sphinx/latexwriter.py:172 -msgid "Release" -msgstr "Versão" - -#: sphinx/roles.py:53 sphinx/directives/desc.py:537 -#, python-format -msgid "environment variable; %s" -msgstr "váriavel de ambiente; %s" - -#: sphinx/roles.py:60 -#, python-format -msgid "Python Enhancement Proposals!PEP %s" -msgstr "Python Enhancement Proposals!PEP %s" - -#: sphinx/textwriter.py:166 -#, python-format -msgid "Platform: %s" -msgstr "Plataforma: %s" - -#: sphinx/textwriter.py:422 -msgid "[image]" -msgstr "[imagem]" - -#: sphinx/directives/desc.py:25 -#, python-format -msgid "%s() (built-in function)" -msgstr "%s() (função interna)" - -#: sphinx/directives/desc.py:26 sphinx/directives/desc.py:42 -#: sphinx/directives/desc.py:54 -#, python-format -msgid "%s() (in module %s)" -msgstr "%s() (no módulo %s)" - -#: sphinx/directives/desc.py:29 -#, python-format -msgid "%s (built-in variable)" -msgstr "%s (variável interna)" - -#: sphinx/directives/desc.py:30 sphinx/directives/desc.py:66 -#, python-format -msgid "%s (in module %s)" -msgstr "%s (no módulo %s)" - -#: sphinx/directives/desc.py:33 -#, python-format -msgid "%s (built-in class)" -msgstr "%s (classe interna)" - -#: sphinx/directives/desc.py:34 -#, python-format -msgid "%s (class in %s)" -msgstr "%s (classe em %s)" - -#: sphinx/directives/desc.py:46 -#, python-format -msgid "%s() (%s.%s method)" -msgstr "%s() (método %s.%s)" - -#: sphinx/directives/desc.py:48 -#, python-format -msgid "%s() (%s method)" -msgstr "%s() (método %s)" - -#: sphinx/directives/desc.py:58 -#, python-format -msgid "%s() (%s.%s static method)" -msgstr "%s() (método estático %s.%s)" - -#: sphinx/directives/desc.py:60 -#, python-format -msgid "%s() (%s static method)" -msgstr "%s() (método estático %s)" - -#: sphinx/directives/desc.py:70 -#, python-format -msgid "%s (%s.%s attribute)" -msgstr "%s (atributo %s.%s)" - -#: sphinx/directives/desc.py:72 -#, python-format -msgid "%s (%s attribute)" -msgstr "%s (atributo %s)" - -#: sphinx/directives/desc.py:74 -#, python-format -msgid "%s (C function)" -msgstr "%s (função C)" - -#: sphinx/directives/desc.py:76 -#, python-format -msgid "%s (C member)" -msgstr "%s (membro C)" - -#: sphinx/directives/desc.py:78 -#, python-format -msgid "%s (C macro)" -msgstr "%s (macro C)" - -#: sphinx/directives/desc.py:80 -#, python-format -msgid "%s (C type)" -msgstr "%s (tipo C)" - -#: sphinx/directives/desc.py:82 -#, python-format -msgid "%s (C variable)" -msgstr "%s (variável C)" - -#: sphinx/directives/desc.py:100 -msgid "Raises" -msgstr "Levanta" - -#: sphinx/directives/desc.py:104 -msgid "Variable" -msgstr "Variável" - -#: sphinx/directives/desc.py:107 -msgid "Returns" -msgstr "Retorna" - -#: sphinx/directives/desc.py:116 -msgid "Return type" -msgstr "Tipo de retorno" - -#: sphinx/directives/desc.py:143 -msgid "Parameters" -msgstr "Parâmetros" - -#: sphinx/directives/desc.py:423 -#, python-format -msgid "%scommand line option; %s" -msgstr "%sopção de linha de comando; %s" - -#: sphinx/directives/other.py:101 -msgid "Platforms: " -msgstr "Plataformas: " - -#: sphinx/directives/other.py:106 -#, python-format -msgid "%s (module)" -msgstr "%s (módulo)" - -#: sphinx/directives/other.py:146 -msgid "Section author: " -msgstr "Autor da seção: " - -#: sphinx/directives/other.py:148 -msgid "Module author: " -msgstr "Autor do módulo: " - -#: sphinx/directives/other.py:150 -msgid "Author: " -msgstr "Autor: " - -#: sphinx/directives/other.py:246 -msgid "See also" -msgstr "Veja também" - -#: sphinx/ext/todo.py:31 -msgid "Todo" -msgstr "Por fazer" - -#: sphinx/ext/todo.py:75 -#, python-format -msgid "(The original entry is located in %s, line %d and can be found " -msgstr "(A entrada original está localizada em %s, linha %d e pode ser encontrada " - -#: sphinx/ext/todo.py:81 -msgid "here" -msgstr "aqui" - -#: sphinx/locale/__init__.py:15 -msgid "Attention" -msgstr "Atenção" - -#: sphinx/locale/__init__.py:16 -msgid "Caution" -msgstr "Cuidado" - -#: sphinx/locale/__init__.py:17 -msgid "Danger" -msgstr "Perigo" - -#: sphinx/locale/__init__.py:18 -msgid "Error" -msgstr "Erro" - -#: sphinx/locale/__init__.py:19 -msgid "Hint" -msgstr "Dica" - -#: sphinx/locale/__init__.py:20 -msgid "Important" -msgstr "Importante" - -#: sphinx/locale/__init__.py:21 -msgid "Note" -msgstr "Nota" - -#: sphinx/locale/__init__.py:22 -msgid "See Also" -msgstr "Veja Também" - -#: sphinx/locale/__init__.py:23 -msgid "Tip" -msgstr "Dica" - -#: sphinx/locale/__init__.py:24 -msgid "Warning" -msgstr "Aviso" - -#: sphinx/locale/__init__.py:28 -#, python-format -msgid "New in version %s" -msgstr "Novo na versão %s" - -#: sphinx/locale/__init__.py:29 -#, python-format -msgid "Changed in version %s" -msgstr "Alterado na versão %s" - -#: sphinx/locale/__init__.py:30 -#, python-format -msgid "Deprecated since version %s" -msgstr "Obsoleto desde a versão %s" - -#: sphinx/locale/__init__.py:34 -msgid "module" -msgstr "módulo" - -#: sphinx/locale/__init__.py:35 -msgid "keyword" -msgstr "palavra-chave" - -#: sphinx/locale/__init__.py:36 -msgid "operator" -msgstr "operador" - -#: sphinx/locale/__init__.py:37 -msgid "object" -msgstr "objeto" - -#: sphinx/locale/__init__.py:38 -msgid "exception" -msgstr "exceção" - -#: sphinx/locale/__init__.py:39 -msgid "statement" -msgstr "comando" - -#: sphinx/locale/__init__.py:40 -msgid "built-in function" -msgstr "função interna" - -#: sphinx/static/doctools.js:174 -msgid "Hide Search Matches" -msgstr "Esconder Resultados da Pesquisa" - -#: sphinx/static/searchtools.js:274 -msgid "Searching" -msgstr "Pesquisando" - -#: sphinx/static/searchtools.js:279 -msgid "Preparing search..." -msgstr "Preparando pesquisa..." - -#: sphinx/static/searchtools.js:338 -msgid "module, in " -msgstr "módulo, em " - -#: sphinx/static/searchtools.js:347 -msgid ", in " -msgstr ", em " - -#: sphinx/static/searchtools.js:447 sphinx/templates/search.html:18 -msgid "Search Results" -msgstr "Resultados da Pesquisa" - -#: sphinx/static/searchtools.js:449 -msgid "" -"Your search did not match any documents. Please make sure that all words " -"are spelled correctly and that you've selected enough categories." -msgstr "" -"Sua pesquisa não encontrou nenhum documento. Por favor assegure-se de que" -" todas as palavras foram digitadas corretamente e de que você tenha " -"selecionado o mínimo de categorias." - -#: sphinx/static/searchtools.js:451 -#, python-format -msgid "Search finished, found %s page(s) matching the search query." -msgstr "" -"Pesquisa finalizada, foram encontrada(s) %s página(s) que conferem com o " -"critério de pesquisa." - -#: sphinx/templates/defindex.html:2 -msgid "Overview" -msgstr "Visão geral" - -#: sphinx/templates/defindex.html:11 -msgid "Indices and tables:" -msgstr "Índices e tabelas:" - -#: sphinx/templates/defindex.html:14 -msgid "Complete Table of Contents" -msgstr "Tabela de Conteúdo Completa" - -#: sphinx/templates/defindex.html:15 -msgid "lists all sections and subsections" -msgstr "Lista todas seções e subseções" - -#: sphinx/templates/defindex.html:17 -msgid "search this documentation" -msgstr "Pesquisar esta documentação" - -#: sphinx/templates/defindex.html:20 -msgid "quick access to all modules" -msgstr "acesso rápido para todos os módulos" - -#: sphinx/templates/defindex.html:22 -msgid "all functions, classes, terms" -msgstr "todas funções, classes, termos" - -#: sphinx/templates/genindex-single.html:5 -#, python-format -msgid "Index – %(key)s" -msgstr "Índice – %(key)s" - -#: sphinx/templates/genindex-single.html:44 -#: sphinx/templates/genindex-split.html:14 -#: sphinx/templates/genindex-split.html:27 sphinx/templates/genindex.html:54 -msgid "Full index on one page" -msgstr "Índice completo em uma página" - -#: sphinx/templates/genindex-split.html:7 -msgid "Index pages by letter" -msgstr "Paginas de índice por letra" - -#: sphinx/templates/genindex-split.html:15 -msgid "can be huge" -msgstr "pode ser enorme" - -#: sphinx/templates/layout.html:9 -msgid "Navigation" -msgstr "Navegação" - -#: sphinx/templates/layout.html:40 -msgid "Table Of Contents" -msgstr "Tabela de Conteúdo" - -#: sphinx/templates/layout.html:46 -msgid "Previous topic" -msgstr "Tópico anterior" - -#: sphinx/templates/layout.html:47 -msgid "previous chapter" -msgstr "capítulo anterior" - -#: sphinx/templates/layout.html:50 -msgid "Next topic" -msgstr "Próximo tópico" - -#: sphinx/templates/layout.html:51 -msgid "next chapter" -msgstr "próximo capítulo" - -#: sphinx/templates/layout.html:55 -msgid "This Page" -msgstr "Esta Página" - -#: sphinx/templates/layout.html:59 -msgid "Suggest Change" -msgstr "Sugerir Alteração" - -#: sphinx/templates/layout.html:60 sphinx/templates/layout.html:62 -msgid "Show Source" -msgstr "Exibir Fonte" - -#: sphinx/templates/layout.html:71 -msgid "Quick search" -msgstr "Pesquisa rápida" - -#: sphinx/templates/layout.html:71 -msgid "Keyword search" -msgstr "Pesquisa de palavras-chave" - -#: sphinx/templates/layout.html:73 -msgid "Go" -msgstr "Ir" - -#: sphinx/templates/layout.html:78 -msgid "Enter a module, class or function name." -msgstr "Informe o nome de um módulo, classe ou função." - -#: sphinx/templates/layout.html:119 -#, python-format -msgid "Search within %(docstitle)s" -msgstr "Pesquisar dentro de %(docstitle)s" - -#: sphinx/templates/layout.html:128 -msgid "About these documents" -msgstr "Sobre estes documentos" - -#: sphinx/templates/layout.html:131 sphinx/templates/search.html:2 -#: sphinx/templates/search.html:5 -msgid "Search" -msgstr "Pesquisar" - -#: sphinx/templates/layout.html:133 -msgid "Copyright" -msgstr "Copyright" - -#: sphinx/templates/layout.html:178 -#, python-format -msgid "© Copyright %(copyright)s." -msgstr "© Copyright %(copyright)s." - -#: sphinx/templates/layout.html:180 -#, python-format -msgid "© Copyright %(copyright)s." -msgstr "© Copyright %(copyright)s." - -#: sphinx/templates/layout.html:183 -#, python-format -msgid "Last updated on %(last_updated)s." -msgstr "Última atualização em %(last_updated)s." - -#: sphinx/templates/layout.html:186 -#, python-format -msgid "" -"Created using Sphinx " -"%(sphinx_version)s." -msgstr "" -"Criado com Sphinx " -"%(sphinx_version)s." - -#: sphinx/templates/modindex.html:15 -msgid "Most popular modules:" -msgstr "Módulos mais populares:" - -#: sphinx/templates/modindex.html:24 -msgid "Show modules only available on these platforms" -msgstr "Exibir somente módulos disponíveis nestas plataformas" - -#: sphinx/templates/modindex.html:56 -msgid "Deprecated" -msgstr "Obsoleto" - -#: sphinx/templates/opensearch.xml:4 -#, python-format -msgid "Search %(docstitle)s" -msgstr "Pesquisar em %(docstitle)s" - -#: sphinx/templates/page.html:8 -msgid "" -"Note: You requested an out-of-date URL from this server." -" We've tried to redirect you to the new location of this page, but it may" -" not be the right one." -msgstr "" -"Nota: Você requisitou uma URL desatualizada deste " -"servidor. Tentamos redirecioná-lo para um novo endereço desta página, " -"porém é possível que o mesmo não seja o correto." - -#: sphinx/templates/search.html:7 -#, fuzzy -msgid "" -"From here you can search these documents. Enter your search\n" -" words into the box below and click \"search\". Note that the search\n" -" function will automatically search for all of the words. Pages\n" -" containing fewer words won't appear in the result list." -msgstr "" -"A partir daqui você pode pesquisar estes documentos. Preencha suas \n" -" palavras de pesquisa na caixa abaixo e clique em \"pesquisar\". " -"Observe que a função de pesquisa\n" -" irá pesquisar automaticamente por todas as palavras.\n" -" Páginas contendo menos palavras não irão aparecer na lista de " -"resultado." - -#: sphinx/templates/search.html:14 -msgid "search" -msgstr "pesquisar" - -#: sphinx/templates/search.html:20 -msgid "Your search did not match any results." -msgstr "Sua pesquisa não encontrou nenhum resultado." - -#: sphinx/templates/changes/frameset.html:5 -#: sphinx/templates/changes/versionchanges.html:12 -#, python-format -msgid "Changes in Version %(version)s — %(docstitle)s" -msgstr "Alterações na Versão%(version)s — %(docstitle)s" - -#: sphinx/templates/changes/rstsource.html:5 -#, python-format -msgid "%(filename)s — %(docstitle)s" -msgstr "%(filename)s — %(docstitle)s" - -#: sphinx/templates/changes/versionchanges.html:17 -#, python-format -msgid "Automatically generated list of changes in version %(version)s" -msgstr "Lista de alterações na versão %(version)s gerada automaticamente" - -#: sphinx/templates/changes/versionchanges.html:18 -msgid "Library changes" -msgstr "Alterações na biblioteca" - -#: sphinx/templates/changes/versionchanges.html:23 -msgid "C API changes" -msgstr "Alterações na API C" - -#: sphinx/templates/changes/versionchanges.html:25 -msgid "Other changes" -msgstr "Outras alterações" - diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/locale/sl/LC_MESSAGES/sphinx.js --- a/buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/locale/sl/LC_MESSAGES/sphinx.js Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,1 +0,0 @@ -Documentation.addTranslations({"locale": "sl", "plural_expr": "0", "messages": {"module, in ": "modul, v ", "Preparing search...": "Pripravljam iskanje...", "Your search did not match any documents. Please make sure that all words are spelled correctly and that you've selected enough categories.": "Za va\u0161e iskanje ni rezultatov. Prosimo preglejte ali so vse besede pravilno \u010drkovane in ali ste izbrali dovolj kategorij.", "Search finished, found %s page(s) matching the search query.": "Iskanje kon\u010dano, najdeno %s strani, ki ustrezajo iskalnemu nizu.", ", in ": ", v ", "Permalink to this headline": "Povezava na naslov", "Searching": "I\u0161\u010dem", "Permalink to this definition": "Povezava na to definicijo", "Hide Search Matches": "Skrij Resultate Iskanja", "Search Results": "Rezultati Iskanja"}}); \ No newline at end of file diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/locale/sl/LC_MESSAGES/sphinx.mo Binary file buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/locale/sl/LC_MESSAGES/sphinx.mo has changed diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/locale/sl/LC_MESSAGES/sphinx.po --- a/buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/locale/sl/LC_MESSAGES/sphinx.po Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,597 +0,0 @@ - -msgid "" -msgstr "" -"Project-Id-Version: Sphinx\n" -"Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" -"POT-Creation-Date: 2008-09-11 23:58+0200\n" -"PO-Revision-Date: 2008-11-27 18:40+0100\n" -"Last-Translator: Rok Garbas \n" -"Language-Team: Rok Garbas \n" -"Plural-Forms: nplurals=1; plural=0\n" -"MIME-Version: 1.0\n" -"Content-Type: text/plain; charset=utf-8\n" -"Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 0.9.4\n" - -#: sphinx/builder.py:408 -#, python-format -msgid "%b %d, %Y" -msgstr "%d %b, %Y" - -#: sphinx/builder.py:427 sphinx/templates/defindex.html:21 -msgid "General Index" -msgstr "Splošni abecedni seznam" - -#: sphinx/builder.py:427 -msgid "index" -msgstr "abecedni seznam" - -#: sphinx/builder.py:429 sphinx/htmlhelp.py:156 -#: sphinx/templates/defindex.html:19 sphinx/templates/modindex.html:2 -#: sphinx/templates/modindex.html:13 -msgid "Global Module Index" -msgstr "Splošen Seznam Modulov" - -#: sphinx/builder.py:429 -msgid "modules" -msgstr "Moduli" - -#: sphinx/builder.py:466 -msgid "next" -msgstr "naprej" - -#: sphinx/builder.py:473 -msgid "previous" -msgstr "nazaj" - -#: sphinx/builder.py:1054 -msgid " (in " -msgstr "(v " - -#: sphinx/builder.py:1129 -msgid "Builtins" -msgstr "Vgrajeni deli" - -#: sphinx/builder.py:1131 -msgid "Module level" -msgstr "Nivo modula" - -#: sphinx/environment.py:102 sphinx/latexwriter.py:169 -#, python-format -msgid "%B %d, %Y" -msgstr "%d %B, %Y" - -#: sphinx/environment.py:291 sphinx/latexwriter.py:175 -#: sphinx/templates/genindex-single.html:2 -#: sphinx/templates/genindex-split.html:2 -#: sphinx/templates/genindex-split.html:5 sphinx/templates/genindex.html:2 -#: sphinx/templates/genindex.html:5 sphinx/templates/genindex.html:48 -#: sphinx/templates/layout.html:130 -msgid "Index" -msgstr "Abecedni seznam" - -#: sphinx/environment.py:292 sphinx/latexwriter.py:174 -msgid "Module Index" -msgstr "Seznam modulov" - -#: sphinx/environment.py:293 sphinx/templates/defindex.html:16 -msgid "Search Page" -msgstr "Iskalna stran" - -#: sphinx/htmlwriter.py:79 sphinx/static/doctools.js:145 -msgid "Permalink to this definition" -msgstr "Povezava na to definicijo" - -#: sphinx/htmlwriter.py:399 sphinx/static/doctools.js:139 -msgid "Permalink to this headline" -msgstr "Povezava na naslov" - -#: sphinx/latexwriter.py:172 -msgid "Release" -msgstr "Izdaja" - -#: sphinx/roles.py:53 sphinx/directives/desc.py:537 -#, python-format -msgid "environment variable; %s" -msgstr "globalna spremenljivka; %s" - -#: sphinx/roles.py:60 -#, python-format -msgid "Python Enhancement Proposals!PEP %s" -msgstr "Python Enhancement Proposals!PEP %s" - -#: sphinx/textwriter.py:166 -#, python-format -msgid "Platform: %s" -msgstr "Platforma: %s" - -#: sphinx/textwriter.py:422 -msgid "[image]" -msgstr "[slika]" - -#: sphinx/directives/desc.py:25 -#, python-format -msgid "%s() (built-in function)" -msgstr "%s() (vgrajene funkcije)" - -#: sphinx/directives/desc.py:26 sphinx/directives/desc.py:42 -#: sphinx/directives/desc.py:54 -#, python-format -msgid "%s() (in module %s)" -msgstr "%s() (v modulu %s)" - -#: sphinx/directives/desc.py:29 -#, python-format -msgid "%s (built-in variable)" -msgstr "%s (vgrajene spremenljivke)" - -#: sphinx/directives/desc.py:30 sphinx/directives/desc.py:66 -#, python-format -msgid "%s (in module %s)" -msgstr "%s (v modulu %s)" - -#: sphinx/directives/desc.py:33 -#, python-format -msgid "%s (built-in class)" -msgstr "%s (vgrajen razred)" - -#: sphinx/directives/desc.py:34 -#, python-format -msgid "%s (class in %s)" -msgstr "%s (razred v %s)" - -#: sphinx/directives/desc.py:46 -#, python-format -msgid "%s() (%s.%s method)" -msgstr "%s() (%s.%s metoda)" - -#: sphinx/directives/desc.py:48 -#, python-format -msgid "%s() (%s method)" -msgstr "%s() (%s metoda)" - -#: sphinx/directives/desc.py:58 -#, python-format -msgid "%s() (%s.%s static method)" -msgstr "%s() (%s.%s statična metoda)" - -#: sphinx/directives/desc.py:60 -#, python-format -msgid "%s() (%s static method)" -msgstr "%s() (%s statična metoda)" - -#: sphinx/directives/desc.py:70 -#, python-format -msgid "%s (%s.%s attribute)" -msgstr "%s (%s.%s atribut)" - -#: sphinx/directives/desc.py:72 -#, python-format -msgid "%s (%s attribute)" -msgstr "%s (%s atribut)" - -#: sphinx/directives/desc.py:74 -#, python-format -msgid "%s (C function)" -msgstr "%s (C funkcija)" - -#: sphinx/directives/desc.py:76 -#, python-format -msgid "%s (C member)" -msgstr "%s (C član)" - -#: sphinx/directives/desc.py:78 -#, python-format -msgid "%s (C macro)" -msgstr "%s (C makro)" - -#: sphinx/directives/desc.py:80 -#, python-format -msgid "%s (C type)" -msgstr "%s (C tip)" - -#: sphinx/directives/desc.py:82 -#, python-format -msgid "%s (C variable)" -msgstr "%s (C spremenljivka)" - -#: sphinx/directives/desc.py:100 -msgid "Raises" -msgstr "Javi" - -#: sphinx/directives/desc.py:104 -msgid "Variable" -msgstr "Spremenljivka" - -#: sphinx/directives/desc.py:107 -msgid "Returns" -msgstr "Vrne" - -#: sphinx/directives/desc.py:116 -msgid "Return type" -msgstr "Vrne tip" - -#: sphinx/directives/desc.py:143 -msgid "Parameters" -msgstr "Parametri" - -#: sphinx/directives/desc.py:423 -#, python-format -msgid "%scommand line option; %s" -msgstr "%sopcija komandne linije; %s" - -#: sphinx/directives/other.py:101 -msgid "Platforms: " -msgstr "Platforma:" - -#: sphinx/directives/other.py:106 -#, python-format -msgid "%s (module)" -msgstr "%s (modul)" - -#: sphinx/directives/other.py:146 -msgid "Section author: " -msgstr "Avtor sekcije:" - -#: sphinx/directives/other.py:148 -msgid "Module author: " -msgstr "Avtor modula:" - -#: sphinx/directives/other.py:150 -msgid "Author: " -msgstr "Avtor:" - -#: sphinx/directives/other.py:246 -msgid "See also" -msgstr "Poglej tudi" - -#: sphinx/ext/todo.py:31 -msgid "Todo" -msgstr "Naredi" - -#: sphinx/ext/todo.py:75 -#, python-format -msgid "(The original entry is located in %s, line %d and can be found " -msgstr "(Originalen vnos se nahajana v %s, vrstica %d in jo je moč poiskati " - -#: sphinx/ext/todo.py:81 -msgid "here" -msgstr "tukaj" - -#: sphinx/locale/__init__.py:15 -msgid "Attention" -msgstr "Pozor" - -#: sphinx/locale/__init__.py:16 -msgid "Caution" -msgstr "Previdno" - -#: sphinx/locale/__init__.py:17 -msgid "Danger" -msgstr "Navarno" - -#: sphinx/locale/__init__.py:18 -msgid "Error" -msgstr "Napaka" - -#: sphinx/locale/__init__.py:19 -msgid "Hint" -msgstr "Nasvet" - -#: sphinx/locale/__init__.py:20 -msgid "Important" -msgstr "Pomembno" - -#: sphinx/locale/__init__.py:21 -msgid "Note" -msgstr "Opomba" - -#: sphinx/locale/__init__.py:22 -msgid "See Also" -msgstr "Poglej Tudi" - -#: sphinx/locale/__init__.py:23 -msgid "Tip" -msgstr "Nasvet" - -#: sphinx/locale/__init__.py:24 -msgid "Warning" -msgstr "Opozorilo" - -#: sphinx/locale/__init__.py:28 -#, python-format -msgid "New in version %s" -msgstr "Novo v verziji %s" - -#: sphinx/locale/__init__.py:29 -#, python-format -msgid "Changed in version %s" -msgstr "Spemenjeno v verziji %s" - -#: sphinx/locale/__init__.py:30 -#, python-format -msgid "Deprecated since version %s" -msgstr "Zastarelo od verzije %s" - -#: sphinx/locale/__init__.py:34 -msgid "module" -msgstr "modul" - -#: sphinx/locale/__init__.py:35 -msgid "keyword" -msgstr "kllučna beseda" - -#: sphinx/locale/__init__.py:36 -msgid "operator" -msgstr "operator" - -#: sphinx/locale/__init__.py:37 -msgid "object" -msgstr "objekt" - -#: sphinx/locale/__init__.py:38 -msgid "exception" -msgstr "izjema" - -#: sphinx/locale/__init__.py:39 -msgid "statement" -msgstr "izjava" - -#: sphinx/locale/__init__.py:40 -msgid "built-in function" -msgstr "vgrajene funkcije" - -#: sphinx/static/doctools.js:174 -msgid "Hide Search Matches" -msgstr "Skrij Resultate Iskanja" - -#: sphinx/static/searchtools.js:274 -msgid "Searching" -msgstr "Iščem" - -#: sphinx/static/searchtools.js:279 -msgid "Preparing search..." -msgstr "Pripravljam iskanje..." - -#: sphinx/static/searchtools.js:338 -msgid "module, in " -msgstr "modul, v " - -#: sphinx/static/searchtools.js:347 -msgid ", in " -msgstr ", v " - -#: sphinx/static/searchtools.js:447 sphinx/templates/search.html:18 -msgid "Search Results" -msgstr "Rezultati Iskanja" - -#: sphinx/static/searchtools.js:449 -msgid "" -"Your search did not match any documents. Please make sure that all words " -"are spelled correctly and that you've selected enough categories." -msgstr "" -"Za vaše iskanje ni rezultatov. Prosimo preglejte ali so vse besede " -"pravilno črkovane in ali ste izbrali dovolj kategorij." - -#: sphinx/static/searchtools.js:451 -#, python-format -msgid "Search finished, found %s page(s) matching the search query." -msgstr "Iskanje končano, najdeno %s strani, ki ustrezajo iskalnemu nizu." - -#: sphinx/templates/defindex.html:2 -msgid "Overview" -msgstr "Pregled" - -#: sphinx/templates/defindex.html:11 -msgid "Indices and tables:" -msgstr "Kazalo in tabele:" - -#: sphinx/templates/defindex.html:14 -msgid "Complete Table of Contents" -msgstr "Popoln Seznam Vsebine" - -#: sphinx/templates/defindex.html:15 -msgid "lists all sections and subsections" -msgstr "prikazi vse sekcije in podsekcije" - -#: sphinx/templates/defindex.html:17 -msgid "search this documentation" -msgstr "isči po dokumentaciji" - -#: sphinx/templates/defindex.html:20 -msgid "quick access to all modules" -msgstr "hiter dostop do vseh modulov" - -#: sphinx/templates/defindex.html:22 -msgid "all functions, classes, terms" -msgstr "vse funkcije, rezredi, termini" - -#: sphinx/templates/genindex-single.html:5 -#, python-format -msgid "Index – %(key)s" -msgstr "Seznam – %(key)s" - -#: sphinx/templates/genindex-single.html:44 -#: sphinx/templates/genindex-split.html:14 -#: sphinx/templates/genindex-split.html:27 sphinx/templates/genindex.html:54 -msgid "Full index on one page" -msgstr "Poln indeks na eni strani" - -#: sphinx/templates/genindex-split.html:7 -msgid "Index pages by letter" -msgstr "Indeksiraj strani po črki" - -#: sphinx/templates/genindex-split.html:15 -msgid "can be huge" -msgstr "lahko je veliko" - -#: sphinx/templates/layout.html:9 -msgid "Navigation" -msgstr "Navigacija" - -#: sphinx/templates/layout.html:40 -msgid "Table Of Contents" -msgstr "Seznam Vsebine" - -#: sphinx/templates/layout.html:46 -msgid "Previous topic" -msgstr "Prejšnja tema" - -#: sphinx/templates/layout.html:47 -msgid "previous chapter" -msgstr "prejšnje poglavje" - -#: sphinx/templates/layout.html:50 -msgid "Next topic" -msgstr "Naslednja tema" - -#: sphinx/templates/layout.html:51 -msgid "next chapter" -msgstr "naslednje poglavje" - -#: sphinx/templates/layout.html:55 -msgid "This Page" -msgstr "Ta stran" - -#: sphinx/templates/layout.html:59 -msgid "Suggest Change" -msgstr "Predlagaj spremembo" - -#: sphinx/templates/layout.html:60 sphinx/templates/layout.html:62 -msgid "Show Source" -msgstr "Prikaži izvorno kodo" - -#: sphinx/templates/layout.html:71 -msgid "Quick search" -msgstr "Hitro iskanje" - -#: sphinx/templates/layout.html:71 -msgid "Keyword search" -msgstr "Iskanje po ključniih besedah" - -#: sphinx/templates/layout.html:73 -msgid "Go" -msgstr "Potrdi" - -#: sphinx/templates/layout.html:78 -msgid "Enter a module, class or function name." -msgstr "Vnesi ime mudla, razreda ali funkcije." - -#: sphinx/templates/layout.html:119 -#, python-format -msgid "Search within %(docstitle)s" -msgstr "Išči med %(docstitle)s" - -#: sphinx/templates/layout.html:128 -msgid "About these documents" -msgstr "O teh dokumentih" - -#: sphinx/templates/layout.html:131 sphinx/templates/search.html:2 -#: sphinx/templates/search.html:5 -msgid "Search" -msgstr "Išči" - -#: sphinx/templates/layout.html:133 -msgid "Copyright" -msgstr "Vse pravice pridržane" - -#: sphinx/templates/layout.html:178 -#, python-format -msgid "© Copyright %(copyright)s." -msgstr "© Vse pravice pridržane %(copyright)s." - -#: sphinx/templates/layout.html:180 -#, python-format -msgid "© Copyright %(copyright)s." -msgstr "© Vse pravice pridržane %(copyright)s." - -#: sphinx/templates/layout.html:183 -#, python-format -msgid "Last updated on %(last_updated)s." -msgstr "Zadnjič posodobljeno na %(last_updated)s." - -#: sphinx/templates/layout.html:186 -#, python-format -msgid "" -"Created using Sphinx " -"%(sphinx_version)s." -msgstr "" -"Narejeno s Sphinx " -"%(sphinx_version)s." - -#: sphinx/templates/modindex.html:15 -msgid "Most popular modules:" -msgstr "Najbolj popularni moduli:" - -#: sphinx/templates/modindex.html:24 -msgid "Show modules only available on these platforms" -msgstr "Prikaži module na razpolago na platformah" - -#: sphinx/templates/modindex.html:56 -msgid "Deprecated" -msgstr "Zastarelo" - -#: sphinx/templates/opensearch.xml:4 -#, python-format -msgid "Search %(docstitle)s" -msgstr "Išči %(docstitle)s" - -#: sphinx/templates/page.html:8 -msgid "" -"Note: You requested an out-of-date URL from this server." -" We've tried to redirect you to the new location of this page, but it may" -" not be the right one." -msgstr "" -"Opomba: Vaš zahtevek za URL s tega streznika je " -"zastaral. Poskušali smo vas preusmeriti na novo lokacijo, vendar utegne " -"biti napačna." - -#: sphinx/templates/search.html:7 -#, fuzzy -msgid "" -"From here you can search these documents. Enter your search\n" -" words into the box below and click \"search\". Note that the search\n" -" function will automatically search for all of the words. Pages\n" -" containing fewer words won't appear in the result list." -msgstr "" -"O tukaj lahko isčete dokumente. Vnesite iskalni\n" -" niz v polje spodaj in pritisnite \"išči\". Sproženo iskanje\n" -" bo iskalo po vseh besedah v iskalnem nizu. Strani, ki ne\n" -" vsebujejo vseh besed ne bodo prikazane na seznamu rezultatov." - -#: sphinx/templates/search.html:14 -msgid "search" -msgstr "išči" - -#: sphinx/templates/search.html:20 -msgid "Your search did not match any results." -msgstr "Vaše iskanje ni imelo nobenega zadetka." - -#: sphinx/templates/changes/frameset.html:5 -#: sphinx/templates/changes/versionchanges.html:12 -#, python-format -msgid "Changes in Version %(version)s — %(docstitle)s" -msgstr "Spremembe v Verziji %(version)s — %(docstitle)s" - -#: sphinx/templates/changes/rstsource.html:5 -#, python-format -msgid "%(filename)s — %(docstitle)s" -msgstr "%(filename)s — %(docstitle)s" - -#: sphinx/templates/changes/versionchanges.html:17 -#, python-format -msgid "Automatically generated list of changes in version %(version)s" -msgstr "Avtomatsko generiran seznam sprememb v verziji %(version)s" - -#: sphinx/templates/changes/versionchanges.html:18 -msgid "Library changes" -msgstr "Spremembe knjižnice" - -#: sphinx/templates/changes/versionchanges.html:23 -msgid "C API changes" -msgstr "C API spremembe" - -#: sphinx/templates/changes/versionchanges.html:25 -msgid "Other changes" -msgstr "Ostale spremembe" - diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/locale/sphinx.pot --- a/buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/locale/sphinx.pot Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,589 +0,0 @@ -# Translations template for Sphinx. -# Copyright (C) 2008 ORGANIZATION -# This file is distributed under the same license as the Sphinx project. -# FIRST AUTHOR , 2008. -# -#, fuzzy -msgid "" -msgstr "" -"Project-Id-Version: Sphinx 0.5\n" -"Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" -"POT-Creation-Date: 2008-11-27 18:39+0100\n" -"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" -"Last-Translator: FULL NAME \n" -"Language-Team: LANGUAGE \n" -"MIME-Version: 1.0\n" -"Content-Type: text/plain; charset=utf-8\n" -"Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 0.9.4\n" - -#: sphinx/builder.py:408 -#, python-format -msgid "%b %d, %Y" -msgstr "" - -#: sphinx/builder.py:427 sphinx/templates/defindex.html:21 -msgid "General Index" -msgstr "" - -#: sphinx/builder.py:427 -msgid "index" -msgstr "" - -#: sphinx/builder.py:429 sphinx/htmlhelp.py:156 -#: sphinx/templates/defindex.html:19 sphinx/templates/modindex.html:2 -#: sphinx/templates/modindex.html:13 -msgid "Global Module Index" -msgstr "" - -#: sphinx/builder.py:429 -msgid "modules" -msgstr "" - -#: sphinx/builder.py:466 -msgid "next" -msgstr "" - -#: sphinx/builder.py:473 -msgid "previous" -msgstr "" - -#: sphinx/builder.py:1054 -msgid " (in " -msgstr "" - -#: sphinx/builder.py:1129 -msgid "Builtins" -msgstr "" - -#: sphinx/builder.py:1131 -msgid "Module level" -msgstr "" - -#: sphinx/environment.py:102 sphinx/latexwriter.py:169 -#, python-format -msgid "%B %d, %Y" -msgstr "" - -#: sphinx/environment.py:291 sphinx/latexwriter.py:175 -#: sphinx/templates/genindex-single.html:2 -#: sphinx/templates/genindex-split.html:2 -#: sphinx/templates/genindex-split.html:5 sphinx/templates/genindex.html:2 -#: sphinx/templates/genindex.html:5 sphinx/templates/genindex.html:48 -#: sphinx/templates/layout.html:130 -msgid "Index" -msgstr "" - -#: sphinx/environment.py:292 sphinx/latexwriter.py:174 -msgid "Module Index" -msgstr "" - -#: sphinx/environment.py:293 sphinx/templates/defindex.html:16 -msgid "Search Page" -msgstr "" - -#: sphinx/htmlwriter.py:79 sphinx/static/doctools.js:145 -msgid "Permalink to this definition" -msgstr "" - -#: sphinx/htmlwriter.py:399 sphinx/static/doctools.js:139 -msgid "Permalink to this headline" -msgstr "" - -#: sphinx/latexwriter.py:172 -msgid "Release" -msgstr "" - -#: sphinx/roles.py:53 sphinx/directives/desc.py:537 -#, python-format -msgid "environment variable; %s" -msgstr "" - -#: sphinx/roles.py:60 -#, python-format -msgid "Python Enhancement Proposals!PEP %s" -msgstr "" - -#: sphinx/textwriter.py:166 -#, python-format -msgid "Platform: %s" -msgstr "" - -#: sphinx/textwriter.py:422 -msgid "[image]" -msgstr "" - -#: sphinx/directives/desc.py:25 -#, python-format -msgid "%s() (built-in function)" -msgstr "" - -#: sphinx/directives/desc.py:26 sphinx/directives/desc.py:42 -#: sphinx/directives/desc.py:54 -#, python-format -msgid "%s() (in module %s)" -msgstr "" - -#: sphinx/directives/desc.py:29 -#, python-format -msgid "%s (built-in variable)" -msgstr "" - -#: sphinx/directives/desc.py:30 sphinx/directives/desc.py:66 -#, python-format -msgid "%s (in module %s)" -msgstr "" - -#: sphinx/directives/desc.py:33 -#, python-format -msgid "%s (built-in class)" -msgstr "" - -#: sphinx/directives/desc.py:34 -#, python-format -msgid "%s (class in %s)" -msgstr "" - -#: sphinx/directives/desc.py:46 -#, python-format -msgid "%s() (%s.%s method)" -msgstr "" - -#: sphinx/directives/desc.py:48 -#, python-format -msgid "%s() (%s method)" -msgstr "" - -#: sphinx/directives/desc.py:58 -#, python-format -msgid "%s() (%s.%s static method)" -msgstr "" - -#: sphinx/directives/desc.py:60 -#, python-format -msgid "%s() (%s static method)" -msgstr "" - -#: sphinx/directives/desc.py:70 -#, python-format -msgid "%s (%s.%s attribute)" -msgstr "" - -#: sphinx/directives/desc.py:72 -#, python-format -msgid "%s (%s attribute)" -msgstr "" - -#: sphinx/directives/desc.py:74 -#, python-format -msgid "%s (C function)" -msgstr "" - -#: sphinx/directives/desc.py:76 -#, python-format -msgid "%s (C member)" -msgstr "" - -#: sphinx/directives/desc.py:78 -#, python-format -msgid "%s (C macro)" -msgstr "" - -#: sphinx/directives/desc.py:80 -#, python-format -msgid "%s (C type)" -msgstr "" - -#: sphinx/directives/desc.py:82 -#, python-format -msgid "%s (C variable)" -msgstr "" - -#: sphinx/directives/desc.py:100 -msgid "Raises" -msgstr "" - -#: sphinx/directives/desc.py:104 -msgid "Variable" -msgstr "" - -#: sphinx/directives/desc.py:107 -msgid "Returns" -msgstr "" - -#: sphinx/directives/desc.py:116 -msgid "Return type" -msgstr "" - -#: sphinx/directives/desc.py:143 -msgid "Parameters" -msgstr "" - -#: sphinx/directives/desc.py:423 -#, python-format -msgid "%scommand line option; %s" -msgstr "" - -#: sphinx/directives/other.py:101 -msgid "Platforms: " -msgstr "" - -#: sphinx/directives/other.py:106 -#, python-format -msgid "%s (module)" -msgstr "" - -#: sphinx/directives/other.py:146 -msgid "Section author: " -msgstr "" - -#: sphinx/directives/other.py:148 -msgid "Module author: " -msgstr "" - -#: sphinx/directives/other.py:150 -msgid "Author: " -msgstr "" - -#: sphinx/directives/other.py:246 -msgid "See also" -msgstr "" - -#: sphinx/ext/todo.py:31 -msgid "Todo" -msgstr "" - -#: sphinx/ext/todo.py:75 -#, python-format -msgid "(The original entry is located in %s, line %d and can be found " -msgstr "" - -#: sphinx/ext/todo.py:81 -msgid "here" -msgstr "" - -#: sphinx/locale/__init__.py:15 -msgid "Attention" -msgstr "" - -#: sphinx/locale/__init__.py:16 -msgid "Caution" -msgstr "" - -#: sphinx/locale/__init__.py:17 -msgid "Danger" -msgstr "" - -#: sphinx/locale/__init__.py:18 -msgid "Error" -msgstr "" - -#: sphinx/locale/__init__.py:19 -msgid "Hint" -msgstr "" - -#: sphinx/locale/__init__.py:20 -msgid "Important" -msgstr "" - -#: sphinx/locale/__init__.py:21 -msgid "Note" -msgstr "" - -#: sphinx/locale/__init__.py:22 -msgid "See Also" -msgstr "" - -#: sphinx/locale/__init__.py:23 -msgid "Tip" -msgstr "" - -#: sphinx/locale/__init__.py:24 -msgid "Warning" -msgstr "" - -#: sphinx/locale/__init__.py:28 -#, python-format -msgid "New in version %s" -msgstr "" - -#: sphinx/locale/__init__.py:29 -#, python-format -msgid "Changed in version %s" -msgstr "" - -#: sphinx/locale/__init__.py:30 -#, python-format -msgid "Deprecated since version %s" -msgstr "" - -#: sphinx/locale/__init__.py:34 -msgid "module" -msgstr "" - -#: sphinx/locale/__init__.py:35 -msgid "keyword" -msgstr "" - -#: sphinx/locale/__init__.py:36 -msgid "operator" -msgstr "" - -#: sphinx/locale/__init__.py:37 -msgid "object" -msgstr "" - -#: sphinx/locale/__init__.py:38 -msgid "exception" -msgstr "" - -#: sphinx/locale/__init__.py:39 -msgid "statement" -msgstr "" - -#: sphinx/locale/__init__.py:40 -msgid "built-in function" -msgstr "" - -#: sphinx/static/doctools.js:174 -msgid "Hide Search Matches" -msgstr "" - -#: sphinx/static/searchtools.js:274 -msgid "Searching" -msgstr "" - -#: sphinx/static/searchtools.js:279 -msgid "Preparing search..." -msgstr "" - -#: sphinx/static/searchtools.js:338 -msgid "module, in " -msgstr "" - -#: sphinx/static/searchtools.js:347 -msgid ", in " -msgstr "" - -#: sphinx/static/searchtools.js:447 sphinx/templates/search.html:18 -msgid "Search Results" -msgstr "" - -#: sphinx/static/searchtools.js:449 -msgid "" -"Your search did not match any documents. Please make sure that all words " -"are spelled correctly and that you've selected enough categories." -msgstr "" - -#: sphinx/static/searchtools.js:451 -#, python-format -msgid "Search finished, found %s page(s) matching the search query." -msgstr "" - -#: sphinx/templates/defindex.html:2 -msgid "Overview" -msgstr "" - -#: sphinx/templates/defindex.html:11 -msgid "Indices and tables:" -msgstr "" - -#: sphinx/templates/defindex.html:14 -msgid "Complete Table of Contents" -msgstr "" - -#: sphinx/templates/defindex.html:15 -msgid "lists all sections and subsections" -msgstr "" - -#: sphinx/templates/defindex.html:17 -msgid "search this documentation" -msgstr "" - -#: sphinx/templates/defindex.html:20 -msgid "quick access to all modules" -msgstr "" - -#: sphinx/templates/defindex.html:22 -msgid "all functions, classes, terms" -msgstr "" - -#: sphinx/templates/genindex-single.html:5 -#, python-format -msgid "Index – %(key)s" -msgstr "" - -#: sphinx/templates/genindex-single.html:44 -#: sphinx/templates/genindex-split.html:14 -#: sphinx/templates/genindex-split.html:27 sphinx/templates/genindex.html:54 -msgid "Full index on one page" -msgstr "" - -#: sphinx/templates/genindex-split.html:7 -msgid "Index pages by letter" -msgstr "" - -#: sphinx/templates/genindex-split.html:15 -msgid "can be huge" -msgstr "" - -#: sphinx/templates/layout.html:9 -msgid "Navigation" -msgstr "" - -#: sphinx/templates/layout.html:40 -msgid "Table Of Contents" -msgstr "" - -#: sphinx/templates/layout.html:46 -msgid "Previous topic" -msgstr "" - -#: sphinx/templates/layout.html:47 -msgid "previous chapter" -msgstr "" - -#: sphinx/templates/layout.html:50 -msgid "Next topic" -msgstr "" - -#: sphinx/templates/layout.html:51 -msgid "next chapter" -msgstr "" - -#: sphinx/templates/layout.html:55 -msgid "This Page" -msgstr "" - -#: sphinx/templates/layout.html:59 -msgid "Suggest Change" -msgstr "" - -#: sphinx/templates/layout.html:60 sphinx/templates/layout.html:62 -msgid "Show Source" -msgstr "" - -#: sphinx/templates/layout.html:71 -msgid "Quick search" -msgstr "" - -#: sphinx/templates/layout.html:71 -msgid "Keyword search" -msgstr "" - -#: sphinx/templates/layout.html:73 -msgid "Go" -msgstr "" - -#: sphinx/templates/layout.html:78 -msgid "Enter a module, class or function name." -msgstr "" - -#: sphinx/templates/layout.html:119 -#, python-format -msgid "Search within %(docstitle)s" -msgstr "" - -#: sphinx/templates/layout.html:128 -msgid "About these documents" -msgstr "" - -#: sphinx/templates/layout.html:131 sphinx/templates/search.html:2 -#: sphinx/templates/search.html:5 -msgid "Search" -msgstr "" - -#: sphinx/templates/layout.html:133 -msgid "Copyright" -msgstr "" - -#: sphinx/templates/layout.html:178 -#, python-format -msgid "© Copyright %(copyright)s." -msgstr "" - -#: sphinx/templates/layout.html:180 -#, python-format -msgid "© Copyright %(copyright)s." -msgstr "" - -#: sphinx/templates/layout.html:183 -#, python-format -msgid "Last updated on %(last_updated)s." -msgstr "" - -#: sphinx/templates/layout.html:186 -#, python-format -msgid "" -"Created using Sphinx " -"%(sphinx_version)s." -msgstr "" - -#: sphinx/templates/modindex.html:15 -msgid "Most popular modules:" -msgstr "" - -#: sphinx/templates/modindex.html:24 -msgid "Show modules only available on these platforms" -msgstr "" - -#: sphinx/templates/modindex.html:56 -msgid "Deprecated" -msgstr "" - -#: sphinx/templates/opensearch.xml:4 -#, python-format -msgid "Search %(docstitle)s" -msgstr "" - -#: sphinx/templates/page.html:8 -msgid "" -"Note: You requested an out-of-date URL from this server." -" We've tried to redirect you to the new location of this page, but it may" -" not be the right one." -msgstr "" - -#: sphinx/templates/search.html:7 -msgid "" -"From here you can search these documents. Enter your search\n" -" words into the box below and click \"search\". Note that the search\n" -" function will automatically search for all of the words. Pages\n" -" containing fewer words won't appear in the result list." -msgstr "" - -#: sphinx/templates/search.html:14 -msgid "search" -msgstr "" - -#: sphinx/templates/search.html:20 -msgid "Your search did not match any results." -msgstr "" - -#: sphinx/templates/changes/frameset.html:5 -#: sphinx/templates/changes/versionchanges.html:12 -#, python-format -msgid "Changes in Version %(version)s — %(docstitle)s" -msgstr "" - -#: sphinx/templates/changes/rstsource.html:5 -#, python-format -msgid "%(filename)s — %(docstitle)s" -msgstr "" - -#: sphinx/templates/changes/versionchanges.html:17 -#, python-format -msgid "Automatically generated list of changes in version %(version)s" -msgstr "" - -#: sphinx/templates/changes/versionchanges.html:18 -msgid "Library changes" -msgstr "" - -#: sphinx/templates/changes/versionchanges.html:23 -msgid "C API changes" -msgstr "" - -#: sphinx/templates/changes/versionchanges.html:25 -msgid "Other changes" -msgstr "" - diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/locale/zh_TW/LC_MESSAGES/sphinx.js --- a/buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/locale/zh_TW/LC_MESSAGES/sphinx.js Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,1 +0,0 @@ -Documentation.addTranslations({"locale": "zh_TW", "plural_expr": "0", "messages": {"module, in ": "", "Preparing search...": "\u6e96\u5099\u641c\u5c0b...", "Your search did not match any documents. Please make sure that all words are spelled correctly and that you've selected enough categories.": "", "Search finished, found %s page(s) matching the search query.": "", ", in ": "", "Permalink to this headline": "", "Searching": "\u641c\u5c0b\u4e2d", "Permalink to this definition": "", "Hide Search Matches": "", "Search Results": "\u641c\u5c0b\u7d50\u679c"}}); \ No newline at end of file diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/locale/zh_TW/LC_MESSAGES/sphinx.mo Binary file buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/locale/zh_TW/LC_MESSAGES/sphinx.mo has changed diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/locale/zh_TW/LC_MESSAGES/sphinx.po --- a/buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/locale/zh_TW/LC_MESSAGES/sphinx.po Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,598 +0,0 @@ -# Chinese (Taiwan) translations for Sphinx. -# Copyright (C) 2008 ORGANIZATION -# This file is distributed under the same license as the Sphinx project. -# Fred Lin , 2008. -# -msgid "" -msgstr "" -"Project-Id-Version: Sphinx 0.5\n" -"Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" -"POT-Creation-Date: 2008-11-09 19:46+0100\n" -"PO-Revision-Date: 2008-11-27 18:40+0100\n" -"Last-Translator: Fred Lin \n" -"Language-Team: tw \n" -"Plural-Forms: nplurals=1; plural=0\n" -"MIME-Version: 1.0\n" -"Content-Type: text/plain; charset=utf-8\n" -"Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 0.9.4\n" - -#: sphinx/builder.py:408 -#, python-format -msgid "%b %d, %Y" -msgstr "%Y 年 %m 月 %d 日" - -#: sphinx/builder.py:427 sphinx/templates/defindex.html:21 -msgid "General Index" -msgstr "總索引" - -#: sphinx/builder.py:427 -msgid "index" -msgstr "索引" - -#: sphinx/builder.py:429 sphinx/htmlhelp.py:156 -#: sphinx/templates/defindex.html:19 sphinx/templates/modindex.html:2 -#: sphinx/templates/modindex.html:13 -msgid "Global Module Index" -msgstr "" - -#: sphinx/builder.py:429 -msgid "modules" -msgstr "模組" - -#: sphinx/builder.py:466 -msgid "next" -msgstr "下一頁" - -#: sphinx/builder.py:473 -msgid "previous" -msgstr "上一頁" - -#: sphinx/builder.py:1054 -msgid " (in " -msgstr "" - -#: sphinx/builder.py:1129 -msgid "Builtins" -msgstr "" - -#: sphinx/builder.py:1131 -msgid "Module level" -msgstr "" - -#: sphinx/environment.py:102 sphinx/latexwriter.py:169 -#, python-format -msgid "%B %d, %Y" -msgstr "%Y 年 %m 月 %d 日" - -#: sphinx/environment.py:291 sphinx/latexwriter.py:175 -#: sphinx/templates/genindex-single.html:2 -#: sphinx/templates/genindex-split.html:2 -#: sphinx/templates/genindex-split.html:5 sphinx/templates/genindex.html:2 -#: sphinx/templates/genindex.html:5 sphinx/templates/genindex.html:48 -#: sphinx/templates/layout.html:130 -msgid "Index" -msgstr "索引" - -#: sphinx/environment.py:292 sphinx/latexwriter.py:174 -msgid "Module Index" -msgstr "模組索引" - -#: sphinx/environment.py:293 sphinx/templates/defindex.html:16 -msgid "Search Page" -msgstr "搜尋頁面" - -#: sphinx/htmlwriter.py:79 sphinx/static/doctools.js:145 -msgid "Permalink to this definition" -msgstr "" - -#: sphinx/htmlwriter.py:399 sphinx/static/doctools.js:139 -msgid "Permalink to this headline" -msgstr "" - -#: sphinx/latexwriter.py:172 -msgid "Release" -msgstr "釋出" - -#: sphinx/roles.py:53 sphinx/directives/desc.py:537 -#, python-format -msgid "environment variable; %s" -msgstr "環境變數; %s" - -#: sphinx/roles.py:60 -#, python-format -msgid "Python Enhancement Proposals!PEP %s" -msgstr "Python 建議文件!PEP %s" - -#: sphinx/textwriter.py:166 -#, python-format -msgid "Platform: %s" -msgstr "平台：%s" - -#: sphinx/textwriter.py:422 -msgid "[image]" -msgstr "[圖片]" - -#: sphinx/directives/desc.py:25 -#, python-format -msgid "%s() (built-in function)" -msgstr "%s() (內建函式)" - -#: sphinx/directives/desc.py:26 sphinx/directives/desc.py:42 -#: sphinx/directives/desc.py:54 -#, python-format -msgid "%s() (in module %s)" -msgstr "%s() (在 %s 模組中)" - -#: sphinx/directives/desc.py:29 -#, python-format -msgid "%s (built-in variable)" -msgstr "%s (內建變數)" - -#: sphinx/directives/desc.py:30 sphinx/directives/desc.py:66 -#, python-format -msgid "%s (in module %s)" -msgstr "%s() (在 %s 模組中)" - -#: sphinx/directives/desc.py:33 -#, python-format -msgid "%s (built-in class)" -msgstr "%s (內建類別)" - -#: sphinx/directives/desc.py:34 -#, python-format -msgid "%s (class in %s)" -msgstr "" - -#: sphinx/directives/desc.py:46 -#, python-format -msgid "%s() (%s.%s method)" -msgstr "%s() (%s.%s 方法)" - -#: sphinx/directives/desc.py:48 -#, python-format -msgid "%s() (%s method)" -msgstr "%s() (%s 方法)" - -#: sphinx/directives/desc.py:58 -#, python-format -msgid "%s() (%s.%s static method)" -msgstr "%s() (%s.%s 靜態方法)" - -#: sphinx/directives/desc.py:60 -#, python-format -msgid "%s() (%s static method)" -msgstr "%s() (%s 靜態方法)" - -#: sphinx/directives/desc.py:70 -#, python-format -msgid "%s (%s.%s attribute)" -msgstr "%s (%s.%s 屬性)" - -#: sphinx/directives/desc.py:72 -#, python-format -msgid "%s (%s attribute)" -msgstr "%s (%s 屬性)" - -#: sphinx/directives/desc.py:74 -#, python-format -msgid "%s (C function)" -msgstr "%s (C 函式)" - -#: sphinx/directives/desc.py:76 -#, python-format -msgid "%s (C member)" -msgstr "%s (C 成員)" - -#: sphinx/directives/desc.py:78 -#, python-format -msgid "%s (C macro)" -msgstr "%s (C 巨集)" - -#: sphinx/directives/desc.py:80 -#, python-format -msgid "%s (C type)" -msgstr "%s (C 類別)" - -#: sphinx/directives/desc.py:82 -#, python-format -msgid "%s (C variable)" -msgstr "%s (C 變數)" - -#: sphinx/directives/desc.py:100 -msgid "Raises" -msgstr "" - -#: sphinx/directives/desc.py:104 -msgid "Variable" -msgstr "變數" - -#: sphinx/directives/desc.py:107 -msgid "Returns" -msgstr "返回" - -#: sphinx/directives/desc.py:116 -msgid "Return type" -msgstr "返回類別" - -#: sphinx/directives/desc.py:143 -msgid "Parameters" -msgstr "參數" - -#: sphinx/directives/desc.py:423 -#, python-format -msgid "%scommand line option; %s" -msgstr "%s命令列選項; %s" - -#: sphinx/directives/other.py:101 -msgid "Platforms: " -msgstr "平台" - -#: sphinx/directives/other.py:106 -#, python-format -msgid "%s (module)" -msgstr "%s (模組)" - -#: sphinx/directives/other.py:146 -msgid "Section author: " -msgstr "Section 作者：" - -#: sphinx/directives/other.py:148 -msgid "Module author: " -msgstr "模組作者：" - -#: sphinx/directives/other.py:150 -msgid "Author: " -msgstr "作者：" - -#: sphinx/directives/other.py:246 -msgid "See also" -msgstr "" - -#: sphinx/ext/todo.py:31 -msgid "Todo" -msgstr "待辦" - -#: sphinx/ext/todo.py:75 -#, python-format -msgid "(The original entry is located in %s, line %d and can be found " -msgstr "" - -#: sphinx/ext/todo.py:81 -msgid "here" -msgstr "" - -#: sphinx/locale/__init__.py:15 -msgid "Attention" -msgstr "注意" - -#: sphinx/locale/__init__.py:16 -msgid "Caution" -msgstr "警示" - -#: sphinx/locale/__init__.py:17 -msgid "Danger" -msgstr "危險" - -#: sphinx/locale/__init__.py:18 -msgid "Error" -msgstr "錯誤" - -#: sphinx/locale/__init__.py:19 -msgid "Hint" -msgstr "提示" - -#: sphinx/locale/__init__.py:20 -msgid "Important" -msgstr "重要" - -#: sphinx/locale/__init__.py:21 -msgid "Note" -msgstr "註解" - -#: sphinx/locale/__init__.py:22 -msgid "See Also" -msgstr "" - -#: sphinx/locale/__init__.py:23 -msgid "Tip" -msgstr "小技巧" - -#: sphinx/locale/__init__.py:24 -msgid "Warning" -msgstr "警告" - -#: sphinx/locale/__init__.py:28 -#, python-format -msgid "New in version %s" -msgstr "%s 版新功能" - -#: sphinx/locale/__init__.py:29 -#, python-format -msgid "Changed in version %s" -msgstr "在 %s 版改變" - -#: sphinx/locale/__init__.py:30 -#, python-format -msgid "Deprecated since version %s" -msgstr "%s 版後已移除" - -#: sphinx/locale/__init__.py:34 -msgid "module" -msgstr "模組" - -#: sphinx/locale/__init__.py:35 -msgid "keyword" -msgstr "關鍵字" - -#: sphinx/locale/__init__.py:36 -msgid "operator" -msgstr "運算子" - -#: sphinx/locale/__init__.py:37 -msgid "object" -msgstr "物件" - -#: sphinx/locale/__init__.py:38 -msgid "exception" -msgstr "例外" - -#: sphinx/locale/__init__.py:39 -msgid "statement" -msgstr "" - -#: sphinx/locale/__init__.py:40 -msgid "built-in function" -msgstr "內建函式" - -#: sphinx/static/doctools.js:174 -msgid "Hide Search Matches" -msgstr "" - -#: sphinx/static/searchtools.js:274 -msgid "Searching" -msgstr "搜尋中" - -#: sphinx/static/searchtools.js:279 -msgid "Preparing search..." -msgstr "準備搜尋..." - -#: sphinx/static/searchtools.js:338 -msgid "module, in " -msgstr "" - -#: sphinx/static/searchtools.js:347 -msgid ", in " -msgstr "" - -#: sphinx/static/searchtools.js:447 sphinx/templates/search.html:18 -msgid "Search Results" -msgstr "搜尋結果" - -#: sphinx/static/searchtools.js:449 -msgid "" -"Your search did not match any documents. Please make sure that all words " -"are spelled correctly and that you've selected enough categories." -msgstr "" - -#: sphinx/static/searchtools.js:451 -#, python-format -msgid "Search finished, found %s page(s) matching the search query." -msgstr "" - -#: sphinx/templates/defindex.html:2 -msgid "Overview" -msgstr "" - -#: sphinx/templates/defindex.html:11 -msgid "Indices and tables:" -msgstr "" - -#: sphinx/templates/defindex.html:14 -msgid "Complete Table of Contents" -msgstr "" - -#: sphinx/templates/defindex.html:15 -msgid "lists all sections and subsections" -msgstr "" - -#: sphinx/templates/defindex.html:17 -msgid "search this documentation" -msgstr "" - -#: sphinx/templates/defindex.html:20 -msgid "quick access to all modules" -msgstr "" - -#: sphinx/templates/defindex.html:22 -msgid "all functions, classes, terms" -msgstr "" - -#: sphinx/templates/genindex-single.html:5 -#, python-format -msgid "Index – %(key)s" -msgstr "" - -#: sphinx/templates/genindex-single.html:44 -#: sphinx/templates/genindex-split.html:14 -#: sphinx/templates/genindex-split.html:27 sphinx/templates/genindex.html:54 -msgid "Full index on one page" -msgstr "" - -#: sphinx/templates/genindex-split.html:7 -msgid "Index pages by letter" -msgstr "" - -#: sphinx/templates/genindex-split.html:15 -msgid "can be huge" -msgstr "" - -#: sphinx/templates/layout.html:9 -msgid "Navigation" -msgstr "瀏覽" - -#: sphinx/templates/layout.html:40 -msgid "Table Of Contents" -msgstr "內容目錄" - -#: sphinx/templates/layout.html:46 -msgid "Previous topic" -msgstr "上一個主題" - -#: sphinx/templates/layout.html:47 -msgid "previous chapter" -msgstr "上一章" - -#: sphinx/templates/layout.html:50 -msgid "Next topic" -msgstr "下一個主題" - -#: sphinx/templates/layout.html:51 -msgid "next chapter" -msgstr "下一章" - -#: sphinx/templates/layout.html:55 -msgid "This Page" -msgstr "本頁" - -#: sphinx/templates/layout.html:59 -msgid "Suggest Change" -msgstr "" - -#: sphinx/templates/layout.html:60 sphinx/templates/layout.html:62 -msgid "Show Source" -msgstr "顯示原始碼" - -#: sphinx/templates/layout.html:71 -msgid "Quick search" -msgstr "快速搜尋" - -#: sphinx/templates/layout.html:71 -msgid "Keyword search" -msgstr "關鍵字搜尋" - -#: sphinx/templates/layout.html:73 -msgid "Go" -msgstr "" - -#: sphinx/templates/layout.html:78 -msgid "Enter a module, class or function name." -msgstr "輸入一個模組、類別、或是函式名稱." - -#: sphinx/templates/layout.html:119 -#, python-format -msgid "Search within %(docstitle)s" -msgstr "在 %(docstitle)s 中搜尋" - -#: sphinx/templates/layout.html:128 -msgid "About these documents" -msgstr "" - -#: sphinx/templates/layout.html:131 sphinx/templates/search.html:2 -#: sphinx/templates/search.html:5 -msgid "Search" -msgstr "搜尋" - -#: sphinx/templates/layout.html:133 -msgid "Copyright" -msgstr "版權所有" - -#: sphinx/templates/layout.html:178 -#, python-format -msgid "© Copyright %(copyright)s." -msgstr "" - -#: sphinx/templates/layout.html:180 -#, python-format -msgid "© Copyright %(copyright)s." -msgstr "" - -#: sphinx/templates/layout.html:183 -#, python-format -msgid "Last updated on %(last_updated)s." -msgstr "最後更新日期是 %(last_updated)s." - -#: sphinx/templates/layout.html:186 -#, python-format -msgid "" -"Created using Sphinx " -"%(sphinx_version)s." -msgstr "" - -#: sphinx/templates/modindex.html:15 -msgid "Most popular modules:" -msgstr "" - -#: sphinx/templates/modindex.html:24 -msgid "Show modules only available on these platforms" -msgstr "" - -#: sphinx/templates/modindex.html:56 -msgid "Deprecated" -msgstr "已移除" - -#: sphinx/templates/opensearch.xml:4 -#, python-format -msgid "Search %(docstitle)s" -msgstr "搜尋 %(docstitle)s" - -#: sphinx/templates/page.html:8 -msgid "" -"Note: You requested an out-of-date URL from this server." -" We've tried to redirect you to the new location of this page, but it may" -" not be the right one." -msgstr "" - -#: sphinx/templates/search.html:7 -msgid "" -"From here you can search these documents. Enter your search\n" -" words into the box below and click \"search\". Note that the search\n" -" function will automatically search for all of the words. Pages\n" -" containing fewer words won't appear in the result list." -msgstr "" - -#: sphinx/templates/search.html:14 -msgid "search" -msgstr "搜尋" - -#: sphinx/templates/search.html:20 -msgid "Your search did not match any results." -msgstr "" - -#: sphinx/templates/changes/frameset.html:5 -#: sphinx/templates/changes/versionchanges.html:12 -#, python-format -msgid "Changes in Version %(version)s — %(docstitle)s" -msgstr "" - -#: sphinx/templates/changes/rstsource.html:5 -#, python-format -msgid "%(filename)s — %(docstitle)s" -msgstr "" - -#: sphinx/templates/changes/versionchanges.html:17 -#, python-format -msgid "Automatically generated list of changes in version %(version)s" -msgstr "" - -#: sphinx/templates/changes/versionchanges.html:18 -msgid "Library changes" -msgstr "" - -#: sphinx/templates/changes/versionchanges.html:23 -msgid "C API changes" -msgstr "C API 改變" - -#: sphinx/templates/changes/versionchanges.html:25 -msgid "Other changes" -msgstr "其他改變：" - -#~ msgid "" -#~ "From here you can search these documents. Enter your search\n" -#~ " words into the box below and" -#~ " click \"search\". Note that the " -#~ "search\n" -#~ " function will automatically search for all of the words. Pages\n" -#~ " containing less words won't appear in the result list." -#~ msgstr "" - diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/quickstart.py --- a/buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/quickstart.py Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,533 +0,0 @@ -# -*- coding: utf-8 -*- -""" - sphinx.quickstart - ~~~~~~~~~~~~~~~~~ - - Quickly setup documentation source to work with Sphinx. - - :copyright: 2008 by Georg Brandl. - :license: BSD. -""" - -import sys, os, time -from os import path - -TERM_ENCODING = getattr(sys.stdin, 'encoding', None) - -from sphinx.util import make_filename -from sphinx.util.console import purple, bold, red, turquoise, nocolor, color_terminal -from sphinx.util.texescape import tex_escape_map - - -PROMPT_PREFIX = '> ' - -QUICKSTART_CONF = '''\ -# -*- coding: utf-8 -*- -# -# %(project)s documentation build configuration file, created by -# sphinx-quickstart on %(now)s. -# -# This file is execfile()d with the current directory set to its containing dir. -# -# The contents of this file are pickled, so don't put values in the namespace -# that aren't pickleable (module imports are okay, they're removed automatically). -# -# Note that not all possible configuration values are present in this -# autogenerated file. -# -# All configuration values have a default; values that are commented out -# serve to show the default. - -import sys, os - -# If your extensions are in another directory, add it here. If the directory -# is relative to the documentation root, use os.path.abspath to make it -# absolute, like shown here. -#sys.path.append(os.path.abspath('.')) - -# General configuration -# --------------------- - -# Add any Sphinx extension module names here, as strings. They can be extensions -# coming with Sphinx (named 'sphinx.ext.*') or your custom ones. -extensions = [%(extensions)s] - -# Add any paths that contain templates here, relative to this directory. -templates_path = ['%(dot)stemplates'] - -# The suffix of source filenames. -source_suffix = '%(suffix)s' - -# The encoding of source files. -#source_encoding = 'utf-8' - -# The master toctree document. -master_doc = '%(master)s' - -# General information about the project. -project = u'%(project)s' -copyright = u'%(copyright)s' - -# The version info for the project you're documenting, acts as replacement for -# |version| and |release|, also used in various other places throughout the -# built documents. -# -# The short X.Y version. -version = '%(version)s' -# The full version, including alpha/beta/rc tags. -release = '%(release)s' - -# The language for content autogenerated by Sphinx. Refer to documentation -# for a list of supported languages. -#language = None - -# There are two options for replacing |today|: either, you set today to some -# non-false value, then it is used: -#today = '' -# Else, today_fmt is used as the format for a strftime call. -#today_fmt = '%%B %%d, %%Y' - -# List of documents that shouldn't be included in the build. -#unused_docs = [] - -# List of directories, relative to source directory, that shouldn't be searched -# for source files. -exclude_trees = [%(exclude_trees)s] - -# The reST default role (used for this markup: `text`) to use for all documents. -#default_role = None - -# If true, '()' will be appended to :func: etc. cross-reference text. -#add_function_parentheses = True - -# If true, the current module name will be prepended to all description -# unit titles (such as .. function::). -#add_module_names = True - -# If true, sectionauthor and moduleauthor directives will be shown in the -# output. They are ignored by default. -#show_authors = False - -# The name of the Pygments (syntax highlighting) style to use. -pygments_style = 'sphinx' - - -# Options for HTML output -# ----------------------- - -# The style sheet to use for HTML and HTML Help pages. A file of that name -# must exist either in Sphinx' static/ path, or in one of the custom paths -# given in html_static_path. -html_style = 'default.css' - -# The name for this set of Sphinx documents. If None, it defaults to -# " v documentation". -#html_title = None - -# A shorter title for the navigation bar. Default is the same as html_title. -#html_short_title = None - -# The name of an image file (relative to this directory) to place at the top -# of the sidebar. -#html_logo = None - -# The name of an image file (within the static path) to use as favicon of the -# docs. This file should be a Windows icon file (.ico) being 16x16 or 32x32 -# pixels large. -#html_favicon = None - -# Add any paths that contain custom static files (such as style sheets) here, -# relative to this directory. They are copied after the builtin static files, -# so a file named "default.css" will overwrite the builtin "default.css". -html_static_path = ['%(dot)sstatic'] - -# If not '', a 'Last updated on:' timestamp is inserted at every page bottom, -# using the given strftime format. -#html_last_updated_fmt = '%%b %%d, %%Y' - -# If true, SmartyPants will be used to convert quotes and dashes to -# typographically correct entities. -#html_use_smartypants = True - -# Custom sidebar templates, maps document names to template names. -#html_sidebars = {} - -# Additional templates that should be rendered to pages, maps page names to -# template names. -#html_additional_pages = {} - -# If false, no module index is generated. -#html_use_modindex = True - -# If false, no index is generated. -#html_use_index = True - -# If true, the index is split into individual pages for each letter. -#html_split_index = False - -# If true, the reST sources are included in the HTML build as _sources/. -#html_copy_source = True - -# If true, an OpenSearch description file will be output, and all pages will -# contain a tag referring to it. The value of this option must be the -# base URL from which the finished HTML is served. -#html_use_opensearch = '' - -# If nonempty, this is the file name suffix for HTML files (e.g. ".xhtml"). -#html_file_suffix = '' - -# Output file base name for HTML help builder. -htmlhelp_basename = '%(project_fn)sdoc' - - -# Options for LaTeX output -# ------------------------ - -# The paper size ('letter' or 'a4'). -#latex_paper_size = 'letter' - -# The font size ('10pt', '11pt' or '12pt'). -#latex_font_size = '10pt' - -# Grouping the document tree into LaTeX files. List of tuples -# (source start file, target name, title, author, document class [howto/manual]). -latex_documents = [ - ('%(master)s', '%(project_fn)s.tex', ur'%(project_doc_texescaped)s', - ur'%(author_texescaped)s', 'manual'), -] - -# The name of an image file (relative to this directory) to place at the top of -# the title page. -#latex_logo = None - -# For "manual" documents, if this is true, then toplevel headings are parts, -# not chapters. -#latex_use_parts = False - -# Additional stuff for the LaTeX preamble. -#latex_preamble = '' - -# Documents to append as an appendix to all manuals. -#latex_appendices = [] - -# If false, no module index is generated. -#latex_use_modindex = True -''' - -INTERSPHINX_CONFIG = ''' - -# Example configuration for intersphinx: refer to the Python standard library. -intersphinx_mapping = {'http://docs.python.org/dev': None} -''' - -MASTER_FILE = '''\ -.. %(project)s documentation master file, created by sphinx-quickstart on %(now)s. - You can adapt this file completely to your liking, but it should at least - contain the root `toctree` directive. - -Welcome to %(project)s's documentation! -===========%(underline)s================= - -Contents: - -.. toctree:: - :maxdepth: 2 - -Indices and tables -================== - -* :ref:`genindex` -* :ref:`modindex` -* :ref:`search` - -''' - -MAKEFILE = '''\ -# Makefile for Sphinx documentation -# - -# You can set these variables from the command line. -SPHINXOPTS = -SPHINXBUILD = sphinx-build -PAPER = - -# Internal variables. -PAPEROPT_a4 = -D latex_paper_size=a4 -PAPEROPT_letter = -D latex_paper_size=letter -ALLSPHINXOPTS = -d %(rbuilddir)s/doctrees $(PAPEROPT_$(PAPER)) \ -$(SPHINXOPTS) %(rsrcdir)s - -.PHONY: help clean html web pickle htmlhelp latex changes linkcheck - -help: -\t@echo "Please use \\`make ' where is one of" -\t@echo " html to make standalone HTML files" -\t@echo " pickle to make pickle files" -\t@echo " json to make JSON files" -\t@echo " htmlhelp to make HTML files and a HTML help project" -\t@echo " latex to make LaTeX files, you can set PAPER=a4 or PAPER=letter" -\t@echo " changes to make an overview over all changed/added/deprecated items" -\t@echo " linkcheck to check all external links for integrity" - -clean: -\t-rm -rf %(rbuilddir)s/* - -html: -\tmkdir -p %(rbuilddir)s/html %(rbuilddir)s/doctrees -\t$(SPHINXBUILD) -b html $(ALLSPHINXOPTS) %(rbuilddir)s/html -\t@echo -\t@echo "Build finished. The HTML pages are in %(rbuilddir)s/html." - -pickle: -\tmkdir -p %(rbuilddir)s/pickle %(rbuilddir)s/doctrees -\t$(SPHINXBUILD) -b pickle $(ALLSPHINXOPTS) %(rbuilddir)s/pickle -\t@echo -\t@echo "Build finished; now you can process the pickle files." - -web: pickle - -json: -\tmkdir -p %(rbuilddir)s/json %(rbuilddir)s/doctrees -\t$(SPHINXBUILD) -b json $(ALLSPHINXOPTS) %(rbuilddir)s/json -\t@echo -\t@echo "Build finished; now you can process the JSON files." - -htmlhelp: -\tmkdir -p %(rbuilddir)s/htmlhelp %(rbuilddir)s/doctrees -\t$(SPHINXBUILD) -b htmlhelp $(ALLSPHINXOPTS) %(rbuilddir)s/htmlhelp -\t@echo -\t@echo "Build finished; now you can run HTML Help Workshop with the" \\ -\t ".hhp project file in %(rbuilddir)s/htmlhelp." - -latex: -\tmkdir -p %(rbuilddir)s/latex %(rbuilddir)s/doctrees -\t$(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) %(rbuilddir)s/latex -\t@echo -\t@echo "Build finished; the LaTeX files are in %(rbuilddir)s/latex." -\t@echo "Run \\`make all-pdf' or \\`make all-ps' in that directory to" \\ -\t "run these through (pdf)latex." - -changes: -\tmkdir -p %(rbuilddir)s/changes %(rbuilddir)s/doctrees -\t$(SPHINXBUILD) -b changes $(ALLSPHINXOPTS) %(rbuilddir)s/changes -\t@echo -\t@echo "The overview file is in %(rbuilddir)s/changes." - -linkcheck: -\tmkdir -p %(rbuilddir)s/linkcheck %(rbuilddir)s/doctrees -\t$(SPHINXBUILD) -b linkcheck $(ALLSPHINXOPTS) %(rbuilddir)s/linkcheck -\t@echo -\t@echo "Link check complete; look for any errors in the above output " \\ -\t "or in %(rbuilddir)s/linkcheck/output.txt." -''' - - -def mkdir_p(dir): - if path.isdir(dir): - return - os.makedirs(dir) - - -def is_path(x): - """Please enter a valid path name.""" - return path.isdir(x) or not path.exists(x) - -def nonempty(x): - """Please enter some text.""" - return len(x) - -def choice(*l): - def val(x): - return x in l - val.__doc__ = 'Please enter one of %s.' % ', '.join(l) - return val - -def boolean(x): - """Please enter either 'y' or 'n'.""" - return x.upper() in ('Y', 'YES', 'N', 'NO') - -def suffix(x): - """Please enter a file suffix, e.g. '.rst' or '.txt'.""" - return x[0:1] == '.' and len(x) > 1 - -def ok(x): - return True - - -def do_prompt(d, key, text, default=None, validator=nonempty): - while True: - if default: - prompt = purple(PROMPT_PREFIX + '%s [%s]: ' % (text, default)) - else: - prompt = purple(PROMPT_PREFIX + text + ': ') - x = raw_input(prompt) - if default and not x: - x = default - if x.decode('ascii', 'replace').encode('ascii', 'replace') != x: - if TERM_ENCODING: - x = x.decode(TERM_ENCODING) - else: - print turquoise('* Note: non-ASCII characters entered and terminal ' - 'encoding unknown -- assuming UTF-8 or Latin-1.') - try: - x = x.decode('utf-8') - except UnicodeDecodeError: - x = x.decode('latin1') - if validator and not validator(x): - print red('* ' + validator.__doc__) - continue - break - d[key] = x - - -def inner_main(args): - d = {} - - if not sys.stdout.isatty() or not color_terminal(): - nocolor() - - print bold('Welcome to the Sphinx quickstart utility.') - print ''' -Please enter values for the following settings (just press Enter to -accept a default value, if one is given in brackets).''' - - print ''' -Enter the root path for documentation.''' - do_prompt(d, 'path', 'Root path for the documentation', '.', is_path) - - while path.isfile(path.join(d['path'], 'conf.py')) or \ - path.isfile(path.join(d['path'], 'source', 'conf.py')): - print - print bold('Error: an existing conf.py has been found in the ' - 'selected root path.') - print 'sphinx-quickstart will not overwrite existing Sphinx projects.' - print - do_prompt(d, 'path', 'Please enter a new root path (or just Enter to exit)', - '', is_path) - if not d['path']: - sys.exit(1) - - print ''' -You have two options for placing the build directory for Sphinx output. -Either, you use a directory ".build" within the root path, or you separate -"source" and "build" directories within the root path.''' - do_prompt(d, 'sep', 'Separate source and build directories (y/N)', 'n', - boolean) - print ''' -Inside the root directory, two more directories will be created; ".templates" -for custom HTML templates and ".static" for custom stylesheets and other -static files. Since the leading dot may be inconvenient for Windows users, -you can enter another prefix (such as "_") to replace the dot.''' - do_prompt(d, 'dot', 'Name prefix for templates and static dir', '.', ok) - - print ''' -The project name will occur in several places in the built documentation.''' - do_prompt(d, 'project', 'Project name') - do_prompt(d, 'author', 'Author name(s)') - print ''' -Sphinx has the notion of a "version" and a "release" for the -software. Each version can have multiple releases. For example, for -Python the version is something like 2.5 or 3.0, while the release is -something like 2.5.1 or 3.0a1. If you don't need this dual structure, -just set both to the same value.''' - do_prompt(d, 'version', 'Project version') - do_prompt(d, 'release', 'Project release', d['version']) - print ''' -The file name suffix for source files. Commonly, this is either ".txt" -or ".rst". Only files with this suffix are considered documents.''' - do_prompt(d, 'suffix', 'Source file suffix', '.rst', suffix) - print ''' -One document is special in that it is considered the top node of the -"contents tree", that is, it is the root of the hierarchical structure -of the documents. Normally, this is "index", but if your "index" -document is a custom template, you can also set this to another filename.''' - do_prompt(d, 'master', 'Name of your master document (without suffix)', - 'index') - print ''' -Please indicate if you want to use one of the following Sphinx extensions:''' - do_prompt(d, 'ext_autodoc', 'autodoc: automatically insert docstrings ' - 'from modules (y/N)', 'n', boolean) - do_prompt(d, 'ext_doctest', 'doctest: automatically test code snippets ' - 'in doctest blocks (y/N)', 'n', boolean) - do_prompt(d, 'ext_intersphinx', 'intersphinx: link between Sphinx documentation ' - 'of different projects (y/N)', 'n', boolean) - print ''' -If you are under Unix, a Makefile can be generated for you so that you -only have to run e.g. `make html' instead of invoking sphinx-build -directly.''' - do_prompt(d, 'makefile', 'Create Makefile? (Y/n)', - os.name == 'posix' and 'y' or 'n', boolean) - - d['project_fn'] = make_filename(d['project']) - d['now'] = time.asctime() - d['underline'] = len(d['project']) * '=' - d['extensions'] = ', '.join( - repr('sphinx.ext.' + name) for name in ('autodoc', 'doctest', 'intersphinx') - if d['ext_' + name].upper() in ('Y', 'YES')) - d['copyright'] = time.strftime('%Y') + ', ' + d['author'] - d['author_texescaped'] = unicode(d['author']).translate(tex_escape_map) - d['project_doc'] = d['project'] + ' Documentation' - d['project_doc_texescaped'] = \ - unicode(d['project'] + ' Documentation').translate(tex_escape_map) - - if not path.isdir(d['path']): - mkdir_p(d['path']) - - separate = d['sep'].upper() in ('Y', 'YES') - srcdir = separate and path.join(d['path'], 'source') or d['path'] - - mkdir_p(srcdir) - if separate: - builddir = path.join(d['path'], 'build') - d['exclude_trees'] = '' - else: - builddir = path.join(srcdir, d['dot'] + 'build') - d['exclude_trees'] = repr(d['dot'] + 'build') - mkdir_p(builddir) - mkdir_p(path.join(srcdir, d['dot'] + 'templates')) - mkdir_p(path.join(srcdir, d['dot'] + 'static')) - - conf_text = QUICKSTART_CONF % d - if d['ext_intersphinx'].upper() in ('Y', 'YES'): - conf_text += INTERSPHINX_CONFIG - - f = open(path.join(srcdir, 'conf.py'), 'w') - f.write(conf_text.encode('utf-8')) - f.close() - - masterfile = path.join(srcdir, d['master'] + d['suffix']) - f = open(masterfile, 'w') - f.write((MASTER_FILE % d).encode('utf-8')) - f.close() - - create_makefile = d['makefile'].upper() in ('Y', 'YES') - if create_makefile: - d['rsrcdir'] = separate and 'source' or '.' - d['rbuilddir'] = separate and 'build' or d['dot'] + 'build' - f = open(path.join(d['path'], 'Makefile'), 'w') - f.write((MAKEFILE % d).encode('utf-8')) - f.close() - - print - print bold('Finished: An initial directory structure has been created.') - print ''' -You should now populate your master file %s and create other documentation -source files. ''' % masterfile + (create_makefile and '''\ -Use the Makefile to build the docs, like so: - make builder -''' or '''\ -Use the sphinx-build command to build the docs, like so: - sphinx-build -b builder %s %s -''' % (srcdir, builddir)) + '''\ -where "builder" is one of the supported builders, e.g. html, latex or linkcheck. -''' - - -def main(argv=sys.argv): - try: - return inner_main(argv) - except (KeyboardInterrupt, EOFError): - print - print '[Interrupted.]' - return - diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/roles.py --- a/buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/roles.py Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,245 +0,0 @@ -# -*- coding: utf-8 -*- -""" - sphinx.roles - ~~~~~~~~~~~~ - - Handlers for additional ReST roles. - - :copyright: 2007-2008 by Georg Brandl. - :license: BSD. -""" - -import re - -from docutils import nodes, utils -from docutils.parsers.rst import roles - -from sphinx import addnodes -from sphinx.util import ws_re, caption_ref_re - - -generic_docroles = { - 'command' : nodes.strong, - 'dfn' : nodes.emphasis, - 'guilabel' : nodes.strong, - 'kbd' : nodes.literal, - 'mailheader' : addnodes.literal_emphasis, - 'makevar' : nodes.Text, - 'manpage' : addnodes.literal_emphasis, - 'mimetype' : addnodes.literal_emphasis, - 'newsgroup' : addnodes.literal_emphasis, - 'program' : nodes.strong, - 'regexp' : nodes.literal, -} - -for rolename, nodeclass in generic_docroles.iteritems(): - roles.register_generic_role(rolename, nodeclass) - - -def indexmarkup_role(typ, rawtext, etext, lineno, inliner, options={}, content=[]): - env = inliner.document.settings.env - if not typ: - typ = env.config.default_role - else: - typ = typ.lower() - text = utils.unescape(etext) - targetid = 'index-%s' % env.index_num - env.index_num += 1 - indexnode = addnodes.index() - targetnode = nodes.target('', '', ids=[targetid]) - inliner.document.note_explicit_target(targetnode) - if typ == 'envvar': - indexnode['entries'] = [('single', text, targetid, text), - ('single', _('environment variable; %s') % text, - targetid, text)] - xref_nodes = xfileref_role(typ, rawtext, etext, lineno, inliner, - options, content)[0] - return [indexnode, targetnode] + xref_nodes, [] - elif typ == 'pep': - indexnode['entries'] = [('single', - _('Python Enhancement Proposals!PEP %s') % text, - targetid, 'PEP %s' % text)] - try: - pepnum = int(text) - except ValueError: - msg = inliner.reporter.error('invalid PEP number %s' % text, line=lineno) - prb = inliner.problematic(rawtext, rawtext, msg) - return [prb], [msg] - ref = inliner.document.settings.pep_base_url + 'pep-%04d' % pepnum - sn = nodes.strong('PEP '+text, 'PEP '+text) - rn = nodes.reference('', '', refuri=ref) - rn += sn - return [indexnode, targetnode, rn], [] - elif typ == 'rfc': - indexnode['entries'] = [('single', 'RFC; RFC %s' % text, - targetid, 'RFC %s' % text)] - try: - rfcnum = int(text) - except ValueError: - msg = inliner.reporter.error('invalid RFC number %s' % text, line=lineno) - prb = inliner.problematic(rawtext, rawtext, msg) - return [prb], [msg] - ref = inliner.document.settings.rfc_base_url + inliner.rfc_url % rfcnum - sn = nodes.strong('RFC '+text, 'RFC '+text) - rn = nodes.reference('', '', refuri=ref) - rn += sn - return [indexnode, targetnode, rn], [] - -roles.register_canonical_role('envvar', indexmarkup_role) -roles.register_local_role('pep', indexmarkup_role) -roles.register_local_role('rfc', indexmarkup_role) - - -# default is `literal` -innernodetypes = { - 'ref': nodes.emphasis, - 'term': nodes.emphasis, - 'token': nodes.strong, - 'envvar': nodes.strong, - 'option': addnodes.literal_emphasis, -} - -def _fix_parens(typ, text, env): - if typ in ('func', 'meth', 'cfunc'): - if text.endswith('()'): - # remove parentheses - text = text[:-2] - if env.config.add_function_parentheses: - # add them back to all occurrences if configured - text += '()' - return text - -def xfileref_role(typ, rawtext, text, lineno, inliner, options={}, content=[]): - env = inliner.document.settings.env - if not typ: - typ = env.config.default_role - else: - typ = typ.lower() - text = utils.unescape(text) - # if the first character is a bang, don't cross-reference at all - if text[0:1] == '!': - text = _fix_parens(typ, text[1:], env) - return [innernodetypes.get(typ, nodes.literal)( - rawtext, text, classes=['xref'])], [] - # we want a cross-reference, create the reference node - pnode = addnodes.pending_xref(rawtext, reftype=typ, refcaption=False, - modname=env.currmodule, classname=env.currclass) - # we may need the line number for warnings - pnode.line = lineno - # the link title may differ from the target, but by default they are the same - title = target = text - titleistarget = True - # look if explicit title and target are given with `foo ` syntax - brace = text.find('<') - if brace != -1: - titleistarget = False - pnode['refcaption'] = True - m = caption_ref_re.match(text) - if m: - target = m.group(2) - title = m.group(1) - else: - # fallback: everything after '<' is the target - target = text[brace+1:] - title = text[:brace] - # special target for Python object cross-references - if typ in ('data', 'exc', 'func', 'class', 'const', 'attr', 'meth', 'mod', 'obj'): - # fix-up parentheses in link title - if titleistarget: - title = title.lstrip('.') # only has a meaning for the target - target = target.lstrip('~') # only has a meaning for the title - title = _fix_parens(typ, title, env) - # if the first character is a tilde, don't display the module/class - # parts of the contents - if title[0:1] == '~': - title = title[1:] - dot = title.rfind('.') - if dot != -1: - title = title[dot+1:] - # remove parentheses from the target too - if target.endswith('()'): - target = target[:-2] - # if the first character is a dot, search more specific namespaces first - # else search builtins first - if target[0:1] == '.': - target = target[1:] - pnode['refspecific'] = True - # some other special cases for the target - elif typ == 'option': - program = env.currprogram - if titleistarget: - if ' ' in title and not (title.startswith('/') or title.startswith('-')): - program, target = re.split(' (?=-|--|/)', title, 1) - program = ws_re.sub('-', program) - target = target.strip() - elif ' ' in target: - program, target = re.split(' (?=-|--|/)', target, 1) - program = ws_re.sub('-', program) - pnode['refprogram'] = program - elif typ == 'term': - # normalize whitespace in definition terms (if the term reference is - # broken over a line, a newline will be in target) - target = ws_re.sub(' ', target).lower() - elif typ == 'ref': - # reST label names are always lowercased - target = ws_re.sub('', target).lower() - else: - # remove all whitespace to avoid referencing problems - target = ws_re.sub('', target) - pnode['reftarget'] = target - pnode += innernodetypes.get(typ, nodes.literal)(rawtext, title, classes=['xref']) - return [pnode], [] - - -def menusel_role(typ, rawtext, text, lineno, inliner, options={}, content=[]): - return [nodes.emphasis( - rawtext, utils.unescape(text).replace('-->', u'\N{TRIANGULAR BULLET}'))], [] - - -_litvar_re = re.compile('{([^}]+)}') - -def emph_literal_role(typ, rawtext, text, lineno, inliner, options={}, content=[]): - text = utils.unescape(text) - pos = 0 - retnode = nodes.literal(role=typ.lower()) - for m in _litvar_re.finditer(text): - if m.start() > pos: - txt = text[pos:m.start()] - retnode += nodes.Text(txt, txt) - retnode += nodes.emphasis(m.group(1), m.group(1)) - pos = m.end() - if pos < len(text): - retnode += nodes.Text(text[pos:], text[pos:]) - return [retnode], [] - - -specific_docroles = { - 'data': xfileref_role, - 'exc': xfileref_role, - 'func': xfileref_role, - 'class': xfileref_role, - 'const': xfileref_role, - 'attr': xfileref_role, - 'meth': xfileref_role, - 'obj': xfileref_role, - 'cfunc' : xfileref_role, - 'cmember': xfileref_role, - 'cdata': xfileref_role, - 'ctype': xfileref_role, - 'cmacro': xfileref_role, - - 'mod': xfileref_role, - - 'keyword': xfileref_role, - 'ref': xfileref_role, - 'token': xfileref_role, - 'term': xfileref_role, - 'option': xfileref_role, - - 'menuselection': menusel_role, - 'file': emph_literal_role, - 'samp': emph_literal_role, -} - -for rolename, func in specific_docroles.iteritems(): - roles.register_canonical_role(rolename, func) diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/search.py --- a/buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/search.py Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,205 +0,0 @@ -# -*- coding: utf-8 -*- -""" - sphinx.search - ~~~~~~~~~~~~~ - - Create a search index for offline search. - - :copyright: 2007-2008 by Armin Ronacher. - :license: BSD. -""" -import re -import cPickle as pickle -from cStringIO import StringIO - -from docutils.nodes import Text, NodeVisitor - -from sphinx.util.stemmer import PorterStemmer -from sphinx.util import jsdump, rpartition - - -word_re = re.compile(r'\w+(?u)') - -stopwords = set(""" -a and are as at -be but by -for -if in into is it -near no not -of on or -such -that the their then there these they this to -was will with -""".split()) - - -class _JavaScriptIndex(object): - """ - The search index as javascript file that calls a function - on the documentation search object to register the index. - """ - - PREFIX = 'Search.setIndex(' - SUFFIX = ')' - - def dumps(self, data): - return self.PREFIX + jsdump.dumps(data) + self.SUFFIX - - def loads(self, s): - data = s[len(self.PREFIX):-len(self.SUFFIX)] - if not data or not s.startswith(self.PREFIX) or not \ - s.endswith(self.SUFFIX): - raise ValueError('invalid data') - return jsdump.loads(data) - - def dump(self, data, f): - f.write(self.dumps(data)) - - def load(self, f): - return self.loads(f.read()) - - -js_index = _JavaScriptIndex() - - -class Stemmer(PorterStemmer): - """ - All those porter stemmer implementations look hideous. - make at least the stem method nicer. - """ - - def stem(self, word): - word = word.lower() - return PorterStemmer.stem(self, word, 0, len(word) - 1) - - -class WordCollector(NodeVisitor): - """ - A special visitor that collects words for the `IndexBuilder`. - """ - - def __init__(self, document): - NodeVisitor.__init__(self, document) - self.found_words = [] - - def dispatch_visit(self, node): - if node.__class__ is Text: - self.found_words.extend(word_re.findall(node.astext())) - - -class IndexBuilder(object): - """ - Helper class that creates a searchindex based on the doctrees - passed to the `feed` method. - """ - formats = { - 'jsdump': jsdump, - 'pickle': pickle - } - - def __init__(self, env): - self.env = env - self._stemmer = Stemmer() - # filename -> title - self._titles = {} - # stemmed word -> set(filenames) - self._mapping = {} - # desctypes -> index - self._desctypes = {} - - def load(self, stream, format): - """Reconstruct from frozen data.""" - if isinstance(format, basestring): - format = self.formats[format] - frozen = format.load(stream) - # if an old index is present, we treat it as not existing. - if not isinstance(frozen, dict): - raise ValueError('old format') - index2fn = frozen['filenames'] - self._titles = dict(zip(index2fn, frozen['titles'])) - self._mapping = {} - for k, v in frozen['terms'].iteritems(): - if isinstance(v, int): - self._mapping[k] = set([index2fn[v]]) - else: - self._mapping[k] = set(index2fn[i] for i in v) - # no need to load keywords/desctypes - - def dump(self, stream, format): - """Dump the frozen index to a stream.""" - if isinstance(format, basestring): - format = self.formats[format] - format.dump(self.freeze(), stream) - - def get_modules(self, fn2index): - rv = {} - for name, (doc, _, _, _) in self.env.modules.iteritems(): - rv[name] = fn2index[doc] - return rv - - def get_descrefs(self, fn2index): - rv = {} - dt = self._desctypes - for fullname, (doc, desctype) in self.env.descrefs.iteritems(): - prefix, name = rpartition(fullname, '.') - pdict = rv.setdefault(prefix, {}) - try: - i = dt[desctype] - except KeyError: - i = len(dt) - dt[desctype] = i - pdict[name] = (fn2index[doc], i) - return rv - - def get_terms(self, fn2index): - rv = {} - for k, v in self._mapping.iteritems(): - if len(v) == 1: - fn, = v - rv[k] = fn2index[fn] - else: - rv[k] = [fn2index[fn] for fn in v] - return rv - - def freeze(self): - """Create a usable data structure for serializing.""" - filenames = self._titles.keys() - titles = self._titles.values() - fn2index = dict((f, i) for (i, f) in enumerate(filenames)) - return dict( - filenames=filenames, - titles=titles, - terms=self.get_terms(fn2index), - descrefs=self.get_descrefs(fn2index), - modules=self.get_modules(fn2index), - desctypes=dict((v, k) for (k, v) in self._desctypes.items()), - ) - - def prune(self, filenames): - """Remove data for all filenames not in the list.""" - new_titles = {} - for filename in filenames: - if filename in self._titles: - new_titles[filename] = self._titles[filename] - self._titles = new_titles - for wordnames in self._mapping.itervalues(): - wordnames.intersection_update(filenames) - - def feed(self, filename, title, doctree): - """Feed a doctree to the index.""" - self._titles[filename] = title - - visitor = WordCollector(doctree) - doctree.walk(visitor) - - def add_term(word, prefix='', stem=self._stemmer.stem): - word = stem(word) - if len(word) < 3 or word in stopwords or word.isdigit(): - return - self._mapping.setdefault(prefix + word, set()).add(filename) - - for word in word_re.findall(title): - add_term(word) - - for word in visitor.found_words: - add_term(word) diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/setup_command.py --- a/buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/setup_command.py Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,89 +0,0 @@ -# -*- coding: utf-8 -*- -""" - sphinx.setup_command - ~~~~~~~~~~~~~~~~~~~~ - - Setuptools/distutils commands to assist the building of sphinx - documentation. - - :author: Sebastian Wiesner - :contact: basti.wiesner@gmx.net - :copyright: 2008 by Sebastian Wiesner. - :license: MIT. -""" - -import sys -import os -from StringIO import StringIO -from distutils.cmd import Command - -from sphinx.application import Sphinx -from sphinx.util.console import darkred, nocolor - - -class BuildDoc(Command): - """Distutils command to build Sphinx documentation.""" - - description = 'Build Sphinx documentation' - user_options = [ - ('fresh-env', 'E', 'discard saved environment'), - ('all-files', 'a', 'build all files'), - ('source-dir=', 's', 'Source directory'), - ('build-dir=', None, 'Build directory'), - ('builder=', 'b', 'The builder to use. Defaults to "html"'), - ] - boolean_options = ['fresh-env', 'all-files'] - - - def initialize_options(self): - self.fresh_env = self.all_files = False - self.source_dir = self.build_dir = None - self.conf_file_name = 'conf.py' - self.builder = 'html' - - def finalize_options(self): - if self.source_dir is None: - if os.path.isdir('doc'): - for root, dirnames, filenames in os.walk('doc'): - if 'conf.py' in filenames: - self.source_dir = root - self.announce('Using source directory %s' % root) - break - self.ensure_dirname('source_dir') - self.source_dir = os.path.abspath(self.source_dir) - - if self.build_dir is None: - build = self.get_finalized_command('build') - self.build_dir = os.path.join(build.build_base, 'sphinx') - self.mkpath(self.build_dir) - self.ensure_dirname('build_dir') - self.doctree_dir = os.path.join(self.build_dir, 'doctrees') - self.mkpath(self.doctree_dir) - self.builder_target_dir = os.path.join(self.build_dir, self.builder) - self.mkpath(self.builder_target_dir) - - def run(self): - if not sys.stdout.isatty() or sys.platform == 'win32': - # Windows' poor cmd box doesn't understand ANSI sequences - nocolor() - if not self.verbose: - status_stream = StringIO() - else: - status_stream = sys.stdout - app = Sphinx(self.source_dir, self.source_dir, - self.builder_target_dir, self.doctree_dir, - self.builder, {}, status_stream, - freshenv=self.fresh_env) - - try: - if self.all_files: - app.builder.build_all() - else: - app.builder.build_update() - except Exception, err: - from docutils.utils import SystemMessage - if isinstance(err, SystemMessage): - sys.stderr, darkred('reST markup error:') - print >>sys.stderr, err.args[0].encode('ascii', 'backslashreplace') - else: - raise diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/static/contents.png Binary file buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/static/contents.png has changed diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/static/default.css --- a/buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/static/default.css Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,657 +0,0 @@ -/** - * Sphinx Doc Design - */ - -body { - font-family: sans-serif; - font-size: 100%; - background-color: #11303d; - color: #000; - margin: 0; - padding: 0; -} - -/* :::: LAYOUT :::: */ - -div.document { - background-color: #1c4e63; -} - -div.documentwrapper { - float: left; - width: 100%; -} - -div.bodywrapper { - margin: 0 0 0 230px; -} - -div.body { - background-color: white; - padding: 0 20px 30px 20px; -} - -div.sphinxsidebarwrapper { - padding: 10px 5px 0 10px; -} - -div.sphinxsidebar { - float: left; - width: 230px; - margin-left: -100%; - font-size: 90%; -} - -div.clearer { - clear: both; -} - -div.footer { - color: #fff; - width: 100%; - padding: 9px 0 9px 0; - text-align: center; - font-size: 75%; -} - -div.footer a { - color: #fff; - text-decoration: underline; -} - -div.related { - background-color: #133f52; - color: #fff; - width: 100%; - line-height: 30px; - font-size: 90%; -} - -div.related h3 { - display: none; -} - -div.related ul { - margin: 0; - padding: 0 0 0 10px; - list-style: none; -} - -div.related li { - display: inline; -} - -div.related li.right { - float: right; - margin-right: 5px; -} - -div.related a { - color: white; -} - -/* ::: TOC :::: */ -div.sphinxsidebar h3 { - font-family: 'Trebuchet MS', sans-serif; - color: white; - font-size: 1.4em; - font-weight: normal; - margin: 0; - padding: 0; -} - -div.sphinxsidebar h3 a { - color: white; -} - -div.sphinxsidebar h4 { - font-family: 'Trebuchet MS', sans-serif; - color: white; - font-size: 1.3em; - font-weight: normal; - margin: 5px 0 0 0; - padding: 0; -} - -div.sphinxsidebar p { - color: white; -} - -div.sphinxsidebar p.topless { - margin: 5px 10px 10px 10px; -} - -div.sphinxsidebar ul { - margin: 10px; - padding: 0; - list-style: none; - color: white; -} - -div.sphinxsidebar ul ul, -div.sphinxsidebar ul.want-points { - margin-left: 20px; - list-style: square; -} - -div.sphinxsidebar ul ul { - margin-top: 0; - margin-bottom: 0; -} - -div.sphinxsidebar a { - color: #98dbcc; -} - -div.sphinxsidebar form { - margin-top: 10px; -} - -div.sphinxsidebar input { - border: 1px solid #98dbcc; - font-family: sans-serif; - font-size: 1em; -} - -/* :::: MODULE CLOUD :::: */ -div.modulecloud { - margin: -5px 10px 5px 10px; - padding: 10px; - line-height: 160%; - border: 1px solid #cbe7e5; - background-color: #f2fbfd; -} - -div.modulecloud a { - padding: 0 5px 0 5px; -} - -/* :::: SEARCH :::: */ -ul.search { - margin: 10px 0 0 20px; - padding: 0; -} - -ul.search li { - padding: 5px 0 5px 20px; - background-image: url(file.png); - background-repeat: no-repeat; - background-position: 0 7px; -} - -ul.search li a { - font-weight: bold; -} - -ul.search li div.context { - color: #888; - margin: 2px 0 0 30px; - text-align: left; -} - -ul.keywordmatches li.goodmatch a { - font-weight: bold; -} - -/* :::: COMMON FORM STYLES :::: */ - -div.actions { - padding: 5px 10px 5px 10px; - border-top: 1px solid #cbe7e5; - border-bottom: 1px solid #cbe7e5; - background-color: #e0f6f4; -} - -form dl { - color: #333; -} - -form dt { - clear: both; - float: left; - min-width: 110px; - margin-right: 10px; - padding-top: 2px; -} - -input#homepage { - display: none; -} - -div.error { - margin: 5px 20px 0 0; - padding: 5px; - border: 1px solid #d00; - font-weight: bold; -} - -/* :::: INDEX PAGE :::: */ - -table.contentstable { - width: 90%; -} - -table.contentstable p.biglink { - line-height: 150%; -} - -a.biglink { - font-size: 1.3em; -} - -span.linkdescr { - font-style: italic; - padding-top: 5px; - font-size: 90%; -} - -/* :::: INDEX STYLES :::: */ - -table.indextable td { - text-align: left; - vertical-align: top; -} - -table.indextable dl, table.indextable dd { - margin-top: 0; - margin-bottom: 0; -} - -table.indextable tr.pcap { - height: 10px; -} - -table.indextable tr.cap { - margin-top: 10px; - background-color: #f2f2f2; -} - -img.toggler { - margin-right: 3px; - margin-top: 3px; - cursor: pointer; -} - -form.pfform { - margin: 10px 0 20px 0; -} - -/* :::: GLOBAL STYLES :::: */ - -.docwarning { - background-color: #ffe4e4; - padding: 10px; - margin: 0 -20px 0 -20px; - border-bottom: 1px solid #f66; -} - -p.subhead { - font-weight: bold; - margin-top: 20px; -} - -a { - color: #355f7c; - text-decoration: none; -} - -a:hover { - text-decoration: underline; -} - -div.body h1, -div.body h2, -div.body h3, -div.body h4, -div.body h5, -div.body h6 { - font-family: 'Trebuchet MS', sans-serif; - background-color: #f2f2f2; - font-weight: normal; - color: #20435c; - border-bottom: 1px solid #ccc; - margin: 20px -20px 10px -20px; - padding: 3px 0 3px 10px; -} - -div.body h1 { margin-top: 0; font-size: 200%; } -div.body h2 { font-size: 160%; } -div.body h3 { font-size: 140%; } -div.body h4 { font-size: 120%; } -div.body h5 { font-size: 110%; } -div.body h6 { font-size: 100%; } - -a.headerlink { - color: #c60f0f; - font-size: 0.8em; - padding: 0 4px 0 4px; - text-decoration: none; - visibility: hidden; -} - -h1:hover > a.headerlink, -h2:hover > a.headerlink, -h3:hover > a.headerlink, -h4:hover > a.headerlink, -h5:hover > a.headerlink, -h6:hover > a.headerlink, -dt:hover > a.headerlink { - visibility: visible; -} - -a.headerlink:hover { - background-color: #c60f0f; - color: white; -} - -div.body p, div.body dd, div.body li { - text-align: justify; - line-height: 130%; -} - -div.body p.caption { - text-align: inherit; -} - -div.body td { - text-align: left; -} - -ul.fakelist { - list-style: none; - margin: 10px 0 10px 20px; - padding: 0; -} - -.field-list ul { - padding-left: 1em; -} - -.first { - margin-top: 0 !important; -} - -/* "Footnotes" heading */ -p.rubric { - margin-top: 30px; - font-weight: bold; -} - -/* Sidebars */ - -div.sidebar { - margin: 0 0 0.5em 1em; - border: 1px solid #ddb; - padding: 7px 7px 0 7px; - background-color: #ffe; - width: 40%; - float: right; -} - -p.sidebar-title { - font-weight: bold; -} - -/* "Topics" */ - -div.topic { - background-color: #eee; - border: 1px solid #ccc; - padding: 7px 7px 0 7px; - margin: 10px 0 10px 0; -} - -p.topic-title { - font-size: 1.1em; - font-weight: bold; - margin-top: 10px; -} - -/* Admonitions */ - -div.admonition { - margin-top: 10px; - margin-bottom: 10px; - padding: 7px; -} - -div.admonition dt { - font-weight: bold; -} - -div.admonition dl { - margin-bottom: 0; -} - -div.admonition p.admonition-title + p { - display: inline; -} - -div.seealso { - background-color: #ffc; - border: 1px solid #ff6; -} - -div.warning { - background-color: #ffe4e4; - border: 1px solid #f66; -} - -div.note { - background-color: #eee; - border: 1px solid #ccc; -} - -p.admonition-title { - margin: 0px 10px 5px 0px; - font-weight: bold; - display: inline; -} - -p.admonition-title:after { - content: ":"; -} - -div.body p.centered { - text-align: center; - margin-top: 25px; -} - -table.docutils { - border: 0; -} - -table.docutils td, table.docutils th { - padding: 1px 8px 1px 0; - border-top: 0; - border-left: 0; - border-right: 0; - border-bottom: 1px solid #aaa; -} - -table.field-list td, table.field-list th { - border: 0 !important; -} - -table.footnote td, table.footnote th { - border: 0 !important; -} - -.field-list ul { - margin: 0; - padding-left: 1em; -} - -.field-list p { - margin: 0; -} - -dl { - margin-bottom: 15px; - clear: both; -} - -dd p { - margin-top: 0px; -} - -dd ul, dd table { - margin-bottom: 10px; -} - -dd { - margin-top: 3px; - margin-bottom: 10px; - margin-left: 30px; -} - -.refcount { - color: #060; -} - -dt:target, -.highlight { - background-color: #fbe54e; -} - -dl.glossary dt { - font-weight: bold; - font-size: 1.1em; -} - -th { - text-align: left; - padding-right: 5px; -} - -pre { - padding: 5px; - background-color: #efc; - color: #333; - border: 1px solid #ac9; - border-left: none; - border-right: none; - overflow: auto; -} - -td.linenos pre { - padding: 5px 0px; - border: 0; - background-color: transparent; - color: #aaa; -} - -table.highlighttable { - margin-left: 0.5em; -} - -table.highlighttable td { - padding: 0 0.5em 0 0.5em; -} - -tt { - background-color: #ecf0f3; - padding: 0 1px 0 1px; - font-size: 0.95em; -} - -tt.descname { - background-color: transparent; - font-weight: bold; - font-size: 1.2em; -} - -tt.descclassname { - background-color: transparent; -} - -tt.xref, a tt { - background-color: transparent; - font-weight: bold; -} - -.footnote:target { background-color: #ffa } - -h1 tt, h2 tt, h3 tt, h4 tt, h5 tt, h6 tt { - background-color: transparent; -} - -.optional { - font-size: 1.3em; -} - -.versionmodified { - font-style: italic; -} - -form.comment { - margin: 0; - padding: 10px 30px 10px 30px; - background-color: #eee; -} - -form.comment h3 { - background-color: #326591; - color: white; - margin: -10px -30px 10px -30px; - padding: 5px; - font-size: 1.4em; -} - -form.comment input, -form.comment textarea { - border: 1px solid #ccc; - padding: 2px; - font-family: sans-serif; - font-size: 100%; -} - -form.comment input[type="text"] { - width: 240px; -} - -form.comment textarea { - width: 100%; - height: 200px; - margin-bottom: 10px; -} - -.system-message { - background-color: #fda; - padding: 5px; - border: 3px solid red; -} - -img.math { - vertical-align: middle; -} - -div.math p { - text-align: center; -} - -span.eqno { - float: right; -} - -img.logo { - border: 0; -} - -/* :::: PRINT :::: */ -@media print { - div.document, - div.documentwrapper, - div.bodywrapper { - margin: 0; - width : 100%; - } - - div.sphinxsidebar, - div.related, - div.footer, - div#comments div.new-comment-box, - #top-link { - display: none; - } -} diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/static/doctools.js --- a/buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/static/doctools.js Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,232 +0,0 @@ -/// XXX: make it cross browser - -/** - * make the code below compatible with browsers without - * an installed firebug like debugger - */ -if (!window.console || !console.firebug) { - var names = ["log", "debug", "info", "warn", "error", "assert", "dir", "dirxml", - "group", "groupEnd", "time", "timeEnd", "count", "trace", "profile", "profileEnd"]; - window.console = {}; - for (var i = 0; i < names.length; ++i) - window.console[names[i]] = function() {} -} - -/** - * small helper function to urldecode strings - */ -jQuery.urldecode = function(x) { - return decodeURIComponent(x).replace(/\+/g, ' '); -} - -/** - * small helper function to urlencode strings - */ -jQuery.urlencode = encodeURIComponent; - -/** - * This function returns the parsed url parameters of the - * current request. Multiple values per key are supported, - * it will always return arrays of strings for the value parts. - */ -jQuery.getQueryParameters = function(s) { - if (typeof s == 'undefined') - s = document.location.search; - var parts = s.substr(s.indexOf('?') + 1).split('&'); - var result = {}; - for (var i = 0; i < parts.length; i++) { - var tmp = parts[i].split('=', 2); - var key = jQuery.urldecode(tmp[0]); - var value = jQuery.urldecode(tmp[1]); - if (key in result) - result[key].push(value); - else - result[key] = [value]; - } - return result; -} - -/** - * small function to check if an array contains - * a given item. - */ -jQuery.contains = function(arr, item) { - for (var i = 0; i < arr.length; i++) { - if (arr[i] == item) - return true; - } - return false; -} - -/** - * highlight a given string on a jquery object by wrapping it in - * span elements with the given class name. - */ -jQuery.fn.highlightText = function(text, className) { - function highlight(node) { - if (node.nodeType == 3) { - var val = node.nodeValue; - var pos = val.toLowerCase().indexOf(text); - if (pos >= 0 && !jQuery.className.has(node.parentNode, className)) { - var span = document.createElement("span"); - span.className = className; - span.appendChild(document.createTextNode(val.substr(pos, text.length))); - node.parentNode.insertBefore(span, node.parentNode.insertBefore( - document.createTextNode(val.substr(pos + text.length)), - node.nextSibling)); - node.nodeValue = val.substr(0, pos); - } - } - else if (!jQuery(node).is("button, select, textarea")) { - jQuery.each(node.childNodes, function() { - highlight(this) - }); - } - } - return this.each(function() { - highlight(this); - }); -} - -/** - * Small JavaScript module for the documentation. - */ -var Documentation = { - - init : function() { - this.fixFirefoxAnchorBug(); - this.highlightSearchWords(); - this.initModIndex(); - }, - - /** - * i18n support - */ - TRANSLATIONS : {}, - PLURAL_EXPR : function(n) { return n == 1 ? 0 : 1; }, - LOCALE : 'unknown', - - // gettext and ngettext don't access this so that the functions - // can savely bound to a different name (_ = Documentation.gettext) - gettext : function(string) { - var translated = Documentation.TRANSLATIONS[string]; - if (typeof translated == 'undefined') - return string; - return (typeof translated == 'string') ? translated : translated[0]; - }, - - ngettext : function(singular, plural, n) { - var translated = Documentation.TRANSLATIONS[singular]; - if (typeof translated == 'undefined') - return (n == 1) ? singular : plural; - return translated[Documentation.PLURALEXPR(n)]; - }, - - addTranslations : function(catalog) { - for (var key in catalog.messages) - this.TRANSLATIONS[key] = catalog.messages[key]; - this.PLURAL_EXPR = new Function('n', 'return +(' + catalog.plural_expr + ')'); - this.LOCALE = catalog.locale; - }, - - /** - * add context elements like header anchor links - */ - addContextElements : function() { - $('div[@id] > :header:first').each(function() { - $('\u00B6'). - attr('href', '#' + this.id). - attr('title', _('Permalink to this headline')). - appendTo(this); - }); - $('dt[@id]').each(function() { - $('\u00B6'). - attr('href', '#' + this.id). - attr('title', _('Permalink to this definition')). - appendTo(this); - }); - }, - - /** - * workaround a firefox stupidity - */ - fixFirefoxAnchorBug : function() { - if (document.location.hash && $.browser.mozilla) - window.setTimeout(function() { - document.location.href += ''; - }, 10); - }, - - /** - * highlight the search words provided in the url in the text - */ - highlightSearchWords : function() { - var params = $.getQueryParameters(); - var terms = (params.highlight) ? params.highlight[0].split(/\s+/) : []; - if (terms.length) { - var body = $('div.body'); - window.setTimeout(function() { - $.each(terms, function() { - body.highlightText(this.toLowerCase(), 'highlight'); - }); - }, 10); - $('

' + _('Hide Search Matches') + '

') - .appendTo($('.sidebar .this-page-menu')); - } - }, - - /** - * init the modindex toggle buttons - */ - initModIndex : function() { - var togglers = $('img.toggler').click(function() { - var src = $(this).attr('src'); - var idnum = $(this).attr('id').substr(7); - console.log($('tr.cg-' + idnum).toggle()); - if (src.substr(-9) == 'minus.png') - $(this).attr('src', src.substr(0, src.length-9) + 'plus.png'); - else - $(this).attr('src', src.substr(0, src.length-8) + 'minus.png'); - }).css('display', ''); - if (DOCUMENTATION_OPTIONS.COLLAPSE_MODINDEX) { - togglers.click(); - } - }, - - /** - * helper function to hide the search marks again - */ - hideSearchWords : function() { - $('.sidebar .this-page-menu li.highlight-link').fadeOut(300); - $('span.highlight').removeClass('highlight'); - }, - - /** - * make the url absolute - */ - makeURL : function(relativeURL) { - return DOCUMENTATION_OPTIONS.URL_ROOT + '/' + relativeURL; - }, - - /** - * get the current relative url - */ - getCurrentURL : function() { - var path = document.location.pathname; - var parts = path.split(/\//); - $.each(DOCUMENTATION_OPTIONS.URL_ROOT.split(/\//), function() { - if (this == '..') - parts.pop(); - }); - var url = parts.join('/'); - return path.substring(url.lastIndexOf('/') + 1, path.length - 1); - } -}; - -// quick alias for translations -_ = Documentation.gettext; - -$(document).ready(function() { - Documentation.init(); -}); diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/static/file.png Binary file buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/static/file.png has changed diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/static/jquery.js --- a/buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/static/jquery.js Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,32 +0,0 @@ -/* - * jQuery 1.2.6 - New Wave Javascript - * - * Copyright (c) 2008 John Resig (jquery.com) - * Dual licensed under the MIT (MIT-LICENSE.txt) - * and GPL (GPL-LICENSE.txt) licenses. - * - * $Date: 2008-05-24 14:22:17 -0400 (Sat, 24 May 2008) $ - * $Rev: 5685 $ - */ -(function(){var _jQuery=window.jQuery,_$=window.$;var jQuery=window.jQuery=window.$=function(selector,context){return new jQuery.fn.init(selector,context);};var quickExpr=/^[^<]*(<(.|\s)+>)[^>]*$|^#(\w+)$/,isSimple=/^.[^:#\[\.]*$/,undefined;jQuery.fn=jQuery.prototype={init:function(selector,context){selector=selector||document;if(selector.nodeType){this[0]=selector;this.length=1;return this;}if(typeof selector=="string"){var match=quickExpr.exec(selector);if(match&&(match[1]||!context)){if(match[1])selector=jQuery.clean([match[1]],context);else{var elem=document.getElementById(match[3]);if(elem){if(elem.id!=match[3])return jQuery().find(selector);return jQuery(elem);}selector=[];}}else -return jQuery(context).find(selector);}else if(jQuery.isFunction(selector))return jQuery(document)[jQuery.fn.ready?"ready":"load"](selector);return this.setArray(jQuery.makeArray(selector));},jquery:"1.2.6",size:function(){return this.length;},length:0,get:function(num){return num==undefined?jQuery.makeArray(this):this[num];},pushStack:function(elems){var ret=jQuery(elems);ret.prevObject=this;return ret;},setArray:function(elems){this.length=0;Array.prototype.push.apply(this,elems);return this;},each:function(callback,args){return jQuery.each(this,callback,args);},index:function(elem){var ret=-1;return jQuery.inArray(elem&&elem.jquery?elem[0]:elem,this);},attr:function(name,value,type){var options=name;if(name.constructor==String)if(value===undefined)return this[0]&&jQuery[type||"attr"](this[0],name);else{options={};options[name]=value;}return this.each(function(i){for(name in options)jQuery.attr(type?this.style:this,name,jQuery.prop(this,options[name],type,i,name));});},css:function(key,value){if((key=='width'||key=='height')&&parseFloat(value)<0)value=undefined;return this.attr(key,value,"curCSS");},text:function(text){if(typeof text!="object"&&text!=null)return this.empty().append((this[0]&&this[0].ownerDocument||document).createTextNode(text));var ret="";jQuery.each(text||this,function(){jQuery.each(this.childNodes,function(){if(this.nodeType!=8)ret+=this.nodeType!=1?this.nodeValue:jQuery.fn.text([this]);});});return ret;},wrapAll:function(html){if(this[0])jQuery(html,this[0].ownerDocument).clone().insertBefore(this[0]).map(function(){var elem=this;while(elem.firstChild)elem=elem.firstChild;return elem;}).append(this);return this;},wrapInner:function(html){return this.each(function(){jQuery(this).contents().wrapAll(html);});},wrap:function(html){return this.each(function(){jQuery(this).wrapAll(html);});},append:function(){return this.domManip(arguments,true,false,function(elem){if(this.nodeType==1)this.appendChild(elem);});},prepend:function(){return this.domManip(arguments,true,true,function(elem){if(this.nodeType==1)this.insertBefore(elem,this.firstChild);});},before:function(){return this.domManip(arguments,false,false,function(elem){this.parentNode.insertBefore(elem,this);});},after:function(){return this.domManip(arguments,false,true,function(elem){this.parentNode.insertBefore(elem,this.nextSibling);});},end:function(){return this.prevObject||jQuery([]);},find:function(selector){var elems=jQuery.map(this,function(elem){return jQuery.find(selector,elem);});return this.pushStack(/[^+>] [^+>]/.test(selector)||selector.indexOf("..")>-1?jQuery.unique(elems):elems);},clone:function(events){var ret=this.map(function(){if(jQuery.browser.msie&&!jQuery.isXMLDoc(this)){var clone=this.cloneNode(true),container=document.createElement("div");container.appendChild(clone);return jQuery.clean([container.innerHTML])[0];}else -return this.cloneNode(true);});var clone=ret.find("*").andSelf().each(function(){if(this[expando]!=undefined)this[expando]=null;});if(events===true)this.find("*").andSelf().each(function(i){if(this.nodeType==3)return;var events=jQuery.data(this,"events");for(var type in events)for(var handler in events[type])jQuery.event.add(clone[i],type,events[type][handler],events[type][handler].data);});return ret;},filter:function(selector){return this.pushStack(jQuery.isFunction(selector)&&jQuery.grep(this,function(elem,i){return selector.call(elem,i);})||jQuery.multiFilter(selector,this));},not:function(selector){if(selector.constructor==String)if(isSimple.test(selector))return this.pushStack(jQuery.multiFilter(selector,this,true));else -selector=jQuery.multiFilter(selector,this);var isArrayLike=selector.length&&selector[selector.length-1]!==undefined&&!selector.nodeType;return this.filter(function(){return isArrayLike?jQuery.inArray(this,selector)<0:this!=selector;});},add:function(selector){return this.pushStack(jQuery.unique(jQuery.merge(this.get(),typeof selector=='string'?jQuery(selector):jQuery.makeArray(selector))));},is:function(selector){return!!selector&&jQuery.multiFilter(selector,this).length>0;},hasClass:function(selector){return this.is("."+selector);},val:function(value){if(value==undefined){if(this.length){var elem=this[0];if(jQuery.nodeName(elem,"select")){var index=elem.selectedIndex,values=[],options=elem.options,one=elem.type=="select-one";if(index<0)return null;for(var i=one?index:0,max=one?index+1:options.length;i=0||jQuery.inArray(this.name,value)>=0);else if(jQuery.nodeName(this,"select")){var values=jQuery.makeArray(value);jQuery("option",this).each(function(){this.selected=(jQuery.inArray(this.value,values)>=0||jQuery.inArray(this.text,values)>=0);});if(!values.length)this.selectedIndex=-1;}else -this.value=value;});},html:function(value){return value==undefined?(this[0]?this[0].innerHTML:null):this.empty().append(value);},replaceWith:function(value){return this.after(value).remove();},eq:function(i){return this.slice(i,i+1);},slice:function(){return this.pushStack(Array.prototype.slice.apply(this,arguments));},map:function(callback){return this.pushStack(jQuery.map(this,function(elem,i){return callback.call(elem,i,elem);}));},andSelf:function(){return this.add(this.prevObject);},data:function(key,value){var parts=key.split(".");parts[1]=parts[1]?"."+parts[1]:"";if(value===undefined){var data=this.triggerHandler("getData"+parts[1]+"!",[parts[0]]);if(data===undefined&&this.length)data=jQuery.data(this[0],key);return data===undefined&&parts[1]?this.data(parts[0]):data;}else -return this.trigger("setData"+parts[1]+"!",[parts[0],value]).each(function(){jQuery.data(this,key,value);});},removeData:function(key){return this.each(function(){jQuery.removeData(this,key);});},domManip:function(args,table,reverse,callback){var clone=this.length>1,elems;return this.each(function(){if(!elems){elems=jQuery.clean(args,this.ownerDocument);if(reverse)elems.reverse();}var obj=this;if(table&&jQuery.nodeName(this,"table")&&jQuery.nodeName(elems[0],"tr"))obj=this.getElementsByTagName("tbody")[0]||this.appendChild(this.ownerDocument.createElement("tbody"));var scripts=jQuery([]);jQuery.each(elems,function(){var elem=clone?jQuery(this).clone(true)[0]:this;if(jQuery.nodeName(elem,"script"))scripts=scripts.add(elem);else{if(elem.nodeType==1)scripts=scripts.add(jQuery("script",elem).remove());callback.call(obj,elem);}});scripts.each(evalScript);});}};jQuery.fn.init.prototype=jQuery.fn;function evalScript(i,elem){if(elem.src)jQuery.ajax({url:elem.src,async:false,dataType:"script"});else -jQuery.globalEval(elem.text||elem.textContent||elem.innerHTML||"");if(elem.parentNode)elem.parentNode.removeChild(elem);}function now(){return+new Date;}jQuery.extend=jQuery.fn.extend=function(){var target=arguments[0]||{},i=1,length=arguments.length,deep=false,options;if(target.constructor==Boolean){deep=target;target=arguments[1]||{};i=2;}if(typeof target!="object"&&typeof target!="function")target={};if(length==i){target=this;--i;}for(;i-1;}},swap:function(elem,options,callback){var old={};for(var name in options){old[name]=elem.style[name];elem.style[name]=options[name];}callback.call(elem);for(var name in options)elem.style[name]=old[name];},css:function(elem,name,force){if(name=="width"||name=="height"){var val,props={position:"absolute",visibility:"hidden",display:"block"},which=name=="width"?["Left","Right"]:["Top","Bottom"];function getWH(){val=name=="width"?elem.offsetWidth:elem.offsetHeight;var padding=0,border=0;jQuery.each(which,function(){padding+=parseFloat(jQuery.curCSS(elem,"padding"+this,true))||0;border+=parseFloat(jQuery.curCSS(elem,"border"+this+"Width",true))||0;});val-=Math.round(padding+border);}if(jQuery(elem).is(":visible"))getWH();else -jQuery.swap(elem,props,getWH);return Math.max(0,val);}return jQuery.curCSS(elem,name,force);},curCSS:function(elem,name,force){var ret,style=elem.style;function color(elem){if(!jQuery.browser.safari)return false;var ret=defaultView.getComputedStyle(elem,null);return!ret||ret.getPropertyValue("color")=="";}if(name=="opacity"&&jQuery.browser.msie){ret=jQuery.attr(style,"opacity");return ret==""?"1":ret;}if(jQuery.browser.opera&&name=="display"){var save=style.outline;style.outline="0 solid black";style.outline=save;}if(name.match(/float/i))name=styleFloat;if(!force&&style&&style[name])ret=style[name];else if(defaultView.getComputedStyle){if(name.match(/float/i))name="float";name=name.replace(/([A-Z])/g,"-$1").toLowerCase();var computedStyle=defaultView.getComputedStyle(elem,null);if(computedStyle&&!color(elem))ret=computedStyle.getPropertyValue(name);else{var swap=[],stack=[],a=elem,i=0;for(;a&&color(a);a=a.parentNode)stack.unshift(a);for(;i]*?)\/>/g,function(all,front,tag){return tag.match(/^(abbr|br|col|img|input|link|meta|param|hr|area|embed)$/i)?all:front+">";});var tags=jQuery.trim(elem).toLowerCase(),div=context.createElement("div");var wrap=!tags.indexOf("",""]||!tags.indexOf("",""]||tags.match(/^<(thead|tbody|tfoot|colg|cap)/)&&[1,"","

"]||!tags.indexOf("",""]||(!tags.indexOf("",""]||!tags.indexOf("",""]||jQuery.browser.msie&&[1,"div

","

"]||[0,"",""];div.innerHTML=wrap[1]+elem+wrap[2];while(wrap[0]--)div=div.lastChild;if(jQuery.browser.msie){var tbody=!tags.indexOf(""&&tags.indexOf("=0;--j)if(jQuery.nodeName(tbody[j],"tbody")&&!tbody[j].childNodes.length)tbody[j].parentNode.removeChild(tbody[j]);if(/^\s/.test(elem))div.insertBefore(context.createTextNode(elem.match(/^\s*/)[0]),div.firstChild);}elem=jQuery.makeArray(div.childNodes);}if(elem.length===0&&(!jQuery.nodeName(elem,"form")&&!jQuery.nodeName(elem,"select")))return;if(elem[0]==undefined||jQuery.nodeName(elem,"form")||elem.options)ret.push(elem);else -ret=jQuery.merge(ret,elem);});return ret;},attr:function(elem,name,value){if(!elem||elem.nodeType==3||elem.nodeType==8)return undefined;var notxml=!jQuery.isXMLDoc(elem),set=value!==undefined,msie=jQuery.browser.msie;name=notxml&&jQuery.props[name]||name;if(elem.tagName){var special=/href|src|style/.test(name);if(name=="selected"&&jQuery.browser.safari)elem.parentNode.selectedIndex;if(name in elem&¬xml&&!special){if(set){if(name=="type"&&jQuery.nodeName(elem,"input")&&elem.parentNode)throw"type property can't be changed";elem[name]=value;}if(jQuery.nodeName(elem,"form")&&elem.getAttributeNode(name))return elem.getAttributeNode(name).nodeValue;return elem[name];}if(msie&¬xml&&name=="style")return jQuery.attr(elem.style,"cssText",value);if(set)elem.setAttribute(name,""+value);var attr=msie&¬xml&&special?elem.getAttribute(name,2):elem.getAttribute(name);return attr===null?undefined:attr;}if(msie&&name=="opacity"){if(set){elem.zoom=1;elem.filter=(elem.filter||"").replace(/alpha$[^)]*$/,"")+(parseInt(value)+''=="NaN"?"":"alpha(opacity="+value*100+")");}return elem.filter&&elem.filter.indexOf("opacity=")>=0?(parseFloat(elem.filter.match(/opacity=([^)]*)/)[1])/100)+'':"";}name=name.replace(/-([a-z])/ig,function(all,letter){return letter.toUpperCase();});if(set)elem[name]=value;return elem[name];},trim:function(text){return(text||"").replace(/^\s+|\s+$/g,"");},makeArray:function(array){var ret=[];if(array!=null){var i=array.length;if(i==null||array.split||array.setInterval||array.call)ret[0]=array;else -while(i)ret[--i]=array[i];}return ret;},inArray:function(elem,array){for(var i=0,length=array.length;i*",this).remove();while(this.firstChild)this.removeChild(this.firstChild);}},function(name,fn){jQuery.fn[name]=function(){return this.each(fn,arguments);};});jQuery.each(["Height","Width"],function(i,name){var type=name.toLowerCase();jQuery.fn[type]=function(size){return this[0]==window?jQuery.browser.opera&&document.body["client"+name]||jQuery.browser.safari&&window["inner"+name]||document.compatMode=="CSS1Compat"&&document.documentElement["client"+name]||document.body["client"+name]:this[0]==document?Math.max(Math.max(document.body["scroll"+name],document.documentElement["scroll"+name]),Math.max(document.body["offset"+name],document.documentElement["offset"+name])):size==undefined?(this.length?jQuery.css(this[0],type):null):this.css(type,size.constructor==String?size:size+"px");};});function num(elem,prop){return elem[0]&&parseInt(jQuery.curCSS(elem[0],prop,true),10)||0;}var chars=jQuery.browser.safari&&parseInt(jQuery.browser.version)<417?"(?:[\\w*_-]|\\\\.)":"(?:[\\w\u0128-\uFFFF*_-]|\\\\.)",quickChild=new RegExp("^>\\s*("+chars+"+)"),quickID=new RegExp("^("+chars+"+)(#)("+chars+"+)"),quickClass=new RegExp("^([#.]?)("+chars+"*)");jQuery.extend({expr:{"":function(a,i,m){return m[2]=="*"||jQuery.nodeName(a,m[2]);},"#":function(a,i,m){return a.getAttribute("id")==m[2];},":":{lt:function(a,i,m){return im[3]-0;},nth:function(a,i,m){return m[3]-0==i;},eq:function(a,i,m){return m[3]-0==i;},first:function(a,i){return i==0;},last:function(a,i,m,r){return i==r.length-1;},even:function(a,i){return i%2==0;},odd:function(a,i){return i%2;},"first-child":function(a){return a.parentNode.getElementsByTagName("*")[0]==a;},"last-child":function(a){return jQuery.nth(a.parentNode.lastChild,1,"previousSibling")==a;},"only-child":function(a){return!jQuery.nth(a.parentNode.lastChild,2,"previousSibling");},parent:function(a){return a.firstChild;},empty:function(a){return!a.firstChild;},contains:function(a,i,m){return(a.textContent||a.innerText||jQuery(a).text()||"").indexOf(m[3])>=0;},visible:function(a){return"hidden"!=a.type&&jQuery.css(a,"display")!="none"&&jQuery.css(a,"visibility")!="hidden";},hidden:function(a){return"hidden"==a.type||jQuery.css(a,"display")=="none"||jQuery.css(a,"visibility")=="hidden";},enabled:function(a){return!a.disabled;},disabled:function(a){return a.disabled;},checked:function(a){return a.checked;},selected:function(a){return a.selected||jQuery.attr(a,"selected");},text:function(a){return"text"==a.type;},radio:function(a){return"radio"==a.type;},checkbox:function(a){return"checkbox"==a.type;},file:function(a){return"file"==a.type;},password:function(a){return"password"==a.type;},submit:function(a){return"submit"==a.type;},image:function(a){return"image"==a.type;},reset:function(a){return"reset"==a.type;},button:function(a){return"button"==a.type||jQuery.nodeName(a,"button");},input:function(a){return/input|select|textarea|button/i.test(a.nodeName);},has:function(a,i,m){return jQuery.find(m[3],a).length;},header:function(a){return/h\d/i.test(a.nodeName);},animated:function(a){return jQuery.grep(jQuery.timers,function(fn){return a==fn.elem;}).length;}}},parse:[/^(\[) *@?([\w-]+) *([!*$^~=]*) *('?"?)(.*?)\4 *\]/,/^(:)([\w-]+)$"?'?(.*?(\(.*?$)?[^(]*?)"?'?\)/,new RegExp("^([:.#]*)("+chars+"+)")],multiFilter:function(expr,elems,not){var old,cur=[];while(expr&&expr!=old){old=expr;var f=jQuery.filter(expr,elems,not);expr=f.t.replace(/^\s*,\s*/,"");cur=not?elems=f.r:jQuery.merge(cur,f.r);}return cur;},find:function(t,context){if(typeof t!="string")return[t];if(context&&context.nodeType!=1&&context.nodeType!=9)return[];context=context||document;var ret=[context],done=[],last,nodeName;while(t&&last!=t){var r=[];last=t;t=jQuery.trim(t);var foundToken=false,re=quickChild,m=re.exec(t);if(m){nodeName=m[1].toUpperCase();for(var i=0;ret[i];i++)for(var c=ret[i].firstChild;c;c=c.nextSibling)if(c.nodeType==1&&(nodeName=="*"||c.nodeName.toUpperCase()==nodeName))r.push(c);ret=r;t=t.replace(re,"");if(t.indexOf(" ")==0)continue;foundToken=true;}else{re=/^([>+~])\s*(\w*)/i;if((m=re.exec(t))!=null){r=[];var merge={};nodeName=m[2].toUpperCase();m=m[1];for(var j=0,rl=ret.length;j=0;if(!not&&pass||not&&!pass)tmp.push(r[i]);}return tmp;},filter:function(t,r,not){var last;while(t&&t!=last){last=t;var p=jQuery.parse,m;for(var i=0;p[i];i++){m=p[i].exec(t);if(m){t=t.substring(m[0].length);m[2]=m[2].replace(/\\/g,"");break;}}if(!m)break;if(m[1]==":"&&m[2]=="not")r=isSimple.test(m[3])?jQuery.filter(m[3],r,true).r:jQuery(r).not(m[3]);else if(m[1]==".")r=jQuery.classFilter(r,m[2],not);else if(m[1]=="["){var tmp=[],type=m[3];for(var i=0,rl=r.length;i=0)^not)tmp.push(a);}r=tmp;}else if(m[1]==":"&&m[2]=="nth-child"){var merge={},tmp=[],test=/(-?)(\d*)n((?:\+|-)?\d*)/.exec(m[3]=="even"&&"2n"||m[3]=="odd"&&"2n+1"||!/\D/.test(m[3])&&"0n+"+m[3]||m[3]),first=(test[1]+(test[2]||1))-0,last=test[3]-0;for(var i=0,rl=r.length;i=0)add=true;if(add^not)tmp.push(node);}r=tmp;}else{var fn=jQuery.expr[m[1]];if(typeof fn=="object")fn=fn[m[2]];if(typeof fn=="string")fn=eval("false||function(a,i){return "+fn+";}");r=jQuery.grep(r,function(elem,i){return fn(elem,i,m,r);},not);}}return{r:r,t:t};},dir:function(elem,dir){var matched=[],cur=elem[dir];while(cur&&cur!=document){if(cur.nodeType==1)matched.push(cur);cur=cur[dir];}return matched;},nth:function(cur,result,dir,elem){result=result||1;var num=0;for(;cur;cur=cur[dir])if(cur.nodeType==1&&++num==result)break;return cur;},sibling:function(n,elem){var r=[];for(;n;n=n.nextSibling){if(n.nodeType==1&&n!=elem)r.push(n);}return r;}});jQuery.event={add:function(elem,types,handler,data){if(elem.nodeType==3||elem.nodeType==8)return;if(jQuery.browser.msie&&elem.setInterval)elem=window;if(!handler.guid)handler.guid=this.guid++;if(data!=undefined){var fn=handler;handler=this.proxy(fn,function(){return fn.apply(this,arguments);});handler.data=data;}var events=jQuery.data(elem,"events")||jQuery.data(elem,"events",{}),handle=jQuery.data(elem,"handle")||jQuery.data(elem,"handle",function(){if(typeof jQuery!="undefined"&&!jQuery.event.triggered)return jQuery.event.handle.apply(arguments.callee.elem,arguments);});handle.elem=elem;jQuery.each(types.split(/\s+/),function(index,type){var parts=type.split(".");type=parts[0];handler.type=parts[1];var handlers=events[type];if(!handlers){handlers=events[type]={};if(!jQuery.event.special[type]||jQuery.event.special[type].setup.call(elem)===false){if(elem.addEventListener)elem.addEventListener(type,handle,false);else if(elem.attachEvent)elem.attachEvent("on"+type,handle);}}handlers[handler.guid]=handler;jQuery.event.global[type]=true;});elem=null;},guid:1,global:{},remove:function(elem,types,handler){if(elem.nodeType==3||elem.nodeType==8)return;var events=jQuery.data(elem,"events"),ret,index;if(events){if(types==undefined||(typeof types=="string"&&types.charAt(0)=="."))for(var type in events)this.remove(elem,type+(types||""));else{if(types.type){handler=types.handler;types=types.type;}jQuery.each(types.split(/\s+/),function(index,type){var parts=type.split(".");type=parts[0];if(events[type]){if(handler)delete events[type][handler.guid];else -for(handler in events[type])if(!parts[1]||events[type][handler].type==parts[1])delete events[type][handler];for(ret in events[type])break;if(!ret){if(!jQuery.event.special[type]||jQuery.event.special[type].teardown.call(elem)===false){if(elem.removeEventListener)elem.removeEventListener(type,jQuery.data(elem,"handle"),false);else if(elem.detachEvent)elem.detachEvent("on"+type,jQuery.data(elem,"handle"));}ret=null;delete events[type];}}});}for(ret in events)break;if(!ret){var handle=jQuery.data(elem,"handle");if(handle)handle.elem=null;jQuery.removeData(elem,"events");jQuery.removeData(elem,"handle");}}},trigger:function(type,data,elem,donative,extra){data=jQuery.makeArray(data);if(type.indexOf("!")>=0){type=type.slice(0,-1);var exclusive=true;}if(!elem){if(this.global[type])jQuery("*").add([window,document]).trigger(type,data);}else{if(elem.nodeType==3||elem.nodeType==8)return undefined;var val,ret,fn=jQuery.isFunction(elem[type]||null),event=!data[0]||!data[0].preventDefault;if(event){data.unshift({type:type,target:elem,preventDefault:function(){},stopPropagation:function(){},timeStamp:now()});data[0][expando]=true;}data[0].type=type;if(exclusive)data[0].exclusive=true;var handle=jQuery.data(elem,"handle");if(handle)val=handle.apply(elem,data);if((!fn||(jQuery.nodeName(elem,'a')&&type=="click"))&&elem["on"+type]&&elem["on"+type].apply(elem,data)===false)val=false;if(event)data.shift();if(extra&&jQuery.isFunction(extra)){ret=extra.apply(elem,val==null?data:data.concat(val));if(ret!==undefined)val=ret;}if(fn&&donative!==false&&val!==false&&!(jQuery.nodeName(elem,'a')&&type=="click")){this.triggered=true;try{elem[type]();}catch(e){}}this.triggered=false;}return val;},handle:function(event){var val,ret,namespace,all,handlers;event=arguments[0]=jQuery.event.fix(event||window.event);namespace=event.type.split(".");event.type=namespace[0];namespace=namespace[1];all=!namespace&&!event.exclusive;handlers=(jQuery.data(this,"events")||{})[event.type];for(var j in handlers){var handler=handlers[j];if(all||handler.type==namespace){event.handler=handler;event.data=handler.data;ret=handler.apply(this,arguments);if(val!==false)val=ret;if(ret===false){event.preventDefault();event.stopPropagation();}}}return val;},fix:function(event){if(event[expando]==true)return event;var originalEvent=event;event={originalEvent:originalEvent};var props="altKey attrChange attrName bubbles button cancelable charCode clientX clientY ctrlKey currentTarget data detail eventPhase fromElement handler keyCode metaKey newValue originalTarget pageX pageY prevValue relatedNode relatedTarget screenX screenY shiftKey srcElement target timeStamp toElement type view wheelDelta which".split(" ");for(var i=props.length;i;i--)event[props[i]]=originalEvent[props[i]];event[expando]=true;event.preventDefault=function(){if(originalEvent.preventDefault)originalEvent.preventDefault();originalEvent.returnValue=false;};event.stopPropagation=function(){if(originalEvent.stopPropagation)originalEvent.stopPropagation();originalEvent.cancelBubble=true;};event.timeStamp=event.timeStamp||now();if(!event.target)event.target=event.srcElement||document;if(event.target.nodeType==3)event.target=event.target.parentNode;if(!event.relatedTarget&&event.fromElement)event.relatedTarget=event.fromElement==event.target?event.toElement:event.fromElement;if(event.pageX==null&&event.clientX!=null){var doc=document.documentElement,body=document.body;event.pageX=event.clientX+(doc&&doc.scrollLeft||body&&body.scrollLeft||0)-(doc.clientLeft||0);event.pageY=event.clientY+(doc&&doc.scrollTop||body&&body.scrollTop||0)-(doc.clientTop||0);}if(!event.which&&((event.charCode||event.charCode===0)?event.charCode:event.keyCode))event.which=event.charCode||event.keyCode;if(!event.metaKey&&event.ctrlKey)event.metaKey=event.ctrlKey;if(!event.which&&event.button)event.which=(event.button&1?1:(event.button&2?3:(event.button&4?2:0)));return event;},proxy:function(fn,proxy){proxy.guid=fn.guid=fn.guid||proxy.guid||this.guid++;return proxy;},special:{ready:{setup:function(){bindReady();return;},teardown:function(){return;}},mouseenter:{setup:function(){if(jQuery.browser.msie)return false;jQuery(this).bind("mouseover",jQuery.event.special.mouseenter.handler);return true;},teardown:function(){if(jQuery.browser.msie)return false;jQuery(this).unbind("mouseover",jQuery.event.special.mouseenter.handler);return true;},handler:function(event){if(withinElement(event,this))return true;event.type="mouseenter";return jQuery.event.handle.apply(this,arguments);}},mouseleave:{setup:function(){if(jQuery.browser.msie)return false;jQuery(this).bind("mouseout",jQuery.event.special.mouseleave.handler);return true;},teardown:function(){if(jQuery.browser.msie)return false;jQuery(this).unbind("mouseout",jQuery.event.special.mouseleave.handler);return true;},handler:function(event){if(withinElement(event,this))return true;event.type="mouseleave";return jQuery.event.handle.apply(this,arguments);}}}};jQuery.fn.extend({bind:function(type,data,fn){return type=="unload"?this.one(type,data,fn):this.each(function(){jQuery.event.add(this,type,fn||data,fn&&data);});},one:function(type,data,fn){var one=jQuery.event.proxy(fn||data,function(event){jQuery(this).unbind(event,one);return(fn||data).apply(this,arguments);});return this.each(function(){jQuery.event.add(this,type,one,fn&&data);});},unbind:function(type,fn){return this.each(function(){jQuery.event.remove(this,type,fn);});},trigger:function(type,data,fn){return this.each(function(){jQuery.event.trigger(type,data,this,true,fn);});},triggerHandler:function(type,data,fn){return this[0]&&jQuery.event.trigger(type,data,this[0],false,fn);},toggle:function(fn){var args=arguments,i=1;while(i=0){var selector=url.slice(off,url.length);url=url.slice(0,off);}callback=callback||function(){};var type="GET";if(params)if(jQuery.isFunction(params)){callback=params;params=null;}else{params=jQuery.param(params);type="POST";}var self=this;jQuery.ajax({url:url,type:type,dataType:"html",data:params,complete:function(res,status){if(status=="success"||status=="notmodified")self.html(selector?jQuery("

").append(res.responseText.replace(//g,"")).find(selector):res.responseText);self.each(callback,[res.responseText,status,res]);}});return this;},serialize:function(){return jQuery.param(this.serializeArray());},serializeArray:function(){return this.map(function(){return jQuery.nodeName(this,"form")?jQuery.makeArray(this.elements):this;}).filter(function(){return this.name&&!this.disabled&&(this.checked||/select|textarea/i.test(this.nodeName)||/text|hidden|password/i.test(this.type));}).map(function(i,elem){var val=jQuery(this).val();return val==null?null:val.constructor==Array?jQuery.map(val,function(val,i){return{name:elem.name,value:val};}):{name:elem.name,value:val};}).get();}});jQuery.each("ajaxStart,ajaxStop,ajaxComplete,ajaxError,ajaxSuccess,ajaxSend".split(","),function(i,o){jQuery.fn[o]=function(f){return this.bind(o,f);};});var jsc=now();jQuery.extend({get:function(url,data,callback,type){if(jQuery.isFunction(data)){callback=data;data=null;}return jQuery.ajax({type:"GET",url:url,data:data,success:callback,dataType:type});},getScript:function(url,callback){return jQuery.get(url,null,callback,"script");},getJSON:function(url,data,callback){return jQuery.get(url,data,callback,"json");},post:function(url,data,callback,type){if(jQuery.isFunction(data)){callback=data;data={};}return jQuery.ajax({type:"POST",url:url,data:data,success:callback,dataType:type});},ajaxSetup:function(settings){jQuery.extend(jQuery.ajaxSettings,settings);},ajaxSettings:{url:location.href,global:true,type:"GET",timeout:0,contentType:"application/x-www-form-urlencoded",processData:true,async:true,data:null,username:null,password:null,accepts:{xml:"application/xml, text/xml",html:"text/html",script:"text/javascript, application/javascript",json:"application/json, text/javascript",text:"text/plain",_default:"*/*"}},lastModified:{},ajax:function(s){s=jQuery.extend(true,s,jQuery.extend(true,{},jQuery.ajaxSettings,s));var jsonp,jsre=/=\?(&|$)/g,status,data,type=s.type.toUpperCase();if(s.data&&s.processData&&typeof s.data!="string")s.data=jQuery.param(s.data);if(s.dataType=="jsonp"){if(type=="GET"){if(!s.url.match(jsre))s.url+=(s.url.match(/\?/)?"&":"?")+(s.jsonp||"callback")+"=?";}else if(!s.data||!s.data.match(jsre))s.data=(s.data?s.data+"&":"")+(s.jsonp||"callback")+"=?";s.dataType="json";}if(s.dataType=="json"&&(s.data&&s.data.match(jsre)||s.url.match(jsre))){jsonp="jsonp"+jsc++;if(s.data)s.data=(s.data+"").replace(jsre,"="+jsonp+"$1");s.url=s.url.replace(jsre,"="+jsonp+"$1");s.dataType="script";window[jsonp]=function(tmp){data=tmp;success();complete();window[jsonp]=undefined;try{delete window[jsonp];}catch(e){}if(head)head.removeChild(script);};}if(s.dataType=="script"&&s.cache==null)s.cache=false;if(s.cache===false&&type=="GET"){var ts=now();var ret=s.url.replace(/(\?|&)_=.*?(&|$)/,"$1_="+ts+"$2");s.url=ret+((ret==s.url)?(s.url.match(/\?/)?"&":"?")+"_="+ts:"");}if(s.data&&type=="GET"){s.url+=(s.url.match(/\?/)?"&":"?")+s.data;s.data=null;}if(s.global&&!jQuery.active++)jQuery.event.trigger("ajaxStart");var remote=/^(?:\w+:)?\/\/([^\/?#]+)/;if(s.dataType=="script"&&type=="GET"&&remote.test(s.url)&&remote.exec(s.url)[1]!=location.host){var head=document.getElementsByTagName("head")[0];var script=document.createElement("script");script.src=s.url;if(s.scriptCharset)script.charset=s.scriptCharset;if(!jsonp){var done=false;script.onload=script.onreadystatechange=function(){if(!done&&(!this.readyState||this.readyState=="loaded"||this.readyState=="complete")){done=true;success();complete();head.removeChild(script);}};}head.appendChild(script);return undefined;}var requestDone=false;var xhr=window.ActiveXObject?new ActiveXObject("Microsoft.XMLHTTP"):new XMLHttpRequest();if(s.username)xhr.open(type,s.url,s.async,s.username,s.password);else -xhr.open(type,s.url,s.async);try{if(s.data)xhr.setRequestHeader("Content-Type",s.contentType);if(s.ifModified)xhr.setRequestHeader("If-Modified-Since",jQuery.lastModified[s.url]||"Thu, 01 Jan 1970 00:00:00 GMT");xhr.setRequestHeader("X-Requested-With","XMLHttpRequest");xhr.setRequestHeader("Accept",s.dataType&&s.accepts[s.dataType]?s.accepts[s.dataType]+", */*":s.accepts._default);}catch(e){}if(s.beforeSend&&s.beforeSend(xhr,s)===false){s.global&&jQuery.active--;xhr.abort();return false;}if(s.global)jQuery.event.trigger("ajaxSend",[xhr,s]);var onreadystatechange=function(isTimeout){if(!requestDone&&xhr&&(xhr.readyState==4||isTimeout=="timeout")){requestDone=true;if(ival){clearInterval(ival);ival=null;}status=isTimeout=="timeout"&&"timeout"||!jQuery.httpSuccess(xhr)&&"error"||s.ifModified&&jQuery.httpNotModified(xhr,s.url)&&"notmodified"||"success";if(status=="success"){try{data=jQuery.httpData(xhr,s.dataType,s.dataFilter);}catch(e){status="parsererror";}}if(status=="success"){var modRes;try{modRes=xhr.getResponseHeader("Last-Modified");}catch(e){}if(s.ifModified&&modRes)jQuery.lastModified[s.url]=modRes;if(!jsonp)success();}else -jQuery.handleError(s,xhr,status);complete();if(s.async)xhr=null;}};if(s.async){var ival=setInterval(onreadystatechange,13);if(s.timeout>0)setTimeout(function(){if(xhr){xhr.abort();if(!requestDone)onreadystatechange("timeout");}},s.timeout);}try{xhr.send(s.data);}catch(e){jQuery.handleError(s,xhr,null,e);}if(!s.async)onreadystatechange();function success(){if(s.success)s.success(data,status);if(s.global)jQuery.event.trigger("ajaxSuccess",[xhr,s]);}function complete(){if(s.complete)s.complete(xhr,status);if(s.global)jQuery.event.trigger("ajaxComplete",[xhr,s]);if(s.global&&!--jQuery.active)jQuery.event.trigger("ajaxStop");}return xhr;},handleError:function(s,xhr,status,e){if(s.error)s.error(xhr,status,e);if(s.global)jQuery.event.trigger("ajaxError",[xhr,s,e]);},active:0,httpSuccess:function(xhr){try{return!xhr.status&&location.protocol=="file:"||(xhr.status>=200&&xhr.status<300)||xhr.status==304||xhr.status==1223||jQuery.browser.safari&&xhr.status==undefined;}catch(e){}return false;},httpNotModified:function(xhr,url){try{var xhrRes=xhr.getResponseHeader("Last-Modified");return xhr.status==304||xhrRes==jQuery.lastModified[url]||jQuery.browser.safari&&xhr.status==undefined;}catch(e){}return false;},httpData:function(xhr,type,filter){var ct=xhr.getResponseHeader("content-type"),xml=type=="xml"||!type&&ct&&ct.indexOf("xml")>=0,data=xml?xhr.responseXML:xhr.responseText;if(xml&&data.documentElement.tagName=="parsererror")throw"parsererror";if(filter)data=filter(data,type);if(type=="script")jQuery.globalEval(data);if(type=="json")data=eval("("+data+")");return data;},param:function(a){var s=[];if(a.constructor==Array||a.jquery)jQuery.each(a,function(){s.push(encodeURIComponent(this.name)+"="+encodeURIComponent(this.value));});else -for(var j in a)if(a[j]&&a[j].constructor==Array)jQuery.each(a[j],function(){s.push(encodeURIComponent(j)+"="+encodeURIComponent(this));});else -s.push(encodeURIComponent(j)+"="+encodeURIComponent(jQuery.isFunction(a[j])?a[j]():a[j]));return s.join("&").replace(/%20/g,"+");}});jQuery.fn.extend({show:function(speed,callback){return speed?this.animate({height:"show",width:"show",opacity:"show"},speed,callback):this.filter(":hidden").each(function(){this.style.display=this.oldblock||"";if(jQuery.css(this,"display")=="none"){var elem=jQuery("<"+this.tagName+" />").appendTo("body");this.style.display=elem.css("display");if(this.style.display=="none")this.style.display="block";elem.remove();}}).end();},hide:function(speed,callback){return speed?this.animate({height:"hide",width:"hide",opacity:"hide"},speed,callback):this.filter(":visible").each(function(){this.oldblock=this.oldblock||jQuery.css(this,"display");this.style.display="none";}).end();},_toggle:jQuery.fn.toggle,toggle:function(fn,fn2){return jQuery.isFunction(fn)&&jQuery.isFunction(fn2)?this._toggle.apply(this,arguments):fn?this.animate({height:"toggle",width:"toggle",opacity:"toggle"},fn,fn2):this.each(function(){jQuery(this)[jQuery(this).is(":hidden")?"show":"hide"]();});},slideDown:function(speed,callback){return this.animate({height:"show"},speed,callback);},slideUp:function(speed,callback){return this.animate({height:"hide"},speed,callback);},slideToggle:function(speed,callback){return this.animate({height:"toggle"},speed,callback);},fadeIn:function(speed,callback){return this.animate({opacity:"show"},speed,callback);},fadeOut:function(speed,callback){return this.animate({opacity:"hide"},speed,callback);},fadeTo:function(speed,to,callback){return this.animate({opacity:to},speed,callback);},animate:function(prop,speed,easing,callback){var optall=jQuery.speed(speed,easing,callback);return this[optall.queue===false?"each":"queue"](function(){if(this.nodeType!=1)return false;var opt=jQuery.extend({},optall),p,hidden=jQuery(this).is(":hidden"),self=this;for(p in prop){if(prop[p]=="hide"&&hidden||prop[p]=="show"&&!hidden)return opt.complete.call(this);if(p=="height"||p=="width"){opt.display=jQuery.css(this,"display");opt.overflow=this.style.overflow;}}if(opt.overflow!=null)this.style.overflow="hidden";opt.curAnim=jQuery.extend({},prop);jQuery.each(prop,function(name,val){var e=new jQuery.fx(self,opt,name);if(/toggle|show|hide/.test(val))e[val=="toggle"?hidden?"show":"hide":val](prop);else{var parts=val.toString().match(/^([+-]=)?([\d+-.]+)(.*)$/),start=e.cur(true)||0;if(parts){var end=parseFloat(parts[2]),unit=parts[3]||"px";if(unit!="px"){self.style[name]=(end||1)+unit;start=((end||1)/e.cur(true))*start;self.style[name]=start+unit;}if(parts[1])end=((parts[1]=="-="?-1:1)*end)+start;e.custom(start,end,unit);}else -e.custom(start,val,"");}});return true;});},queue:function(type,fn){if(jQuery.isFunction(type)||(type&&type.constructor==Array)){fn=type;type="fx";}if(!type||(typeof type=="string"&&!fn))return queue(this[0],type);return this.each(function(){if(fn.constructor==Array)queue(this,type,fn);else{queue(this,type).push(fn);if(queue(this,type).length==1)fn.call(this);}});},stop:function(clearQueue,gotoEnd){var timers=jQuery.timers;if(clearQueue)this.queue([]);this.each(function(){for(var i=timers.length-1;i>=0;i--)if(timers[i].elem==this){if(gotoEnd)timers[i](true);timers.splice(i,1);}});if(!gotoEnd)this.dequeue();return this;}});var queue=function(elem,type,array){if(elem){type=type||"fx";var q=jQuery.data(elem,type+"queue");if(!q||array)q=jQuery.data(elem,type+"queue",jQuery.makeArray(array));}return q;};jQuery.fn.dequeue=function(type){type=type||"fx";return this.each(function(){var q=queue(this,type);q.shift();if(q.length)q[0].call(this);});};jQuery.extend({speed:function(speed,easing,fn){var opt=speed&&speed.constructor==Object?speed:{complete:fn||!fn&&easing||jQuery.isFunction(speed)&&speed,duration:speed,easing:fn&&easing||easing&&easing.constructor!=Function&&easing};opt.duration=(opt.duration&&opt.duration.constructor==Number?opt.duration:jQuery.fx.speeds[opt.duration])||jQuery.fx.speeds.def;opt.old=opt.complete;opt.complete=function(){if(opt.queue!==false)jQuery(this).dequeue();if(jQuery.isFunction(opt.old))opt.old.call(this);};return opt;},easing:{linear:function(p,n,firstNum,diff){return firstNum+diff*p;},swing:function(p,n,firstNum,diff){return((-Math.cos(p*Math.PI)/2)+0.5)*diff+firstNum;}},timers:[],timerId:null,fx:function(elem,options,prop){this.options=options;this.elem=elem;this.prop=prop;if(!options.orig)options.orig={};}});jQuery.fx.prototype={update:function(){if(this.options.step)this.options.step.call(this.elem,this.now,this);(jQuery.fx.step[this.prop]||jQuery.fx.step._default)(this);if(this.prop=="height"||this.prop=="width")this.elem.style.display="block";},cur:function(force){if(this.elem[this.prop]!=null&&this.elem.style[this.prop]==null)return this.elem[this.prop];var r=parseFloat(jQuery.css(this.elem,this.prop,force));return r&&r>-10000?r:parseFloat(jQuery.curCSS(this.elem,this.prop))||0;},custom:function(from,to,unit){this.startTime=now();this.start=from;this.end=to;this.unit=unit||this.unit||"px";this.now=this.start;this.pos=this.state=0;this.update();var self=this;function t(gotoEnd){return self.step(gotoEnd);}t.elem=this.elem;jQuery.timers.push(t);if(jQuery.timerId==null){jQuery.timerId=setInterval(function(){var timers=jQuery.timers;for(var i=0;ithis.options.duration+this.startTime){this.now=this.end;this.pos=this.state=1;this.update();this.options.curAnim[this.prop]=true;var done=true;for(var i in this.options.curAnim)if(this.options.curAnim[i]!==true)done=false;if(done){if(this.options.display!=null){this.elem.style.overflow=this.options.overflow;this.elem.style.display=this.options.display;if(jQuery.css(this.elem,"display")=="none")this.elem.style.display="block";}if(this.options.hide)this.elem.style.display="none";if(this.options.hide||this.options.show)for(var p in this.options.curAnim)jQuery.attr(this.elem.style,p,this.options.orig[p]);}if(done)this.options.complete.call(this.elem);return false;}else{var n=t-this.startTime;this.state=n/this.options.duration;this.pos=jQuery.easing[this.options.easing||(jQuery.easing.swing?"swing":"linear")](this.state,n,0,1,this.options.duration);this.now=this.start+((this.end-this.start)*this.pos);this.update();}return true;}};jQuery.extend(jQuery.fx,{speeds:{slow:600,fast:200,def:400},step:{scrollLeft:function(fx){fx.elem.scrollLeft=fx.now;},scrollTop:function(fx){fx.elem.scrollTop=fx.now;},opacity:function(fx){jQuery.attr(fx.elem.style,"opacity",fx.now);},_default:function(fx){fx.elem.style[fx.prop]=fx.now+fx.unit;}}});jQuery.fn.offset=function(){var left=0,top=0,elem=this[0],results;if(elem)with(jQuery.browser){var parent=elem.parentNode,offsetChild=elem,offsetParent=elem.offsetParent,doc=elem.ownerDocument,safari2=safari&&parseInt(version)<522&&!/adobeair/i.test(userAgent),css=jQuery.curCSS,fixed=css(elem,"position")=="fixed";if(elem.getBoundingClientRect){var box=elem.getBoundingClientRect();add(box.left+Math.max(doc.documentElement.scrollLeft,doc.body.scrollLeft),box.top+Math.max(doc.documentElement.scrollTop,doc.body.scrollTop));add(-doc.documentElement.clientLeft,-doc.documentElement.clientTop);}else{add(elem.offsetLeft,elem.offsetTop);while(offsetParent){add(offsetParent.offsetLeft,offsetParent.offsetTop);if(mozilla&&!/^t(able|d|h)$/i.test(offsetParent.tagName)||safari&&!safari2)border(offsetParent);if(!fixed&&css(offsetParent,"position")=="fixed")fixed=true;offsetChild=/^body$/i.test(offsetParent.tagName)?offsetChild:offsetParent;offsetParent=offsetParent.offsetParent;}while(parent&&parent.tagName&&!/^body|html$/i.test(parent.tagName)){if(!/^inline|table.*$/i.test(css(parent,"display")))add(-parent.scrollLeft,-parent.scrollTop);if(mozilla&&css(parent,"overflow")!="visible")border(parent);parent=parent.parentNode;}if((safari2&&(fixed||css(offsetChild,"position")=="absolute"))||(mozilla&&css(offsetChild,"position")!="absolute"))add(-doc.body.offsetLeft,-doc.body.offsetTop);if(fixed)add(Math.max(doc.documentElement.scrollLeft,doc.body.scrollLeft),Math.max(doc.documentElement.scrollTop,doc.body.scrollTop));}results={top:top,left:left};}function border(elem){add(jQuery.curCSS(elem,"borderLeftWidth",true),jQuery.curCSS(elem,"borderTopWidth",true));}function add(l,t){left+=parseInt(l,10)||0;top+=parseInt(t,10)||0;}return results;};jQuery.fn.extend({position:function(){var left=0,top=0,results;if(this[0]){var offsetParent=this.offsetParent(),offset=this.offset(),parentOffset=/^body|html$/i.test(offsetParent[0].tagName)?{top:0,left:0}:offsetParent.offset();offset.top-=num(this,'marginTop');offset.left-=num(this,'marginLeft');parentOffset.top+=num(offsetParent,'borderTopWidth');parentOffset.left+=num(offsetParent,'borderLeftWidth');results={top:offset.top-parentOffset.top,left:offset.left-parentOffset.left};}return results;},offsetParent:function(){var offsetParent=this[0].offsetParent;while(offsetParent&&(!/^body|html$/i.test(offsetParent.tagName)&&jQuery.css(offsetParent,'position')=='static'))offsetParent=offsetParent.offsetParent;return jQuery(offsetParent);}});jQuery.each(['Left','Top'],function(i,name){var method='scroll'+name;jQuery.fn[method]=function(val){if(!this[0])return;return val!=undefined?this.each(function(){this==window||this==document?window.scrollTo(!i?val:jQuery(window).scrollLeft(),i?val:jQuery(window).scrollTop()):this[method]=val;}):this[0]==window||this[0]==document?self[i?'pageYOffset':'pageXOffset']||jQuery.boxModel&&document.documentElement[method]||document.body[method]:this[0][method];};});jQuery.each(["Height","Width"],function(i,name){var tl=i?"Left":"Top",br=i?"Right":"Bottom";jQuery.fn["inner"+name]=function(){return this[name.toLowerCase()]()+num(this,"padding"+tl)+num(this,"padding"+br);};jQuery.fn["outer"+name]=function(margin){return this["inner"+name]()+num(this,"border"+tl+"Width")+num(this,"border"+br+"Width")+(margin?num(this,"margin"+tl)+num(this,"margin"+br):0);};});})(); \ No newline at end of file diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/static/minus.png Binary file buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/static/minus.png has changed diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/static/navigation.png Binary file buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/static/navigation.png has changed diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/static/plus.png Binary file buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/static/plus.png has changed diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/static/rightsidebar.css --- a/buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/static/rightsidebar.css Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,16 +0,0 @@ -/** - * Sphinx Doc Design -- Right Side Bar Overrides - */ - - -div.sphinxsidebar { - float: right; -} - -div.bodywrapper { - margin: 0 230px 0 0; -} - -div.inlinecomments { - right: 250px; -} diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/static/searchtools.js --- a/buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/static/searchtools.js Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,467 +0,0 @@ -/** - * helper function to return a node containing the - * search summary for a given text. keywords is a list - * of stemmed words, hlwords is the list of normal, unstemmed - * words. the first one is used to find the occurance, the - * latter for highlighting it. - */ - -jQuery.makeSearchSummary = function(text, keywords, hlwords) { - var textLower = text.toLowerCase(); - var start = 0; - $.each(keywords, function() { - var i = textLower.indexOf(this.toLowerCase()); - if (i > -1) - start = i; - }); - start = Math.max(start - 120, 0); - var excerpt = ((start > 0) ? '...' : '') + - $.trim(text.substr(start, 240)) + - ((start + 240 - text.length) ? '...' : ''); - var rv = $('

').text(excerpt); - $.each(hlwords, function() { - rv = rv.highlightText(this, 'highlight'); - }); - return rv; -} - -/** - * Porter Stemmer - */ -var PorterStemmer = function() { - - var step2list = { - ational: 'ate', - tional: 'tion', - enci: 'ence', - anci: 'ance', - izer: 'ize', - bli: 'ble', - alli: 'al', - entli: 'ent', - eli: 'e', - ousli: 'ous', - ization: 'ize', - ation: 'ate', - ator: 'ate', - alism: 'al', - iveness: 'ive', - fulness: 'ful', - ousness: 'ous', - aliti: 'al', - iviti: 'ive', - biliti: 'ble', - logi: 'log' - }; - - var step3list = { - icate: 'ic', - ative: '', - alize: 'al', - iciti: 'ic', - ical: 'ic', - ful: '', - ness: '' - }; - - var c = "[^aeiou]"; // consonant - var v = "[aeiouy]"; // vowel - var C = c + "[^aeiouy]*"; // consonant sequence - var V = v + "[aeiou]*"; // vowel sequence - - var mgr0 = "^(" + C + ")?" + V + C; // [C]VC... is m>0 - var meq1 = "^(" + C + ")?" + V + C + "(" + V + ")?$"; // [C]VC[V] is m=1 - var mgr1 = "^(" + C + ")?" + V + C + V + C; // [C]VCVC... is m>1 - var s_v = "^(" + C + ")?" + v; // vowel in stem - - this.stemWord = function (w) { - var stem; - var suffix; - var firstch; - var origword = w; - - if (w.length < 3) - return w; - - var re; - var re2; - var re3; - var re4; - - firstch = w.substr(0,1); - if (firstch == "y") - w = firstch.toUpperCase() + w.substr(1); - - // Step 1a - re = /^(.+?)(ss|i)es$/; - re2 = /^(.+?)([^s])s$/; - - if (re.test(w)) - w = w.replace(re,"$1$2"); - else if (re2.test(w)) - w = w.replace(re2,"$1$2"); - - // Step 1b - re = /^(.+?)eed$/; - re2 = /^(.+?)(ed|ing)$/; - if (re.test(w)) { - var fp = re.exec(w); - re = new RegExp(mgr0); - if (re.test(fp[1])) { - re = /.$/; - w = w.replace(re,""); - } - } - else if (re2.test(w)) { - var fp = re2.exec(w); - stem = fp[1]; - re2 = new RegExp(s_v); - if (re2.test(stem)) { - w = stem; - re2 = /(at|bl|iz)$/; - re3 = new RegExp("([^aeiouylsz])\\1$"); - re4 = new RegExp("^" + C + v + "[^aeiouwxy]$"); - if (re2.test(w)) - w = w + "e"; - else if (re3.test(w)) { - re = /.$/; - w = w.replace(re,""); - } - else if (re4.test(w)) - w = w + "e"; - } - } - - // Step 1c - re = /^(.+?)y$/; - if (re.test(w)) { - var fp = re.exec(w); - stem = fp[1]; - re = new RegExp(s_v); - if (re.test(stem)) - w = stem + "i"; - } - - // Step 2 - re = /^(.+?)(ational|tional|enci|anci|izer|bli|alli|entli|eli|ousli|ization|ation|ator|alism|iveness|fulness|ousness|aliti|iviti|biliti|logi)$/; - if (re.test(w)) { - var fp = re.exec(w); - stem = fp[1]; - suffix = fp[2]; - re = new RegExp(mgr0); - if (re.test(stem)) - w = stem + step2list[suffix]; - } - - // Step 3 - re = /^(.+?)(icate|ative|alize|iciti|ical|ful|ness)$/; - if (re.test(w)) { - var fp = re.exec(w); - stem = fp[1]; - suffix = fp[2]; - re = new RegExp(mgr0); - if (re.test(stem)) - w = stem + step3list[suffix]; - } - - // Step 4 - re = /^(.+?)(al|ance|ence|er|ic|able|ible|ant|ement|ment|ent|ou|ism|ate|iti|ous|ive|ize)$/; - re2 = /^(.+?)(s|t)(ion)$/; - if (re.test(w)) { - var fp = re.exec(w); - stem = fp[1]; - re = new RegExp(mgr1); - if (re.test(stem)) - w = stem; - } - else if (re2.test(w)) { - var fp = re2.exec(w); - stem = fp[1] + fp[2]; - re2 = new RegExp(mgr1); - if (re2.test(stem)) - w = stem; - } - - // Step 5 - re = /^(.+?)e$/; - if (re.test(w)) { - var fp = re.exec(w); - stem = fp[1]; - re = new RegExp(mgr1); - re2 = new RegExp(meq1); - re3 = new RegExp("^" + C + v + "[^aeiouwxy]$"); - if (re.test(stem) || (re2.test(stem) && !(re3.test(stem)))) - w = stem; - } - re = /ll$/; - re2 = new RegExp(mgr1); - if (re.test(w) && re2.test(w)) { - re = /.$/; - w = w.replace(re,""); - } - - // and turn initial Y back to y - if (firstch == "y") - w = firstch.toLowerCase() + w.substr(1); - return w; - } -} - - -/** - * Search Module - */ -var Search = { - - _index : null, - _queued_query : null, - _pulse_status : -1, - - init : function() { - var params = $.getQueryParameters(); - if (params.q) { - var query = params.q[0]; - $('input[@name="q"]')[0].value = query; - this.performSearch(query); - } - }, - - /** - * Sets the index - */ - setIndex : function(index) { - var q; - this._index = index; - if ((q = this._queued_query) !== null) { - this._queued_query = null; - Search.query(q); - } - }, - - hasIndex : function() { - return this._index !== null; - }, - - deferQuery : function(query) { - this._queued_query = query; - }, - - stopPulse : function() { - this._pulse_status = 0; - }, - - startPulse : function() { - if (this._pulse_status >= 0) - return; - function pulse() { - Search._pulse_status = (Search._pulse_status + 1) % 4; - var dotString = ''; - for (var i = 0; i < Search._pulse_status; i++) - dotString += '.'; - Search.dots.text(dotString); - if (Search._pulse_status > -1) - window.setTimeout(pulse, 500); - }; - pulse(); - }, - - /** - * perform a search for something - */ - performSearch : function(query) { - // create the required interface elements - this.out = $('#search-results'); - this.title = $('

' + _('Searching') + '

').appendTo(this.out); - this.dots = $('').appendTo(this.title); - this.status = $('').appendTo(this.out); - this.output = $('

-      {{ text }}
-

- - diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/templates/changes/versionchanges.html --- a/buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/templates/changes/versionchanges.html Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,33 +0,0 @@ -{% macro entries changes %} -

{% for entry, docname, lineno in changes %} -

{{ entry }}

{% trans version=version|e, docstitle=docstitle|e %}Changes in Version {{ version }} — {{ docstitle }}{% endtrans %}

{% trans version=version|e %}Automatically generated list of changes in version {{ version }}{% endtrans %}

- {% for modname, changes in libchanges %} -

- {{ entries(changes) }} - {% endfor %} -

- {{ entries(apichanges) }} -

- {% for (fn, title), changes in otherchanges %} -

{{ title }} ({{ fn }})

- {{ entries(changes) }} - {% endfor %} -

- Welcome! This is - {% block description %}the documentation for {{ project|e }} - {{ release|e }}{% if last_updated %}, last updated {{ last_updated|e }}{% endif %}{% endblock %}. -

{{ _('Indices and tables:') }}

{{ _('Complete Table of Contents') }}
- {{ _('lists all sections and subsections') }}

{{ _('Search Page') }}
- {{ _('search this documentation') }}

{{ _('Global Module Index') }}
- {{ _('quick access to all modules') }}

{{ _('General Index') }}
- {{ _('all functions, classes, terms') }}

{% trans key=key %}Index – {{ key }}{% endtrans %}

{%- if links -%}{{ entryname|e }} - {%- for link in links[1:] %}, [{{ loop.index }}]{% endfor -%} - {%- else -%} -{{ entryname|e }} - {%- endif -%}

{{ subentryname|e }} - {%- for link in subentrylinks[1:] %}, [{{ loop.index }}]{% endfor -%} -

-{%- endif -%} -{%- endfor %} -

Index

{% for key, dummy in genindexentries -%} - {{ key }} - {% if not loop.last %}| {% endif %} - {%- endfor %}

{{ _('Full index on one page') }}

{{ _('Index pages by letter') }}:

{% for key, dummy in genindexentries -%} - {{ key }} - {% if not loop.last %}| {% endif %} - {%- endfor %}

{{ _('Full index on one page') }} - ({{ _('can be huge') }})

Index

{% for key, dummy in genindexentries -%} - {{ key }} - {% if not loop.last %}| {% endif %} - {%- endfor %}

{{ _('Full index on one page') }}

{{ key }}

{%- if links -%}{{ entryname|e }} - {%- for link in links[1:] %}, [{{ loop.index }}]{% endfor -%} - {%- else -%} -{{ entryname|e }} - {%- endif -%}

{{ subentryname|e }} - {%- for link in subentrylinks[1:] %}, [{{ loop.index }}]{% endfor -%} -

-{%- endif -%} -{%- endfor %} -

{% for key, dummy in genindexentries -%} - {{ key }} - {% if not loop.last %}| {% endif %} - {%- endfor %}

{{ _('Full index on one page') }}

- {%- block sidebarlogo %} - {%- if logo %} -

- -

- {%- endif %} - {%- endblock %} - {%- block sidebartoc %} - {%- if display_toc %} -

- {{ toc }} - {%- endif %} - {%- endblock %} - {%- block sidebarrel %} - {%- if prev %} -

- {%- endif %} - {%- if next %} -

- {%- endif %} - {%- endblock %} - {%- if sourcename %} -

- - {%- endif %} - {%- if customsidebar %} - {{ rendertemplate(customsidebar) }} - {%- endif %} - {%- block sidebarsearch %} - {%- if pagename != "search" %} -

{% if builder == 'web' %}{{ _('Keyword search')}}{% else %}{{ _('Quick search') }}{% endif %}

- - {%- if builder == 'web' %} -

- {%- endif %} - {%- endif %} - {%- endblock %} -

- {%- if builder != 'htmlhelp' %} -

- {%- endif %} -

- {% block body %} {% endblock %} -

- {%- if builder != 'htmlhelp' %} -

- {%- endif %} -

-{%- endblock %} - -{%- block sidebar2 %}{{ sidebar() }}{% endblock %} -

- {%- if hasdoc('copyright') %} - {% trans path=pathto('copyright'), copyright=copyright|e %}© Copyright {{ copyright }}.{% endtrans %} - {%- else %} - {% trans copyright=copyright|e %}© Copyright {{ copyright }}.{% endtrans %} - {%- endif %} - {%- if last_updated %} - {% trans last_updated=last_updated|e %}Last updated on {{ last_updated }}.{% endtrans %} - {%- endif %} - {%- if show_sphinx %} - {% trans sphinx_version=sphinx_version|e %}Created using Sphinx {{ sphinx_version }}.{% endtrans %} - {%- endif %} -

- {%- for module in freqentries %} - {{ module.name|e }} - {%- endfor %} -

{{ letter }}


	{{ fname }}
{% if collapse -%} - - {%- endif %}	{% if indent %} {% endif %} - {% if fname %}{% endif -%} - `{{ modname\|e }}` - {%- if fname %}{% endif %} - {%- if pform[0] %} ({{ pform\|join(', ') }}){% endif -%} -	{% if dep %}{{ _('Deprecated')}}:{% endif %} - {{ synops\|e }}

- {{ project|e }} - {% trans docstitle=docstitle|e %}Search {{ docstitle }}{% endtrans %} - utf-8 - - {{ docstitle|e }} -{% block extra %} {# Put e.g. an element here. #} {% endblock %} -

- {% trans %}Note: You requested an out-of-date URL from this server. We've tried to redirect you to the new location of this page, but it may not be the right one.{% endtrans %} -

- {% trans %}From here you can search these documents. Enter your search - words into the box below and click "search". Note that the search - function will automatically search for all of the words. Pages - containing fewer words won't appear in the result list.{% endtrans %} -

- {% if search_results %} -

{{ caption }} -
{{ context|e }}
-

- {% endif %} -

' % node.astext()) - self.end_state() - raise nodes.SkipNode - - def visit_comment(self, node): - raise nodes.SkipNode - - def visit_meta(self, node): - # only valid for HTML - raise nodes.SkipNode - - def unknown_visit(self, node): - raise NotImplementedError('Unknown node: ' + node.__class__.__name__) diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/util/__init__.py --- a/buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/util/__init__.py Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,284 +0,0 @@ -# -*- coding: utf-8 -*- -""" - sphinx.util - ~~~~~~~~~~~ - - Utility functions for Sphinx. - - :copyright: 2007-2008 by Georg Brandl. - :license: BSD. -""" - -import os -import re -import sys -import time -import fnmatch -import tempfile -import traceback -from os import path - - -# Generally useful regular expressions. -ws_re = re.compile(r'\s+') -caption_ref_re = re.compile(r'^([^<]+?)\s*<(.+)>$') - - -# SEP separates path elements in the canonical file names -# -# Define SEP as a manifest constant, not so much because we expect it to change -# in the future as to avoid the suspicion that a stray "/" in the code is a -# hangover from more *nix-oriented origins. -SEP = "/" - -def os_path(canonicalpath): - return canonicalpath.replace(SEP, os.path.sep) - - -def relative_uri(base, to): - """Return a relative URL from ``base`` to ``to``.""" - b2 = base.split(SEP) - t2 = to.split(SEP) - # remove common segments - for x, y in zip(b2, t2): - if x != y: - break - b2.pop(0) - t2.pop(0) - return ('..' + SEP) * (len(b2)-1) + SEP.join(t2) - - -def ensuredir(path): - """Ensure that a path exists.""" - try: - os.makedirs(path) - except OSError, err: - if not err.errno == 17: - raise - - -def walk(top, topdown=True, followlinks=False): - """ - Backport of os.walk from 2.6, where the followlinks argument was added. - """ - names = os.listdir(top) - - dirs, nondirs = [], [] - for name in names: - if path.isdir(path.join(top, name)): - dirs.append(name) - else: - nondirs.append(name) - - if topdown: - yield top, dirs, nondirs - for name in dirs: - fullpath = path.join(top, name) - if followlinks or not path.islink(fullpath): - for x in walk(fullpath, topdown, followlinks): - yield x - if not topdown: - yield top, dirs, nondirs - - -def get_matching_docs(dirname, suffix, exclude_docs=(), exclude_dirs=(), - exclude_trees=(), exclude_dirnames=()): - """ - Get all file names (without suffix) matching a suffix in a - directory, recursively. - - Exclude docs in *exclude_docs*, exclude dirs in *exclude_dirs*, - prune dirs in *exclude_trees*, prune dirnames in *exclude_dirnames*. - """ - pattern = '*' + suffix - # dirname is a normalized absolute path. - dirname = path.normpath(path.abspath(dirname)) - dirlen = len(dirname) + 1 # exclude slash - for root, dirs, files in walk(dirname, followlinks=True): - if root[dirlen:] in exclude_dirs: - continue - if root[dirlen:] in exclude_trees: - del dirs[:] - continue - dirs.sort() - files.sort() - for prunedir in exclude_dirnames: - if prunedir in dirs: - dirs.remove(prunedir) - for sfile in files: - if not fnmatch.fnmatch(sfile, pattern): - continue - qualified_name = path.join(root[dirlen:], sfile[:-len(suffix)]) - qualified_name = qualified_name.replace(os.path.sep, SEP) - if qualified_name in exclude_docs: - continue - yield qualified_name - - -def mtimes_of_files(dirnames, suffix): - for dirname in dirnames: - for root, dirs, files in os.walk(dirname): - for sfile in files: - if sfile.endswith(suffix): - try: - yield path.getmtime(path.join(root, sfile)) - except EnvironmentError: - pass - - -def shorten_result(text='', keywords=[], maxlen=240, fuzz=60): - if not text: - text = '' - text_low = text.lower() - beg = -1 - for k in keywords: - i = text_low.find(k.lower()) - if (i > -1 and i < beg) or beg == -1: - beg = i - excerpt_beg = 0 - if beg > fuzz: - for sep in ('.', ':', ';', '='): - eb = text.find(sep, beg - fuzz, beg - 1) - if eb > -1: - eb += 1 - break - else: - eb = beg - fuzz - excerpt_beg = eb - if excerpt_beg < 0: - excerpt_beg = 0 - msg = text[excerpt_beg:beg+maxlen] - if beg > fuzz: - msg = '... ' + msg - if beg < len(text)-maxlen: - msg = msg + ' ...' - return msg - - -class attrdict(dict): - def __getattr__(self, key): - return self[key] - def __setattr__(self, key, val): - self[key] = val - def __delattr__(self, key): - del self[key] - - -def fmt_ex(ex): - """Format a single line with an exception description.""" - return traceback.format_exception_only(ex.__class__, ex)[-1].strip() - - -def rpartition(s, t): - """Similar to str.rpartition from 2.5, but doesn't return the separator.""" - i = s.rfind(t) - if i != -1: - return s[:i], s[i+len(t):] - return '', s - - -def format_exception_cut_frames(x=1): - """ - Format an exception with traceback, but only the last x frames. - """ - typ, val, tb = sys.exc_info() - #res = ['Traceback (most recent call last):\n'] - res = [] - tbres = traceback.format_tb(tb) - res += tbres[-x:] - res += traceback.format_exception_only(typ, val) - return ''.join(res) - - -def save_traceback(): - """ - Save the current exception's traceback in a temporary file. - """ - exc = traceback.format_exc() - fd, path = tempfile.mkstemp('.log', 'sphinx-err-') - os.write(fd, exc) - os.close(fd) - return path - - -def _translate_pattern(pat): - """ - Translate a shell-style glob pattern to a regular expression. - - Adapted from the fnmatch module, but enhanced so that single stars don't - match slashes. - """ - i, n = 0, len(pat) - res = '' - while i < n: - c = pat[i] - i += 1 - if c == '*': - if i < n and pat[i] == '*': - # double star matches slashes too - i += 1 - res = res + '.*' - else: - # single star doesn't match slashes - res = res + '[^/]*' - elif c == '?': - # question mark doesn't match slashes too - res = res + '[^/]' - elif c == '[': - j = i - if j < n and pat[j] == '!': - j += 1 - if j < n and pat[j] == ']': - j += 1 - while j < n and pat[j] != ']': - j += 1 - if j >= n: - res = res + '\\[' - else: - stuff = pat[i:j].replace('\\', '\\\\') - i = j + 1 - if stuff[0] == '!': - # negative pattern mustn't match slashes too - stuff = '^/' + stuff[1:] - elif stuff[0] == '^': - stuff = '\\' + stuff - res = '%s[%s]' % (res, stuff) - else: - res += re.escape(c) - return res + '$' - - -_pat_cache = {} - -def patfilter(names, pat): - """ - Return the subset of the list NAMES that match PAT. - Adapted from fnmatch module. - """ - result = [] - if pat not in _pat_cache: - _pat_cache[pat] = re.compile(_translate_pattern(pat)) - match = _pat_cache[pat].match - return filter(match, names) - - -no_fn_re = re.compile(r'[^a-zA-Z0-9_-]') - -def make_filename(string): - return no_fn_re.sub('', string) - - -def nested_parse_with_titles(state, content, node): - # hack around title style bookkeeping - surrounding_title_styles = state.memo.title_styles - surrounding_section_level = state.memo.section_level - state.memo.title_styles = [] - state.memo.section_level = 0 - state.nested_parse(content, 0, node, match_titles=1) - state.memo.title_styles = surrounding_title_styles - state.memo.section_level = surrounding_section_level - - -def ustrftime(format, *args): - # strftime for unicode strings - return time.strftime(unicode(format).encode('utf-8'), *args).decode('utf-8') diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/util/compat.py --- a/buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/util/compat.py Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,37 +0,0 @@ -# -*- coding: utf-8 -*- -""" - sphinx.util.compat - ~~~~~~~~~~~~~~~~~~ - - Stuff for docutils compatibility. - - :copyright: 2008 by Georg Brandl. - :license: BSD. -""" - -from docutils import nodes - - -# function missing in 0.5 SVN -def make_admonition(node_class, name, arguments, options, content, lineno, - content_offset, block_text, state, state_machine): - #if not content: - # error = state_machine.reporter.error( - # 'The "%s" admonition is empty; content required.' % (name), - # nodes.literal_block(block_text, block_text), line=lineno) - # return [error] - text = '\n'.join(content) - admonition_node = node_class(text) - if arguments: - title_text = arguments[0] - textnodes, messages = state.inline_text(title_text, lineno) - admonition_node += nodes.title(title_text, '', *textnodes) - admonition_node += messages - if options.has_key('class'): - classes = options['class'] - else: - classes = ['admonition-' + nodes.make_id(title_text)] - admonition_node['classes'] += classes - state.nested_parse(content, content_offset, admonition_node) - return [admonition_node] - diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/util/console.py --- a/buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/util/console.py Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,92 +0,0 @@ -# -*- coding: utf-8 -*- -""" - sphinx.util.console - ~~~~~~~~~~~~~~~~~~~ - - Format colored console output. - - :copyright: 2007-2008 by Georg Brandl. - :license: BSD. -""" - -import os - -codes = {} - -def get_terminal_width(): - """Borrowed from the py lib.""" - try: - import os, termios, fcntl, struct - call = fcntl.ioctl(0, termios.TIOCGWINSZ, "\000"*8) - height, width = struct.unpack("hhhh", call)[:2] - terminal_width = width - except (SystemExit, KeyboardInterrupt): - raise - except: - # FALLBACK - terminal_width = int(os.environ.get('COLUMNS', 80))-1 - return terminal_width - -_tw = get_terminal_width() - -def print_and_backspace(text, func): - if not codes: - # if no coloring, don't output fancy backspaces - func(text) - else: - func(text.ljust(_tw) + _tw * "\b") - -def color_terminal(): - if 'COLORTERM' in os.environ: - return True - term = os.environ.get('TERM', 'dumb').lower() - if 'xterm' in term or 'color' in term: - return True - return False - - -def nocolor(): - codes.clear() - -def coloron(): - codes.update(_orig_codes) - -def colorize(name, text): - return codes.get(name, '') + text + codes.get('reset', '') - -def create_color_func(name): - def inner(text): - return colorize(name, text) - globals()[name] = inner - -_attrs = { - 'reset': '39;49;00m', - 'bold': '01m', - 'faint': '02m', - 'standout': '03m', - 'underline': '04m', - 'blink': '05m', -} - -for _name, _value in _attrs.items(): - codes[_name] = '\x1b[' + _value - -_colors = [ - ('black', 'darkgray'), - ('darkred', 'red'), - ('darkgreen', 'green'), - ('brown', 'yellow'), - ('darkblue', 'blue'), - ('purple', 'fuchsia'), - ('turquoise', 'teal'), - ('lightgray', 'white'), -] - -for i, (dark, light) in enumerate(_colors): - codes[dark] = '\x1b[%im' % (i+30) - codes[light] = '\x1b[%i;01m' % (i+30) - -_orig_codes = codes.copy() - -for _name in codes: - create_color_func(_name) diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/util/jsdump.py --- a/buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/util/jsdump.py Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,193 +0,0 @@ -# -*- coding: utf-8 -*- -""" - sphinx.util.jsdump - ~~~~~~~~~~~~~~~~~~ - - This module implements a simple JavaScript serializer. - Uses the basestring encode function from simplejson. - - :copyright: 2008 by Armin Ronacher, Bob Ippolito, Georg Brandl. - :license: BSD. -""" - -import re - -_str_re = re.compile(r'"(\\\\|\\"|[^"])*"') -_int_re = re.compile(r'\d+') -_name_re = re.compile(r'[a-zA-Z]\w*') -_nameonly_re = re.compile(r'[a-zA-Z]\w*$') - -# escape \, ", control characters and everything outside ASCII -ESCAPE_ASCII = re.compile(r'([\\"]|[^\ -~])') -ESCAPE_DICT = { - '\\': '\\\\', - '"': '\\"', - '\b': '\\b', - '\f': '\\f', - '\n': '\\n', - '\r': '\\r', - '\t': '\\t', -} - -ESCAPED = re.compile(r'\\u.{4}|\\.') - - -def encode_string(s): - def replace(match): - s = match.group(0) - try: - return ESCAPE_DICT[s] - except KeyError: - n = ord(s) - if n < 0x10000: - return '\\u%04x' % (n,) - else: - # surrogate pair - n -= 0x10000 - s1 = 0xd800 | ((n >> 10) & 0x3ff) - s2 = 0xdc00 | (n & 0x3ff) - return '\\u%04x\\u%04x' % (s1, s2) - return '"' + str(ESCAPE_ASCII.sub(replace, s)) + '"' - -def decode_string(s): - return ESCAPED.sub(lambda m: eval('u"'+m.group()+'"'), s) - - -reswords = set("""\ -abstract else instanceof switch -boolean enum int synchronized -break export interface this -byte extends long throw -case false native throws -catch final new transient -char finally null true -class float package try -const for private typeof -continue function protected var -debugger goto public void -default if return volatile -delete implements short while -do import static with -double in super""".split()) - -def dumps(obj, key=False): - if key: - if not isinstance(obj, basestring): - obj = str(obj) - if _nameonly_re.match(obj) and obj not in reswords: - return obj # return it as a bare word - else: - return encode_string(obj) - if obj is None: - return 'null' - elif obj is True or obj is False: - return obj and 'true' or 'false' - elif isinstance(obj, (int, long, float)): - return str(obj) - elif isinstance(obj, dict): - return '{%s}' % ','.join('%s:%s' % ( - dumps(key, True), - dumps(value) - ) for key, value in obj.iteritems()) - elif isinstance(obj, (tuple, list, set)): - return '[%s]' % ','.join(dumps(x) for x in obj) - elif isinstance(obj, basestring): - return encode_string(obj) - raise TypeError(type(obj)) - -def dump(obj, f): - f.write(dumps(obj)) - - -def loads(x): - """Loader that can read the JS subset the indexer produces.""" - nothing = object() - i = 0 - n = len(x) - stack = [] - obj = nothing - key = False - keys = [] - while i < n: - c = x[i] - if c == '{': - obj = {} - stack.append(obj) - key = True - keys.append(nothing) - i += 1 - elif c == '[': - obj = [] - stack.append(obj) - key = False - keys.append(nothing) - i += 1 - elif c in '}]': - if key: - if keys[-1] is not nothing: - raise ValueError("unfinished dict") - # empty dict - key = False - oldobj = stack.pop() - keys.pop() - if stack: - obj = stack[-1] - if isinstance(obj, dict): - if keys[-1] is nothing: - raise ValueError("invalid key object", oldobj) - obj[keys[-1]] = oldobj - else: - obj.append(oldobj) - else: - break - i += 1 - elif c == ',': - if key: - raise ValueError("multiple keys") - if isinstance(obj, dict): - key = True - i += 1 - elif c == ':': - if not isinstance(obj, dict): - raise ValueError("colon in list") - i += 1 - if not key: - raise ValueError("multiple values") - key = False - else: - m = _str_re.match(x, i) - if m: - y = decode_string(m.group()[1:-1]) - else: - m = _int_re.match(x, i) - if m: - y = int(m.group()) - else: - m = _name_re.match(x, i) - if m: - y = m.group() - if y == 'true': - y = True - elif y == 'false': - y = False - elif y == 'null': - y = None - elif not key: - raise ValueError("bareword as value") - else: - raise ValueError("read error at pos %d" % i) - i = m.end() - if isinstance(obj, dict): - if key: - keys[-1] = y - else: - obj[keys[-1]] = y - key = False - else: - obj.append(y) - if obj is nothing: - raise ValueError("nothing loaded from string") - return obj - -def load(f): - return loads(f.read()) diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/util/png.py --- a/buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/util/png.py Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,58 +0,0 @@ -# -*- coding: utf-8 -*- -""" - sphinx.util.png - ~~~~~~~~~~~~~~~ - - PNG image manipulation helpers. - - :copyright: 2008 by Georg Brandl. - :license: BSD. -""" - -import struct -import binascii - -LEN_IEND = 12 -LEN_DEPTH = 22 - -DEPTH_CHUNK_LEN = struct.pack('!i', 10) -DEPTH_CHUNK_START = 'tEXtDepth\x00' -IEND_CHUNK = '\x00\x00\x00\x00IEND\xAE\x42\x60\x82' - - -def read_png_depth(filename): - """ - Read the special tEXt chunk indicating the depth from a PNG file. - """ - result = None - f = open(filename, 'rb') - try: - f.seek(- (LEN_IEND + LEN_DEPTH), 2) - depthchunk = f.read(LEN_DEPTH) - if not depthchunk.startswith(DEPTH_CHUNK_LEN + DEPTH_CHUNK_START): - # either not a PNG file or not containing the depth chunk - return None - result = struct.unpack('!i', depthchunk[14:18])[0] - finally: - f.close() - return result - - -def write_png_depth(filename, depth): - """ - Write the special tEXt chunk indicating the depth to a PNG file. - The chunk is placed immediately before the special IEND chunk. - """ - data = struct.pack('!i', depth) - f = open(filename, 'r+b') - try: - # seek to the beginning of the IEND chunk - f.seek(-LEN_IEND, 2) - # overwrite it with the depth chunk - f.write(DEPTH_CHUNK_LEN + DEPTH_CHUNK_START + data) - # calculate the checksum over chunk name and data - f.write(struct.pack('!i', binascii.crc32(DEPTH_CHUNK_START + data))) - # replace the IEND chunk - f.write(IEND_CHUNK) - finally: - f.close() diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/util/smartypants.py --- a/buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/util/smartypants.py Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,303 +0,0 @@ -r""" -This is based on SmartyPants.py by `Chad Miller`_. - -Copyright and License -===================== - -SmartyPants_ license:: - - Copyright (c) 2003 John Gruber - (http://daringfireball.net/) - All rights reserved. - - Redistribution and use in source and binary forms, with or without - modification, are permitted provided that the following conditions are - met: - - * Redistributions of source code must retain the above copyright - notice, this list of conditions and the following disclaimer. - - * Redistributions in binary form must reproduce the above copyright - notice, this list of conditions and the following disclaimer in - the documentation and/or other materials provided with the - distribution. - - * Neither the name "SmartyPants" nor the names of its contributors - may be used to endorse or promote products derived from this - software without specific prior written permission. - - This software is provided by the copyright holders and contributors "as - is" and any express or implied warranties, including, but not limited - to, the implied warranties of merchantability and fitness for a - particular purpose are disclaimed. In no event shall the copyright - owner or contributors be liable for any direct, indirect, incidental, - special, exemplary, or consequential damages (including, but not - limited to, procurement of substitute goods or services; loss of use, - data, or profits; or business interruption) however caused and on any - theory of liability, whether in contract, strict liability, or tort - (including negligence or otherwise) arising in any way out of the use - of this software, even if advised of the possibility of such damage. - - -smartypants.py license:: - - smartypants.py is a derivative work of SmartyPants. - - Redistribution and use in source and binary forms, with or without - modification, are permitted provided that the following conditions are - met: - - * Redistributions of source code must retain the above copyright - notice, this list of conditions and the following disclaimer. - - * Redistributions in binary form must reproduce the above copyright - notice, this list of conditions and the following disclaimer in - the documentation and/or other materials provided with the - distribution. - - This software is provided by the copyright holders and contributors "as - is" and any express or implied warranties, including, but not limited - to, the implied warranties of merchantability and fitness for a - particular purpose are disclaimed. In no event shall the copyright - owner or contributors be liable for any direct, indirect, incidental, - special, exemplary, or consequential damages (including, but not - limited to, procurement of substitute goods or services; loss of use, - data, or profits; or business interruption) however caused and on any - theory of liability, whether in contract, strict liability, or tort - (including negligence or otherwise) arising in any way out of the use - of this software, even if advised of the possibility of such damage. - -.. _Chad Miller: http://web.chad.org/ -""" - -import re - - -def sphinx_smarty_pants(t): - t = t.replace('"', '"') - t = educateDashesOldSchool(t) - t = educateQuotes(t) - t = t.replace('"', '"') - return t - -# Constants for quote education. - -punct_class = r"""[!"#\$\%'()*+,-.\/:;<=>?\@\[\\\]\^_`{|}~]""" -close_class = r"""[^\ \t\r\n\[\{\(\-]""" -dec_dashes = r"""–|—""" - -# Special case if the very first character is a quote -# followed by punctuation at a non-word-break. Close the quotes by brute force: -single_quote_start_re = re.compile(r"""^'(?=%s\\B)""" % (punct_class,)) -double_quote_start_re = re.compile(r"""^"(?=%s\\B)""" % (punct_class,)) - -# Special case for double sets of quotes, e.g.: -#

He said, "'Quoted' words in a larger quote."

-double_quote_sets_re = re.compile(r""""'(?=\w)""") -single_quote_sets_re = re.compile(r"""'"(?=\w)""") - -# Special case for decade abbreviations (the '80s): -decade_abbr_re = re.compile(r"""\b'(?=\d{2}s)""") - -# Get most opening double quotes: -opening_double_quotes_regex = re.compile(r""" - ( - \s | # a whitespace char, or - | # a non-breaking space entity, or - -- | # dashes, or - &[mn]dash; | # named dash entities - %s | # or decimal entities - &\#x201[34]; # or hex - ) - " # the quote - (?=\w) # followed by a word character - """ % (dec_dashes,), re.VERBOSE) - -# Double closing quotes: -closing_double_quotes_regex = re.compile(r""" - #(%s)? # character that indicates the quote should be closing - " - (?=\s) - """ % (close_class,), re.VERBOSE) - -closing_double_quotes_regex_2 = re.compile(r""" - (%s) # character that indicates the quote should be closing - " - """ % (close_class,), re.VERBOSE) - -# Get most opening single quotes: -opening_single_quotes_regex = re.compile(r""" - ( - \s | # a whitespace char, or - | # a non-breaking space entity, or - -- | # dashes, or - &[mn]dash; | # named dash entities - %s | # or decimal entities - &\#x201[34]; # or hex - ) - ' # the quote - (?=\w) # followed by a word character - """ % (dec_dashes,), re.VERBOSE) - -closing_single_quotes_regex = re.compile(r""" - (%s) - ' - (?!\s | s\b | \d) - """ % (close_class,), re.VERBOSE) - -closing_single_quotes_regex_2 = re.compile(r""" - (%s) - ' - (\s | s\b) - """ % (close_class,), re.VERBOSE) - -def educateQuotes(s): - """ - Parameter: String. - - Returns: The string, with "educated" curly quote HTML entities. - - Example input: "Isn't this fun?" - Example output: “Isn’t this fun?” - """ - - # Special case if the very first character is a quote - # followed by punctuation at a non-word-break. Close the quotes by brute force: - s = single_quote_start_re.sub("’", s) - s = double_quote_start_re.sub("”", s) - - # Special case for double sets of quotes, e.g.: - #

He said, "'Quoted' words in a larger quote."

- s = double_quote_sets_re.sub("“‘", s) - s = single_quote_sets_re.sub("‘“", s) - - # Special case for decade abbreviations (the '80s): - s = decade_abbr_re.sub("’", s) - - s = opening_single_quotes_regex.sub(r"\1‘", s) - s = closing_single_quotes_regex.sub(r"\1’", s) - s = closing_single_quotes_regex_2.sub(r"\1’\2", s) - - # Any remaining single quotes should be opening ones: - s = s.replace("'", "‘") - - s = opening_double_quotes_regex.sub(r"\1“", s) - s = closing_double_quotes_regex.sub(r"”", s) - s = closing_double_quotes_regex_2.sub(r"\1”", s) - - # Any remaining quotes should be opening ones. - return s.replace('"', "“") - - -def educateQuotesLatex(s, dquotes=("``", "''")): - """ - Parameter: String. - - Returns: The string, with double quotes corrected to LaTeX quotes. - - Example input: "Isn't this fun?" - Example output: ``Isn't this fun?''; - """ - - # Special case if the very first character is a quote - # followed by punctuation at a non-word-break. Close the quotes by brute force: - s = single_quote_start_re.sub("\x04", s) - s = double_quote_start_re.sub("\x02", s) - - # Special case for double sets of quotes, e.g.: - #

He said, "'Quoted' words in a larger quote."

- s = double_quote_sets_re.sub("\x01\x03", s) - s = single_quote_sets_re.sub("\x03\x01", s) - - # Special case for decade abbreviations (the '80s): - s = decade_abbr_re.sub("\x04", s) - - s = opening_single_quotes_regex.sub("\\1\x03", s) - s = closing_single_quotes_regex.sub("\\1\x04", s) - s = closing_single_quotes_regex_2.sub("\\1\x04\\2", s) - - # Any remaining single quotes should be opening ones: - s = s.replace("'", "\x03") - - s = opening_double_quotes_regex.sub("\\1\x01", s) - s = closing_double_quotes_regex.sub("\x02", s) - s = closing_double_quotes_regex_2.sub("\\1\x02", s) - - # Any remaining quotes should be opening ones. - s = s.replace('"', "\x01") - - # Finally, replace all helpers with quotes. - return s.replace("\x01", dquotes[0]).replace("\x02", dquotes[1]).\ - replace("\x03", "`").replace("\x04", "'") - - -def educateBackticks(s): - """ - Parameter: String. - Returns: The string, with ``backticks'' -style double quotes - translated into HTML curly quote entities. - Example input: ``Isn't this fun?'' - Example output: “Isn't this fun?” - """ - return s.replace("``", "“").replace("''", "”") - - -def educateSingleBackticks(s): - """ - Parameter: String. - Returns: The string, with `backticks' -style single quotes - translated into HTML curly quote entities. - - Example input: `Isn't this fun?' - Example output: ‘Isn’t this fun?’ - """ - return s.replace('`', "‘").replace("'", "’") - - -def educateDashesOldSchool(s): - """ - Parameter: String. - - Returns: The string, with each instance of "--" translated to - an en-dash HTML entity, and each "---" translated to - an em-dash HTML entity. - """ - return s.replace('---', "—").replace('--', "–") - - -def educateDashesOldSchoolInverted(s): - """ - Parameter: String. - - Returns: The string, with each instance of "--" translated to - an em-dash HTML entity, and each "---" translated to - an en-dash HTML entity. Two reasons why: First, unlike the - en- and em-dash syntax supported by - EducateDashesOldSchool(), it's compatible with existing - entries written before SmartyPants 1.1, back when "--" was - only used for em-dashes. Second, em-dashes are more - common than en-dashes, and so it sort of makes sense that - the shortcut should be shorter to type. (Thanks to Aaron - Swartz for the idea.) - """ - return s.replace('---', "–").replace('--', "—") - - - -def educateEllipses(s): - """ - Parameter: String. - Returns: The string, with each instance of "..." translated to - an ellipsis HTML entity. - - Example input: Huh...? - Example output: Huh…? - """ - return s.replace('...', "…").replace('. . .', "…") - - -__author__ = "Chad Miller " -__version__ = "1.5_1.5: Sat, 13 Aug 2005 15:50:24 -0400" -__url__ = "http://wiki.chad.org/SmartyPantsPy" -__description__ = \ - "Smart-quotes, smart-ellipses, and smart-dashes for weblog entries in pyblosxom" diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/util/stemmer.py --- a/buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/util/stemmer.py Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,343 +0,0 @@ -# -*- coding: utf-8 -*- -""" - sphinx.util.stemmer - ~~~~~~~~~~~~~~~~~~~ - - Porter Stemming Algorithm - - This is the Porter stemming algorithm, ported to Python from the - version coded up in ANSI C by the author. It may be be regarded - as canonical, in that it follows the algorithm presented in - - Porter, 1980, An algorithm for suffix stripping, Program, Vol. 14, - no. 3, pp 130-137, - - only differing from it at the points maked --DEPARTURE-- below. - - See also http://www.tartarus.org/~martin/PorterStemmer - - The algorithm as described in the paper could be exactly replicated - by adjusting the points of DEPARTURE, but this is barely necessary, - because (a) the points of DEPARTURE are definitely improvements, and - (b) no encoding of the Porter stemmer I have seen is anything like - as exact as this version, even with the points of DEPARTURE! - - Release 1: January 2001 - - :copyright: 2001 by Vivake Gupta . - :license: Public Domain ("can be used free of charge for any purpose"). -""" - -class PorterStemmer(object): - - def __init__(self): - """The main part of the stemming algorithm starts here. - b is a buffer holding a word to be stemmed. The letters are in b[k0], - b[k0+1] ... ending at b[k]. In fact k0 = 0 in this demo program. k is - readjusted downwards as the stemming progresses. Zero termination is - not in fact used in the algorithm. - - Note that only lower case sequences are stemmed. Forcing to lower case - should be done before stem(...) is called. - """ - - self.b = "" # buffer for word to be stemmed - self.k = 0 - self.k0 = 0 - self.j = 0 # j is a general offset into the string - - def cons(self, i): - """cons(i) is TRUE <=> b[i] is a consonant.""" - if self.b[i] == 'a' or self.b[i] == 'e' or self.b[i] == 'i' \ - or self.b[i] == 'o' or self.b[i] == 'u': - return 0 - if self.b[i] == 'y': - if i == self.k0: - return 1 - else: - return (not self.cons(i - 1)) - return 1 - - def m(self): - """m() measures the number of consonant sequences between k0 and j. - if c is a consonant sequence and v a vowel sequence, and <..> - indicates arbitrary presence, - - gives 0 - vc gives 1 - vcvc gives 2 - vcvcvc gives 3 - .... - """ - n = 0 - i = self.k0 - while 1: - if i > self.j: - return n - if not self.cons(i): - break - i = i + 1 - i = i + 1 - while 1: - while 1: - if i > self.j: - return n - if self.cons(i): - break - i = i + 1 - i = i + 1 - n = n + 1 - while 1: - if i > self.j: - return n - if not self.cons(i): - break - i = i + 1 - i = i + 1 - - def vowelinstem(self): - """vowelinstem() is TRUE <=> k0,...j contains a vowel""" - for i in range(self.k0, self.j + 1): - if not self.cons(i): - return 1 - return 0 - - def doublec(self, j): - """doublec(j) is TRUE <=> j,(j-1) contain a double consonant.""" - if j < (self.k0 + 1): - return 0 - if (self.b[j] != self.b[j-1]): - return 0 - return self.cons(j) - - def cvc(self, i): - """cvc(i) is TRUE <=> i-2,i-1,i has the form consonant - vowel - consonant - and also if the second c is not w,x or y. this is used when trying to - restore an e at the end of a short e.g. - - cav(e), lov(e), hop(e), crim(e), but - snow, box, tray. - """ - if i < (self.k0 + 2) or not self.cons(i) or self.cons(i-1) or not self.cons(i-2): - return 0 - ch = self.b[i] - if ch == 'w' or ch == 'x' or ch == 'y': - return 0 - return 1 - - def ends(self, s): - """ends(s) is TRUE <=> k0,...k ends with the string s.""" - length = len(s) - if s[length - 1] != self.b[self.k]: # tiny speed-up - return 0 - if length > (self.k - self.k0 + 1): - return 0 - if self.b[self.k-length+1:self.k+1] != s: - return 0 - self.j = self.k - length - return 1 - - def setto(self, s): - """setto(s) sets (j+1),...k to the characters in the string s, readjusting k.""" - length = len(s) - self.b = self.b[:self.j+1] + s + self.b[self.j+length+1:] - self.k = self.j + length - - def r(self, s): - """r(s) is used further down.""" - if self.m() > 0: - self.setto(s) - - def step1ab(self): - """step1ab() gets rid of plurals and -ed or -ing. e.g. - - caresses -> caress - ponies -> poni - ties -> ti - caress -> caress - cats -> cat - - feed -> feed - agreed -> agree - disabled -> disable - - matting -> mat - mating -> mate - meeting -> meet - milling -> mill - messing -> mess - - meetings -> meet - """ - if self.b[self.k] == 's': - if self.ends("sses"): - self.k = self.k - 2 - elif self.ends("ies"): - self.setto("i") - elif self.b[self.k - 1] != 's': - self.k = self.k - 1 - if self.ends("eed"): - if self.m() > 0: - self.k = self.k - 1 - elif (self.ends("ed") or self.ends("ing")) and self.vowelinstem(): - self.k = self.j - if self.ends("at"): self.setto("ate") - elif self.ends("bl"): self.setto("ble") - elif self.ends("iz"): self.setto("ize") - elif self.doublec(self.k): - self.k = self.k - 1 - ch = self.b[self.k] - if ch == 'l' or ch == 's' or ch == 'z': - self.k = self.k + 1 - elif (self.m() == 1 and self.cvc(self.k)): - self.setto("e") - - def step1c(self): - """step1c() turns terminal y to i when there is another vowel in the stem.""" - if (self.ends("y") and self.vowelinstem()): - self.b = self.b[:self.k] + 'i' + self.b[self.k+1:] - - def step2(self): - """step2() maps double suffices to single ones. - so -ization ( = -ize plus -ation) maps to -ize etc. note that the - string before the suffix must give m() > 0. - """ - if self.b[self.k - 1] == 'a': - if self.ends("ational"): self.r("ate") - elif self.ends("tional"): self.r("tion") - elif self.b[self.k - 1] == 'c': - if self.ends("enci"): self.r("ence") - elif self.ends("anci"): self.r("ance") - elif self.b[self.k - 1] == 'e': - if self.ends("izer"): self.r("ize") - elif self.b[self.k - 1] == 'l': - if self.ends("bli"): self.r("ble") # --DEPARTURE-- - # To match the published algorithm, replace this phrase with - # if self.ends("abli"): self.r("able") - elif self.ends("alli"): self.r("al") - elif self.ends("entli"): self.r("ent") - elif self.ends("eli"): self.r("e") - elif self.ends("ousli"): self.r("ous") - elif self.b[self.k - 1] == 'o': - if self.ends("ization"): self.r("ize") - elif self.ends("ation"): self.r("ate") - elif self.ends("ator"): self.r("ate") - elif self.b[self.k - 1] == 's': - if self.ends("alism"): self.r("al") - elif self.ends("iveness"): self.r("ive") - elif self.ends("fulness"): self.r("ful") - elif self.ends("ousness"): self.r("ous") - elif self.b[self.k - 1] == 't': - if self.ends("aliti"): self.r("al") - elif self.ends("iviti"): self.r("ive") - elif self.ends("biliti"): self.r("ble") - elif self.b[self.k - 1] == 'g': # --DEPARTURE-- - if self.ends("logi"): self.r("log") - # To match the published algorithm, delete this phrase - - def step3(self): - """step3() dels with -ic-, -full, -ness etc. similar strategy to step2.""" - if self.b[self.k] == 'e': - if self.ends("icate"): self.r("ic") - elif self.ends("ative"): self.r("") - elif self.ends("alize"): self.r("al") - elif self.b[self.k] == 'i': - if self.ends("iciti"): self.r("ic") - elif self.b[self.k] == 'l': - if self.ends("ical"): self.r("ic") - elif self.ends("ful"): self.r("") - elif self.b[self.k] == 's': - if self.ends("ness"): self.r("") - - def step4(self): - """step4() takes off -ant, -ence etc., in context vcvc.""" - if self.b[self.k - 1] == 'a': - if self.ends("al"): pass - else: return - elif self.b[self.k - 1] == 'c': - if self.ends("ance"): pass - elif self.ends("ence"): pass - else: return - elif self.b[self.k - 1] == 'e': - if self.ends("er"): pass - else: return - elif self.b[self.k - 1] == 'i': - if self.ends("ic"): pass - else: return - elif self.b[self.k - 1] == 'l': - if self.ends("able"): pass - elif self.ends("ible"): pass - else: return - elif self.b[self.k - 1] == 'n': - if self.ends("ant"): pass - elif self.ends("ement"): pass - elif self.ends("ment"): pass - elif self.ends("ent"): pass - else: return - elif self.b[self.k - 1] == 'o': - if self.ends("ion") and (self.b[self.j] == 's' \ - or self.b[self.j] == 't'): pass - elif self.ends("ou"): pass - # takes care of -ous - else: return - elif self.b[self.k - 1] == 's': - if self.ends("ism"): pass - else: return - elif self.b[self.k - 1] == 't': - if self.ends("ate"): pass - elif self.ends("iti"): pass - else: return - elif self.b[self.k - 1] == 'u': - if self.ends("ous"): pass - else: return - elif self.b[self.k - 1] == 'v': - if self.ends("ive"): pass - else: return - elif self.b[self.k - 1] == 'z': - if self.ends("ize"): pass - else: return - else: - return - if self.m() > 1: - self.k = self.j - - def step5(self): - """step5() removes a final -e if m() > 1, and changes -ll to -l if - m() > 1. - """ - self.j = self.k - if self.b[self.k] == 'e': - a = self.m() - if a > 1 or (a == 1 and not self.cvc(self.k-1)): - self.k = self.k - 1 - if self.b[self.k] == 'l' and self.doublec(self.k) and self.m() > 1: - self.k = self.k -1 - - def stem(self, p, i, j): - """In stem(p,i,j), p is a char pointer, and the string to be stemmed - is from p[i] to p[j] inclusive. Typically i is zero and j is the - offset to the last character of a string, (p[j+1] == '\0'). The - stemmer adjusts the characters p[i] ... p[j] and returns the new - end-point of the string, k. Stemming never increases word length, so - i <= k <= j. To turn the stemmer into a module, declare 'stem' as - extern, and delete the remainder of this file. - """ - # copy the parameters into statics - self.b = p - self.k = j - self.k0 = i - if self.k <= self.k0 + 1: - return self.b # --DEPARTURE-- - - # With this line, strings of length 1 or 2 don't go through the - # stemming process, although no mention is made of this in the - # published algorithm. Remove the line to match the published - # algorithm. - - self.step1ab() - self.step1c() - self.step2() - self.step3() - self.step4() - self.step5() - return self.b[self.k0:self.k+1] diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/util/texescape.py --- a/buildframework/helium/external/python/lib/2.5/Sphinx-0.5.1-py2.5.egg/sphinx/util/texescape.py Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,110 +0,0 @@ -# -*- coding: utf-8 -*- -""" - sphinx.util.texescape - ~~~~~~~~~~~~~~~~~~~~~ - - TeX escaping helper. - - :copyright: 2008 by Georg Brandl. - :license: BSD. -""" - -tex_replacements = [ - # map TeX special chars - (u'$', ur'\$'), - (u'%', ur'\%'), - (u'&', ur'\&'), - (u'#', ur'\#'), - (u'_', ur'\_'), - (u'{', ur'\{'), - (u'}', ur'\}'), - (u'[', ur'{[}'), - (u']', ur'{]}'), - (u'`', ur'{}`'), - (u'\\',ur'\textbackslash{}'), - (u'~', ur'\textasciitilde{}'), - (u'<', ur'\textless{}'), - (u'>', ur'\textgreater{}'), - (u'^', ur'\textasciicircum{}'), - # map special Unicode characters to TeX commands - (u'¶', ur'\P{}'), - (u'§', ur'\S{}'), - (u'€', ur'\texteuro{}'), - (u'∞', ur'$\infty$'), - (u'±', ur'$\pm$'), - (u'→', ur'$\rightarrow$'), - (u'‣', ur'$\rightarrow$'), - # used to separate -- in options - (u'', ur'{}'), - # map some special Unicode characters to similar ASCII ones - (u'─', ur'-'), - (u'⎽', ur'\_'), - (u'╲', ur'\textbackslash{}'), - (u'│', ur'|'), - (u'ℯ', ur'e'), - (u'ⅈ', ur'i'), - (u'₁', ur'1'), - (u'₂', ur'2'), - # map Greek alphabet - (u'α', ur'$\alpha$'), - (u'β', ur'$\beta$'), - (u'γ', ur'$\gamma$'), - (u'δ', ur'$\delta$'), - (u'ε', ur'$\epsilon$'), - (u'ζ', ur'$\zeta$'), - (u'η', ur'$\eta$'), - (u'θ', ur'$\theta$'), - (u'ι', ur'$\iota$'), - (u'κ', ur'$\kappa$'), - (u'λ', ur'$\lambda$'), - (u'μ', ur'$\mu$'), - (u'ν', ur'$\nu$'), - (u'ξ', ur'$\xi$'), - (u'ο', ur'o'), - (u'π', ur'$\pi$'), - (u'ρ', ur'$\rho$'), - (u'σ', ur'$\sigma$'), - (u'τ', ur'$\tau$'), - (u'υ', u'\$\\upsilon\$'), - (u'φ', ur'$\phi$'), - (u'χ', ur'$\chi$'), - (u'ψ', ur'$\psi$'), - (u'ω', ur'$\omega$'), - (u'Α', ur'A'), - (u'Β', ur'B'), - (u'Γ', ur'$\Gamma$'), - (u'Δ', ur'$\Delta$'), - (u'Ε', ur'E'), - (u'Ζ', ur'Z'), - (u'Η', ur'H'), - (u'Θ', ur'$\Theta$'), - (u'Ι', ur'I'), - (u'Κ', ur'K'), - (u'Λ', ur'$\Lambda$'), - (u'Μ', ur'M'), - (u'Ν', ur'N'), - (u'Ξ', ur'$\Xi$'), - (u'Ο', ur'O'), - (u'Π', ur'$\Pi$'), - (u'Ρ', ur'P'), - (u'Σ', ur'$\Sigma$'), - (u'Τ', ur'T'), - (u'Υ', u'\$\\Upsilon\$'), - (u'Φ', ur'$\Phi$'), - (u'Χ', ur'X'), - (u'Ψ', ur'$\Psi$'), - (u'Ω', ur'$\Omega$'), - (u'Ω', ur'$\Omega$'), -] - -tex_escape_map = {} -tex_hl_escape_map = {} -_new_cmd_chars = {ord(u'\\'): u'@', ord(u'{'): u'[', ord(u'}'): u']'} - -def init(): - for a, b in tex_replacements: - tex_escape_map[ord(a)] = b - - for a, b in tex_replacements: - if a in u'[]{}\\': continue - tex_hl_escape_map[ord(a)] = b.translate(_new_cmd_chars) diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/coverage-2.85-py2.5.egg Binary file buildframework/helium/external/python/lib/2.5/coverage-2.85-py2.5.egg has changed diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/EGG-INFO/PKG-INFO --- a/buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/EGG-INFO/PKG-INFO Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,38 +0,0 @@ -Metadata-Version: 1.0 -Name: docutils -Version: 0.5 -Summary: Docutils -- Python Documentation Utilities -Home-page: http://docutils.sourceforge.net/ -Author: David Goodger -Author-email: goodger@python.org -License: public domain, Python, BSD, GPL (see COPYING.txt) -Description: Docutils is a modular system for processing documentation - into useful formats, such as HTML, XML, and LaTeX. For - input Docutils supports reStructuredText, an easy-to-read, - what-you-see-is-what-you-get plaintext markup syntax. -Platform: OS-independent -Classifier: Development Status :: 3 - Alpha -Classifier: Environment :: Console -Classifier: Intended Audience :: End Users/Desktop -Classifier: Intended Audience :: Other Audience -Classifier: Intended Audience :: Developers -Classifier: Intended Audience :: System Administrators -Classifier: License :: Public Domain -Classifier: License :: OSI Approved :: Python Software Foundation License -Classifier: License :: OSI Approved :: BSD License -Classifier: License :: OSI Approved :: GNU General Public License (GPL) -Classifier: Operating System :: OS Independent -Classifier: Programming Language :: Python -Classifier: Topic :: Documentation -Classifier: Topic :: Software Development :: Documentation -Classifier: Topic :: Text Processing -Classifier: Natural Language :: English -Classifier: Natural Language :: Afrikaans -Classifier: Natural Language :: Esperanto -Classifier: Natural Language :: French -Classifier: Natural Language :: German -Classifier: Natural Language :: Italian -Classifier: Natural Language :: Russian -Classifier: Natural Language :: Slovak -Classifier: Natural Language :: Spanish -Classifier: Natural Language :: Swedish diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/EGG-INFO/SOURCES.txt --- a/buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/EGG-INFO/SOURCES.txt Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,482 +0,0 @@ -BUGS.txt -COPYING.txt -FAQ.txt -HISTORY.txt -MANIFEST.in -README.txt -RELEASE-NOTES.txt -THANKS.txt -install.py -setup.py -docs/index.txt -docs/api/cmdline-tool.txt -docs/api/publisher.txt -docs/api/runtime-settings.txt -docs/dev/distributing.txt -docs/dev/enthought-plan.txt -docs/dev/enthought-rfp.txt -docs/dev/hacking.txt -docs/dev/policies.txt -docs/dev/pysource.dtd -docs/dev/pysource.txt -docs/dev/release.txt -docs/dev/repository.txt -docs/dev/semantics.txt -docs/dev/testing.txt -docs/dev/todo.txt -docs/dev/website.txt -docs/dev/rst/alternatives.txt -docs/dev/rst/problems.txt -docs/howto/html-stylesheets.txt -docs/howto/i18n.txt -docs/howto/rst-directives.txt -docs/howto/rst-roles.txt -docs/howto/security.txt -docs/peps/pep-0256.txt -docs/peps/pep-0257.txt -docs/peps/pep-0258.txt -docs/peps/pep-0287.txt -docs/ref/doctree.txt -docs/ref/docutils.dtd -docs/ref/soextblx.dtd -docs/ref/transforms.txt -docs/ref/rst/definitions.txt -docs/ref/rst/directives.txt -docs/ref/rst/introduction.txt -docs/ref/rst/restructuredtext.txt -docs/ref/rst/roles.txt -docs/user/Makefile.docutils-update -docs/user/config.txt -docs/user/emacs.txt -docs/user/latex.txt -docs/user/links.txt -docs/user/mailing-lists.txt -docs/user/slide-shows.txt -docs/user/tools.txt -docs/user/images/big-black.png -docs/user/images/big-white.png -docs/user/images/default.png -docs/user/images/happy_monkey.png -docs/user/images/medium-black.png -docs/user/images/medium-white.png -docs/user/images/rsp-all.png -docs/user/images/rsp-breaks.png -docs/user/images/rsp-covers.png -docs/user/images/rsp-cuts.png -docs/user/images/rsp-empty.png -docs/user/images/rsp-objects.png -docs/user/images/rsp.svg -docs/user/images/s5-files.png -docs/user/images/s5-files.svg -docs/user/images/small-black.png -docs/user/images/small-white.png -docs/user/rst/cheatsheet.txt -docs/user/rst/demo.txt -docs/user/rst/quickref.html -docs/user/rst/quickstart.txt -docs/user/rst/images/ball1.gif -docs/user/rst/images/biohazard.png -docs/user/rst/images/title.png -docutils/__init__.py -docutils/core.py -docutils/docutils.conf -docutils/examples.py -docutils/frontend.py -docutils/io.py -docutils/nodes.py -docutils/statemachine.py -docutils/urischemes.py -docutils/utils.py -docutils/languages/__init__.py -docutils/languages/af.py -docutils/languages/ca.py -docutils/languages/cs.py -docutils/languages/de.py -docutils/languages/en.py -docutils/languages/eo.py -docutils/languages/es.py -docutils/languages/fi.py -docutils/languages/fr.py -docutils/languages/he.py -docutils/languages/it.py -docutils/languages/ja.py -docutils/languages/nl.py -docutils/languages/pt_br.py -docutils/languages/ru.py -docutils/languages/sk.py -docutils/languages/sv.py -docutils/languages/zh_cn.py -docutils/languages/zh_tw.py -docutils/parsers/__init__.py -docutils/parsers/null.py -docutils/parsers/rst/__init__.py -docutils/parsers/rst/roles.py -docutils/parsers/rst/states.py -docutils/parsers/rst/tableparser.py -docutils/parsers/rst/directives/__init__.py -docutils/parsers/rst/directives/admonitions.py -docutils/parsers/rst/directives/body.py -docutils/parsers/rst/directives/html.py -docutils/parsers/rst/directives/images.py -docutils/parsers/rst/directives/misc.py -docutils/parsers/rst/directives/parts.py -docutils/parsers/rst/directives/references.py -docutils/parsers/rst/directives/tables.py -docutils/parsers/rst/include/README.txt -docutils/parsers/rst/include/isoamsa.txt -docutils/parsers/rst/include/isoamsb.txt -docutils/parsers/rst/include/isoamsc.txt -docutils/parsers/rst/include/isoamsn.txt -docutils/parsers/rst/include/isoamso.txt -docutils/parsers/rst/include/isoamsr.txt -docutils/parsers/rst/include/isobox.txt -docutils/parsers/rst/include/isocyr1.txt -docutils/parsers/rst/include/isocyr2.txt -docutils/parsers/rst/include/isodia.txt -docutils/parsers/rst/include/isogrk1.txt -docutils/parsers/rst/include/isogrk2.txt -docutils/parsers/rst/include/isogrk3.txt -docutils/parsers/rst/include/isogrk4-wide.txt -docutils/parsers/rst/include/isogrk4.txt -docutils/parsers/rst/include/isolat1.txt -docutils/parsers/rst/include/isolat2.txt -docutils/parsers/rst/include/isomfrk-wide.txt -docutils/parsers/rst/include/isomfrk.txt -docutils/parsers/rst/include/isomopf-wide.txt -docutils/parsers/rst/include/isomopf.txt -docutils/parsers/rst/include/isomscr-wide.txt -docutils/parsers/rst/include/isomscr.txt -docutils/parsers/rst/include/isonum.txt -docutils/parsers/rst/include/isopub.txt -docutils/parsers/rst/include/isotech.txt -docutils/parsers/rst/include/mmlalias.txt -docutils/parsers/rst/include/mmlextra-wide.txt -docutils/parsers/rst/include/mmlextra.txt -docutils/parsers/rst/include/s5defs.txt -docutils/parsers/rst/include/xhtml1-lat1.txt -docutils/parsers/rst/include/xhtml1-special.txt -docutils/parsers/rst/include/xhtml1-symbol.txt -docutils/parsers/rst/languages/__init__.py -docutils/parsers/rst/languages/af.py -docutils/parsers/rst/languages/ca.py -docutils/parsers/rst/languages/cs.py -docutils/parsers/rst/languages/de.py -docutils/parsers/rst/languages/en.py -docutils/parsers/rst/languages/eo.py -docutils/parsers/rst/languages/es.py -docutils/parsers/rst/languages/fi.py -docutils/parsers/rst/languages/fr.py -docutils/parsers/rst/languages/he.py -docutils/parsers/rst/languages/it.py -docutils/parsers/rst/languages/ja.py -docutils/parsers/rst/languages/nl.py -docutils/parsers/rst/languages/pt_br.py -docutils/parsers/rst/languages/ru.py -docutils/parsers/rst/languages/sk.py -docutils/parsers/rst/languages/sv.py -docutils/parsers/rst/languages/zh_cn.py -docutils/parsers/rst/languages/zh_tw.py -docutils/readers/__init__.py -docutils/readers/doctree.py -docutils/readers/pep.py -docutils/readers/standalone.py -docutils/readers/python/__init__.py -docutils/readers/python/moduleparser.py -docutils/readers/python/pynodes.py -docutils/transforms/__init__.py -docutils/transforms/components.py -docutils/transforms/frontmatter.py -docutils/transforms/misc.py -docutils/transforms/parts.py -docutils/transforms/peps.py -docutils/transforms/references.py -docutils/transforms/universal.py -docutils/transforms/writer_aux.py -docutils/writers/__init__.py -docutils/writers/docutils_xml.py -docutils/writers/null.py -docutils/writers/pseudoxml.py -docutils/writers/html4css1/__init__.py -docutils/writers/html4css1/html4css1.css -docutils/writers/html4css1/template.txt -docutils/writers/latex2e/__init__.py -docutils/writers/latex2e/latex2e.tex -docutils/writers/newlatex2e/__init__.py -docutils/writers/newlatex2e/base.tex -docutils/writers/newlatex2e/notes.txt -docutils/writers/newlatex2e/tests.txt -docutils/writers/newlatex2e/unicode_map.py -docutils/writers/pep_html/__init__.py -docutils/writers/pep_html/pep.css -docutils/writers/pep_html/template.txt -docutils/writers/s5_html/__init__.py -docutils/writers/s5_html/themes/README.txt -docutils/writers/s5_html/themes/big-black/__base__ -docutils/writers/s5_html/themes/big-black/framing.css -docutils/writers/s5_html/themes/big-black/pretty.css -docutils/writers/s5_html/themes/big-white/framing.css -docutils/writers/s5_html/themes/big-white/pretty.css -docutils/writers/s5_html/themes/default/blank.gif -docutils/writers/s5_html/themes/default/framing.css -docutils/writers/s5_html/themes/default/iepngfix.htc -docutils/writers/s5_html/themes/default/opera.css -docutils/writers/s5_html/themes/default/outline.css -docutils/writers/s5_html/themes/default/pretty.css -docutils/writers/s5_html/themes/default/print.css -docutils/writers/s5_html/themes/default/s5-core.css -docutils/writers/s5_html/themes/default/slides.css -docutils/writers/s5_html/themes/default/slides.js -docutils/writers/s5_html/themes/medium-black/__base__ -docutils/writers/s5_html/themes/medium-black/pretty.css -docutils/writers/s5_html/themes/medium-white/framing.css -docutils/writers/s5_html/themes/medium-white/pretty.css -docutils/writers/s5_html/themes/small-black/__base__ -docutils/writers/s5_html/themes/small-black/pretty.css -docutils/writers/s5_html/themes/small-white/framing.css -docutils/writers/s5_html/themes/small-white/pretty.css -extras/optparse.py -extras/roman.py -extras/textwrap.py -extras/docutils.egg-info/PKG-INFO -extras/docutils.egg-info/SOURCES.txt -extras/docutils.egg-info/dependency_links.txt -extras/docutils.egg-info/top_level.txt -licenses/docutils.conf -licenses/gpl.txt -licenses/python-2-1-1.txt -licenses/python-2-2.txt -licenses/python-2-3.txt -test/DocutilsTestSupport.py -test/alltests.py -test/coverage.sh -test/docutils.conf -test/docutils_difflib.py -test/package_unittest.py -test/test_dependencies.py -test/test_functional.py -test/test_io.py -test/test_language.py -test/test_nodes.py -test/test_pickle.py -test/test_publisher.py -test/test_settings.py -test/test_statemachine.py -test/test_traversals.py -test/test_utils.py -test/test_viewlist.py -test/data/config_1.txt -test/data/config_2.txt -test/data/config_error_handler.txt -test/data/config_list.txt -test/data/config_list_2.txt -test/data/config_old.txt -test/data/csv_data.txt -test/data/csv_dep.txt -test/data/dependencies.txt -test/data/full-template.txt -test/data/include.txt -test/data/raw.txt -test/data/stylesheet.txt -test/functional/README.txt -test/functional/expected/compact_lists.html -test/functional/expected/dangerous.html -test/functional/expected/field_name_limit.html -test/functional/expected/latex_docinfo.tex -test/functional/expected/misc_rst_html4css1.html -test/functional/expected/pep_html.html -test/functional/expected/standalone_rst_html4css1.html -test/functional/expected/standalone_rst_latex.tex -test/functional/expected/standalone_rst_pseudoxml.txt -test/functional/expected/standalone_rst_s5_html_1.html -test/functional/expected/standalone_rst_s5_html_2.html -test/functional/expected/ui/default/blank.gif -test/functional/expected/ui/default/framing.css -test/functional/expected/ui/default/iepngfix.htc -test/functional/expected/ui/default/opera.css -test/functional/expected/ui/default/outline.css -test/functional/expected/ui/default/pretty.css -test/functional/expected/ui/default/print.css -test/functional/expected/ui/default/s5-core.css -test/functional/expected/ui/default/slides.css -test/functional/expected/ui/default/slides.js -test/functional/expected/ui/small-black/blank.gif -test/functional/expected/ui/small-black/framing.css -test/functional/expected/ui/small-black/iepngfix.htc -test/functional/expected/ui/small-black/opera.css -test/functional/expected/ui/small-black/outline.css -test/functional/expected/ui/small-black/pretty.css -test/functional/expected/ui/small-black/print.css -test/functional/expected/ui/small-black/s5-core.css -test/functional/expected/ui/small-black/slides.css -test/functional/expected/ui/small-black/slides.js -test/functional/input/compact_lists.txt -test/functional/input/dangerous.txt -test/functional/input/field_list.txt -test/functional/input/latex_docinfo.txt -test/functional/input/pep_html.txt -test/functional/input/simple.txt -test/functional/input/standalone_rst_html4css1.txt -test/functional/input/standalone_rst_latex.txt -test/functional/input/standalone_rst_newlatex.txt -test/functional/input/standalone_rst_pseudoxml.txt -test/functional/input/standalone_rst_s5_html.txt -test/functional/input/data/custom_roles.txt -test/functional/input/data/errors.txt -test/functional/input/data/header_footer.txt -test/functional/input/data/latex.txt -test/functional/input/data/latex2e.txt -test/functional/input/data/list_table.txt -test/functional/input/data/nonalphanumeric.txt -test/functional/input/data/standard.txt -test/functional/input/data/table_colspan.txt -test/functional/input/data/table_complex.txt -test/functional/input/data/table_rowspan.txt -test/functional/input/data/unicode.txt -test/functional/output/README.txt -test/functional/tests/_default.py -test/functional/tests/_standalone_rst_defaults.py -test/functional/tests/compact_lists.py -test/functional/tests/dangerous.py -test/functional/tests/field_name_limit.py -test/functional/tests/latex_docinfo.py -test/functional/tests/misc_rst_html4css1.py -test/functional/tests/pep_html.py -test/functional/tests/standalone_rst_html4css1.py -test/functional/tests/standalone_rst_latex.py -test/functional/tests/standalone_rst_pseudoxml.py -test/functional/tests/standalone_rst_s5_html_1.py -test/functional/tests/standalone_rst_s5_html_2.py -test/test_parsers/__init__.py -test/test_parsers/test_rst/__init__.py -test/test_parsers/test_rst/test_SimpleTableParser.py -test/test_parsers/test_rst/test_TableParser.py -test/test_parsers/test_rst/test_block_quotes.py -test/test_parsers/test_rst/test_bullet_lists.py -test/test_parsers/test_rst/test_citations.py -test/test_parsers/test_rst/test_comments.py -test/test_parsers/test_rst/test_definition_lists.py -test/test_parsers/test_rst/test_doctest_blocks.py -test/test_parsers/test_rst/test_east_asian_text.py -test/test_parsers/test_rst/test_enumerated_lists.py -test/test_parsers/test_rst/test_field_lists.py -test/test_parsers/test_rst/test_footnotes.py -test/test_parsers/test_rst/test_functions.py -test/test_parsers/test_rst/test_inline_markup.py -test/test_parsers/test_rst/test_interpreted.py -test/test_parsers/test_rst/test_line_blocks.py -test/test_parsers/test_rst/test_literal_blocks.py -test/test_parsers/test_rst/test_option_lists.py -test/test_parsers/test_rst/test_outdenting.py -test/test_parsers/test_rst/test_paragraphs.py -test/test_parsers/test_rst/test_section_headers.py -test/test_parsers/test_rst/test_substitutions.py -test/test_parsers/test_rst/test_tables.py -test/test_parsers/test_rst/test_targets.py -test/test_parsers/test_rst/test_transitions.py -test/test_parsers/test_rst/includes/include9.txt -test/test_parsers/test_rst/test_directives/__init__.py -test/test_parsers/test_rst/test_directives/empty.txt -test/test_parsers/test_rst/test_directives/include 11.txt -test/test_parsers/test_rst/test_directives/include1.txt -test/test_parsers/test_rst/test_directives/include10.txt -test/test_parsers/test_rst/test_directives/include12.txt -test/test_parsers/test_rst/test_directives/include13.txt -test/test_parsers/test_rst/test_directives/include2.txt -test/test_parsers/test_rst/test_directives/include3.txt -test/test_parsers/test_rst/test_directives/include8.txt -test/test_parsers/test_rst/test_directives/raw1.txt -test/test_parsers/test_rst/test_directives/test_admonitions.py -test/test_parsers/test_rst/test_directives/test_block_quotes.py -test/test_parsers/test_rst/test_directives/test_class.py -test/test_parsers/test_rst/test_directives/test_compound.py -test/test_parsers/test_rst/test_directives/test_container.py -test/test_parsers/test_rst/test_directives/test_contents.py -test/test_parsers/test_rst/test_directives/test_date.py -test/test_parsers/test_rst/test_directives/test_decorations.py -test/test_parsers/test_rst/test_directives/test_default_role.py -test/test_parsers/test_rst/test_directives/test_figures.py -test/test_parsers/test_rst/test_directives/test_images.py -test/test_parsers/test_rst/test_directives/test_include.py -test/test_parsers/test_rst/test_directives/test_line_blocks.py -test/test_parsers/test_rst/test_directives/test_meta.py -test/test_parsers/test_rst/test_directives/test_parsed_literals.py -test/test_parsers/test_rst/test_directives/test_raw.py -test/test_parsers/test_rst/test_directives/test_replace.py -test/test_parsers/test_rst/test_directives/test_role.py -test/test_parsers/test_rst/test_directives/test_rubrics.py -test/test_parsers/test_rst/test_directives/test_sectnum.py -test/test_parsers/test_rst/test_directives/test_sidebars.py -test/test_parsers/test_rst/test_directives/test_tables.py -test/test_parsers/test_rst/test_directives/test_target_notes.py -test/test_parsers/test_rst/test_directives/test_test_directives.py -test/test_parsers/test_rst/test_directives/test_title.py -test/test_parsers/test_rst/test_directives/test_topics.py -test/test_parsers/test_rst/test_directives/test_unicode.py -test/test_parsers/test_rst/test_directives/test_unknown.py -test/test_parsers/test_rst/test_directives/utf-16.csv -test/test_parsers/test_rst/test_directives/includes/include4.txt -test/test_parsers/test_rst/test_directives/includes/include5.txt -test/test_parsers/test_rst/test_directives/includes/more/include6.txt -test/test_parsers/test_rst/test_directives/includes/sibling/include7.txt -test/test_readers/__init__.py -test/test_readers/test_pep/__init__.py -test/test_readers/test_pep/test_inline_markup.py -test/test_readers/test_pep/test_rfc2822.py -test/test_readers/test_python/__init__.py -test/test_readers/test_python/showast -test/test_readers/test_python/showdoc -test/test_readers/test_python/showparse -test/test_readers/test_python/showtok -test/test_readers/test_python/test_functions.py -test/test_readers/test_python/test_parser.py -test/test_readers/test_python/test_token_parser.py -test/test_transforms/__init__.py -test/test_transforms/test___init__.py -test/test_transforms/test_class.py -test/test_transforms/test_contents.py -test/test_transforms/test_docinfo.py -test/test_transforms/test_doctitle.py -test/test_transforms/test_expose_internals.py -test/test_transforms/test_filter.py -test/test_transforms/test_footnotes.py -test/test_transforms/test_hyperlinks.py -test/test_transforms/test_messages.py -test/test_transforms/test_peps.py -test/test_transforms/test_sectnum.py -test/test_transforms/test_strip_comments.py -test/test_transforms/test_substitutions.py -test/test_transforms/test_target_notes.py -test/test_transforms/test_transitions.py -test/test_transforms/test_writer_aux.py -test/test_writers/__init__.py -test/test_writers/test_docutils_xml.py -test/test_writers/test_html4css1_misc.py -test/test_writers/test_html4css1_parts.py -test/test_writers/test_html4css1_template.py -test/test_writers/test_latex2e.py -test/test_writers/test_null.py -test/test_writers/test_pseudoxml.py -test/test_writers/test_s5.py -tools/buildhtml.py -tools/docutils.conf -tools/quicktest.py -tools/rst2html.py -tools/rst2latex.py -tools/rst2newlatex.py -tools/rst2pseudoxml.py -tools/rst2s5.py -tools/rst2xml.py -tools/rstpep2html.py -tools/dev/README.txt -tools/dev/create_unimap.py -tools/dev/profile_docutils.py -tools/dev/unicode2rstsubs.py -tools/editors/README.txt -tools/editors/emacs/README.txt -tools/editors/emacs/docutils.conf -tools/editors/emacs/rst.el -tools/editors/emacs/tests/Makefile -tools/editors/emacs/tests/README.txt -tools/editors/emacs/tests/tests-adjust-section.el -tools/editors/emacs/tests/tests-basic.el -tools/editors/emacs/tests/tests-runner.el diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/EGG-INFO/dependency_links.txt --- a/buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/EGG-INFO/dependency_links.txt Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,1 +0,0 @@ - diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/EGG-INFO/not-zip-safe --- a/buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/EGG-INFO/not-zip-safe Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,1 +0,0 @@ - diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/EGG-INFO/scripts/rst2html.py --- a/buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/EGG-INFO/scripts/rst2html.py Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,23 +0,0 @@ -#!C:\Python25\python.exe - -# $Id: rst2html.py 4564 2006-05-21 20:44:42Z wiemann $ -# Author: David Goodger -# Copyright: This module has been placed in the public domain. - -""" -A minimal front end to the Docutils Publisher, producing HTML. -""" - -try: - import locale - locale.setlocale(locale.LC_ALL, '') -except: - pass - -from docutils.core import publish_cmdline, default_description - - -description = ('Generates (X)HTML documents from standalone reStructuredText ' - 'sources. ' + default_description) - -publish_cmdline(writer_name='html', description=description) diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/EGG-INFO/scripts/rst2latex.py --- a/buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/EGG-INFO/scripts/rst2latex.py Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,23 +0,0 @@ -#!C:\Python25\python.exe - -# $Id: rst2latex.py 4564 2006-05-21 20:44:42Z wiemann $ -# Author: David Goodger -# Copyright: This module has been placed in the public domain. - -""" -A minimal front end to the Docutils Publisher, producing LaTeX. -""" - -try: - import locale - locale.setlocale(locale.LC_ALL, '') -except: - pass - -from docutils.core import publish_cmdline, default_description - - -description = ('Generates LaTeX documents from standalone reStructuredText ' - 'sources. ' + default_description) - -publish_cmdline(writer_name='latex', description=description) diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/EGG-INFO/scripts/rst2newlatex.py --- a/buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/EGG-INFO/scripts/rst2newlatex.py Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,25 +0,0 @@ -#!C:\Python25\python.exe - -# $Id: rst2newlatex.py 4564 2006-05-21 20:44:42Z wiemann $ -# Author: David Goodger -# Copyright: This module has been placed in the public domain. - -""" -A minimal front end to the Docutils Publisher, producing LaTeX using -the new LaTeX writer. -""" - -try: - import locale - locale.setlocale(locale.LC_ALL, '') -except: - pass - -from docutils.core import publish_cmdline, default_description - - -description = ('Generates LaTeX documents from standalone reStructuredText ' - 'sources. This writer is EXPERIMENTAL and should not be used ' - 'in a production environment. ' + default_description) - -publish_cmdline(writer_name='newlatex2e', description=description) diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/EGG-INFO/scripts/rst2pseudoxml.py --- a/buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/EGG-INFO/scripts/rst2pseudoxml.py Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,23 +0,0 @@ -#!C:\Python25\python.exe - -# $Id: rst2pseudoxml.py 4564 2006-05-21 20:44:42Z wiemann $ -# Author: David Goodger -# Copyright: This module has been placed in the public domain. - -""" -A minimal front end to the Docutils Publisher, producing pseudo-XML. -""" - -try: - import locale - locale.setlocale(locale.LC_ALL, '') -except: - pass - -from docutils.core import publish_cmdline, default_description - - -description = ('Generates pseudo-XML from standalone reStructuredText ' - 'sources (for testing purposes). ' + default_description) - -publish_cmdline(description=description) diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/EGG-INFO/scripts/rst2s5.py --- a/buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/EGG-INFO/scripts/rst2s5.py Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,24 +0,0 @@ -#!C:\Python25\python.exe - -# $Id: rst2s5.py 4564 2006-05-21 20:44:42Z wiemann $ -# Author: Chris Liechti -# Copyright: This module has been placed in the public domain. - -""" -A minimal front end to the Docutils Publisher, producing HTML slides using -the S5 template system. -""" - -try: - import locale - locale.setlocale(locale.LC_ALL, '') -except: - pass - -from docutils.core import publish_cmdline, default_description - - -description = ('Generates S5 (X)HTML slideshow documents from standalone ' - 'reStructuredText sources. ' + default_description) - -publish_cmdline(writer_name='s5', description=description) diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/EGG-INFO/scripts/rst2xml.py --- a/buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/EGG-INFO/scripts/rst2xml.py Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,23 +0,0 @@ -#!C:\Python25\python.exe - -# $Id: rst2xml.py 4564 2006-05-21 20:44:42Z wiemann $ -# Author: David Goodger -# Copyright: This module has been placed in the public domain. - -""" -A minimal front end to the Docutils Publisher, producing Docutils XML. -""" - -try: - import locale - locale.setlocale(locale.LC_ALL, '') -except: - pass - -from docutils.core import publish_cmdline, default_description - - -description = ('Generates Docutils-native XML from standalone ' - 'reStructuredText sources. ' + default_description) - -publish_cmdline(writer_name='xml', description=description) diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/EGG-INFO/scripts/rstpep2html.py --- a/buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/EGG-INFO/scripts/rstpep2html.py Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,25 +0,0 @@ -#!C:\Python25\python.exe - -# $Id: rstpep2html.py 4564 2006-05-21 20:44:42Z wiemann $ -# Author: David Goodger -# Copyright: This module has been placed in the public domain. - -""" -A minimal front end to the Docutils Publisher, producing HTML from PEP -(Python Enhancement Proposal) documents. -""" - -try: - import locale - locale.setlocale(locale.LC_ALL, '') -except: - pass - -from docutils.core import publish_cmdline, default_description - - -description = ('Generates (X)HTML from reStructuredText-format PEP files. ' - + default_description) - -publish_cmdline(reader_name='pep', writer_name='pep_html', - description=description) diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/EGG-INFO/top_level.txt --- a/buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/EGG-INFO/top_level.txt Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,2 +0,0 @@ -docutils -roman diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/__init__.py --- a/buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/__init__.py Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,204 +0,0 @@ -# $Id: __init__.py 4801 2006-11-12 18:02:08Z goodger $ -# Author: David Goodger -# Copyright: This module has been placed in the public domain. - -""" -This is the Docutils (Python Documentation Utilities) package. - -Package Structure -================= - -Modules: - -- __init__.py: Contains component base classes, exception classes, and - Docutils version information. - -- core.py: Contains the ``Publisher`` class and ``publish_*()`` convenience - functions. - -- frontend.py: Runtime settings (command-line interface, configuration files) - processing, for Docutils front-ends. - -- io.py: Provides a uniform API for low-level input and output. - -- nodes.py: Docutils document tree (doctree) node class library. - -- statemachine.py: A finite state machine specialized for - regular-expression-based text filters. - -- urischemes.py: Contains a complete mapping of known URI addressing - scheme names to descriptions. - -- utils.py: Contains the ``Reporter`` system warning class and miscellaneous - utilities. - -Subpackages: - -- languages: Language-specific mappings of terms. - -- parsers: Syntax-specific input parser modules or packages. - -- readers: Context-specific input handlers which understand the data - source and manage a parser. - -- transforms: Modules used by readers and writers to modify DPS - doctrees. - -- writers: Format-specific output translators. -""" - -__docformat__ = 'reStructuredText' - -__version__ = '0.5' -"""``major.minor.micro`` version number. The micro number is bumped for API -changes, for new functionality, and for interim project releases. The minor -number is bumped whenever there is a significant project release. The major -number will be bumped when the project is feature-complete, and perhaps if -there is a major change in the design.""" - -__version_details__ = 'snapshot 2007-11-01, r5461' -"""Extra version details (e.g. 'snapshot 2005-05-29, r3410', 'repository', -'release'), modified automatically & manually.""" - -class ApplicationError(StandardError): pass -class DataError(ApplicationError): pass - - -class SettingsSpec: - - """ - Runtime setting specification base class. - - SettingsSpec subclass objects used by `docutils.frontend.OptionParser`. - """ - - settings_spec = () - """Runtime settings specification. Override in subclasses. - - Defines runtime settings and associated command-line options, as used by - `docutils.frontend.OptionParser`. This is a tuple of: - - - Option group title (string or `None` which implies no group, just a list - of single options). - - - Description (string or `None`). - - - A sequence of option tuples. Each consists of: - - - Help text (string) - - - List of option strings (e.g. ``['-Q', '--quux']``). - - - Dictionary of keyword arguments sent to the OptionParser/OptionGroup - ``add_option`` method. - - Runtime setting names are derived implicitly from long option names - ('--a-setting' becomes ``settings.a_setting``) or explicitly from the - 'dest' keyword argument. - - Most settings will also have a 'validator' keyword & function. The - validator function validates setting values (from configuration files - and command-line option arguments) and converts them to appropriate - types. For example, the ``docutils.frontend.validate_boolean`` - function, **required by all boolean settings**, converts true values - ('1', 'on', 'yes', and 'true') to 1 and false values ('0', 'off', - 'no', 'false', and '') to 0. Validators need only be set once per - setting. See the `docutils.frontend.validate_*` functions. - - See the optparse docs for more details. - - - More triples of group title, description, options, as many times as - needed. Thus, `settings_spec` tuples can be simply concatenated. - """ - - settings_defaults = None - """A dictionary of defaults for settings not in `settings_spec` (internal - settings, intended to be inaccessible by command-line and config file). - Override in subclasses.""" - - settings_default_overrides = None - """A dictionary of auxiliary defaults, to override defaults for settings - defined in other components. Override in subclasses.""" - - relative_path_settings = () - """Settings containing filesystem paths. Override in subclasses. - Settings listed here are to be interpreted relative to the current working - directory.""" - - config_section = None - """The name of the config file section specific to this component - (lowercase, no brackets). Override in subclasses.""" - - config_section_dependencies = None - """A list of names of config file sections that are to be applied before - `config_section`, in order (from general to specific). In other words, - the settings in `config_section` are to be overlaid on top of the settings - from these sections. The "general" section is assumed implicitly. - Override in subclasses.""" - - -class TransformSpec: - - """ - Runtime transform specification base class. - - TransformSpec subclass objects used by `docutils.transforms.Transformer`. - """ - - def get_transforms(self): - """Transforms required by this class. Override in subclasses.""" - if self.default_transforms != (): - import warnings - warnings.warn('default_transforms attribute deprecated.\n' - 'Use get_transforms() method instead.', - DeprecationWarning) - return list(self.default_transforms) - return [] - - # Deprecated; for compatibility. - default_transforms = () - - unknown_reference_resolvers = () - """List of functions to try to resolve unknown references. Unknown - references have a 'refname' attribute which doesn't correspond to any - target in the document. Called when the transforms in - `docutils.tranforms.references` are unable to find a correct target. The - list should contain functions which will try to resolve unknown - references, with the following signature:: - - def reference_resolver(node): - '''Returns boolean: true if resolved, false if not.''' - - If the function is able to resolve the reference, it should also remove - the 'refname' attribute and mark the node as resolved:: - - del node['refname'] - node.resolved = 1 - - Each function must have a "priority" attribute which will affect the order - the unknown_reference_resolvers are run:: - - reference_resolver.priority = 100 - - Override in subclasses.""" - - -class Component(SettingsSpec, TransformSpec): - - """Base class for Docutils components.""" - - component_type = None - """Name of the component type ('reader', 'parser', 'writer'). Override in - subclasses.""" - - supported = () - """Names for this component. Override in subclasses.""" - - def supports(self, format): - """ - Is `format` supported by this component? - - To be used by transforms to ask the dependent component if it supports - a certain input context or output format. - """ - return format in self.supported diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/core.py --- a/buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/core.py Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,613 +0,0 @@ -# $Id: core.py 5033 2007-03-21 19:51:22Z wiemann $ -# Author: David Goodger -# Copyright: This module has been placed in the public domain. - -""" -Calling the ``publish_*`` convenience functions (or instantiating a -`Publisher` object) with component names will result in default -behavior. For custom behavior (setting component options), create -custom component objects first, and pass *them* to -``publish_*``/`Publisher`. See `The Docutils Publisher`_. - -.. _The Docutils Publisher: http://docutils.sf.net/docs/api/publisher.html -""" - -__docformat__ = 'reStructuredText' - -import sys -import pprint -from types import StringType -from docutils import __version__, __version_details__, SettingsSpec -from docutils import frontend, io, utils, readers, writers -from docutils.frontend import OptionParser -from docutils.transforms import Transformer -import docutils.readers.doctree - - -class Publisher: - - """ - A facade encapsulating the high-level logic of a Docutils system. - """ - - def __init__(self, reader=None, parser=None, writer=None, - source=None, source_class=io.FileInput, - destination=None, destination_class=io.FileOutput, - settings=None): - """ - Initial setup. If any of `reader`, `parser`, or `writer` are not - specified, the corresponding ``set_...`` method should be called with - a component name (`set_reader` sets the parser as well). - """ - - self.document = None - """The document tree (`docutils.nodes` objects).""" - - self.reader = reader - """A `docutils.readers.Reader` instance.""" - - self.parser = parser - """A `docutils.parsers.Parser` instance.""" - - self.writer = writer - """A `docutils.writers.Writer` instance.""" - - for component in 'reader', 'parser', 'writer': - assert not isinstance(getattr(self, component), StringType), \ - ('passed string as "%s" parameter; use "%s_name" instead' - % (getattr(self, component), component, component)) - - self.source = source - """The source of input data, a `docutils.io.Input` instance.""" - - self.source_class = source_class - """The class for dynamically created source objects.""" - - self.destination = destination - """The destination for docutils output, a `docutils.io.Output` - instance.""" - - self.destination_class = destination_class - """The class for dynamically created destination objects.""" - - self.settings = settings - """An object containing Docutils settings as instance attributes. - Set by `self.process_command_line()` or `self.get_settings()`.""" - - def set_reader(self, reader_name, parser, parser_name): - """Set `self.reader` by name.""" - reader_class = readers.get_reader_class(reader_name) - self.reader = reader_class(parser, parser_name) - self.parser = self.reader.parser - - def set_writer(self, writer_name): - """Set `self.writer` by name.""" - writer_class = writers.get_writer_class(writer_name) - self.writer = writer_class() - - def set_components(self, reader_name, parser_name, writer_name): - if self.reader is None: - self.set_reader(reader_name, self.parser, parser_name) - if self.parser is None: - if self.reader.parser is None: - self.reader.set_parser(parser_name) - self.parser = self.reader.parser - if self.writer is None: - self.set_writer(writer_name) - - def setup_option_parser(self, usage=None, description=None, - settings_spec=None, config_section=None, - **defaults): - if config_section: - if not settings_spec: - settings_spec = SettingsSpec() - settings_spec.config_section = config_section - parts = config_section.split() - if len(parts) > 1 and parts[-1] == 'application': - settings_spec.config_section_dependencies = ['applications'] - #@@@ Add self.source & self.destination to components in future? - option_parser = OptionParser( - components=(self.parser, self.reader, self.writer, settings_spec), - defaults=defaults, read_config_files=1, - usage=usage, description=description) - return option_parser - - def get_settings(self, usage=None, description=None, - settings_spec=None, config_section=None, **defaults): - """ - Set and return default settings (overrides in `defaults` dict). - - Set components first (`self.set_reader` & `self.set_writer`). - Explicitly setting `self.settings` disables command line option - processing from `self.publish()`. - """ - option_parser = self.setup_option_parser( - usage, description, settings_spec, config_section, **defaults) - self.settings = option_parser.get_default_values() - return self.settings - - def process_programmatic_settings(self, settings_spec, - settings_overrides, - config_section): - if self.settings is None: - defaults = (settings_overrides or {}).copy() - # Propagate exceptions by default when used programmatically: - defaults.setdefault('traceback', 1) - self.get_settings(settings_spec=settings_spec, - config_section=config_section, - **defaults) - - def process_command_line(self, argv=None, usage=None, description=None, - settings_spec=None, config_section=None, - **defaults): - """ - Pass an empty list to `argv` to avoid reading `sys.argv` (the - default). - - Set components first (`self.set_reader` & `self.set_writer`). - """ - option_parser = self.setup_option_parser( - usage, description, settings_spec, config_section, **defaults) - if argv is None: - argv = sys.argv[1:] - self.settings = option_parser.parse_args(argv) - - def set_io(self, source_path=None, destination_path=None): - if self.source is None: - self.set_source(source_path=source_path) - if self.destination is None: - self.set_destination(destination_path=destination_path) - - def set_source(self, source=None, source_path=None): - if source_path is None: - source_path = self.settings._source - else: - self.settings._source = source_path - self.source = self.source_class( - source=source, source_path=source_path, - encoding=self.settings.input_encoding) - - def set_destination(self, destination=None, destination_path=None): - if destination_path is None: - destination_path = self.settings._destination - else: - self.settings._destination = destination_path - self.destination = self.destination_class( - destination=destination, destination_path=destination_path, - encoding=self.settings.output_encoding, - error_handler=self.settings.output_encoding_error_handler) - - def apply_transforms(self): - self.document.transformer.populate_from_components( - (self.source, self.reader, self.reader.parser, self.writer, - self.destination)) - self.document.transformer.apply_transforms() - - def publish(self, argv=None, usage=None, description=None, - settings_spec=None, settings_overrides=None, - config_section=None, enable_exit_status=None): - """ - Process command line options and arguments (if `self.settings` not - already set), run `self.reader` and then `self.writer`. Return - `self.writer`'s output. - """ - exit = None - try: - if self.settings is None: - self.process_command_line( - argv, usage, description, settings_spec, config_section, - **(settings_overrides or {})) - self.set_io() - self.document = self.reader.read(self.source, self.parser, - self.settings) - self.apply_transforms() - output = self.writer.write(self.document, self.destination) - self.writer.assemble_parts() - except SystemExit, error: - exit = 1 - exit_status = error.code - except Exception, error: - if not self.settings: # exception too early to report nicely - raise - if self.settings.traceback: # Propagate exceptions? - self.debugging_dumps() - raise - self.report_Exception(error) - exit = 1 - exit_status = 1 - self.debugging_dumps() - if (enable_exit_status and self.document - and (self.document.reporter.max_level - >= self.settings.exit_status_level)): - sys.exit(self.document.reporter.max_level + 10) - elif exit: - sys.exit(exit_status) - return output - - def debugging_dumps(self): - if not self.document: - return - if self.settings.dump_settings: - print >>sys.stderr, '\n::: Runtime settings:' - print >>sys.stderr, pprint.pformat(self.settings.__dict__) - if self.settings.dump_internals: - print >>sys.stderr, '\n::: Document internals:' - print >>sys.stderr, pprint.pformat(self.document.__dict__) - if self.settings.dump_transforms: - print >>sys.stderr, '\n::: Transforms applied:' - print >>sys.stderr, (' (priority, transform class, ' - 'pending node details, keyword args)') - print >>sys.stderr, pprint.pformat( - [(priority, '%s.%s' % (xclass.__module__, xclass.__name__), - pending and pending.details, kwargs) - for priority, xclass, pending, kwargs - in self.document.transformer.applied]) - if self.settings.dump_pseudo_xml: - print >>sys.stderr, '\n::: Pseudo-XML:' - print >>sys.stderr, self.document.pformat().encode( - 'raw_unicode_escape') - - def report_Exception(self, error): - if isinstance(error, utils.SystemMessage): - self.report_SystemMessage(error) - elif isinstance(error, UnicodeError): - self.report_UnicodeError(error) - else: - print >>sys.stderr, '%s: %s' % (error.__class__.__name__, error) - print >>sys.stderr, ("""\ -Exiting due to error. Use "--traceback" to diagnose. -Please report errors to . -Include "--traceback" output, Docutils version (%s [%s]), -Python version (%s), your OS type & version, and the -command line used.""" % (__version__, __version_details__, - sys.version.split()[0])) - - def report_SystemMessage(self, error): - print >>sys.stderr, ('Exiting due to level-%s (%s) system message.' - % (error.level, - utils.Reporter.levels[error.level])) - - def report_UnicodeError(self, error): - sys.stderr.write( - '%s: %s\n' - '\n' - 'The specified output encoding (%s) cannot\n' - 'handle all of the output.\n' - 'Try setting "--output-encoding-error-handler" to\n' - '\n' - '* "xmlcharrefreplace" (for HTML & XML output);\n' - % (error.__class__.__name__, error, - self.settings.output_encoding)) - try: - data = error.object[error.start:error.end] - sys.stderr.write( - ' the output will contain "%s" and should be usable.\n' - '* "backslashreplace" (for other output formats, Python 2.3+);\n' - ' look for "%s" in the output.\n' - % (data.encode('ascii', 'xmlcharrefreplace'), - data.encode('ascii', 'backslashreplace'))) - except AttributeError: - sys.stderr.write(' the output should be usable as-is.\n') - sys.stderr.write( - '* "replace"; look for "?" in the output.\n' - '\n' - '"--output-encoding-error-handler" is currently set to "%s".\n' - '\n' - 'Exiting due to error. Use "--traceback" to diagnose.\n' - 'If the advice above doesn\'t eliminate the error,\n' - 'please report it to .\n' - 'Include "--traceback" output, Docutils version (%s),\n' - 'Python version (%s), your OS type & version, and the\n' - 'command line used.\n' - % (self.settings.output_encoding_error_handler, - __version__, sys.version.split()[0])) - -default_usage = '%prog [options] [ []]' -default_description = ('Reads from (default is stdin) and writes to ' - ' (default is stdout). See ' - ' for ' - 'the full reference.') - -def publish_cmdline(reader=None, reader_name='standalone', - parser=None, parser_name='restructuredtext', - writer=None, writer_name='pseudoxml', - settings=None, settings_spec=None, - settings_overrides=None, config_section=None, - enable_exit_status=1, argv=None, - usage=default_usage, description=default_description): - """ - Set up & run a `Publisher` for command-line-based file I/O (input and - output file paths taken automatically from the command line). Return the - encoded string output also. - - Parameters: see `publish_programmatically` for the remainder. - - - `argv`: Command-line argument list to use instead of ``sys.argv[1:]``. - - `usage`: Usage string, output if there's a problem parsing the command - line. - - `description`: Program description, output for the "--help" option - (along with command-line option descriptions). - """ - pub = Publisher(reader, parser, writer, settings=settings) - pub.set_components(reader_name, parser_name, writer_name) - output = pub.publish( - argv, usage, description, settings_spec, settings_overrides, - config_section=config_section, enable_exit_status=enable_exit_status) - return output - -def publish_file(source=None, source_path=None, - destination=None, destination_path=None, - reader=None, reader_name='standalone', - parser=None, parser_name='restructuredtext', - writer=None, writer_name='pseudoxml', - settings=None, settings_spec=None, settings_overrides=None, - config_section=None, enable_exit_status=None): - """ - Set up & run a `Publisher` for programmatic use with file-like I/O. - Return the encoded string output also. - - Parameters: see `publish_programmatically`. - """ - output, pub = publish_programmatically( - source_class=io.FileInput, source=source, source_path=source_path, - destination_class=io.FileOutput, - destination=destination, destination_path=destination_path, - reader=reader, reader_name=reader_name, - parser=parser, parser_name=parser_name, - writer=writer, writer_name=writer_name, - settings=settings, settings_spec=settings_spec, - settings_overrides=settings_overrides, - config_section=config_section, - enable_exit_status=enable_exit_status) - return output - -def publish_string(source, source_path=None, destination_path=None, - reader=None, reader_name='standalone', - parser=None, parser_name='restructuredtext', - writer=None, writer_name='pseudoxml', - settings=None, settings_spec=None, - settings_overrides=None, config_section=None, - enable_exit_status=None): - """ - Set up & run a `Publisher` for programmatic use with string I/O. Return - the encoded string or Unicode string output. - - For encoded string output, be sure to set the 'output_encoding' setting to - the desired encoding. Set it to 'unicode' for unencoded Unicode string - output. Here's one way:: - - publish_string(..., settings_overrides={'output_encoding': 'unicode'}) - - Similarly for Unicode string input (`source`):: - - publish_string(..., settings_overrides={'input_encoding': 'unicode'}) - - Parameters: see `publish_programmatically`. - """ - output, pub = publish_programmatically( - source_class=io.StringInput, source=source, source_path=source_path, - destination_class=io.StringOutput, - destination=None, destination_path=destination_path, - reader=reader, reader_name=reader_name, - parser=parser, parser_name=parser_name, - writer=writer, writer_name=writer_name, - settings=settings, settings_spec=settings_spec, - settings_overrides=settings_overrides, - config_section=config_section, - enable_exit_status=enable_exit_status) - return output - -def publish_parts(source, source_path=None, source_class=io.StringInput, - destination_path=None, - reader=None, reader_name='standalone', - parser=None, parser_name='restructuredtext', - writer=None, writer_name='pseudoxml', - settings=None, settings_spec=None, - settings_overrides=None, config_section=None, - enable_exit_status=None): - """ - Set up & run a `Publisher`, and return a dictionary of document parts. - Dictionary keys are the names of parts, and values are Unicode strings; - encoding is up to the client. For programmatic use with string I/O. - - For encoded string input, be sure to set the 'input_encoding' setting to - the desired encoding. Set it to 'unicode' for unencoded Unicode string - input. Here's how:: - - publish_parts(..., settings_overrides={'input_encoding': 'unicode'}) - - Parameters: see `publish_programmatically`. - """ - output, pub = publish_programmatically( - source=source, source_path=source_path, source_class=source_class, - destination_class=io.StringOutput, - destination=None, destination_path=destination_path, - reader=reader, reader_name=reader_name, - parser=parser, parser_name=parser_name, - writer=writer, writer_name=writer_name, - settings=settings, settings_spec=settings_spec, - settings_overrides=settings_overrides, - config_section=config_section, - enable_exit_status=enable_exit_status) - return pub.writer.parts - -def publish_doctree(source, source_path=None, - source_class=io.StringInput, - reader=None, reader_name='standalone', - parser=None, parser_name='restructuredtext', - settings=None, settings_spec=None, - settings_overrides=None, config_section=None, - enable_exit_status=None): - """ - Set up & run a `Publisher` for programmatic use with string I/O. - Return the document tree. - - For encoded string input, be sure to set the 'input_encoding' setting to - the desired encoding. Set it to 'unicode' for unencoded Unicode string - input. Here's one way:: - - publish_doctree(..., settings_overrides={'input_encoding': 'unicode'}) - - Parameters: see `publish_programmatically`. - """ - pub = Publisher(reader=reader, parser=parser, writer=None, - settings=settings, - source_class=source_class, - destination_class=io.NullOutput) - pub.set_components(reader_name, parser_name, 'null') - pub.process_programmatic_settings( - settings_spec, settings_overrides, config_section) - pub.set_source(source, source_path) - pub.set_destination(None, None) - output = pub.publish(enable_exit_status=enable_exit_status) - return pub.document - -def publish_from_doctree(document, destination_path=None, - writer=None, writer_name='pseudoxml', - settings=None, settings_spec=None, - settings_overrides=None, config_section=None, - enable_exit_status=None): - """ - Set up & run a `Publisher` to render from an existing document - tree data structure, for programmatic use with string I/O. Return - the encoded string output. - - Note that document.settings is overridden; if you want to use the settings - of the original `document`, pass settings=document.settings. - - Also, new document.transformer and document.reporter objects are - generated. - - For encoded string output, be sure to set the 'output_encoding' setting to - the desired encoding. Set it to 'unicode' for unencoded Unicode string - output. Here's one way:: - - publish_from_doctree( - ..., settings_overrides={'output_encoding': 'unicode'}) - - Parameters: `document` is a `docutils.nodes.document` object, an existing - document tree. - - Other parameters: see `publish_programmatically`. - """ - reader = docutils.readers.doctree.Reader(parser_name='null') - pub = Publisher(reader, None, writer, - source=io.DocTreeInput(document), - destination_class=io.StringOutput, settings=settings) - if not writer and writer_name: - pub.set_writer(writer_name) - pub.process_programmatic_settings( - settings_spec, settings_overrides, config_section) - pub.set_destination(None, destination_path) - return pub.publish(enable_exit_status=enable_exit_status) - -def publish_programmatically(source_class, source, source_path, - destination_class, destination, destination_path, - reader, reader_name, - parser, parser_name, - writer, writer_name, - settings, settings_spec, - settings_overrides, config_section, - enable_exit_status): - """ - Set up & run a `Publisher` for custom programmatic use. Return the - encoded string output and the Publisher object. - - Applications should not need to call this function directly. If it does - seem to be necessary to call this function directly, please write to the - Docutils-develop mailing list - . - - Parameters: - - * `source_class` **required**: The class for dynamically created source - objects. Typically `io.FileInput` or `io.StringInput`. - - * `source`: Type depends on `source_class`: - - - If `source_class` is `io.FileInput`: Either a file-like object - (must have 'read' and 'close' methods), or ``None`` - (`source_path` is opened). If neither `source` nor - `source_path` are supplied, `sys.stdin` is used. - - - If `source_class` is `io.StringInput` **required**: The input - string, either an encoded 8-bit string (set the - 'input_encoding' setting to the correct encoding) or a Unicode - string (set the 'input_encoding' setting to 'unicode'). - - * `source_path`: Type depends on `source_class`: - - - `io.FileInput`: Path to the input file, opened if no `source` - supplied. - - - `io.StringInput`: Optional. Path to the file or object that produced - `source`. Only used for diagnostic output. - - * `destination_class` **required**: The class for dynamically created - destination objects. Typically `io.FileOutput` or `io.StringOutput`. - - * `destination`: Type depends on `destination_class`: - - - `io.FileOutput`: Either a file-like object (must have 'write' and - 'close' methods), or ``None`` (`destination_path` is opened). If - neither `destination` nor `destination_path` are supplied, - `sys.stdout` is used. - - - `io.StringOutput`: Not used; pass ``None``. - - * `destination_path`: Type depends on `destination_class`: - - - `io.FileOutput`: Path to the output file. Opened if no `destination` - supplied. - - - `io.StringOutput`: Path to the file or object which will receive the - output; optional. Used for determining relative paths (stylesheets, - source links, etc.). - - * `reader`: A `docutils.readers.Reader` object. - - * `reader_name`: Name or alias of the Reader class to be instantiated if - no `reader` supplied. - - * `parser`: A `docutils.parsers.Parser` object. - - * `parser_name`: Name or alias of the Parser class to be instantiated if - no `parser` supplied. - - * `writer`: A `docutils.writers.Writer` object. - - * `writer_name`: Name or alias of the Writer class to be instantiated if - no `writer` supplied. - - * `settings`: A runtime settings (`docutils.frontend.Values`) object, for - dotted-attribute access to runtime settings. It's the end result of the - `SettingsSpec`, config file, and option processing. If `settings` is - passed, it's assumed to be complete and no further setting/config/option - processing is done. - - * `settings_spec`: A `docutils.SettingsSpec` subclass or object. Provides - extra application-specific settings definitions independently of - components. In other words, the application becomes a component, and - its settings data is processed along with that of the other components. - Used only if no `settings` specified. - - * `settings_overrides`: A dictionary containing application-specific - settings defaults that override the defaults of other components. - Used only if no `settings` specified. - - * `config_section`: A string, the name of the configuration file section - for this application. Overrides the ``config_section`` attribute - defined by `settings_spec`. Used only if no `settings` specified. - - * `enable_exit_status`: Boolean; enable exit status at end of processing? - """ - pub = Publisher(reader, parser, writer, settings=settings, - source_class=source_class, - destination_class=destination_class) - pub.set_components(reader_name, parser_name, writer_name) - pub.process_programmatic_settings( - settings_spec, settings_overrides, config_section) - pub.set_source(source, source_path) - pub.set_destination(destination, destination_path) - output = pub.publish(enable_exit_status=enable_exit_status) - return output, pub diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/examples.py --- a/buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/examples.py Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,96 +0,0 @@ -# $Id: examples.py 4800 2006-11-12 18:02:01Z goodger $ -# Author: David Goodger -# Copyright: This module has been placed in the public domain. - -""" -This module contains practical examples of Docutils client code. - -Importing this module from client code is not recommended; its contents are -subject to change in future Docutils releases. Instead, it is recommended -that you copy and paste the parts you need into your own code, modifying as -necessary. -""" - -from docutils import core, io - - -def html_parts(input_string, source_path=None, destination_path=None, - input_encoding='unicode', doctitle=1, initial_header_level=1): - """ - Given an input string, returns a dictionary of HTML document parts. - - Dictionary keys are the names of parts, and values are Unicode strings; - encoding is up to the client. - - Parameters: - - - `input_string`: A multi-line text string; required. - - `source_path`: Path to the source file or object. Optional, but useful - for diagnostic output (system messages). - - `destination_path`: Path to the file or object which will receive the - output; optional. Used for determining relative paths (stylesheets, - source links, etc.). - - `input_encoding`: The encoding of `input_string`. If it is an encoded - 8-bit string, provide the correct encoding. If it is a Unicode string, - use "unicode", the default. - - `doctitle`: Disable the promotion of a lone top-level section title to - document title (and subsequent section title to document subtitle - promotion); enabled by default. - - `initial_header_level`: The initial level for header elements (e.g. 1 - for "

"). - """ - overrides = {'input_encoding': input_encoding, - 'doctitle_xform': doctitle, - 'initial_header_level': initial_header_level} - parts = core.publish_parts( - source=input_string, source_path=source_path, - destination_path=destination_path, - writer_name='html', settings_overrides=overrides) - return parts - -def html_body(input_string, source_path=None, destination_path=None, - input_encoding='unicode', output_encoding='unicode', - doctitle=1, initial_header_level=1): - """ - Given an input string, returns an HTML fragment as a string. - - The return value is the contents of the element. - - Parameters (see `html_parts()` for the remainder): - - - `output_encoding`: The desired encoding of the output. If a Unicode - string is desired, use the default value of "unicode" . - """ - parts = html_parts( - input_string=input_string, source_path=source_path, - destination_path=destination_path, - input_encoding=input_encoding, doctitle=doctitle, - initial_header_level=initial_header_level) - fragment = parts['html_body'] - if output_encoding != 'unicode': - fragment = fragment.encode(output_encoding) - return fragment - -def internals(input_string, source_path=None, destination_path=None, - input_encoding='unicode', settings_overrides=None): - """ - Return the document tree and publisher, for exploring Docutils internals. - - Parameters: see `html_parts()`. - """ - if settings_overrides: - overrides = settings_overrides.copy() - else: - overrides = {} - overrides['input_encoding'] = input_encoding - output, pub = core.publish_programmatically( - source_class=io.StringInput, source=input_string, - source_path=source_path, - destination_class=io.NullOutput, destination=None, - destination_path=destination_path, - reader=None, reader_name='standalone', - parser=None, parser_name='restructuredtext', - writer=None, writer_name='null', - settings=None, settings_spec=None, settings_overrides=overrides, - config_section=None, enable_exit_status=None) - return pub.writer.document, pub diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/frontend.py --- a/buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/frontend.py Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,756 +0,0 @@ -# $Id: frontend.py 4913 2007-02-12 04:05:20Z goodger $ -# Author: David Goodger -# Copyright: This module has been placed in the public domain. - -""" -Command-line and common processing for Docutils front-end tools. - -Exports the following classes: - -* `OptionParser`: Standard Docutils command-line processing. -* `Option`: Customized version of `optparse.Option`; validation support. -* `Values`: Runtime settings; objects are simple structs - (``object.attribute``). Supports cumulative list settings (attributes). -* `ConfigParser`: Standard Docutils config file processing. - -Also exports the following functions: - -* Option callbacks: `store_multiple`, `read_config_file`. -* Setting validators: `validate_encoding`, - `validate_encoding_error_handler`, - `validate_encoding_and_error_handler`, `validate_boolean`, - `validate_threshold`, `validate_colon_separated_string_list`, - `validate_dependency_file`. -* `make_paths_absolute`. -""" - -docformat = 'reStructuredText' - -import os -import os.path -import sys -import types -import warnings -import ConfigParser as CP -import codecs -import docutils -import docutils.utils -import docutils.nodes -try: - import optparse - from optparse import SUPPRESS_HELP -except ImportError: - import optik as optparse - from optik import SUPPRESS_HELP - - -def store_multiple(option, opt, value, parser, *args, **kwargs): - """ - Store multiple values in `parser.values`. (Option callback.) - - Store `None` for each attribute named in `args`, and store the value for - each key (attribute name) in `kwargs`. - """ - for attribute in args: - setattr(parser.values, attribute, None) - for key, value in kwargs.items(): - setattr(parser.values, key, value) - -def read_config_file(option, opt, value, parser): - """ - Read a configuration file during option processing. (Option callback.) - """ - try: - new_settings = parser.get_config_file_settings(value) - except ValueError, error: - parser.error(error) - parser.values.update(new_settings, parser) - -def validate_encoding(setting, value, option_parser, - config_parser=None, config_section=None): - try: - codecs.lookup(value) - except LookupError: - raise (LookupError('setting "%s": unknown encoding: "%s"' - % (setting, value)), - None, sys.exc_info()[2]) - return value - -def validate_encoding_error_handler(setting, value, option_parser, - config_parser=None, config_section=None): - try: - codecs.lookup_error(value) - except AttributeError: # prior to Python 2.3 - if value not in ('strict', 'ignore', 'replace', 'xmlcharrefreplace'): - raise (LookupError( - 'unknown encoding error handler: "%s" (choices: ' - '"strict", "ignore", "replace", or "xmlcharrefreplace")' % value), - None, sys.exc_info()[2]) - except LookupError: - raise (LookupError( - 'unknown encoding error handler: "%s" (choices: ' - '"strict", "ignore", "replace", "backslashreplace", ' - '"xmlcharrefreplace", and possibly others; see documentation for ' - 'the Python ``codecs`` module)' % value), - None, sys.exc_info()[2]) - return value - -def validate_encoding_and_error_handler( - setting, value, option_parser, config_parser=None, config_section=None): - """ - Side-effect: if an error handler is included in the value, it is inserted - into the appropriate place as if it was a separate setting/option. - """ - if ':' in value: - encoding, handler = value.split(':') - validate_encoding_error_handler( - setting + '_error_handler', handler, option_parser, - config_parser, config_section) - if config_parser: - config_parser.set(config_section, setting + '_error_handler', - handler) - else: - setattr(option_parser.values, setting + '_error_handler', handler) - else: - encoding = value - validate_encoding(setting, encoding, option_parser, - config_parser, config_section) - return encoding - -def validate_boolean(setting, value, option_parser, - config_parser=None, config_section=None): - if isinstance(value, types.UnicodeType): - try: - return option_parser.booleans[value.strip().lower()] - except KeyError: - raise (LookupError('unknown boolean value: "%s"' % value), - None, sys.exc_info()[2]) - return value - -def validate_nonnegative_int(setting, value, option_parser, - config_parser=None, config_section=None): - value = int(value) - if value < 0: - raise ValueError('negative value; must be positive or zero') - return value - -def validate_threshold(setting, value, option_parser, - config_parser=None, config_section=None): - try: - return int(value) - except ValueError: - try: - return option_parser.thresholds[value.lower()] - except (KeyError, AttributeError): - raise (LookupError('unknown threshold: %r.' % value), - None, sys.exc_info[2]) - -def validate_colon_separated_string_list( - setting, value, option_parser, config_parser=None, config_section=None): - if isinstance(value, types.UnicodeType): - value = value.split(':') - else: - last = value.pop() - value.extend(last.split(':')) - return value - -def validate_url_trailing_slash( - setting, value, option_parser, config_parser=None, config_section=None): - if not value: - return './' - elif value.endswith('/'): - return value - else: - return value + '/' - -def validate_dependency_file(setting, value, option_parser, - config_parser=None, config_section=None): - try: - return docutils.utils.DependencyList(value) - except IOError: - return docutils.utils.DependencyList(None) - -def validate_strip_class(setting, value, option_parser, - config_parser=None, config_section=None): - if config_parser: # validate all values - class_values = value - else: # just validate the latest value - class_values = [value[-1]] - for class_value in class_values: - normalized = docutils.nodes.make_id(class_value) - if class_value != normalized: - raise ValueError('invalid class value %r (perhaps %r?)' - % (class_value, normalized)) - return value - -def make_paths_absolute(pathdict, keys, base_path=None): - """ - Interpret filesystem path settings relative to the `base_path` given. - - Paths are values in `pathdict` whose keys are in `keys`. Get `keys` from - `OptionParser.relative_path_settings`. - """ - if base_path is None: - base_path = os.getcwd() - for key in keys: - if pathdict.has_key(key): - value = pathdict[key] - if isinstance(value, types.ListType): - value = [make_one_path_absolute(base_path, path) - for path in value] - elif value: - value = make_one_path_absolute(base_path, value) - pathdict[key] = value - -def make_one_path_absolute(base_path, path): - return os.path.abspath(os.path.join(base_path, path)) - - -class Values(optparse.Values): - - """ - Updates list attributes by extension rather than by replacement. - Works in conjunction with the `OptionParser.lists` instance attribute. - """ - - def init(self, *args, **kwargs): - optparse.Values.init(self, *args, **kwargs) - if (not hasattr(self, 'record_dependencies') - or self.record_dependencies is None): - # Set up dependency list, in case it is needed. - self.record_dependencies = docutils.utils.DependencyList() - - def update(self, other_dict, option_parser): - if isinstance(other_dict, Values): - other_dict = other_dict.dict - other_dict = other_dict.copy() - for setting in option_parser.lists.keys(): - if (hasattr(self, setting) and other_dict.has_key(setting)): - value = getattr(self, setting) - if value: - value += other_dict[setting] - del other_dict[setting] - self._update_loose(other_dict) - - def copy(self): - """Return a shallow copy of `self`.""" - return self.class(defaults=self.dict) - - -class Option(optparse.Option): - - ATTRS = optparse.Option.ATTRS + ['validator', 'overrides'] - - def process(self, opt, value, values, parser): - """ - Call the validator function on applicable settings and - evaluate the 'overrides' option. - Extends `optparse.Option.process`. - """ - result = optparse.Option.process(self, opt, value, values, parser) - setting = self.dest - if setting: - if self.validator: - value = getattr(values, setting) - try: - new_value = self.validator(setting, value, parser) - except Exception, error: - raise (optparse.OptionValueError( - 'Error in option "%s":\n %s: %s' - % (opt, error.class.name, error)), - None, sys.exc_info()[2]) - setattr(values, setting, new_value) - if self.overrides: - setattr(values, self.overrides, None) - return result - - -class OptionParser(optparse.OptionParser, docutils.SettingsSpec): - - """ - Parser for command-line and library use. The `settings_spec` - specification here and in other Docutils components are merged to build - the set of command-line options and runtime settings for this process. - - Common settings (defined below) and component-specific settings must not - conflict. Short options are reserved for common settings, and components - are restrict to using long options. - """ - - standard_config_files = [ - '/etc/docutils.conf', # system-wide - './docutils.conf', # project-specific - '~/.docutils'] # user-specific - """Docutils configuration files, using ConfigParser syntax. Filenames - will be tilde-expanded later. Later files override earlier ones.""" - - threshold_choices = 'info 1 warning 2 error 3 severe 4 none 5'.split() - """Possible inputs for for --report and --halt threshold values.""" - - thresholds = {'info': 1, 'warning': 2, 'error': 3, 'severe': 4, 'none': 5} - """Lookup table for --report and --halt threshold values.""" - - booleans={'1': 1, 'on': 1, 'yes': 1, 'true': 1, - '0': 0, 'off': 0, 'no': 0, 'false': 0, '': 0} - """Lookup table for boolean configuration file settings.""" - - if hasattr(codecs, 'backslashreplace_errors'): - default_error_encoding_error_handler = 'backslashreplace' - else: - default_error_encoding_error_handler = 'replace' - - settings_spec = ( - 'General Docutils Options', - None, - (('Specify the document title as metadata.', - ['--title'], {}), - ('Include a "Generated by Docutils" credit and link.', - ['--generator', '-g'], {'action': 'store_true', - 'validator': validate_boolean}), - ('Do not include a generator credit.', - ['--no-generator'], {'action': 'store_false', 'dest': 'generator'}), - ('Include the date at the end of the document (UTC).', - ['--date', '-d'], {'action': 'store_const', 'const': '%Y-%m-%d', - 'dest': 'datestamp'}), - ('Include the time & date (UTC).', - ['--time', '-t'], {'action': 'store_const', - 'const': '%Y-%m-%d %H:%M UTC', - 'dest': 'datestamp'}), - ('Do not include a datestamp of any kind.', - ['--no-datestamp'], {'action': 'store_const', 'const': None, - 'dest': 'datestamp'}), - ('Include a "View document source" link.', - ['--source-link', '-s'], {'action': 'store_true', - 'validator': validate_boolean}), - ('Use for a source link; implies --source-link.', - ['--source-url'], {'metavar': ''}), - ('Do not include a "View document source" link.', - ['--no-source-link'], - {'action': 'callback', 'callback': store_multiple, - 'callback_args': ('source_link', 'source_url')}), - ('Link from section headers to TOC entries. (default)', - ['--toc-entry-backlinks'], - {'dest': 'toc_backlinks', 'action': 'store_const', 'const': 'entry', - 'default': 'entry'}), - ('Link from section headers to the top of the TOC.', - ['--toc-top-backlinks'], - {'dest': 'toc_backlinks', 'action': 'store_const', 'const': 'top'}), - ('Disable backlinks to the table of contents.', - ['--no-toc-backlinks'], - {'dest': 'toc_backlinks', 'action': 'store_false'}), - ('Link from footnotes/citations to references. (default)', - ['--footnote-backlinks'], - {'action': 'store_true', 'default': 1, - 'validator': validate_boolean}), - ('Disable backlinks from footnotes and citations.', - ['--no-footnote-backlinks'], - {'dest': 'footnote_backlinks', 'action': 'store_false'}), - ('Enable section numbering. (default)', - ['--section-numbering'], - {'action': 'store_true', 'dest': 'sectnum_xform', - 'default': 1, 'validator': validate_boolean}), - ('Disable section numbering.', - ['--no-section-numbering'], - {'action': 'store_false', 'dest': 'sectnum_xform'}), - ('Remove comment elements from the document tree.', - ['--strip-comments'], - {'action': 'store_true', 'validator': validate_boolean}), - ('Leave comment elements in the document tree. (default)', - ['--leave-comments'], - {'action': 'store_false', 'dest': 'strip_comments'}), - ('Remove all elements with classes="" from the document tree. ' - '(Multiple-use option.)', - ['--strip-elements-with-class'], - {'action': 'append', 'dest': 'strip_elements_with_classes', - 'metavar': '', 'validator': validate_strip_class}), - ('Remove all classes="" attributes from elements in the ' - 'document tree. (Multiple-use option.)', - ['--strip-class'], - {'action': 'append', 'dest': 'strip_classes', - 'metavar': '', 'validator': validate_strip_class}), - ('Report system messages at or higher than : "info" or "1", ' - '"warning"/"2" (default), "error"/"3", "severe"/"4", "none"/"5"', - ['--report', '-r'], {'choices': threshold_choices, 'default': 2, - 'dest': 'report_level', 'metavar': '', - 'validator': validate_threshold}), - ('Report all system messages. (Same as "--report=1".)', - ['--verbose', '-v'], {'action': 'store_const', 'const': 1, - 'dest': 'report_level'}), - ('Report no system messages. (Same as "--report=5".)', - ['--quiet', '-q'], {'action': 'store_const', 'const': 5, - 'dest': 'report_level'}), - ('Halt execution at system messages at or above . ' - 'Levels as in --report. Default: 4 (severe).', - ['--halt'], {'choices': threshold_choices, 'dest': 'halt_level', - 'default': 4, 'metavar': '', - 'validator': validate_threshold}), - ('Halt at the slightest problem. Same as "--halt=info".', - ['--strict'], {'action': 'store_const', 'const': 'info', - 'dest': 'halt_level'}), - ('Enable a non-zero exit status for non-halting system messages at ' - 'or above . Default: 5 (disabled).', - ['--exit-status'], {'choices': threshold_choices, - 'dest': 'exit_status_level', - 'default': 5, 'metavar': '', - 'validator': validate_threshold}), - ('Enable debug-level system messages and diagnostics.', - ['--debug'], {'action': 'store_true', 'validator': validate_boolean}), - ('Disable debug output. (default)', - ['--no-debug'], {'action': 'store_false', 'dest': 'debug'}), - ('Send the output of system messages to .', - ['--warnings'], {'dest': 'warning_stream', 'metavar': ''}), - ('Enable Python tracebacks when Docutils is halted.', - ['--traceback'], {'action': 'store_true', 'default': None, - 'validator': validate_boolean}), - ('Disable Python tracebacks. (default)', - ['--no-traceback'], {'dest': 'traceback', 'action': 'store_false'}), - ('Specify the encoding and optionally the ' - 'error handler of input text. Default: :strict.', - ['--input-encoding', '-i'], - {'metavar': '', - 'validator': validate_encoding_and_error_handler}), - ('Specify the error handler for undecodable characters. ' - 'Choices: "strict" (default), "ignore", and "replace".', - ['--input-encoding-error-handler'], - {'default': 'strict', 'validator': validate_encoding_error_handler}), - ('Specify the text encoding and optionally the error handler for ' - 'output. Default: UTF-8:strict.', - ['--output-encoding', '-o'], - {'metavar': '', 'default': 'utf-8', - 'validator': validate_encoding_and_error_handler}), - ('Specify error handler for unencodable output characters; ' - '"strict" (default), "ignore", "replace", ' - '"xmlcharrefreplace", "backslashreplace" (Python 2.3+).', - ['--output-encoding-error-handler'], - {'default': 'strict', 'validator': validate_encoding_error_handler}), - ('Specify text encoding and error handler for error output. ' - 'Default: ASCII:%s.' - % default_error_encoding_error_handler, - ['--error-encoding', '-e'], - {'metavar': '', 'default': 'ascii', - 'validator': validate_encoding_and_error_handler}), - ('Specify the error handler for unencodable characters in ' - 'error output. Default: %s.' - % default_error_encoding_error_handler, - ['--error-encoding-error-handler'], - {'default': default_error_encoding_error_handler, - 'validator': validate_encoding_error_handler}), - ('Specify the language (as 2-letter code). Default: en.', - ['--language', '-l'], {'dest': 'language_code', 'default': 'en', - 'metavar': ''}), - ('Write output file dependencies to .', - ['--record-dependencies'], - {'metavar': '', 'validator': validate_dependency_file, - 'default': None}), # default set in Values class - ('Read configuration settings from , if it exists.', - ['--config'], {'metavar': '', 'type': 'string', - 'action': 'callback', 'callback': read_config_file}), - ("Show this program's version number and exit.", - ['--version', '-V'], {'action': 'version'}), - ('Show this help message and exit.', - ['--help', '-h'], {'action': 'help'}), - # Typically not useful for non-programmatical use: - (SUPPRESS_HELP, ['--id-prefix'], {'default': ''}), - (SUPPRESS_HELP, ['--auto-id-prefix'], {'default': 'id'}), - # Hidden options, for development use only: - (SUPPRESS_HELP, ['--dump-settings'], {'action': 'store_true'}), - (SUPPRESS_HELP, ['--dump-internals'], {'action': 'store_true'}), - (SUPPRESS_HELP, ['--dump-transforms'], {'action': 'store_true'}), - (SUPPRESS_HELP, ['--dump-pseudo-xml'], {'action': 'store_true'}), - (SUPPRESS_HELP, ['--expose-internal-attribute'], - {'action': 'append', 'dest': 'expose_internals', - 'validator': validate_colon_separated_string_list}), - (SUPPRESS_HELP, ['--strict-visitor'], {'action': 'store_true'}), - )) - """Runtime settings and command-line options common to all Docutils front - ends. Setting specs specific to individual Docutils components are also - used (see `populate_from_components()`).""" - - settings_defaults = {'_disable_config': None, - '_source': None, - '_destination': None, - '_config_files': None} - """Defaults for settings that don't have command-line option equivalents.""" - - relative_path_settings = ('warning_stream',) - - config_section = 'general' - - version_template = ('%%prog (Docutils %s [%s])' - % (docutils.version, docutils.__version_details)) - """Default version message.""" - - def init__(self, components=(), defaults=None, read_config_files=None, - *args, **kwargs): - """ - `components` is a list of Docutils components each containing a - ``.settings_spec`` attribute. `defaults` is a mapping of setting - default overrides. - """ - - self.lists = {} - """Set of list-type settings.""" - - self.config_files = [] - """List of paths of applied configuration files.""" - - optparse.OptionParser.init( - self, option_class=Option, add_help_option=None, - formatter=optparse.TitledHelpFormatter(width=78), - *args, **kwargs) - if not self.version: - self.version = self.version_template - # Make an instance copy (it will be modified): - self.relative_path_settings = list(self.relative_path_settings) - self.components = (self,) + tuple(components) - self.populate_from_components(self.components) - self.set_defaults_from_dict(defaults or {}) - if read_config_files and not self.defaults['_disable_config']: - try: - config_settings = self.get_standard_config_settings() - except ValueError, error: - self.error(error) - self.set_defaults_from_dict(config_settings.dict) - - def populate_from_components(self, components): - """ - For each component, first populate from the `SettingsSpec.settings_spec` - structure, then from the `SettingsSpec.settings_defaults` dictionary. - After all components have been processed, check for and populate from - each component's `SettingsSpec.settings_default_overrides` dictionary. - """ - for component in components: - if component is None: - continue - settings_spec = component.settings_spec - self.relative_path_settings.extend( - component.relative_path_settings) - for i in range(0, len(settings_spec), 3): - title, description, option_spec = settings_spec[i:i+3] - if title: - group = optparse.OptionGroup(self, title, description) - self.add_option_group(group) - else: - group = self # single options - for (help_text, option_strings, kwargs) in option_spec: - option = group.add_option(help=help_text, *option_strings, - **kwargs) - if kwargs.get('action') == 'append': - self.lists[option.dest] = 1 - if component.settings_defaults: - self.defaults.update(component.settings_defaults) - for component in components: - if component and component.settings_default_overrides: - self.defaults.update(component.settings_default_overrides) - - def get_standard_config_files(self): - """Return list of config files, from environment or standard.""" - try: - config_files = os.environ['DOCUTILSCONFIG'].split(os.pathsep) - except KeyError: - config_files = self.standard_config_files - - # If 'HOME' is not set, expandvars() requires the 'pwd' module which is - # not available under certain environments, for example, within - # mod_python. The publisher ends up in here, and we need to publish - # from within mod_python. Therefore we need to avoid expanding when we - # are in those environments. - expand = os.path.expanduser - if 'HOME' not in os.environ: - try: - import pwd - except ImportError: - expand = lambda x: x - return [expand(f) for f in config_files if f.strip()] - - def get_standard_config_settings(self): - settings = Values() - for filename in self.get_standard_config_files(): - settings.update(self.get_config_file_settings(filename), self) - return settings - - def get_config_file_settings(self, config_file): - """Returns a dictionary containing appropriate config file settings.""" - parser = ConfigParser() - parser.read(config_file, self) - self.config_files.extend(parser._files) - base_path = os.path.dirname(config_file) - applied = {} - settings = Values() - for component in self.components: - if not component: - continue - for section in (tuple(component.config_section_dependencies or ()) - + (component.config_section,)): - if applied.has_key(section): - continue - applied[section] = 1 - settings.update(parser.get_section(section), self) - make_paths_absolute( - settings.dict, self.relative_path_settings, base_path) - return settings.dict - - def check_values(self, values, args): - """Store positional arguments as runtime settings.""" - values._source, values._destination = self.check_args(args) - make_paths_absolute(values.dict, self.relative_path_settings, - os.getcwd()) - values._config_files = self.config_files - return values - - def check_args(self, args): - source = destination = None - if args: - source = args.pop(0) - if source == '-': # means stdin - source = None - if args: - destination = args.pop(0) - if destination == '-': # means stdout - destination = None - if args: - self.error('Maximum 2 arguments allowed.') - if source and source == destination: - self.error('Do not specify the same file for both source and ' - 'destination. It will clobber the source file.') - return source, destination - - def set_defaults_from_dict(self, defaults): - self.defaults.update(defaults) - - def get_default_values(self): - """Needed to get custom `Values` instances.""" - defaults = Values(self.defaults) - defaults._config_files = self.config_files - return defaults - - def get_option_by_dest(self, dest): - """ - Get an option by its dest. - - If you're supplying a dest which is shared by several options, - it is undefined which option of those is returned. - - A KeyError is raised if there is no option with the supplied - dest. - """ - for group in self.option_groups + [self]: - for option in group.option_list: - if option.dest == dest: - return option - raise KeyError('No option with dest == %r.' % dest) - - -class ConfigParser(CP.ConfigParser): - - old_settings = { - 'pep_stylesheet': ('pep_html writer', 'stylesheet'), - 'pep_stylesheet_path': ('pep_html writer', 'stylesheet_path'), - 'pep_template': ('pep_html writer', 'template')} - """{old setting: (new section, new setting)} mapping, used by - `handle_old_config`, to convert settings from the old [options] section.""" - - old_warning = """ -The "[option]" section is deprecated. Support for old-format configuration -files may be removed in a future Docutils release. Please revise your -configuration files. See , -section "Old-Format Configuration Files". -""" - - not_utf8_error = """\ -Unable to read configuration file "%s": content not encoded as UTF-8. -Skipping "%s" configuration file. -""" - - def init(self, *args, **kwargs): - CP.ConfigParser.init(self, *args, **kwargs) - - self._files = [] - """List of paths of configuration files read.""" - - def read(self, filenames, option_parser): - if type(filenames) in (types.StringType, types.UnicodeType): - filenames = [filenames] - for filename in filenames: - try: - # Config files must be UTF-8-encoded: - fp = codecs.open(filename, 'r', 'utf-8') - except IOError: - continue - try: - CP.ConfigParser.readfp(self, fp, filename) - except UnicodeDecodeError: - sys.stderr.write(self.not_utf8_error % (filename, filename)) - fp.close() - continue - fp.close() - self._files.append(filename) - if self.has_section('options'): - self.handle_old_config(filename) - self.validate_settings(filename, option_parser) - - def handle_old_config(self, filename): - warnings.warn_explicit(self.old_warning, ConfigDeprecationWarning, - filename, 0) - options = self.get_section('options') - if not self.has_section('general'): - self.add_section('general') - for key, value in options.items(): - if self.old_settings.has_key(key): - section, setting = self.old_settings[key] - if not self.has_section(section): - self.add_section(section) - else: - section = 'general' - setting = key - if not self.has_option(section, setting): - self.set(section, setting, value) - self.remove_section('options') - - def validate_settings(self, filename, option_parser): - """ - Call the validator function and implement overrides on all applicable - settings. - """ - for section in self.sections(): - for setting in self.options(section): - try: - option = option_parser.get_option_by_dest(setting) - except KeyError: - continue - if option.validator: - value = self.get(section, setting, raw=1) - try: - new_value = option.validator( - setting, value, option_parser, - config_parser=self, config_section=section) - except Exception, error: - raise (ValueError( - 'Error in config file "%s", section "[%s]":\n' - ' %s: %s\n %s = %s' - % (filename, section, error.class.name, - error, setting, value)), None, sys.exc_info()[2]) - self.set(section, setting, new_value) - if option.overrides: - self.set(section, option.overrides, None) - - def optionxform(self, optionstr): - """ - Transform '-' to '_' so the cmdline form of option names can be used. - """ - return optionstr.lower().replace('-', '_') - - def get_section(self, section): - """ - Return a given section as a dictionary (empty if the section - doesn't exist). - """ - section_dict = {} - if self.has_section(section): - for option in self.options(section): - section_dict[option] = self.get(section, option, raw=1) - return section_dict - - -class ConfigDeprecationWarning(DeprecationWarning): - """Warning for deprecated configuration file features.""" diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/io.py --- a/buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/io.py Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,412 +0,0 @@ -# $Id: io.py 4750 2006-09-16 21:32:29Z wiemann $ -# Author: David Goodger -# Copyright: This module has been placed in the public domain. - -""" -I/O classes provide a uniform API for low-level input and output. Subclasses -will exist for a variety of input/output mechanisms. -""" - -docformat = 'reStructuredText' - -import sys -try: - import locale -except: - pass -import re -from types import UnicodeType -from docutils import TransformSpec - - -class Input(TransformSpec): - - """ - Abstract base class for input wrappers. - """ - - component_type = 'input' - - default_source_path = None - - def init(self, source=None, source_path=None, encoding=None, - error_handler='strict'): - self.encoding = encoding - """Text encoding for the input source.""" - - self.error_handler = error_handler - """Text decoding error handler.""" - - self.source = source - """The source of input data.""" - - self.source_path = source_path - """A text reference to the source.""" - - if not source_path: - self.source_path = self.default_source_path - - self.successful_encoding = None - """The encoding that successfully decoded the source data.""" - - def repr(self): - return '%s: source=%r, source_path=%r' % (self.class, self.source, - self.source_path) - - def read(self): - raise NotImplementedError - - def decode(self, data): - """ - Decode a string, `data`, heuristically. - Raise UnicodeError if unsuccessful. - - The client application should call ``locale.setlocale`` at the - beginning of processing:: - - locale.setlocale(locale.LC_ALL, '') - """ - if self.encoding and self.encoding.lower() == 'unicode': - assert isinstance(data, UnicodeType), ( - 'input encoding is "unicode" ' - 'but input is not a unicode object') - if isinstance(data, UnicodeType): - # Accept unicode even if self.encoding != 'unicode'. - return data - if self.encoding: - # We believe the user/application when the encoding is - # explicitly given. - encodings = [self.encoding] - else: - data_encoding = self.determine_encoding_from_data(data) - if data_encoding: - # If the data declares its encoding (explicitly or via a BOM), - # we believe it. - encodings = [data_encoding] - else: - # Apply heuristics only if no encoding is explicitly given and - # no BOM found. Start with UTF-8, because that only matches - # data that IS UTF-8: - encodings = ['utf-8'] - try: - # for Python 2.2 compatibility - encodings.append(locale.nl_langinfo(locale.CODESET)) - except: - pass - try: - encodings.append(locale.getlocale()[1]) - except: - pass - try: - encodings.append(locale.getdefaultlocale()[1]) - except: - pass - # fallback encoding: - encodings.append('latin-1') - error = None - error_details = '' - for enc in encodings: - if not enc: - continue - try: - decoded = unicode(data, enc, self.error_handler) - self.successful_encoding = enc - # Return decoded, removing BOMs. - return decoded.replace(u'\ufeff', u'') - except (UnicodeError, LookupError), error: - pass - if error is not None: - error_details = '\n(%s: %s)' % (error.class.name, error) - raise UnicodeError( - 'Unable to decode input data. Tried the following encodings: ' - '%s.%s' - % (', '.join([repr(enc) for enc in encodings if enc]), - error_details)) - - coding_slug = re.compile("coding[:=]\s([-\w.]+)") - """Encoding declaration pattern.""" - - byte_order_marks = (('\xef\xbb\xbf', 'utf-8'), - ('\xfe\xff', 'utf-16-be'), - ('\xff\xfe', 'utf-16-le'),) - """Sequence of (start_bytes, encoding) tuples to for encoding detection. - The first bytes of input data are checked against the start_bytes strings. - A match indicates the given encoding.""" - - def determine_encoding_from_data(self, data): - """ - Try to determine the encoding of `data` by looking in* `data`. - Check for a byte order mark (BOM) or an encoding declaration. - """ - # check for a byte order mark: - for start_bytes, encoding in self.byte_order_marks: - if data.startswith(start_bytes): - return encoding - # check for an encoding declaration pattern in first 2 lines of file: - for line in data.splitlines()[:2]: - match = self.coding_slug.search(line) - if match: - return match.group(1) - return None - - -class Output(TransformSpec): - - """ - Abstract base class for output wrappers. - """ - - component_type = 'output' - - default_destination_path = None - - def init(self, destination=None, destination_path=None, - encoding=None, error_handler='strict'): - self.encoding = encoding - """Text encoding for the output destination.""" - - self.error_handler = error_handler or 'strict' - """Text encoding error handler.""" - - self.destination = destination - """The destination for output data.""" - - self.destination_path = destination_path - """A text reference to the destination.""" - - if not destination_path: - self.destination_path = self.default_destination_path - - def repr(self): - return ('%s: destination=%r, destination_path=%r' - % (self.class, self.destination, self.destination_path)) - - def write(self, data): - """`data` is a Unicode string, to be encoded by `self.encode`.""" - raise NotImplementedError - - def encode(self, data): - if self.encoding and self.encoding.lower() == 'unicode': - assert isinstance(data, UnicodeType), ( - 'the encoding given is "unicode" but the output is not ' - 'a Unicode string') - return data - if not isinstance(data, UnicodeType): - # Non-unicode (e.g. binary) output. - return data - else: - try: - return data.encode(self.encoding, self.error_handler) - except (LookupError, ValueError): - # LookupError is raised if there are unencodable chars - # in data and the error_handler isn't found. In old - # Python versions, ValueError is raised. - if self.error_handler == 'xmlcharrefreplace': - # We are using xmlcharrefreplace with a Python - # version that doesn't support it (2.1, 2.2, or - # IronPython 1.0) so we emulate its behavior. - return ''.join([self.xmlcharref_encode(char) - for char in data]) - else: - raise - - def xmlcharref_encode(self, char): - """Emulate Python 2.3's 'xmlcharrefreplace' encoding error handler.""" - try: - return char.encode(self.encoding, 'strict') - except UnicodeError: - return '&#%i;' % ord(char) - - -class FileInput(Input): - - """ - Input for single, simple file-like objects. - """ - - def init(self, source=None, source_path=None, - encoding=None, error_handler='strict', - autoclose=1, handle_io_errors=1): - """ - :Parameters: - - `source`: either a file-like object (which is read directly), or - `None` (which implies `sys.stdin` if no `source_path` given). - - `source_path`: a path to a file, which is opened and then read. - - `encoding`: the expected text encoding of the input file. - - `error_handler`: the encoding error handler to use. - - `autoclose`: close automatically after read (boolean); always - false if `sys.stdin` is the source. - - `handle_io_errors`: summarize I/O errors here, and exit? - """ - Input.init(self, source, source_path, encoding, error_handler) - self.autoclose = autoclose - self.handle_io_errors = handle_io_errors - if source is None: - if source_path: - try: - self.source = open(source_path) - except IOError, error: - if not handle_io_errors: - raise - print >>sys.stderr, '%s: %s' % (error.class.name, - error) - print >>sys.stderr, ( - 'Unable to open source file for reading (%r). Exiting.' - % source_path) - sys.exit(1) - else: - self.source = sys.stdin - self.autoclose = None - if not source_path: - try: - self.source_path = self.source.name - except AttributeError: - pass - - def read(self): - """ - Read and decode a single file and return the data (Unicode string). - """ - try: - data = self.source.read() - finally: - if self.autoclose: - self.close() - return self.decode(data) - - def close(self): - self.source.close() - - -class FileOutput(Output): - - """ - Output for single, simple file-like objects. - """ - - def init(self, destination=None, destination_path=None, - encoding=None, error_handler='strict', autoclose=1, - handle_io_errors=1): - """ - :Parameters: - - `destination`: either a file-like object (which is written - directly) or `None` (which implies `sys.stdout` if no - `destination_path` given). - - `destination_path`: a path to a file, which is opened and then - written. - - `autoclose`: close automatically after write (boolean); always - false if `sys.stdout` is the destination. - """ - Output.init(self, destination, destination_path, - encoding, error_handler) - self.opened = 1 - self.autoclose = autoclose - self.handle_io_errors = handle_io_errors - if destination is None: - if destination_path: - self.opened = None - else: - self.destination = sys.stdout - self.autoclose = None - if not destination_path: - try: - self.destination_path = self.destination.name - except AttributeError: - pass - - def open(self): - try: - self.destination = open(self.destination_path, 'w') - except IOError, error: - if not self.handle_io_errors: - raise - print >>sys.stderr, '%s: %s' % (error.class.name, - error) - print >>sys.stderr, ('Unable to open destination file for writing ' - '(%r). Exiting.' % self.destination_path) - sys.exit(1) - self.opened = 1 - - def write(self, data): - """Encode `data`, write it to a single file, and return it.""" - output = self.encode(data) - if not self.opened: - self.open() - try: - self.destination.write(output) - finally: - if self.autoclose: - self.close() - return output - - def close(self): - self.destination.close() - self.opened = None - - -class StringInput(Input): - - """ - Direct string input. - """ - - default_source_path = '' - - def read(self): - """Decode and return the source string.""" - return self.decode(self.source) - - -class StringOutput(Output): - - """ - Direct string output. - """ - - default_destination_path = '' - - def write(self, data): - """Encode `data`, store it in `self.destination`, and return it.""" - self.destination = self.encode(data) - return self.destination - - -class NullInput(Input): - - """ - Degenerate input: read nothing. - """ - - default_source_path = 'null input' - - def read(self): - """Return a null string.""" - return u'' - - -class NullOutput(Output): - - """ - Degenerate output: write nothing. - """ - - default_destination_path = 'null output' - - def write(self, data): - """Do nothing ([don't even] send data to the bit bucket).""" - pass - - -class DocTreeInput(Input): - - """ - Adapter for document tree input. - - The document tree must be passed in the ``source`` parameter. - """ - - default_source_path = 'doctree input' - - def read(self): - """Return the document tree.""" - return self.source diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/languages/init.py --- a/buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/languages/init.py Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,21 +0,0 @@ -# $Id: init.py 4564 2006-05-21 20:44:42Z wiemann $ -# Author: David Goodger -# Copyright: This module has been placed in the public domain. - -# Internationalization details are documented in -# . - -""" -This package contains modules for language-dependent features of Docutils. -""" - -docformat = 'reStructuredText' - -_languages = {} - -def get_language(language_code): - if _languages.has_key(language_code): - return _languages[language_code] - module = import(language_code, globals(), locals()) - _languages[language_code] = module - return module diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/languages/af.py --- a/buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/languages/af.py Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,58 +0,0 @@ -# $Id: af.py 4564 2006-05-21 20:44:42Z wiemann $ -# Author: Jannie Hofmeyr -# Copyright: This module has been placed in the public domain. - -# New language mappings are welcome. Before doing a new translation, please -# read . Two files must be -# translated for each language: one in docutils/languages, the other in -# docutils/parsers/rst/languages. - -""" -Afrikaans-language mappings for language-dependent features of Docutils. -""" - -docformat = 'reStructuredText' - -labels = { - 'author': 'Auteur', - 'authors': 'Auteurs', - 'organization': 'Organisasie', - 'address': 'Adres', - 'contact': 'Kontak', - 'version': 'Weergawe', - 'revision': 'Revisie', - 'status': 'Status', - 'date': 'Datum', - 'copyright': 'Kopiereg', - 'dedication': 'Opdrag', - 'abstract': 'Opsomming', - 'attention': 'Aandag!', - 'caution': 'Wees versigtig!', - 'danger': '!GEVAAR!', - 'error': 'Fout', - 'hint': 'Wenk', - 'important': 'Belangrik', - 'note': 'Nota', - 'tip': 'Tip', # hint and tip both have the same translation: wenk - 'warning': 'Waarskuwing', - 'contents': 'Inhoud'} -"""Mapping of node class name to label text.""" - -bibliographic_fields = { - 'auteur': 'author', - 'auteurs': 'authors', - 'organisasie': 'organization', - 'adres': 'address', - 'kontak': 'contact', - 'weergawe': 'version', - 'revisie': 'revision', - 'status': 'status', - 'datum': 'date', - 'kopiereg': 'copyright', - 'opdrag': 'dedication', - 'opsomming': 'abstract'} -"""Afrikaans (lowcased) to canonical name mapping for bibliographic fields.""" - -author_separators = [';', ','] -"""List of separator strings for the 'Authors' bibliographic field. Tried in -order.""" diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/languages/ca.py --- a/buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/languages/ca.py Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,60 +0,0 @@ -# $Id: ca.py 4564 2006-05-21 20:44:42Z wiemann $ -# Author: Ivan Vilata i Balaguer -# Copyright: This module has been placed in the public domain. - -# New language mappings are welcome. Before doing a new translation, please -# read . Two files must be -# translated for each language: one in docutils/languages, the other in -# docutils/parsers/rst/languages. - -""" -Catalan-language mappings for language-dependent features of Docutils. -""" - -docformat = 'reStructuredText' - -labels = { - # fixed: language-dependent - 'author': u'Autor', - 'authors': u'Autors', - 'organization': u'Organitzaci\u00F3', - 'address': u'Adre\u00E7a', - 'contact': u'Contacte', - 'version': u'Versi\u00F3', - 'revision': u'Revisi\u00F3', - 'status': u'Estat', - 'date': u'Data', - 'copyright': u'Copyright', - 'dedication': u'Dedicat\u00F2ria', - 'abstract': u'Resum', - 'attention': u'Atenci\u00F3!', - 'caution': u'Compte!', - 'danger': u'PERILL!', - 'error': u'Error', - 'hint': u'Suggeriment', - 'important': u'Important', - 'note': u'Nota', - 'tip': u'Consell', - 'warning': u'Av\u00EDs', - 'contents': u'Contingut'} -"""Mapping of node class name to label text.""" - -bibliographic_fields = { - # language-dependent: fixed - u'autor': 'author', - u'autors': 'authors', - u'organitzaci\u00F3': 'organization', - u'adre\u00E7a': 'address', - u'contacte': 'contact', - u'versi\u00F3': 'version', - u'revisi\u00F3': 'revision', - u'estat': 'status', - u'data': 'date', - u'copyright': 'copyright', - u'dedicat\u00F2ria': 'dedication', - u'resum': 'abstract'} -"""Catalan (lowcased) to canonical name mapping for bibliographic fields.""" - -author_separators = [';', ','] -"""List of separator strings for the 'Authors' bibliographic field. Tried in -order.""" diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/languages/cs.py --- a/buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/languages/cs.py Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,60 +0,0 @@ -# $Id: cs.py 4564 2006-05-21 20:44:42Z wiemann $ -# Author: Marek Blaha -# Copyright: This module has been placed in the public domain. - -# New language mappings are welcome. Before doing a new translation, please -# read . Two files must be -# translated for each language: one in docutils/languages, the other in -# docutils/parsers/rst/languages. - -""" -Czech-language mappings for language-dependent features of Docutils. -""" - -docformat = 'reStructuredText' - -labels = { - # fixed: language-dependent - 'author': u'Autor', - 'authors': u'Auto\u0159i', - 'organization': u'Organizace', - 'address': u'Adresa', - 'contact': u'Kontakt', - 'version': u'Verze', - 'revision': u'Revize', - 'status': u'Stav', - 'date': u'Datum', - 'copyright': u'Copyright', - 'dedication': u'V\u011Bnov\u00E1n\u00ED', - 'abstract': u'Abstrakt', - 'attention': u'Pozor!', - 'caution': u'Opatrn\u011B!', - 'danger': u'!NEBEZPE\u010C\u00CD!', - 'error': u'Chyba', - 'hint': u'Rada', - 'important': u'D\u016Fle\u017Eit\u00E9', - 'note': u'Pozn\u00E1mka', - 'tip': u'Tip', - 'warning': u'Varov\u00E1n\u00ED', - 'contents': u'Obsah'} -"""Mapping of node class name to label text.""" - -bibliographic_fields = { - # language-dependent: fixed - u'autor': 'author', - u'auto\u0159i': 'authors', - u'organizace': 'organization', - u'adresa': 'address', - u'kontakt': 'contact', - u'verze': 'version', - u'revize': 'revision', - u'stav': 'status', - u'datum': 'date', - u'copyright': 'copyright', - u'v\u011Bnov\u00E1n\u00ED': 'dedication', - u'abstrakt': 'abstract'} -"""Czech (lowcased) to canonical name mapping for bibliographic fields.""" - -author_separators = [';', ','] -"""List of separator strings for the 'Authors' bibliographic field. Tried in -order.""" diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/languages/de.py --- a/buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/languages/de.py Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,58 +0,0 @@ -# $Id: de.py 4564 2006-05-21 20:44:42Z wiemann $ -# Author: Gunnar Schwant -# Copyright: This module has been placed in the public domain. - -# New language mappings are welcome. Before doing a new translation, please -# read . Two files must be -# translated for each language: one in docutils/languages, the other in -# docutils/parsers/rst/languages. - -""" -German language mappings for language-dependent features of Docutils. -""" - -docformat = 'reStructuredText' - -labels = { - 'author': 'Autor', - 'authors': 'Autoren', - 'organization': 'Organisation', - 'address': 'Adresse', - 'contact': 'Kontakt', - 'version': 'Version', - 'revision': 'Revision', - 'status': 'Status', - 'date': 'Datum', - 'dedication': 'Widmung', - 'copyright': 'Copyright', - 'abstract': 'Zusammenfassung', - 'attention': 'Achtung!', - 'caution': 'Vorsicht!', - 'danger': '!GEFAHR!', - 'error': 'Fehler', - 'hint': 'Hinweis', - 'important': 'Wichtig', - 'note': 'Bemerkung', - 'tip': 'Tipp', - 'warning': 'Warnung', - 'contents': 'Inhalt'} -"""Mapping of node class name to label text.""" - -bibliographic_fields = { - 'autor': 'author', - 'autoren': 'authors', - 'organisation': 'organization', - 'adresse': 'address', - 'kontakt': 'contact', - 'version': 'version', - 'revision': 'revision', - 'status': 'status', - 'datum': 'date', - 'copyright': 'copyright', - 'widmung': 'dedication', - 'zusammenfassung': 'abstract'} -"""German (lowcased) to canonical name mapping for bibliographic fields.""" - -author_separators = [';', ','] -"""List of separator strings for the 'Authors' bibliographic field. Tried in -order.""" diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/languages/en.py --- a/buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/languages/en.py Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,60 +0,0 @@ -# $Id: en.py 4564 2006-05-21 20:44:42Z wiemann $ -# Author: David Goodger -# Copyright: This module has been placed in the public domain. - -# New language mappings are welcome. Before doing a new translation, please -# read . Two files must be -# translated for each language: one in docutils/languages, the other in -# docutils/parsers/rst/languages. - -""" -English-language mappings for language-dependent features of Docutils. -""" - -docformat = 'reStructuredText' - -labels = { - # fixed: language-dependent - 'author': 'Author', - 'authors': 'Authors', - 'organization': 'Organization', - 'address': 'Address', - 'contact': 'Contact', - 'version': 'Version', - 'revision': 'Revision', - 'status': 'Status', - 'date': 'Date', - 'copyright': 'Copyright', - 'dedication': 'Dedication', - 'abstract': 'Abstract', - 'attention': 'Attention!', - 'caution': 'Caution!', - 'danger': '!DANGER!', - 'error': 'Error', - 'hint': 'Hint', - 'important': 'Important', - 'note': 'Note', - 'tip': 'Tip', - 'warning': 'Warning', - 'contents': 'Contents'} -"""Mapping of node class name to label text.""" - -bibliographic_fields = { - # language-dependent: fixed - 'author': 'author', - 'authors': 'authors', - 'organization': 'organization', - 'address': 'address', - 'contact': 'contact', - 'version': 'version', - 'revision': 'revision', - 'status': 'status', - 'date': 'date', - 'copyright': 'copyright', - 'dedication': 'dedication', - 'abstract': 'abstract'} -"""English (lowcased) to canonical name mapping for bibliographic fields.""" - -author_separators = [';', ','] -"""List of separator strings for the 'Authors' bibliographic field. Tried in -order.""" diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/languages/eo.py --- a/buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/languages/eo.py Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,61 +0,0 @@ -# $Id: eo.py 4564 2006-05-21 20:44:42Z wiemann $ -# Author: Marcelo Huerta San Martin -# Copyright: This module has been placed in the public domain. - -# New language mappings are welcome. Before doing a new translation, please -# read . Two files must be -# translated for each language: one in docutils/languages, the other in -# docutils/parsers/rst/languages. - -""" -Esperanto-language mappings for language-dependent features of Docutils. -""" - -docformat = 'reStructuredText' - -labels = { - # fixed: language-dependent - 'author': u'A\u016dtoro', - 'authors': u'A\u016dtoroj', - 'organization': u'Organizo', - 'address': u'Adreso', - 'contact': u'Kontakto', - 'version': u'Versio', - 'revision': u'Revido', - 'status': u'Stato', - 'date': u'Dato', - # 'copyright': u'Kopirajto', - 'copyright': u'A\u016dtorrajto', - 'dedication': u'Dedi\u0109o', - 'abstract': u'Resumo', - 'attention': u'Atentu!', - 'caution': u'Zorgu!', - 'danger': u'DAN\u011cERO!', - 'error': u'Eraro', - 'hint': u'Spuro', - 'important': u'Grava', - 'note': u'Noto', - 'tip': u'Helpeto', - 'warning': u'Averto', - 'contents': u'Enhavo'} -"""Mapping of node class name to label text.""" - -bibliographic_fields = { - # language-dependent: fixed - 'a\u016dtoro': 'author', - 'a\u016dtoroj': 'authors', - 'organizo': 'organization', - 'adreso': 'address', - 'kontakto': 'contact', - 'versio': 'version', - 'revido': 'revision', - 'stato': 'status', - 'dato': 'date', - 'a\u016dtorrajto': 'copyright', - 'dedi\u0109o': 'dedication', - 'resumo': 'abstract'} -"""Esperanto (lowcased) to canonical name mapping for bibliographic fields.""" - -author_separators = [';', ','] -"""List of separator strings for the 'Authors' bibliographic field. Tried in -order.""" diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/languages/es.py --- a/buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/languages/es.py Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,59 +0,0 @@ -# -- coding: utf-8 -- -# $Id: es.py 4572 2006-05-25 20:48:37Z richieadler $ -# Author: Marcelo Huerta San Martín -# Copyright: This module has been placed in the public domain. - -# New language mappings are welcome. Before doing a new translation, please -# read . Two files must be -# translated for each language: one in docutils/languages, the other in -# docutils/parsers/rst/languages. - -""" -Spanish-language mappings for language-dependent features of Docutils. -""" - -docformat = 'reStructuredText' - -labels = { - 'author': u'Autor', - 'authors': u'Autores', - 'organization': u'Organizaci\u00f3n', - 'address': u'Direcci\u00f3n', - 'contact': u'Contacto', - 'version': u'Versi\u00f3n', - 'revision': u'Revisi\u00f3n', - 'status': u'Estado', - 'date': u'Fecha', - 'copyright': u'Copyright', - 'dedication': u'Dedicatoria', - 'abstract': u'Resumen', - 'attention': u'\u00a1Atenci\u00f3n!', - 'caution': u'\u00a1Precauci\u00f3n!', - 'danger': u'\u00a1PELIGRO!', - 'error': u'Error', - 'hint': u'Sugerencia', - 'important': u'Importante', - 'note': u'Nota', - 'tip': u'Consejo', - 'warning': u'Advertencia', - 'contents': u'Contenido'} -"""Mapping of node class name to label text.""" - -bibliographic_fields = { - u'autor': 'author', - u'autores': 'authors', - u'organizaci\u00f3n': 'organization', - u'direcci\u00f3n': 'address', - u'contacto': 'contact', - u'versi\u00f3n': 'version', - u'revisi\u00f3n': 'revision', - u'estado': 'status', - u'fecha': 'date', - u'copyright': 'copyright', - u'dedicatoria': 'dedication', - u'resumen': 'abstract'} -"""Spanish (lowcased) to canonical name mapping for bibliographic fields.""" - -author_separators = [';', ','] -"""List of separator strings for the 'Authors' bibliographic field. Tried in -order.""" diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/languages/fi.py --- a/buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/languages/fi.py Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,60 +0,0 @@ -# $Id: fi.py 4564 2006-05-21 20:44:42Z wiemann $ -# Author: Asko Soukka -# Copyright: This module has been placed in the public domain. - -# New language mappings are welcome. Before doing a new translation, please -# read . Two files must be -# translated for each language: one in docutils/languages, the other in -# docutils/parsers/rst/languages. - -""" -Finnish-language mappings for language-dependent features of Docutils. -""" - -docformat = 'reStructuredText' - -labels = { - # fixed: language-dependent - u'author': u'Tekij\u00e4', - u'authors': u'Tekij\u00e4t', - u'organization': u'Yhteis\u00f6', - u'address': u'Osoite', - u'contact': u'Yhteystiedot', - u'version': u'Versio', - u'revision': u'Vedos', - u'status': u'Tila', - u'date': u'P\u00e4iv\u00e4ys', - u'copyright': u'Tekij\u00e4noikeudet', - u'dedication': u'Omistuskirjoitus', - u'abstract': u'Tiivistelm\u00e4', - u'attention': u'Huomio!', - u'caution': u'Varo!', - u'danger': u'!VAARA!', - u'error': u'Virhe', - u'hint': u'Vihje', - u'important': u'T\u00e4rke\u00e4\u00e4', - u'note': u'Huomautus', - u'tip': u'Neuvo', - u'warning': u'Varoitus', - u'contents': u'Sis\u00e4llys'} -"""Mapping of node class name to label text.""" - -bibliographic_fields = { - # language-dependent: fixed - u'tekij\u00e4': u'author', - u'tekij\u00e4t': u'authors', - u'yhteis\u00f6': u'organization', - u'osoite': u'address', - u'yhteystiedot': u'contact', - u'versio': u'version', - u'vedos': u'revision', - u'tila': u'status', - u'p\u00e4iv\u00e4ys': u'date', - u'tekij\u00e4noikeudet': u'copyright', - u'omistuskirjoitus': u'dedication', - u'tiivistelm\u00e4': u'abstract'} -"""Finnish (lowcased) to canonical name mapping for bibliographic fields.""" - -author_separators = [';', ','] -"""List of separator strings for the 'Authors' bibliographic field. Tried in -order.""" diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/languages/fr.py --- a/buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/languages/fr.py Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,58 +0,0 @@ -# $Id: fr.py 4564 2006-05-21 20:44:42Z wiemann $ -# Author: Stefane Fermigier -# Copyright: This module has been placed in the public domain. - -# New language mappings are welcome. Before doing a new translation, please -# read . Two files must be -# translated for each language: one in docutils/languages, the other in -# docutils/parsers/rst/languages. - -""" -French-language mappings for language-dependent features of Docutils. -""" - -docformat = 'reStructuredText' - -labels = { - u'author': u'Auteur', - u'authors': u'Auteurs', - u'organization': u'Organisation', - u'address': u'Adresse', - u'contact': u'Contact', - u'version': u'Version', - u'revision': u'R\u00e9vision', - u'status': u'Statut', - u'date': u'Date', - u'copyright': u'Copyright', - u'dedication': u'D\u00e9dicace', - u'abstract': u'R\u00e9sum\u00e9', - u'attention': u'Attention!', - u'caution': u'Avertissement!', - u'danger': u'!DANGER!', - u'error': u'Erreur', - u'hint': u'Indication', - u'important': u'Important', - u'note': u'Note', - u'tip': u'Astuce', - u'warning': u'Avis', - u'contents': u'Sommaire'} -"""Mapping of node class name to label text.""" - -bibliographic_fields = { - u'auteur': u'author', - u'auteurs': u'authors', - u'organisation': u'organization', - u'adresse': u'address', - u'contact': u'contact', - u'version': u'version', - u'r\u00e9vision': u'revision', - u'statut': u'status', - u'date': u'date', - u'copyright': u'copyright', - u'd\u00e9dicace': u'dedication', - u'r\u00e9sum\u00e9': u'abstract'} -"""French (lowcased) to canonical name mapping for bibliographic fields.""" - -author_separators = [';', ','] -"""List of separator strings for the 'Authors' bibliographic field. Tried in -order.""" diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/languages/he.py --- a/buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/languages/he.py Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,60 +0,0 @@ -# Author: Meir Kriheli -# Id: $Id: he.py 4837 2006-12-26 09:59:41Z sfcben $ -# Copyright: This module has been placed in the public domain. - -# New language mappings are welcome. Before doing a new translation, please -# read . Two files must be -# translated for each language: one in docutils/languages, the other in -# docutils/parsers/rst/languages. - -""" -Hebrew-language mappings for language-dependent features of Docutils. -""" - -docformat = 'reStructuredText' - -labels = { - # fixed: language-dependent - 'author': u'\u05de\u05d7\u05d1\u05e8', - 'authors': u'\u05de\u05d7\u05d1\u05e8\u05d9', - 'organization': u'\u05d0\u05e8\u05d2\u05d5\u05df', - 'address': u'\u05db\u05ea\u05d5\u05d1\u05ea', - 'contact': u'\u05d0\u05d9\u05e9 \u05e7\u05e9\u05e8', - 'version': u'\u05d2\u05e8\u05e1\u05d4', - 'revision': u'\u05de\u05d4\u05d3\u05d5\u05e8\u05d4', - 'status': u'\u05e1\u05d8\u05d8\u05d5\u05e1', - 'date': u'\u05ea\u05d0\u05e8\u05d9\u05da', - 'copyright': u'\u05d6\u05db\u05d5\u05d9\u05d5\u05ea \u05e9\u05de\u05d5\u05e8\u05d5\u05ea', - 'dedication': u'\u05d4\u05e7\u05d3\u05e9\u05d4', - 'abstract': u'\u05ea\u05e7\u05e6\u05d9\u05e8', - 'attention': u'\u05ea\u05e9\u05d5\u05de\u05ea \u05dc\u05d1', - 'caution': u'\u05d6\u05d4\u05d9\u05e8\u05d5\u05ea', - 'danger': u'\u05e1\u05db\u05e0\u05d4', - 'error': u'\u05e9\u05d2\u05d9\u05d0\u05d4' , - 'hint': u'\u05e8\u05de\u05d6', - 'important': u'\u05d7\u05e9\u05d5\u05d1', - 'note': u'\u05d4\u05e2\u05e8\u05d4', - 'tip': u'\u05d8\u05d9\u05e4', - 'warning': u'\u05d0\u05d6\u05d4\u05e8\u05d4', - 'contents': u'\u05ea\u05d5\u05db\u05df'} -"""Mapping of node class name to label text.""" - -bibliographic_fields = { - # language-dependent: fixed - u'\u05de\u05d7\u05d1\u05e8': 'author', - u'\u05de\u05d7\u05d1\u05e8\u05d9': 'authors', - u'\u05d0\u05e8\u05d2\u05d5\u05df': 'organization', - u'\u05db\u05ea\u05d5\u05d1\u05ea': 'address', - u'\u05d0\u05d9\u05e9 \u05e7\u05e9\u05e8': 'contact', - u'\u05d2\u05e8\u05e1\u05d4': 'version', - u'\u05de\u05d4\u05d3\u05d5\u05e8\u05d4': 'revision', - u'\u05e1\u05d8\u05d8\u05d5\u05e1': 'status', - u'\u05ea\u05d0\u05e8\u05d9\u05da': 'date', - u'\u05d6\u05db\u05d5\u05d9\u05d5\u05ea \u05e9\u05de\u05d5\u05e8\u05d5\u05ea': 'copyright', - u'\u05d4\u05e7\u05d3\u05e9\u05d4': 'dedication', - u'\u05ea\u05e7\u05e6\u05d9\u05e8': 'abstract'} -"""Hebrew to canonical name mapping for bibliographic fields.""" - -author_separators = [';', ','] -"""List of separator strings for the 'Authors' bibliographic field. Tried in -order.""" diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/languages/it.py --- a/buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/languages/it.py Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,58 +0,0 @@ -# $Id: it.py 4564 2006-05-21 20:44:42Z wiemann $ -# Author: Nicola Larosa -# Copyright: This module has been placed in the public domain. - -# New language mappings are welcome. Before doing a new translation, please -# read . Two files must be -# translated for each language: one in docutils/languages, the other in -# docutils/parsers/rst/languages. - -""" -Italian-language mappings for language-dependent features of Docutils. -""" - -docformat = 'reStructuredText' - -labels = { - 'author': 'Autore', - 'authors': 'Autori', - 'organization': 'Organizzazione', - 'address': 'Indirizzo', - 'contact': 'Contatti', - 'version': 'Versione', - 'revision': 'Revisione', - 'status': 'Status', - 'date': 'Data', - 'copyright': 'Copyright', - 'dedication': 'Dedica', - 'abstract': 'Riassunto', - 'attention': 'Attenzione!', - 'caution': 'Cautela!', - 'danger': '!PERICOLO!', - 'error': 'Errore', - 'hint': 'Suggerimento', - 'important': 'Importante', - 'note': 'Nota', - 'tip': 'Consiglio', - 'warning': 'Avvertenza', - 'contents': 'Indice'} -"""Mapping of node class name to label text.""" - -bibliographic_fields = { - 'autore': 'author', - 'autori': 'authors', - 'organizzazione': 'organization', - 'indirizzo': 'address', - 'contatto': 'contact', - 'versione': 'version', - 'revisione': 'revision', - 'status': 'status', - 'data': 'date', - 'copyright': 'copyright', - 'dedica': 'dedication', - 'riassunto': 'abstract'} -"""Italian (lowcased) to canonical name mapping for bibliographic fields.""" - -author_separators = [';', ','] -"""List of separator strings for the 'Authors' bibliographic field. Tried in -order.""" diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/languages/ja.py --- a/buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/languages/ja.py Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,61 +0,0 @@ -# -- coding: utf-8 -- -# $Id: ja.py 4564 2006-05-21 20:44:42Z wiemann $ -# Author: Hisashi Morita -# Copyright: This module has been placed in the public domain. - -# New language mappings are welcome. Before doing a new translation, please -# read . Two files must be -# translated for each language: one in docutils/languages, the other in -# docutils/parsers/rst/languages. - -""" -Japanese-language mappings for language-dependent features of Docutils. -""" - -docformat = 'reStructuredText' - -labels = { - # fixed: language-dependent - 'author': u'著者', - 'authors': u'著者', - 'organization': u'組織', - 'address': u'住所', - 'contact': u'連絡先', - 'version': u'バージョン', - 'revision': u'リビジョン', - 'status': u'ステータス', - 'date': u'日付', - 'copyright': u'著作権', - 'dedication': u'献辞', - 'abstract': u'概要', - 'attention': u'注目!', - 'caution': u'注意!', - 'danger': u'!危険!', - 'error': u'エラー', - 'hint': u'ヒント', - 'important': u'重要', - 'note': u'備考', - 'tip': u'通報', - 'warning': u'警告', - 'contents': u'目次'} -"""Mapping of node class name to label text.""" - -bibliographic_fields = { - # language-dependent: fixed - u'著者': 'author', - u' n/a': 'authors', - u'組織': 'organization', - u'住所': 'address', - u'連絡先': 'contact', - u'バージョン': 'version', - u'リビジョン': 'revision', - u'ステータス': 'status', - u'日付': 'date', - u'著作権': 'copyright', - u'献辞': 'dedication', - u'概要': 'abstract'} -"""Japanese (lowcased) to canonical name mapping for bibliographic fields.""" - -author_separators = [';', ','] -"""List of separator strings for the 'Authors' bibliographic field. Tried in -order.""" diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/languages/nl.py --- a/buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/languages/nl.py Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,60 +0,0 @@ -# $Id: nl.py 4564 2006-05-21 20:44:42Z wiemann $ -# Author: Martijn Pieters -# Copyright: This module has been placed in the public domain. - -# New language mappings are welcome. Before doing a new translation, please -# read . Two files must be -# translated for each language: one in docutils/languages, the other in -# docutils/parsers/rst/languages. - -""" -Dutch-language mappings for language-dependent features of Docutils. -""" - -docformat = 'reStructuredText' - -labels = { - # fixed: language-dependent - 'author': 'Auteur', - 'authors': 'Auteurs', - 'organization': 'Organisatie', - 'address': 'Adres', - 'contact': 'Contact', - 'version': 'Versie', - 'revision': 'Revisie', - 'status': 'Status', - 'date': 'Datum', - 'copyright': 'Copyright', - 'dedication': 'Toewijding', - 'abstract': 'Samenvatting', - 'attention': 'Attentie!', - 'caution': 'Let op!', - 'danger': '!GEVAAR!', - 'error': 'Fout', - 'hint': 'Hint', - 'important': 'Belangrijk', - 'note': 'Opmerking', - 'tip': 'Tip', - 'warning': 'Waarschuwing', - 'contents': 'Inhoud'} -"""Mapping of node class name to label text.""" - -bibliographic_fields = { - # language-dependent: fixed - 'auteur': 'author', - 'auteurs': 'authors', - 'organisatie': 'organization', - 'adres': 'address', - 'contact': 'contact', - 'versie': 'version', - 'revisie': 'revision', - 'status': 'status', - 'datum': 'date', - 'copyright': 'copyright', - 'toewijding': 'dedication', - 'samenvatting': 'abstract'} -"""Dutch (lowcased) to canonical name mapping for bibliographic fields.""" - -author_separators = [';', ','] -"""List of separator strings for the 'Authors' bibliographic field. Tried in -order.""" diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/languages/pt_br.py --- a/buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/languages/pt_br.py Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,60 +0,0 @@ -# $Id: pt_br.py 4564 2006-05-21 20:44:42Z wiemann $ -# Author: David Goodger -# Copyright: This module has been placed in the public domain. - -# New language mappings are welcome. Before doing a new translation, please -# read . Two files must be -# translated for each language: one in docutils/languages, the other in -# docutils/parsers/rst/languages. - -""" -Brazilian Portuguese-language mappings for language-dependent features of Docutils. -""" - -docformat = 'reStructuredText' - -labels = { - # fixed: language-dependent - 'author': u'Autor', - 'authors': u'Autores', - 'organization': u'Organiza\u00E7\u00E3o', - 'address': u'Endere\u00E7o', - 'contact': u'Contato', - 'version': u'Vers\u00E3o', - 'revision': u'Revis\u00E3o', - 'status': u'Estado', - 'date': u'Data', - 'copyright': u'Copyright', - 'dedication': u'Dedicat\u00F3ria', - 'abstract': u'Resumo', - 'attention': u'Atten\u00E7\u00E3o!', - 'caution': u'Cuidado!', - 'danger': u'PERIGO!', - 'error': u'Erro', - 'hint': u'Sugest\u00E3o', - 'important': u'Importante', - 'note': u'Nota', - 'tip': u'Dica', - 'warning': u'Aviso', - 'contents': u'Sum\u00E1rio'} -"""Mapping of node class name to label text.""" - -bibliographic_fields = { - # language-dependent: fixed - u'autor': 'author', - u'autores': 'authors', - u'organiza\u00E7\u00E3o': 'organization', - u'endere\u00E7o': 'address', - u'contato': 'contact', - u'vers\u00E3o': 'version', - u'revis\u00E3o': 'revision', - u'estado': 'status', - u'data': 'date', - u'copyright': 'copyright', - u'dedicat\u00F3ria': 'dedication', - u'resumo': 'abstract'} -"""Brazilian Portuguese (lowcased) to canonical name mapping for bibliographic fields.""" - -author_separators = [';', ','] -"""List of separator strings for the 'Authors' bibliographic field. Tried in -order.""" diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/languages/ru.py --- a/buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/languages/ru.py Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,66 +0,0 @@ -# $Id: ru.py 4564 2006-05-21 20:44:42Z wiemann $ -# Author: Roman Suzi -# Copyright: This module has been placed in the public domain. - -# New language mappings are welcome. Before doing a new translation, please -# read . Two files must be -# translated for each language: one in docutils/languages, the other in -# docutils/parsers/rst/languages. - -""" -Russian-language mappings for language-dependent features of Docutils. -""" - -docformat = 'reStructuredText' - -labels = { - u'abstract': u'\u0410\u043d\u043d\u043e\u0442\u0430\u0446\u0438\u044f', - u'address': u'\u0410\u0434\u0440\u0435\u0441', - u'attention': u'\u0412\u043d\u0438\u043c\u0430\u043d\u0438\u0435!', - u'author': u'\u0410\u0432\u0442\u043e\u0440', - u'authors': u'\u0410\u0432\u0442\u043e\u0440\u044b', - u'caution': u'\u041e\u0441\u0442\u043e\u0440\u043e\u0436\u043d\u043e!', - u'contact': u'\u041a\u043e\u043d\u0442\u0430\u043a\u0442', - u'contents': - u'\u0421\u043e\u0434\u0435\u0440\u0436\u0430\u043d\u0438\u0435', - u'copyright': u'\u041f\u0440\u0430\u0432\u0430 ' - u'\u043a\u043e\u043f\u0438\u0440\u043e\u0432\u0430\u043d\u0438\u044f', - u'danger': u'\u041e\u041f\u0410\u0421\u041d\u041e!', - u'date': u'\u0414\u0430\u0442\u0430', - u'dedication': - u'\u041f\u043e\u0441\u0432\u044f\u0449\u0435\u043d\u0438\u0435', - u'error': u'\u041e\u0448\u0438\u0431\u043a\u0430', - u'hint': u'\u0421\u043e\u0432\u0435\u0442', - u'important': u'\u0412\u0430\u0436\u043d\u043e', - u'note': u'\u041f\u0440\u0438\u043c\u0435\u0447\u0430\u043d\u0438\u0435', - u'organization': - u'\u041e\u0440\u0433\u0430\u043d\u0438\u0437\u0430\u0446\u0438\u044f', - u'revision': u'\u0420\u0435\u0434\u0430\u043a\u0446\u0438\u044f', - u'status': u'\u0421\u0442\u0430\u0442\u0443\u0441', - u'tip': u'\u041f\u043e\u0434\u0441\u043a\u0430\u0437\u043a\u0430', - u'version': u'\u0412\u0435\u0440\u0441\u0438\u044f', - u'warning': u'\u041f\u0440\u0435\u0434\u0443\u043f\u0440\u0435\u0436' - u'\u0434\u0435\u043d\u0438\u0435'} -"""Mapping of node class name to label text.""" - -bibliographic_fields = { - u'\u0430\u043d\u043d\u043e\u0442\u0430\u0446\u0438\u044f': u'abstract', - u'\u0430\u0434\u0440\u0435\u0441': u'address', - u'\u0430\u0432\u0442\u043e\u0440': u'author', - u'\u0430\u0432\u0442\u043e\u0440\u044b': u'authors', - u'\u043a\u043e\u043d\u0442\u0430\u043a\u0442': u'contact', - u'\u043f\u0440\u0430\u0432\u0430 \u043a\u043e\u043f\u0438\u0440\u043e' - u'\u0432\u0430\u043d\u0438\u044f': u'copyright', - u'\u0434\u0430\u0442\u0430': u'date', - u'\u043f\u043e\u0441\u0432\u044f\u0449\u0435\u043d\u0438\u0435': - u'dedication', - u'\u043e\u0440\u0433\u0430\u043d\u0438\u0437\u0430\u0446\u0438\u044f': - u'organization', - u'\u0440\u0435\u0434\u0430\u043a\u0446\u0438\u044f': u'revision', - u'\u0441\u0442\u0430\u0442\u0443\u0441': u'status', - u'\u0432\u0435\u0440\u0441\u0438\u044f': u'version'} -"""Russian (lowcased) to canonical name mapping for bibliographic fields.""" - -author_separators = [';', ','] -"""List of separator strings for the 'Authors' bibliographic field. Tried in -order.""" diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/languages/sk.py --- a/buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/languages/sk.py Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,58 +0,0 @@ -# $Id: sk.py 4564 2006-05-21 20:44:42Z wiemann $ -# Author: Miroslav Vasko -# Copyright: This module has been placed in the public domain. - -# New language mappings are welcome. Before doing a new translation, please -# read . Two files must be -# translated for each language: one in docutils/languages, the other in -# docutils/parsers/rst/languages. - -""" -Slovak-language mappings for language-dependent features of Docutils. -""" - -docformat = 'reStructuredText' - -labels = { - 'author': u'Autor', - 'authors': u'Autori', - 'organization': u'Organiz\u00E1cia', - 'address': u'Adresa', - 'contact': u'Kontakt', - 'version': u'Verzia', - 'revision': u'Rev\u00EDzia', - 'status': u'Stav', - 'date': u'D\u00E1tum', - 'copyright': u'Copyright', - 'dedication': u'Venovanie', - 'abstract': u'Abstraktne', - 'attention': u'Pozor!', - 'caution': u'Opatrne!', - 'danger': u'!NEBEZPE\u010cENSTVO!', - 'error': u'Chyba', - 'hint': u'Rada', - 'important': u'D\u00F4le\u017Eit\u00E9', - 'note': u'Pozn\u00E1mka', - 'tip': u'Tip', - 'warning': u'Varovanie', - 'contents': u'Obsah'} -"""Mapping of node class name to label text.""" - -bibliographic_fields = { - u'autor': 'author', - u'autori': 'authors', - u'organiz\u00E1cia': 'organization', - u'adresa': 'address', - u'kontakt': 'contact', - u'verzia': 'version', - u'rev\u00EDzia': 'revision', - u'stav': 'status', - u'd\u00E1tum': 'date', - u'copyright': 'copyright', - u'venovanie': 'dedication', - u'abstraktne': 'abstract'} -"""Slovak (lowcased) to canonical name mapping for bibliographic fields.""" - -author_separators = [';', ','] -"""List of separator strings for the 'Authors' bibliographic field. Tried in -order.""" diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/languages/sv.py --- a/buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/languages/sv.py Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,59 +0,0 @@ -# $Id: sv.py 4564 2006-05-21 20:44:42Z wiemann $ -# Author: Adam Chodorowski -# Copyright: This module has been placed in the public domain. - -# New language mappings are welcome. Before doing a new translation, please -# read . Two files must be -# translated for each language: one in docutils/languages, the other in -# docutils/parsers/rst/languages. - -""" -Swedish language mappings for language-dependent features of Docutils. -""" - -docformat = 'reStructuredText' - -labels = { - 'author': u'F\u00f6rfattare', - 'authors': u'F\u00f6rfattare', - 'organization': u'Organisation', - 'address': u'Adress', - 'contact': u'Kontakt', - 'version': u'Version', - 'revision': u'Revision', - 'status': u'Status', - 'date': u'Datum', - 'copyright': u'Copyright', - 'dedication': u'Dedikation', - 'abstract': u'Sammanfattning', - 'attention': u'Observera!', - 'caution': u'Varning!', - 'danger': u'FARA!', - 'error': u'Fel', - 'hint': u'V\u00e4gledning', - 'important': u'Viktigt', - 'note': u'Notera', - 'tip': u'Tips', - 'warning': u'Varning', - 'contents': u'Inneh\u00e5ll' } -"""Mapping of node class name to label text.""" - -bibliographic_fields = { - # 'Author' and 'Authors' identical in Swedish; assume the plural: - u'f\u00f6rfattare': 'authors', - u' n/a': 'author', - u'organisation': 'organization', - u'adress': 'address', - u'kontakt': 'contact', - u'version': 'version', - u'revision': 'revision', - u'status': 'status', - u'datum': 'date', - u'copyright': 'copyright', - u'dedikation': 'dedication', - u'sammanfattning': 'abstract' } -"""Swedish (lowcased) to canonical name mapping for bibliographic fields.""" - -author_separators = [';', ','] -"""List of separator strings for the 'Authors' bibliographic field. Tried in -order.""" diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/languages/zh_cn.py --- a/buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/languages/zh_cn.py Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,67 +0,0 @@ -# -- coding: utf-8 -- -# $Id: zh_cn.py 4564 2006-05-21 20:44:42Z wiemann $ -# Author: Pan Junyong -# Copyright: This module has been placed in the public domain. - -# New language mappings are welcome. Before doing a new translation, please -# read . Two files must be -# translated for each language: one in docutils/languages, the other in -# docutils/parsers/rst/languages. - -""" -Simplified Chinese language mappings for language-dependent features -of Docutils. -""" - -docformat = 'reStructuredText' - -labels = { - # fixed: language-dependent - 'author': u'作者', - 'authors': u'作者群', - 'organization': u'组织', - 'address': u'地址', - 'contact': u'联系', - 'version': u'版本', - 'revision': u'修订', - 'status': u'状态', - 'date': u'日期', - 'copyright': u'版权', - 'dedication': u'献辞', - 'abstract': u'摘要', - 'attention': u'注意', - 'caution': u'小心', - 'danger': u'危险', - 'error': u'错误', - 'hint': u'提示', - 'important': u'重要', - 'note': u'注解', - 'tip': u'技巧', - 'warning': u'警告', - 'contents': u'目录', -} -"""Mapping of node class name to label text.""" - -bibliographic_fields = { - # language-dependent: fixed - u'作者': 'author', - u'作者群': 'authors', - u'组织': 'organization', - u'地址': 'address', - u'联系': 'contact', - u'版本': 'version', - u'修订': 'revision', - u'状态': 'status', - u'时间': 'date', - u'版权': 'copyright', - u'献辞': 'dedication', - u'摘要': 'abstract'} -"""Simplified Chinese to canonical name mapping for bibliographic fields.""" - -author_separators = [';', ',', - u'\uff1b', # '；' - u'\uff0c', # '，' - u'\u3001', # '、' - ] -"""List of separator strings for the 'Authors' bibliographic field. Tried in -order.""" diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/languages/zh_tw.py --- a/buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/languages/zh_tw.py Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,66 +0,0 @@ -# -- coding: utf-8 -- -# $Id: zh_tw.py 4564 2006-05-21 20:44:42Z wiemann $ -# Author: Joe YS Jaw -# Copyright: This module has been placed in the public domain. - -# New language mappings are welcome. Before doing a new translation, please -# read . Two files must be -# translated for each language: one in docutils/languages, the other in -# docutils/parsers/rst/languages. - -""" -Traditional Chinese language mappings for language-dependent features of Docutils. -""" - -docformat = 'reStructuredText' - -labels = { - # fixed: language-dependent - 'author': u'\u4f5c\u8005', # '作者' <-- Chinese word - 'authors': u'\u4f5c\u8005\u7fa4', # '作者群', - 'organization': u'\u7d44\u7e54', # '組織', - 'address': u'\u5730\u5740', # '地址', - 'contact': u'\u9023\u7d61', # '連絡', - 'version': u'\u7248\u672c', # '版本', - 'revision': u'\u4fee\u8a02', # '修訂', - 'status': u'\u72c0\u614b', # '狀態', - 'date': u'\u65e5\u671f', # '日期', - 'copyright': u'\u7248\u6b0a', # '版權', - 'dedication': u'\u984c\u737b', # '題獻', - 'abstract': u'\u6458\u8981', # '摘要', - 'attention': u'\u6ce8\u610f\uff01', # '注意！', - 'caution': u'\u5c0f\u5fc3\uff01', # '小心！', - 'danger': u'\uff01\u5371\u96aa\uff01', # '！危險！', - 'error': u'\u932f\u8aa4', # '錯誤', - 'hint': u'\u63d0\u793a', # '提示', - 'important': u'\u91cd\u8981', # '注意！', - 'note': u'\u8a3b\u91cb', # '註釋', - 'tip': u'\u79d8\u8a23', # '秘訣', - 'warning': u'\u8b66\u544a', # '警告', - 'contents': u'\u76ee\u9304' # '目錄' -} -"""Mapping of node class name to label text.""" - -bibliographic_fields = { - # language-dependent: fixed - 'author (translation required)': 'author', - 'authors (translation required)': 'authors', - 'organization (translation required)': 'organization', - 'address (translation required)': 'address', - 'contact (translation required)': 'contact', - 'version (translation required)': 'version', - 'revision (translation required)': 'revision', - 'status (translation required)': 'status', - 'date (translation required)': 'date', - 'copyright (translation required)': 'copyright', - 'dedication (translation required)': 'dedication', - 'abstract (translation required)': 'abstract'} -"""Traditional Chinese to canonical name mapping for bibliographic fields.""" - -author_separators = [';', ',', - u'\uff1b', # '；' - u'\uff0c', # '，' - u'\u3001', # '、' - ] -"""List of separator strings for the 'Authors' bibliographic field. Tried in -order.""" diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/nodes.py --- a/buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/nodes.py Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,1801 +0,0 @@ -# $Id: nodes.py 5033 2007-03-21 19:51:22Z wiemann $ -# Author: David Goodger -# Copyright: This module has been placed in the public domain. - -""" -Docutils document tree element class library. - -Classes in CamelCase are abstract base classes or auxiliary classes. The one -exception is `Text`, for a text (PCDATA) node; uppercase is used to -differentiate from element classes. Classes in lower_case_with_underscores -are element classes, matching the XML element generic identifiers in the DTD_. - -The position of each node (the level at which it can occur) is significant and -is represented by abstract base classes (`Root`, `Structural`, `Body`, -`Inline`, etc.). Certain transformations will be easier because we can use -``isinstance(node, base_class)`` to determine the position of the node in the -hierarchy. - -.. _DTD: http://docutils.sourceforge.net/docs/ref/docutils.dtd -""" - -docformat = 'reStructuredText' - -import sys -import os -import re -import warnings -from types import IntType, SliceType, StringType, UnicodeType, \ - TupleType, ListType, ClassType, TypeType -from UserString import UserString - - -# ============================== -# Functional Node Base Classes -# ============================== - -class Node: - - """Abstract base class of nodes in a document tree.""" - - parent = None - """Back-reference to the Node immediately containing this Node.""" - - document = None - """The `document` node at the root of the tree containing this Node.""" - - source = None - """Path or description of the input source which generated this Node.""" - - line = None - """The line number (1-based) of the beginning of this Node in `source`.""" - - def nonzero(self): - """ - Node instances are always true, even if they're empty. A node is more - than a simple container. Its boolean "truth" does not depend on - having one or more subnodes in the doctree. - - Use `len()` to check node length. Use `None` to represent a boolean - false value. - """ - return 1 - - def str(self): - return self.unicode().encode('raw_unicode_escape') - - def unicode(self): - # Override in subclass. - raise NotImplementedError - - def asdom(self, dom=None): - """Return a DOM fragment representation of this Node.""" - if dom is None: - import xml.dom.minidom as dom - domroot = dom.Document() - return self._dom_node(domroot) - - def pformat(self, indent=' ', level=0): - """ - Return an indented pseudo-XML representation, for test purposes. - - Override in subclasses. - """ - raise NotImplementedError - - def copy(self): - """Return a copy of self.""" - raise NotImplementedError - - def deepcopy(self): - """Return a deep copy of self (also copying children).""" - raise NotImplementedError - - def setup_child(self, child): - child.parent = self - if self.document: - child.document = self.document - if child.source is None: - child.source = self.document.current_source - if child.line is None: - child.line = self.document.current_line - - def walk(self, visitor): - """ - Traverse a tree of `Node` objects, calling the - `dispatch_visit()` method of `visitor` when entering each - node. (The `walkabout()` method is similar, except it also - calls the `dispatch_departure()` method before exiting each - node.) - - This tree traversal supports limited in-place tree - modifications. Replacing one node with one or more nodes is - OK, as is removing an element. However, if the node removed - or replaced occurs after the current node, the old node will - still be traversed, and any new nodes will not. - - Within ``visit`` methods (and ``depart`` methods for - `walkabout()`), `TreePruningException` subclasses may be raised - (`SkipChildren`, `SkipSiblings`, `SkipNode`, `SkipDeparture`). - - Parameter `visitor`: A `NodeVisitor` object, containing a - ``visit`` implementation for each `Node` subclass encountered. - - Return true if we should stop the traversal. - """ - stop = 0 - visitor.document.reporter.debug( - 'docutils.nodes.Node.walk calling dispatch_visit for %s' - % self.class.name) - try: - try: - visitor.dispatch_visit(self) - except (SkipChildren, SkipNode): - return stop - except SkipDeparture: # not applicable; ignore - pass - children = self.children - try: - for child in children[:]: - if child.walk(visitor): - stop = 1 - break - except SkipSiblings: - pass - except StopTraversal: - stop = 1 - return stop - - def walkabout(self, visitor): - """ - Perform a tree traversal similarly to `Node.walk()` (which - see), except also call the `dispatch_departure()` method - before exiting each node. - - Parameter `visitor`: A `NodeVisitor` object, containing a - ``visit`` and ``depart`` implementation for each `Node` - subclass encountered. - - Return true if we should stop the traversal. - """ - call_depart = 1 - stop = 0 - visitor.document.reporter.debug( - 'docutils.nodes.Node.walkabout calling dispatch_visit for %s' - % self.class.name) - try: - try: - visitor.dispatch_visit(self) - except SkipNode: - return stop - except SkipDeparture: - call_depart = 0 - children = self.children - try: - for child in children[:]: - if child.walkabout(visitor): - stop = 1 - break - except SkipSiblings: - pass - except SkipChildren: - pass - except StopTraversal: - stop = 1 - if call_depart: - visitor.document.reporter.debug( - 'docutils.nodes.Node.walkabout calling dispatch_departure ' - 'for %s' % self.class.name) - visitor.dispatch_departure(self) - return stop - - def traverse(self, condition=None, - include_self=1, descend=1, siblings=0, ascend=0): - """ - Return an iterable containing - - * self (if include_self is true) - * all descendants in tree traversal order (if descend is true) - * all siblings (if siblings is true) and their descendants (if - also descend is true) - * the siblings of the parent (if ascend is true) and their - descendants (if also descend is true), and so on - - If `condition` is not None, the iterable contains only nodes - for which ``condition(node)`` is true. If `condition` is a - node class ``cls``, it is equivalent to a function consisting - of ``return isinstance(node, cls)``. - - If ascend is true, assume siblings to be true as well. - - For example, given the following tree:: - - - <--- emphasis.traverse() and - <--- strong.traverse() are called. - Foo - Bar - - Baz - - Then list(emphasis.traverse()) equals :: - - [, , <#text: Foo>, <#text: Bar>] - - and list(strong.traverse(ascend=1)) equals :: - - [, <#text: Foo>, <#text: Bar>, , <#text: Baz>] - """ - r = [] - if ascend: - siblings=1 - # Check if `condition` is a class (check for TypeType for Python - # implementations that use only new-style classes, like PyPy). - if isinstance(condition, (ClassType, TypeType)): - node_class = condition - def condition(node, node_class=node_class): - return isinstance(node, node_class) - if include_self and (condition is None or condition(self)): - r.append(self) - if descend and len(self.children): - for child in self: - r.extend(child.traverse( - include_self=1, descend=1, siblings=0, ascend=0, - condition=condition)) - if siblings or ascend: - node = self - while node.parent: - index = node.parent.index(node) - for sibling in node.parent[index+1:]: - r.extend(sibling.traverse(include_self=1, descend=descend, - siblings=0, ascend=0, - condition=condition)) - if not ascend: - break - else: - node = node.parent - return r - - def next_node(self, condition=None, - include_self=0, descend=1, siblings=0, ascend=0): - """ - Return the first node in the iterable returned by traverse(), - or None if the iterable is empty. - - Parameter list is the same as of traverse. Note that - include_self defaults to 0, though. - """ - iterable = self.traverse(condition=condition, - include_self=include_self, descend=descend, - siblings=siblings, ascend=ascend) - try: - return iterable[0] - except IndexError: - return None - -class Text(Node, UserString): - - """ - Instances are terminal nodes (leaves) containing text only; no child - nodes or attributes. Initialize by passing a string to the constructor. - Access the text itself with the `astext` method. - """ - - tagname = '#text' - - children = () - """Text nodes have no children, and cannot have children.""" - - def init(self, data, rawsource=''): - UserString.init(self, data) - - self.rawsource = rawsource - """The raw text from which this element was constructed.""" - - def repr(self): - data = repr(self.data) - if len(data) > 70: - data = repr(self.data[:64] + ' ...') - return '<%s: %s>' % (self.tagname, data) - - def len(self): - return len(self.data) - - def shortrepr(self): - data = repr(self.data) - if len(data) > 20: - data = repr(self.data[:16] + ' ...') - return '<%s: %s>' % (self.tagname, data) - - def _dom_node(self, domroot): - return domroot.createTextNode(self.data) - - def astext(self): - return self.data - - def unicode(self): - return self.data - - def copy(self): - return self.class(self.data) - - def deepcopy(self): - return self.copy() - - def pformat(self, indent=' ', level=0): - result = [] - indent = indent * level - for line in self.data.splitlines(): - result.append(indent + line + '\n') - return ''.join(result) - - -class Element(Node): - - """ - `Element` is the superclass to all specific elements. - - Elements contain attributes and child nodes. Elements emulate - dictionaries for attributes, indexing by attribute name (a string). To - set the attribute 'att' to 'value', do:: - - element['att'] = 'value' - - There are two special attributes: 'ids' and 'names'. Both are - lists of unique identifiers, and names serve as human interfaces - to IDs. Names are case- and whitespace-normalized (see the - fully_normalize_name() function), and IDs conform to the regular - expression ``[a-z](-?[a-z0-9]+)`` (see the make_id() function). - - Elements also emulate lists for child nodes (element nodes and/or text - nodes), indexing by integer. To get the first child node, use:: - - element[0] - - Elements may be constructed using the ``+=`` operator. To add one new - child node to element, do:: - - element += node - - This is equivalent to ``element.append(node)``. - - To add a list of multiple child nodes at once, use the same ``+=`` - operator:: - - element += [node1, node2] - - This is equivalent to ``element.extend([node1, node2])``. - """ - - list_attributes = ('ids', 'classes', 'names', 'dupnames', 'backrefs') - """List attributes, automatically initialized to empty lists for - all nodes.""" - - tagname = None - """The element generic identifier. If None, it is set as an instance - attribute to the name of the class.""" - - child_text_separator = '\n\n' - """Separator for child nodes, used by `astext()` method.""" - - def init(self, rawsource='', children, **attributes): - self.rawsource = rawsource - """The raw text from which this element was constructed.""" - - self.children = [] - """List of child nodes (elements and/or `Text`).""" - - self.extend(children) # maintain parent info - - self.attributes = {} - """Dictionary of attribute {name: value}.""" - - # Initialize list attributes. - for att in self.list_attributes: - self.attributes[att] = [] - - for att, value in attributes.items(): - att = att.lower() - if att in self.list_attributes: - # mutable list; make a copy for this node - self.attributes[att] = value[:] - else: - self.attributes[att] = value - - if self.tagname is None: - self.tagname = self.class.name - - def _dom_node(self, domroot): - element = domroot.createElement(self.tagname) - for attribute, value in self.attlist(): - if isinstance(value, ListType): - value = ' '.join([serial_escape('%s' % v) for v in value]) - element.setAttribute(attribute, '%s' % value) - for child in self.children: - element.appendChild(child._dom_node(domroot)) - return element - - def repr(self): - data = '' - for c in self.children: - data += c.shortrepr() - if len(data) > 60: - data = data[:56] + ' ...' - break - if self['names']: - return '<%s "%s": %s>' % (self.class.name, - '; '.join(self['names']), data) - else: - return '<%s: %s>' % (self.class.name, data) - - def shortrepr(self): - if self['names']: - return '<%s "%s"...>' % (self.class.name, - '; '.join(self['names'])) - else: - return '<%s...>' % self.tagname - - def unicode(self): - if self.children: - return u'%s%s%s' % (self.starttag(), - ''.join([unicode(c) for c in self.children]), - self.endtag()) - else: - return self.emptytag() - - def starttag(self): - parts = [self.tagname] - for name, value in self.attlist(): - if value is None: # boolean attribute - parts.append(name) - elif isinstance(value, ListType): - values = [serial_escape('%s' % v) for v in value] - parts.append('%s="%s"' % (name, ' '.join(values))) - else: - parts.append('%s="%s"' % (name, value)) - return '<%s>' % ' '.join(parts) - - def endtag(self): - return '' % self.tagname - - def emptytag(self): - return u'<%s/>' % ' '.join([self.tagname] + - ['%s="%s"' % (n, v) - for n, v in self.attlist()]) - - def len(self): - return len(self.children) - - def getitem(self, key): - if isinstance(key, UnicodeType) or isinstance(key, StringType): - return self.attributes[key] - elif isinstance(key, IntType): - return self.children[key] - elif isinstance(key, SliceType): - assert key.step in (None, 1), 'cannot handle slice with stride' - return self.children[key.start:key.stop] - else: - raise TypeError, ('element index must be an integer, a slice, or ' - 'an attribute name string') - - def setitem(self, key, item): - if isinstance(key, UnicodeType) or isinstance(key, StringType): - self.attributes[str(key)] = item - elif isinstance(key, IntType): - self.setup_child(item) - self.children[key] = item - elif isinstance(key, SliceType): - assert key.step in (None, 1), 'cannot handle slice with stride' - for node in item: - self.setup_child(node) - self.children[key.start:key.stop] = item - else: - raise TypeError, ('element index must be an integer, a slice, or ' - 'an attribute name string') - - def delitem(self, key): - if isinstance(key, UnicodeType) or isinstance(key, StringType): - del self.attributes[key] - elif isinstance(key, IntType): - del self.children[key] - elif isinstance(key, SliceType): - assert key.step in (None, 1), 'cannot handle slice with stride' - del self.children[key.start:key.stop] - else: - raise TypeError, ('element index must be an integer, a simple ' - 'slice, or an attribute name string') - - def add(self, other): - return self.children + other - - def radd(self, other): - return other + self.children - - def iadd(self, other): - """Append a node or a list of nodes to `self.children`.""" - if isinstance(other, Node): - self.append(other) - elif other is not None: - self.extend(other) - return self - - def astext(self): - return self.child_text_separator.join( - [child.astext() for child in self.children]) - - def non_default_attributes(self): - atts = {} - for key, value in self.attributes.items(): - if self.is_not_default(key): - atts[key] = value - return atts - - def attlist(self): - attlist = self.non_default_attributes().items() - attlist.sort() - return attlist - - def get(self, key, failobj=None): - return self.attributes.get(key, failobj) - - def hasattr(self, attr): - return self.attributes.has_key(attr) - - def delattr(self, attr): - if self.attributes.has_key(attr): - del self.attributes[attr] - - def setdefault(self, key, failobj=None): - return self.attributes.setdefault(key, failobj) - - has_key = hasattr - - def append(self, item): - self.setup_child(item) - self.children.append(item) - - def extend(self, item): - for node in item: - self.append(node) - - def insert(self, index, item): - if isinstance(item, Node): - self.setup_child(item) - self.children.insert(index, item) - elif item is not None: - self[index:index] = item - - def pop(self, i=-1): - return self.children.pop(i) - - def remove(self, item): - self.children.remove(item) - - def index(self, item): - return self.children.index(item) - - def is_not_default(self, key): - if self[key] == [] and key in self.list_attributes: - return 0 - else: - return 1 - - def update_basic_atts(self, dict): - """ - Update basic attributes ('ids', 'names', 'classes', - 'dupnames', but not 'source') from node or dictionary `dict`. - """ - if isinstance(dict, Node): - dict = dict.attributes - for att in ('ids', 'classes', 'names', 'dupnames'): - for value in dict.get(att, []): - if not value in self[att]: - self[att].append(value) - - def clear(self): - self.children = [] - - def replace(self, old, new): - """Replace one child `Node` with another child or children.""" - index = self.index(old) - if isinstance(new, Node): - self.setup_child(new) - self[index] = new - elif new is not None: - self[index:index+1] = new - - def replace_self(self, new): - """ - Replace `self` node with `new`, where `new` is a node or a - list of nodes. - """ - update = new - if not isinstance(new, Node): - # `new` is a list; update first child. - try: - update = new[0] - except IndexError: - update = None - if isinstance(update, Element): - update.update_basic_atts(self) - else: - # `update` is a Text node or `new` is an empty list. - # Assert that we aren't losing any attributes. - for att in ('ids', 'names', 'classes', 'dupnames'): - assert not self[att], \ - 'Losing "%s" attribute: %s' % (att, self[att]) - self.parent.replace(self, new) - - def first_child_matching_class(self, childclass, start=0, end=sys.maxint): - """ - Return the index of the first child whose class exactly matches. - - Parameters: - - - `childclass`: A `Node` subclass to search for, or a tuple of `Node` - classes. If a tuple, any of the classes may match. - - `start`: Initial index to check. - - `end`: Initial index to not check. - """ - if not isinstance(childclass, TupleType): - childclass = (childclass,) - for index in range(start, min(len(self), end)): - for c in childclass: - if isinstance(self[index], c): - return index - return None - - def first_child_not_matching_class(self, childclass, start=0, - end=sys.maxint): - """ - Return the index of the first child whose class does not match. - - Parameters: - - - `childclass`: A `Node` subclass to skip, or a tuple of `Node` - classes. If a tuple, none of the classes may match. - - `start`: Initial index to check. - - `end`: Initial index to not check. - """ - if not isinstance(childclass, TupleType): - childclass = (childclass,) - for index in range(start, min(len(self), end)): - for c in childclass: - if isinstance(self.children[index], c): - break - else: - return index - return None - - def pformat(self, indent=' ', level=0): - return ''.join(['%s%s\n' % (indent * level, self.starttag())] + - [child.pformat(indent, level+1) - for child in self.children]) - - def copy(self): - return self.class(**self.attributes) - - def deepcopy(self): - copy = self.copy() - copy.extend([child.deepcopy() for child in self.children]) - return copy - - def set_class(self, name): - """Add a new class to the "classes" attribute.""" - warnings.warn('docutils.nodes.Element.set_class deprecated; ' - "append to Element['classes'] list attribute directly", - DeprecationWarning, stacklevel=2) - assert ' ' not in name - self['classes'].append(name.lower()) - - def note_referenced_by(self, name=None, id=None): - """Note that this Element has been referenced by its name - `name` or id `id`.""" - self.referenced = 1 - # Element.expect_referenced_by_* dictionaries map names or ids - # to nodes whose ``referenced`` attribute is set to true as - # soon as this node is referenced by the given name or id. - # Needed for target propagation. - by_name = getattr(self, 'expect_referenced_by_name', {}).get(name) - by_id = getattr(self, 'expect_referenced_by_id', {}).get(id) - if by_name: - assert name is not None - by_name.referenced = 1 - if by_id: - assert id is not None - by_id.referenced = 1 - - -class TextElement(Element): - - """ - An element which directly contains text. - - Its children are all `Text` or `Inline` subclass nodes. You can - check whether an element's context is inline simply by checking whether - its immediate parent is a `TextElement` instance (including subclasses). - This is handy for nodes like `image` that can appear both inline and as - standalone body elements. - - If passing children to `init()`, make sure to set `text` to - ``''`` or some other suitable value. - """ - - child_text_separator = '' - """Separator for child nodes, used by `astext()` method.""" - - def init(self, rawsource='', text='', *children, **attributes): - if text != '': - textnode = Text(text) - Element.init(self, rawsource, textnode, *children, - **attributes) - else: - Element.init(self, rawsource, *children, **attributes) - - -class FixedTextElement(TextElement): - - """An element which directly contains preformatted text.""" - - def init(self, rawsource='', text='', *children, **attributes): - TextElement.init(self, rawsource, text, *children, **attributes) - self.attributes['xml:space'] = 'preserve' - - -# ======== -# Mixins -# ======== - -class Resolvable: - - resolved = 0 - - -class BackLinkable: - - def add_backref(self, refid): - self['backrefs'].append(refid) - - -# ==================== -# Element Categories -# ==================== - -class Root: pass - -class Titular: pass - -class PreBibliographic: - """Category of Node which may occur before Bibliographic Nodes.""" - -class Bibliographic: pass - -class Decorative(PreBibliographic): pass - -class Structural: pass - -class Body: pass - -class General(Body): pass - -class Sequential(Body): - """List-like elements.""" - -class Admonition(Body): pass - -class Special(Body): - """Special internal body elements.""" - -class Invisible(PreBibliographic): - """Internal elements that don't appear in output.""" - -class Part: pass - -class Inline: pass - -class Referential(Resolvable): pass - - -class Targetable(Resolvable): - - referenced = 0 - - indirect_reference_name = None - """Holds the whitespace_normalized_name (contains mixed case) of a target. - Required for MoinMoin/reST compatibility.""" - - -class Labeled: - """Contains a `label` as its first element.""" - - -# ============== -# Root Element -# ============== - -class document(Root, Structural, Element): - - """ - The document root element. - - Do not instantiate this class directly; use - `docutils.utils.new_document()` instead. - """ - - def init(self, settings, reporter, *args, **kwargs): - Element.init(self, args, kwargs) - - self.current_source = None - """Path to or description of the input source being processed.""" - - self.current_line = None - """Line number (1-based) of `current_source`.""" - - self.settings = settings - """Runtime settings data record.""" - - self.reporter = reporter - """System message generator.""" - - self.indirect_targets = [] - """List of indirect target nodes.""" - - self.substitution_defs = {} - """Mapping of substitution names to substitution_definition nodes.""" - - self.substitution_names = {} - """Mapping of case-normalized substitution names to case-sensitive - names.""" - - self.refnames = {} - """Mapping of names to lists of referencing nodes.""" - - self.refids = {} - """Mapping of ids to lists of referencing nodes.""" - - self.nameids = {} - """Mapping of names to unique id's.""" - - self.nametypes = {} - """Mapping of names to hyperlink type (boolean: True => explicit, - False => implicit.""" - - self.ids = {} - """Mapping of ids to nodes.""" - - self.footnote_refs = {} - """Mapping of footnote labels to lists of footnote_reference nodes.""" - - self.citation_refs = {} - """Mapping of citation labels to lists of citation_reference nodes.""" - - self.autofootnotes = [] - """List of auto-numbered footnote nodes.""" - - self.autofootnote_refs = [] - """List of auto-numbered footnote_reference nodes.""" - - self.symbol_footnotes = [] - """List of symbol footnote nodes.""" - - self.symbol_footnote_refs = [] - """List of symbol footnote_reference nodes.""" - - self.footnotes = [] - """List of manually-numbered footnote nodes.""" - - self.citations = [] - """List of citation nodes.""" - - self.autofootnote_start = 1 - """Initial auto-numbered footnote number.""" - - self.symbol_footnote_start = 0 - """Initial symbol footnote symbol index.""" - - self.id_start = 1 - """Initial ID number.""" - - self.parse_messages = [] - """System messages generated while parsing.""" - - self.transform_messages = [] - """System messages generated while applying transforms.""" - - import docutils.transforms - self.transformer = docutils.transforms.Transformer(self) - """Storage for transforms to be applied to this document.""" - - self.decoration = None - """Document's `decoration` node.""" - - self.document = self - - def getstate(self): - """ - Return dict with unpicklable references removed. - """ - state = self.dict.copy() - state['reporter'] = None - state['transformer'] = None - return state - - def asdom(self, dom=None): - """Return a DOM representation of this document.""" - if dom is None: - import xml.dom.minidom as dom - domroot = dom.Document() - domroot.appendChild(self._dom_node(domroot)) - return domroot - - def set_id(self, node, msgnode=None): - for id in node['ids']: - if self.ids.has_key(id) and self.ids[id] is not node: - msg = self.reporter.severe('Duplicate ID: "%s".' % id) - if msgnode != None: - msgnode += msg - if not node['ids']: - for name in node['names']: - id = self.settings.id_prefix + make_id(name) - if id and not self.ids.has_key(id): - break - else: - id = '' - while not id or self.ids.has_key(id): - id = (self.settings.id_prefix + - self.settings.auto_id_prefix + str(self.id_start)) - self.id_start += 1 - node['ids'].append(id) - self.ids[id] = node - return id - - def set_name_id_map(self, node, id, msgnode=None, explicit=None): - """ - `self.nameids` maps names to IDs, while `self.nametypes` maps names to - booleans representing hyperlink type (True==explicit, - False==implicit). This method updates the mappings. - - The following state transition table shows how `self.nameids` ("ids") - and `self.nametypes` ("types") change with new input (a call to this - method), and what actions are performed ("implicit"-type system - messages are INFO/1, and "explicit"-type system messages are ERROR/3): - - ==== ===== ======== ======== ======= ==== ===== ===== - Old State Input Action New State Notes - ----------- -------- ----------------- ----------- ----- - ids types new type sys.msg. dupname ids types - ==== ===== ======== ======== ======= ==== ===== ===== - - - explicit - - new True - - - implicit - - new False - None False explicit - - new True - old False explicit implicit old new True - None True explicit explicit new None True - old True explicit explicit new,old None True [#]_ - None False implicit implicit new None False - old False implicit implicit new,old None False - None True implicit implicit new None True - old True implicit implicit new old True - ==== ===== ======== ======== ======= ==== ===== ===== - - .. [#] Do not clear the name-to-id map or invalidate the old target if - both old and new targets are external and refer to identical URIs. - The new target is invalidated regardless. - """ - for name in node['names']: - if self.nameids.has_key(name): - self.set_duplicate_name_id(node, id, name, msgnode, explicit) - else: - self.nameids[name] = id - self.nametypes[name] = explicit - - def set_duplicate_name_id(self, node, id, name, msgnode, explicit): - old_id = self.nameids[name] - old_explicit = self.nametypes[name] - self.nametypes[name] = old_explicit or explicit - if explicit: - if old_explicit: - level = 2 - if old_id is not None: - old_node = self.ids[old_id] - if node.has_key('refuri'): - refuri = node['refuri'] - if old_node['names'] \ - and old_node.has_key('refuri') \ - and old_node['refuri'] == refuri: - level = 1 # just inform if refuri's identical - if level > 1: - dupname(old_node, name) - self.nameids[name] = None - msg = self.reporter.system_message( - level, 'Duplicate explicit target name: "%s".' % name, - backrefs=[id], base_node=node) - if msgnode != None: - msgnode += msg - dupname(node, name) - else: - self.nameids[name] = id - if old_id is not None: - old_node = self.ids[old_id] - dupname(old_node, name) - else: - if old_id is not None and not old_explicit: - self.nameids[name] = None - old_node = self.ids[old_id] - dupname(old_node, name) - dupname(node, name) - if not explicit or (not old_explicit and old_id is not None): - msg = self.reporter.info( - 'Duplicate implicit target name: "%s".' % name, - backrefs=[id], base_node=node) - if msgnode != None: - msgnode += msg - - def has_name(self, name): - return self.nameids.has_key(name) - - # "note" here is an imperative verb: "take note of". - def note_implicit_target(self, target, msgnode=None): - id = self.set_id(target, msgnode) - self.set_name_id_map(target, id, msgnode, explicit=None) - - def note_explicit_target(self, target, msgnode=None): - id = self.set_id(target, msgnode) - self.set_name_id_map(target, id, msgnode, explicit=1) - - def note_refname(self, node): - self.refnames.setdefault(node['refname'], []).append(node) - - def note_refid(self, node): - self.refids.setdefault(node['refid'], []).append(node) - - def note_indirect_target(self, target): - self.indirect_targets.append(target) - if target['names']: - self.note_refname(target) - - def note_anonymous_target(self, target): - self.set_id(target) - - def note_autofootnote(self, footnote): - self.set_id(footnote) - self.autofootnotes.append(footnote) - - def note_autofootnote_ref(self, ref): - self.set_id(ref) - self.autofootnote_refs.append(ref) - - def note_symbol_footnote(self, footnote): - self.set_id(footnote) - self.symbol_footnotes.append(footnote) - - def note_symbol_footnote_ref(self, ref): - self.set_id(ref) - self.symbol_footnote_refs.append(ref) - - def note_footnote(self, footnote): - self.set_id(footnote) - self.footnotes.append(footnote) - - def note_footnote_ref(self, ref): - self.set_id(ref) - self.footnote_refs.setdefault(ref['refname'], []).append(ref) - self.note_refname(ref) - - def note_citation(self, citation): - self.citations.append(citation) - - def note_citation_ref(self, ref): - self.set_id(ref) - self.citation_refs.setdefault(ref['refname'], []).append(ref) - self.note_refname(ref) - - def note_substitution_def(self, subdef, def_name, msgnode=None): - name = whitespace_normalize_name(def_name) - if self.substitution_defs.has_key(name): - msg = self.reporter.error( - 'Duplicate substitution definition name: "%s".' % name, - base_node=subdef) - if msgnode != None: - msgnode += msg - oldnode = self.substitution_defs[name] - dupname(oldnode, name) - # keep only the last definition: - self.substitution_defs[name] = subdef - # case-insensitive mapping: - self.substitution_names[fully_normalize_name(name)] = name - - def note_substitution_ref(self, subref, refname): - subref['refname'] = whitespace_normalize_name(refname) - - def note_pending(self, pending, priority=None): - self.transformer.add_pending(pending, priority) - - def note_parse_message(self, message): - self.parse_messages.append(message) - - def note_transform_message(self, message): - self.transform_messages.append(message) - - def note_source(self, source, offset): - self.current_source = source - if offset is None: - self.current_line = offset - else: - self.current_line = offset + 1 - - def copy(self): - return self.class(self.settings, self.reporter, - self.attributes) - - def get_decoration(self): - if not self.decoration: - self.decoration = decoration() - index = self.first_child_not_matching_class(Titular) - if index is None: - self.append(self.decoration) - else: - self.insert(index, self.decoration) - return self.decoration - - -# ================ -# Title Elements -# ================ - -class title(Titular, PreBibliographic, TextElement): pass -class subtitle(Titular, PreBibliographic, TextElement): pass -class rubric(Titular, TextElement): pass - - -# ======================== -# Bibliographic Elements -# ======================== - -class docinfo(Bibliographic, Element): pass -class author(Bibliographic, TextElement): pass -class authors(Bibliographic, Element): pass -class organization(Bibliographic, TextElement): pass -class address(Bibliographic, FixedTextElement): pass -class contact(Bibliographic, TextElement): pass -class version(Bibliographic, TextElement): pass -class revision(Bibliographic, TextElement): pass -class status(Bibliographic, TextElement): pass -class date(Bibliographic, TextElement): pass -class copyright(Bibliographic, TextElement): pass - - -# ===================== -# Decorative Elements -# ===================== - -class decoration(Decorative, Element): - - def get_header(self): - if not len(self.children) or not isinstance(self.children[0], header): - self.insert(0, header()) - return self.children[0] - - def get_footer(self): - if not len(self.children) or not isinstance(self.children[-1], footer): - self.append(footer()) - return self.children[-1] - - -class header(Decorative, Element): pass -class footer(Decorative, Element): pass - - -# ===================== -# Structural Elements -# ===================== - -class section(Structural, Element): pass - - -class topic(Structural, Element): - - """ - Topics are terminal, "leaf" mini-sections, like block quotes with titles, - or textual figures. A topic is just like a section, except that it has no - subsections, and it doesn't have to conform to section placement rules. - - Topics are allowed wherever body elements (list, table, etc.) are allowed, - but only at the top level of a section or document. Topics cannot nest - inside topics, sidebars, or body elements; you can't have a topic inside a - table, list, block quote, etc. - """ - - -class sidebar(Structural, Element): - - """ - Sidebars are like miniature, parallel documents that occur inside other - documents, providing related or reference material. A sidebar is - typically offset by a border and "floats" to the side of the page; the - document's main text may flow around it. Sidebars can also be likened to - super-footnotes; their content is outside of the flow of the document's - main text. - - Sidebars are allowed wherever body elements (list, table, etc.) are - allowed, but only at the top level of a section or document. Sidebars - cannot nest inside sidebars, topics, or body elements; you can't have a - sidebar inside a table, list, block quote, etc. - """ - - -class transition(Structural, Element): pass - - -# =============== -# Body Elements -# =============== - -class paragraph(General, TextElement): pass -class compound(General, Element): pass -class container(General, Element): pass -class bullet_list(Sequential, Element): pass -class enumerated_list(Sequential, Element): pass -class list_item(Part, Element): pass -class definition_list(Sequential, Element): pass -class definition_list_item(Part, Element): pass -class term(Part, TextElement): pass -class classifier(Part, TextElement): pass -class definition(Part, Element): pass -class field_list(Sequential, Element): pass -class field(Part, Element): pass -class field_name(Part, TextElement): pass -class field_body(Part, Element): pass - - -class option(Part, Element): - - child_text_separator = '' - - -class option_argument(Part, TextElement): - - def astext(self): - return self.get('delimiter', ' ') + TextElement.astext(self) - - -class option_group(Part, Element): - - child_text_separator = ', ' - - -class option_list(Sequential, Element): pass - - -class option_list_item(Part, Element): - - child_text_separator = ' ' - - -class option_string(Part, TextElement): pass -class description(Part, Element): pass -class literal_block(General, FixedTextElement): pass -class doctest_block(General, FixedTextElement): pass -class line_block(General, Element): pass - - -class line(Part, TextElement): - - indent = None - - -class block_quote(General, Element): pass -class attribution(Part, TextElement): pass -class attention(Admonition, Element): pass -class caution(Admonition, Element): pass -class danger(Admonition, Element): pass -class error(Admonition, Element): pass -class important(Admonition, Element): pass -class note(Admonition, Element): pass -class tip(Admonition, Element): pass -class hint(Admonition, Element): pass -class warning(Admonition, Element): pass -class admonition(Admonition, Element): pass -class comment(Special, Invisible, FixedTextElement): pass -class substitution_definition(Special, Invisible, TextElement): pass -class target(Special, Invisible, Inline, TextElement, Targetable): pass -class footnote(General, BackLinkable, Element, Labeled, Targetable): pass -class citation(General, BackLinkable, Element, Labeled, Targetable): pass -class label(Part, TextElement): pass -class figure(General, Element): pass -class caption(Part, TextElement): pass -class legend(Part, Element): pass -class table(General, Element): pass -class tgroup(Part, Element): pass -class colspec(Part, Element): pass -class thead(Part, Element): pass -class tbody(Part, Element): pass -class row(Part, Element): pass -class entry(Part, Element): pass - - -class system_message(Special, BackLinkable, PreBibliographic, Element): - - """ - System message element. - - Do not instantiate this class directly; use - ``document.reporter.info/warning/error/severe()`` instead. - """ - - def init(self, message=None, children, **attributes): - if message: - p = paragraph('', message) - children = (p,) + children - try: - Element.init(self, '', *children, **attributes) - except: - print 'system_message: children=%r' % (children,) - raise - - def astext(self): - line = self.get('line', '') - return u'%s:%s: (%s/%s) %s' % (self['source'], line, self['type'], - self['level'], Element.astext(self)) - - -class pending(Special, Invisible, Element): - - """ - The "pending" element is used to encapsulate a pending operation: the - operation (transform), the point at which to apply it, and any data it - requires. Only the pending operation's location within the document is - stored in the public document tree (by the "pending" object itself); the - operation and its data are stored in the "pending" object's internal - instance attributes. - - For example, say you want a table of contents in your reStructuredText - document. The easiest way to specify where to put it is from within the - document, with a directive:: - - .. contents:: - - But the "contents" directive can't do its work until the entire document - has been parsed and possibly transformed to some extent. So the directive - code leaves a placeholder behind that will trigger the second phase of its - processing, something like this:: - - + internal attributes - - Use `document.note_pending()` so that the - `docutils.transforms.Transformer` stage of processing can run all pending - transforms. - """ - - def init(self, transform, details=None, - rawsource='', *children, **attributes): - Element.init(self, rawsource, *children, **attributes) - - self.transform = transform - """The `docutils.transforms.Transform` class implementing the pending - operation.""" - - self.details = details or {} - """Detail data (dictionary) required by the pending operation.""" - - def pformat(self, indent=' ', level=0): - internals = [ - '.. internal attributes:', - ' .transform: %s.%s' % (self.transform.module, - self.transform.name), - ' .details:'] - details = self.details.items() - details.sort() - for key, value in details: - if isinstance(value, Node): - internals.append('%7s%s:' % ('', key)) - internals.extend(['%9s%s' % ('', line) - for line in value.pformat().splitlines()]) - elif value and isinstance(value, ListType) \ - and isinstance(value[0], Node): - internals.append('%7s%s:' % ('', key)) - for v in value: - internals.extend(['%9s%s' % ('', line) - for line in v.pformat().splitlines()]) - else: - internals.append('%7s%s: %r' % ('', key, value)) - return (Element.pformat(self, indent, level) - + ''.join([(' %s%s\n' % (indent * level, line)) - for line in internals])) - - def copy(self): - return self.class(self.transform, self.details, self.rawsource, - **self.attributes) - - -class raw(Special, Inline, PreBibliographic, FixedTextElement): - - """ - Raw data that is to be passed untouched to the Writer. - """ - - pass - - -# ================= -# Inline Elements -# ================= - -class emphasis(Inline, TextElement): pass -class strong(Inline, TextElement): pass -class literal(Inline, TextElement): pass -class reference(General, Inline, Referential, TextElement): pass -class footnote_reference(Inline, Referential, TextElement): pass -class citation_reference(Inline, Referential, TextElement): pass -class substitution_reference(Inline, TextElement): pass -class title_reference(Inline, TextElement): pass -class abbreviation(Inline, TextElement): pass -class acronym(Inline, TextElement): pass -class superscript(Inline, TextElement): pass -class subscript(Inline, TextElement): pass - - -class image(General, Inline, Element): - - def astext(self): - return self.get('alt', '') - - -class inline(Inline, TextElement): pass -class problematic(Inline, TextElement): pass -class generated(Inline, TextElement): pass - - -# ======================================== -# Auxiliary Classes, Functions, and Data -# ======================================== - -node_class_names = """ - Text - abbreviation acronym address admonition attention attribution author - authors - block_quote bullet_list - caption caution citation citation_reference classifier colspec comment - compound contact container copyright - danger date decoration definition definition_list definition_list_item - description docinfo doctest_block document - emphasis entry enumerated_list error - field field_body field_list field_name figure footer - footnote footnote_reference - generated - header hint - image important inline - label legend line line_block list_item literal literal_block - note - option option_argument option_group option_list option_list_item - option_string organization - paragraph pending problematic - raw reference revision row rubric - section sidebar status strong subscript substitution_definition - substitution_reference subtitle superscript system_message - table target tbody term tgroup thead tip title title_reference topic - transition - version - warning""".split() -"""A list of names of all concrete Node subclasses.""" - - -class NodeVisitor: - - """ - "Visitor" pattern [GoF95]_ abstract superclass implementation for - document tree traversals. - - Each node class has corresponding methods, doing nothing by - default; override individual methods for specific and useful - behaviour. The `dispatch_visit()` method is called by - `Node.walk()` upon entering a node. `Node.walkabout()` also calls - the `dispatch_departure()` method before exiting a node. - - The dispatch methods call "``visit_`` + node class name" or - "``depart_`` + node class name", resp. - - This is a base class for visitors whose ``visit_...`` & ``depart_...`` - methods should be implemented for all node types encountered (such as - for `docutils.writers.Writer` subclasses). Unimplemented methods will - raise exceptions. - - For sparse traversals, where only certain node types are of interest, - subclass `SparseNodeVisitor` instead. When (mostly or entirely) uniform - processing is desired, subclass `GenericNodeVisitor`. - - .. [GoF95] Gamma, Helm, Johnson, Vlissides. Design Patterns: Elements of - Reusable Object-Oriented Software. Addison-Wesley, Reading, MA, USA, - 1995. - """ - - optional = () - """ - Tuple containing node class names (as strings). - - No exception will be raised if writers do not implement visit - or departure functions for these node classes. - - Used to ensure transitional compatibility with existing 3rd-party writers. - """ - - def init(self, document): - self.document = document - - def dispatch_visit(self, node): - """ - Call self."``visit_`` + node class name" with `node` as - parameter. If the ``visit_...`` method does not exist, call - self.unknown_visit. - """ - node_name = node.class.name - method = getattr(self, 'visit_' + node_name, self.unknown_visit) - self.document.reporter.debug( - 'docutils.nodes.NodeVisitor.dispatch_visit calling %s for %s' - % (method.name, node_name)) - return method(node) - - def dispatch_departure(self, node): - """ - Call self."``depart_`` + node class name" with `node` as - parameter. If the ``depart_...`` method does not exist, call - self.unknown_departure. - """ - node_name = node.class.name - method = getattr(self, 'depart_' + node_name, self.unknown_departure) - self.document.reporter.debug( - 'docutils.nodes.NodeVisitor.dispatch_departure calling %s for %s' - % (method.name, node_name)) - return method(node) - - def unknown_visit(self, node): - """ - Called when entering unknown `Node` types. - - Raise an exception unless overridden. - """ - if (node.document.settings.strict_visitor - or node.class.name not in self.optional): - raise NotImplementedError( - '%s visiting unknown node type: %s' - % (self.class, node.class.name)) - - def unknown_departure(self, node): - """ - Called before exiting unknown `Node` types. - - Raise exception unless overridden. - """ - if (node.document.settings.strict_visitor - or node.class.name not in self.optional): - raise NotImplementedError( - '%s departing unknown node type: %s' - % (self.class, node.class.name)) - - -class SparseNodeVisitor(NodeVisitor): - - """ - Base class for sparse traversals, where only certain node types are of - interest. When ``visit_...`` & ``depart_...`` methods should be - implemented for all node types (such as for `docutils.writers.Writer` - subclasses), subclass `NodeVisitor` instead. - """ - - -class GenericNodeVisitor(NodeVisitor): - - """ - Generic "Visitor" abstract superclass, for simple traversals. - - Unless overridden, each ``visit_...`` method calls `default_visit()`, and - each ``depart_...`` method (when using `Node.walkabout()`) calls - `default_departure()`. `default_visit()` (and `default_departure()`) must - be overridden in subclasses. - - Define fully generic visitors by overriding `default_visit()` (and - `default_departure()`) only. Define semi-generic visitors by overriding - individual ``visit_...()`` (and ``depart_...()``) methods also. - - `NodeVisitor.unknown_visit()` (`NodeVisitor.unknown_departure()`) should - be overridden for default behavior. - """ - - def default_visit(self, node): - """Override for generic, uniform traversals.""" - raise NotImplementedError - - def default_departure(self, node): - """Override for generic, uniform traversals.""" - raise NotImplementedError - -def _call_default_visit(self, node): - self.default_visit(node) - -def _call_default_departure(self, node): - self.default_departure(node) - -def _nop(self, node): - pass - -def _add_node_class_names(names): - """Save typing with dynamic assignments:""" - for _name in names: - setattr(GenericNodeVisitor, "visit_" + _name, _call_default_visit) - setattr(GenericNodeVisitor, "depart_" + _name, _call_default_departure) - setattr(SparseNodeVisitor, 'visit_' + _name, _nop) - setattr(SparseNodeVisitor, 'depart_' + _name, _nop) - -_add_node_class_names(node_class_names) - - -class TreeCopyVisitor(GenericNodeVisitor): - - """ - Make a complete copy of a tree or branch, including element attributes. - """ - - def init(self, document): - GenericNodeVisitor.init(self, document) - self.parent_stack = [] - self.parent = [] - - def get_tree_copy(self): - return self.parent[0] - - def default_visit(self, node): - """Copy the current node, and make it the new acting parent.""" - newnode = node.copy() - self.parent.append(newnode) - self.parent_stack.append(self.parent) - self.parent = newnode - - def default_departure(self, node): - """Restore the previous acting parent.""" - self.parent = self.parent_stack.pop() - - -class TreePruningException(Exception): - - """ - Base class for `NodeVisitor`-related tree pruning exceptions. - - Raise subclasses from within ``visit_...`` or ``depart_...`` methods - called from `Node.walk()` and `Node.walkabout()` tree traversals to prune - the tree traversed. - """ - - pass - - -class SkipChildren(TreePruningException): - - """ - Do not visit any children of the current node. The current node's - siblings and ``depart_...`` method are not affected. - """ - - pass - - -class SkipSiblings(TreePruningException): - - """ - Do not visit any more siblings (to the right) of the current node. The - current node's children and its ``depart_...`` method are not affected. - """ - - pass - - -class SkipNode(TreePruningException): - - """ - Do not visit the current node's children, and do not call the current - node's ``depart_...`` method. - """ - - pass - - -class SkipDeparture(TreePruningException): - - """ - Do not call the current node's ``depart_...`` method. The current node's - children and siblings are not affected. - """ - - pass - - -class NodeFound(TreePruningException): - - """ - Raise to indicate that the target of a search has been found. This - exception must be caught by the client; it is not caught by the traversal - code. - """ - - pass - - -class StopTraversal(TreePruningException): - - """ - Stop the traversal alltogether. The current node's ``depart_...`` method - is not affected. The parent nodes ``depart_...`` methods are also called - as usual. No other nodes are visited. This is an alternative to - NodeFound that does not cause exception handling to trickle up to the - caller. - """ - - pass - - -def make_id(string): - """ - Convert `string` into an identifier and return it. - - Docutils identifiers will conform to the regular expression - ``[a-z](-?[a-z0-9]+)``. For CSS compatibility, identifiers (the "class" - and "id" attributes) should have no underscores, colons, or periods. - Hyphens may be used. - - - The `HTML 4.01 spec`_ defines identifiers based on SGML tokens: - - ID and NAME tokens must begin with a letter ([A-Za-z]) and may be - followed by any number of letters, digits ([0-9]), hyphens ("-"), - underscores ("_"), colons (":"), and periods ("."). - - - However the `CSS1 spec`_ defines identifiers based on the "name" token, - a tighter interpretation ("flex" tokenizer notation; "latin1" and - "escape" 8-bit characters have been replaced with entities):: - - unicode \\[0-9a-f]{1,4} - latin1 [¡-ÿ] - escape {unicode}|\\[ -~¡-ÿ] - nmchar [-a-z0-9]|{latin1}|{escape} - name {nmchar}+ - - The CSS1 "nmchar" rule does not include underscores ("_"), colons (":"), - or periods ("."), therefore "class" and "id" attributes should not contain - these characters. They should be replaced with hyphens ("-"). Combined - with HTML's requirements (the first character must be a letter; no - "unicode", "latin1", or "escape" characters), this results in the - ``[a-z](-?[a-z0-9]+)`` pattern. - - .. _HTML 4.01 spec: http://www.w3.org/TR/html401 - .. _CSS1 spec: http://www.w3.org/TR/REC-CSS1 - """ - id = _non_id_chars.sub('-', ' '.join(string.lower().split())) - id = _non_id_at_ends.sub('', id) - return str(id) - -_non_id_chars = re.compile('[^a-z0-9]+') -_non_id_at_ends = re.compile('^[-0-9]+|-+$') - -def dupname(node, name): - node['dupnames'].append(name) - node['names'].remove(name) - # Assume that this method is referenced, even though it isn't; we - # don't want to throw unnecessary system_messages. - node.referenced = 1 - -def fully_normalize_name(name): - """Return a case- and whitespace-normalized name.""" - return ' '.join(name.lower().split()) - -def whitespace_normalize_name(name): - """Return a whitespace-normalized name.""" - return ' '.join(name.split()) - -def serial_escape(value): - """Escape string values that are elements of a list, for serialization.""" - return value.replace('\\', r'\\').replace(' ', r'\ ') - -# -# -# Local Variables: -# indent-tabs-mode: nil -# sentence-end-double-space: t -# fill-column: 78 -# End: diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/init.py --- a/buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/init.py Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,47 +0,0 @@ -# $Id: init.py 4564 2006-05-21 20:44:42Z wiemann $ -# Author: David Goodger -# Copyright: This module has been placed in the public domain. - -""" -This package contains Docutils parser modules. -""" - -docformat = 'reStructuredText' - -from docutils import Component - - -class Parser(Component): - - component_type = 'parser' - config_section = 'parsers' - - def parse(self, inputstring, document): - """Override to parse `inputstring` into document tree `document`.""" - raise NotImplementedError('subclass must override this method') - - def setup_parse(self, inputstring, document): - """Initial parse setup. Call at start of `self.parse()`.""" - self.inputstring = inputstring - self.document = document - document.reporter.attach_observer(document.note_parse_message) - - def finish_parse(self): - """Finalize parse details. Call at end of `self.parse()`.""" - self.document.reporter.detach_observer( - self.document.note_parse_message) - - -_parser_aliases = { - 'restructuredtext': 'rst', - 'rest': 'rst', - 'restx': 'rst', - 'rtxt': 'rst',} - -def get_parser_class(parser_name): - """Return the Parser class from the `parser_name` module.""" - parser_name = parser_name.lower() - if _parser_aliases.has_key(parser_name): - parser_name = _parser_aliases[parser_name] - module = import(parser_name, globals(), locals()) - return module.Parser diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/null.py --- a/buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/null.py Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,20 +0,0 @@ -# $Id: null.py 4564 2006-05-21 20:44:42Z wiemann $ -# Author: Martin Blais -# Copyright: This module has been placed in the public domain. - -"""A do-nothing parser.""" - -from docutils import parsers - - -class Parser(parsers.Parser): - - """A do-nothing parser.""" - - supported = ('null',) - - config_section = 'null parser' - config_section_dependencies = ('parsers',) - - def parse(self, inputstring, document): - pass diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/init.py --- a/buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/init.py Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,367 +0,0 @@ -# $Id: init.py 4802 2006-11-12 18:02:17Z goodger $ -# Author: David Goodger -# Copyright: This module has been placed in the public domain. - -""" -This is ``docutils.parsers.rst`` package. It exports a single class, `Parser`, -the reStructuredText parser. - - -Usage -===== - -1. Create a parser:: - - parser = docutils.parsers.rst.Parser() - - Several optional arguments may be passed to modify the parser's behavior. - Please see `Customizing the Parser`_ below for details. - -2. Gather input (a multi-line string), by reading a file or the standard - input:: - - input = sys.stdin.read() - -3. Create a new empty `docutils.nodes.document` tree:: - - document = docutils.utils.new_document(source, settings) - - See `docutils.utils.new_document()` for parameter details. - -4. Run the parser, populating the document tree:: - - parser.parse(input, document) - - -Parser Overview -=============== - -The reStructuredText parser is implemented as a state machine, examining its -input one line at a time. To understand how the parser works, please first -become familiar with the `docutils.statemachine` module, then see the -`states` module. - - -Customizing the Parser ----------------------- - -Anything that isn't already customizable is that way simply because that type -of customizability hasn't been implemented yet. Patches welcome! - -When instantiating an object of the `Parser` class, two parameters may be -passed: ``rfc2822`` and ``inliner``. Pass ``rfc2822=1`` to enable an initial -RFC-2822 style header block, parsed as a "field_list" element (with "class" -attribute set to "rfc2822"). Currently this is the only body-level element -which is customizable without subclassing. (Tip: subclass `Parser` and change -its "state_classes" and "initial_state" attributes to refer to new classes. -Contact the author if you need more details.) - -The ``inliner`` parameter takes an instance of `states.Inliner` or a subclass. -It handles inline markup recognition. A common extension is the addition of -further implicit hyperlinks, like "RFC 2822". This can be done by subclassing -`states.Inliner`, adding a new method for the implicit markup, and adding a -``(pattern, method)`` pair to the "implicit_dispatch" attribute of the -subclass. See `states.Inliner.implicit_inline()` for details. Explicit -inline markup can be customized in a `states.Inliner` subclass via the -``patterns.initial`` and ``dispatch`` attributes (and new methods as -appropriate). -""" - -docformat = 'reStructuredText' - - -import docutils.parsers -import docutils.statemachine -from docutils.parsers.rst import states -from docutils import frontend, nodes - - -class Parser(docutils.parsers.Parser): - - """The reStructuredText parser.""" - - supported = ('restructuredtext', 'rst', 'rest', 'restx', 'rtxt', 'rstx') - """Aliases this parser supports.""" - - settings_spec = ( - 'reStructuredText Parser Options', - None, - (('Recognize and link to standalone PEP references (like "PEP 258").', - ['--pep-references'], - {'action': 'store_true', 'validator': frontend.validate_boolean}), - ('Base URL for PEP references ' - '(default "http://www.python.org/dev/peps/").', - ['--pep-base-url'], - {'metavar': '', 'default': 'http://www.python.org/dev/peps/', - 'validator': frontend.validate_url_trailing_slash}), - ('Template for PEP file part of URL. (default "pep-%04d")', - ['--pep-file-url-template'], - {'metavar': '', 'default': 'pep-%04d'}), - ('Recognize and link to standalone RFC references (like "RFC 822").', - ['--rfc-references'], - {'action': 'store_true', 'validator': frontend.validate_boolean}), - ('Base URL for RFC references (default "http://www.faqs.org/rfcs/").', - ['--rfc-base-url'], - {'metavar': '', 'default': 'http://www.faqs.org/rfcs/', - 'validator': frontend.validate_url_trailing_slash}), - ('Set number of spaces for tab expansion (default 8).', - ['--tab-width'], - {'metavar': '', 'type': 'int', 'default': 8, - 'validator': frontend.validate_nonnegative_int}), - ('Remove spaces before footnote references.', - ['--trim-footnote-reference-space'], - {'action': 'store_true', 'validator': frontend.validate_boolean}), - ('Leave spaces before footnote references.', - ['--leave-footnote-reference-space'], - {'action': 'store_false', 'dest': 'trim_footnote_reference_space'}), - ('Disable directives that insert the contents of external file ' - '("include" & "raw"); replaced with a "warning" system message.', - ['--no-file-insertion'], - {'action': 'store_false', 'default': 1, - 'dest': 'file_insertion_enabled', - 'validator': frontend.validate_boolean}), - ('Enable directives that insert the contents of external file ' - '("include" & "raw"). Enabled by default.', - ['--file-insertion-enabled'], - {'action': 'store_true'}), - ('Disable the "raw" directives; replaced with a "warning" ' - 'system message.', - ['--no-raw'], - {'action': 'store_false', 'default': 1, 'dest': 'raw_enabled', - 'validator': frontend.validate_boolean}), - ('Enable the "raw" directive. Enabled by default.', - ['--raw-enabled'], - {'action': 'store_true'}),)) - - config_section = 'restructuredtext parser' - config_section_dependencies = ('parsers',) - - def init(self, rfc2822=None, inliner=None): - if rfc2822: - self.initial_state = 'RFC2822Body' - else: - self.initial_state = 'Body' - self.state_classes = states.state_classes - self.inliner = inliner - - def parse(self, inputstring, document): - """Parse `inputstring` and populate `document`, a document tree.""" - self.setup_parse(inputstring, document) - self.statemachine = states.RSTStateMachine( - state_classes=self.state_classes, - initial_state=self.initial_state, - debug=document.reporter.debug_flag) - inputlines = docutils.statemachine.string2lines( - inputstring, tab_width=document.settings.tab_width, - convert_whitespace=1) - self.statemachine.run(inputlines, document, inliner=self.inliner) - self.finish_parse() - - -class DirectiveError(Exception): - - """ - Store a message and a system message level. - - To be thrown from inside directive code. - - Do not instantiate directly -- use `Directive.directive_error()` - instead! - """ - - def init(self, level, message): - """ - Initialize with message `message`. `level` is a system message level. - """ - Exception.init(self) - self.level = level - self.message = message - - -class Directive: - - """ - Base class for reStructuredText directives. - - The following attributes may be set by subclasses. They are - interpreted by the directive parser (which runs the directive - class): - - - `required_arguments`: The number of required arguments (default: - 0). - - - `optional_arguments`: The number of optional arguments (default: - 0). - - - `final_argument_whitespace`: A boolean, indicating if the final - argument may contain whitespace (default: False). - - - `option_spec`: A dictionary, mapping known option names to - conversion functions such as `int` or `float` (default: {}, no - options). Several conversion functions are defined in the - directives/init.py module. - - Option conversion functions take a single parameter, the option - argument (a string or ``None``), validate it and/or convert it - to the appropriate form. Conversion functions may raise - `ValueError` and `TypeError` exceptions. - - - `has_content`: A boolean; True if content is allowed. Client - code must handle the case where content is required but not - supplied (an empty content list will be supplied). - - Arguments are normally single whitespace-separated words. The - final argument may contain whitespace and/or newlines if - `final_argument_whitespace` is True. - - If the form of the arguments is more complex, specify only one - argument (either required or optional) and set - `final_argument_whitespace` to True; the client code must do any - context-sensitive parsing. - - When a directive implementation is being run, the directive class - is instantiated, and the `run()` method is executed. During - instantiation, the following instance variables are set: - - - ``name`` is the directive type or name (string). - - - ``arguments`` is the list of positional arguments (strings). - - - ``options`` is a dictionary mapping option names (strings) to - values (type depends on option conversion functions; see - `option_spec` above). - - - ``content`` is a list of strings, the directive content line by line. - - - ``lineno`` is the line number of the first line of the directive. - - - ``content_offset`` is the line offset of the first line of the content from - the beginning of the current input. Used when initiating a nested parse. - - - ``block_text`` is a string containing the entire directive. - - - ``state`` is the state which called the directive function. - - - ``state_machine`` is the state machine which controls the state which called - the directive function. - - Directive functions return a list of nodes which will be inserted - into the document tree at the point where the directive was - encountered. This can be an empty list if there is nothing to - insert. - - For ordinary directives, the list must contain body elements or - structural elements. Some directives are intended specifically - for substitution definitions, and must return a list of `Text` - nodes and/or inline elements (suitable for inline insertion, in - place of the substitution reference). Such directives must verify - substitution definition context, typically using code like this:: - - if not isinstance(state, states.SubstitutionDef): - error = state_machine.reporter.error( - 'Invalid context: the "%s" directive can only be used ' - 'within a substitution definition.' % (name), - nodes.literal_block(block_text, block_text), line=lineno) - return [error] - """ - - # There is a "Creating reStructuredText Directives" how-to at - # . If you - # update this docstring, please update the how-to as well. - - required_arguments = 0 - """Number of required directive arguments.""" - - optional_arguments = 0 - """Number of optional arguments after the required arguments.""" - - final_argument_whitespace = False - """May the final argument contain whitespace?""" - - option_spec = None - """Mapping of option names to validator functions.""" - - has_content = False - """May the directive have content?""" - - def init(self, name, arguments, options, content, lineno, - content_offset, block_text, state, state_machine): - self.name = name - self.arguments = arguments - self.options = options - self.content = content - self.lineno = lineno - self.content_offset = content_offset - self.block_text = block_text - self.state = state - self.state_machine = state_machine - - def run(self): - raise NotImplementedError('Must override run() is subclass.') - - # Directive errors: - - def directive_error(self, level, message): - """ - Return a DirectiveError suitable for being thrown as an exception. - - Call "raise self.directive_error(level, message)" from within - a directive implementation to return one single system message - at level `level`, which automatically gets the directive block - and the line number added. - - You'd often use self.error(message) instead, which will - generate an ERROR-level directive error. - """ - return DirectiveError(level, message) - - def debug(self, message): - return self.directive_error(0, message) - - def info(self, message): - return self.directive_error(1, message) - - def warning(self, message): - return self.directive_error(2, message) - - def error(self, message): - return self.directive_error(3, message) - - def severe(self, message): - return self.directive_error(4, message) - - # Convenience methods: - - def assert_has_content(self): - """ - Throw an ERROR-level DirectiveError if the directive doesn't - have contents. - """ - if not self.content: - raise self.error('Content block expected for the "%s" directive; ' - 'none found.' % self.name) - - -def convert_directive_function(directive_fn): - """ - Define & return a directive class generated from `directive_fn`. - - `directive_fn` uses the old-style, functional interface. - """ - - class FunctionalDirective(Directive): - - option_spec = getattr(directive_fn, 'options', None) - has_content = getattr(directive_fn, 'content', False) - _argument_spec = getattr(directive_fn, 'arguments', (0, 0, False)) - required_arguments, optional_arguments, final_argument_whitespace \ - = _argument_spec - - def run(self): - return directive_fn( - self.name, self.arguments, self.options, self.content, - self.lineno, self.content_offset, self.block_text, - self.state, self.state_machine) - - # Return new-style directive. - return FunctionalDirective diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/directives/init.py --- a/buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/directives/init.py Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,367 +0,0 @@ -# $Id: init.py 4667 2006-07-12 21:40:56Z wiemann $ -# Author: David Goodger -# Copyright: This module has been placed in the public domain. - -""" -This package contains directive implementation modules. -""" - -docformat = 'reStructuredText' - -import re -import codecs -from docutils import nodes -from docutils.parsers.rst.languages import en as _fallback_language_module - - -_directive_registry = { - 'attention': ('admonitions', 'Attention'), - 'caution': ('admonitions', 'Caution'), - 'danger': ('admonitions', 'Danger'), - 'error': ('admonitions', 'Error'), - 'important': ('admonitions', 'Important'), - 'note': ('admonitions', 'Note'), - 'tip': ('admonitions', 'Tip'), - 'hint': ('admonitions', 'Hint'), - 'warning': ('admonitions', 'Warning'), - 'admonition': ('admonitions', 'Admonition'), - 'sidebar': ('body', 'Sidebar'), - 'topic': ('body', 'Topic'), - 'line-block': ('body', 'LineBlock'), - 'parsed-literal': ('body', 'ParsedLiteral'), - 'rubric': ('body', 'Rubric'), - 'epigraph': ('body', 'Epigraph'), - 'highlights': ('body', 'Highlights'), - 'pull-quote': ('body', 'PullQuote'), - 'compound': ('body', 'Compound'), - 'container': ('body', 'Container'), - #'questions': ('body', 'question_list'), - 'table': ('tables', 'RSTTable'), - 'csv-table': ('tables', 'CSVTable'), - 'list-table': ('tables', 'ListTable'), - 'image': ('images', 'Image'), - 'figure': ('images', 'Figure'), - 'contents': ('parts', 'Contents'), - 'sectnum': ('parts', 'Sectnum'), - 'header': ('parts', 'Header'), - 'footer': ('parts', 'Footer'), - #'footnotes': ('parts', 'footnotes'), - #'citations': ('parts', 'citations'), - 'target-notes': ('references', 'TargetNotes'), - 'meta': ('html', 'Meta'), - #'imagemap': ('html', 'imagemap'), - 'raw': ('misc', 'Raw'), - 'include': ('misc', 'Include'), - 'replace': ('misc', 'Replace'), - 'unicode': ('misc', 'Unicode'), - 'class': ('misc', 'Class'), - 'role': ('misc', 'Role'), - 'default-role': ('misc', 'DefaultRole'), - 'title': ('misc', 'Title'), - 'date': ('misc', 'Date'), - 'restructuredtext-test-directive': ('misc', 'TestDirective'),} -"""Mapping of directive name to (module name, class name). The -directive name is canonical & must be lowercase. Language-dependent -names are defined in the ``language`` subpackage.""" - -_directives = {} -"""Cache of imported directives.""" - -def directive(directive_name, language_module, document): - """ - Locate and return a directive function from its language-dependent name. - If not found in the current language, check English. Return None if the - named directive cannot be found. - """ - normname = directive_name.lower() - messages = [] - msg_text = [] - if _directives.has_key(normname): - return _directives[normname], messages - canonicalname = None - try: - canonicalname = language_module.directives[normname] - except AttributeError, error: - msg_text.append('Problem retrieving directive entry from language ' - 'module %r: %s.' % (language_module, error)) - except KeyError: - msg_text.append('No directive entry for "%s" in module "%s".' - % (directive_name, language_module.name)) - if not canonicalname: - try: - canonicalname = _fallback_language_module.directives[normname] - msg_text.append('Using English fallback for directive "%s".' - % directive_name) - except KeyError: - msg_text.append('Trying "%s" as canonical directive name.' - % directive_name) - # The canonical name should be an English name, but just in case: - canonicalname = normname - if msg_text: - message = document.reporter.info( - '\n'.join(msg_text), line=document.current_line) - messages.append(message) - try: - modulename, classname = _directive_registry[canonicalname] - except KeyError: - # Error handling done by caller. - return None, messages - try: - module = import(modulename, globals(), locals()) - except ImportError, detail: - messages.append(document.reporter.error( - 'Error importing directive module "%s" (directive "%s"):\n%s' - % (modulename, directive_name, detail), - line=document.current_line)) - return None, messages - try: - directive = getattr(module, classname) - _directives[normname] = directive - except AttributeError: - messages.append(document.reporter.error( - 'No directive class "%s" in module "%s" (directive "%s").' - % (classname, modulename, directive_name), - line=document.current_line)) - return None, messages - return directive, messages - -def register_directive(name, directive): - """ - Register a nonstandard application-defined directive function. - Language lookups are not needed for such functions. - """ - _directives[name] = directive - -def flag(argument): - """ - Check for a valid flag option (no argument) and return ``None``. - (Directive option conversion function.) - - Raise ``ValueError`` if an argument is found. - """ - if argument and argument.strip(): - raise ValueError('no argument is allowed; "%s" supplied' % argument) - else: - return None - -def unchanged_required(argument): - """ - Return the argument text, unchanged. - (Directive option conversion function.) - - Raise ``ValueError`` if no argument is found. - """ - if argument is None: - raise ValueError('argument required but none supplied') - else: - return argument # unchanged! - -def unchanged(argument): - """ - Return the argument text, unchanged. - (Directive option conversion function.) - - No argument implies empty string (""). - """ - if argument is None: - return u'' - else: - return argument # unchanged! - -def path(argument): - """ - Return the path argument unwrapped (with newlines removed). - (Directive option conversion function.) - - Raise ``ValueError`` if no argument is found. - """ - if argument is None: - raise ValueError('argument required but none supplied') - else: - path = ''.join([s.strip() for s in argument.splitlines()]) - return path - -def uri(argument): - """ - Return the URI argument with whitespace removed. - (Directive option conversion function.) - - Raise ``ValueError`` if no argument is found. - """ - if argument is None: - raise ValueError('argument required but none supplied') - else: - uri = ''.join(argument.split()) - return uri - -def nonnegative_int(argument): - """ - Check for a nonnegative integer argument; raise ``ValueError`` if not. - (Directive option conversion function.) - """ - value = int(argument) - if value < 0: - raise ValueError('negative value; must be positive or zero') - return value - -length_units = ['em', 'ex', 'px', 'in', 'cm', 'mm', 'pt', 'pc'] - -def get_measure(argument, units): - """ - Check for a positive argument of one of the units and return a - normalized string of the form "" (without space in - between). - - To be called from directive option conversion functions. - """ - match = re.match(r'^([0-9.]+) (%s)$' % '|'.join(units), argument) - try: - assert match is not None - float(match.group(1)) - except (AssertionError, ValueError): - raise ValueError( - 'not a positive measure of one of the following units:\n%s' - % ' '.join(['"%s"' % i for i in units])) - return match.group(1) + match.group(2) - -def length_or_unitless(argument): - return get_measure(argument, length_units + ['']) - -def length_or_percentage_or_unitless(argument): - return get_measure(argument, length_units + ['%', '']) - -def class_option(argument): - """ - Convert the argument into a list of ID-compatible strings and return it. - (Directive option conversion function.) - - Raise ``ValueError`` if no argument is found. - """ - if argument is None: - raise ValueError('argument required but none supplied') - names = argument.split() - class_names = [] - for name in names: - class_name = nodes.make_id(name) - if not class_name: - raise ValueError('cannot make "%s" into a class name' % name) - class_names.append(class_name) - return class_names - -unicode_pattern = re.compile( - r'(?:0x|x|\\x|U\+?|\\u)([0-9a-f]+)$|&#x([0-9a-f]+);$', re.IGNORECASE) - -def unicode_code(code): - r""" - Convert a Unicode character code to a Unicode character. - (Directive option conversion function.) - - Codes may be decimal numbers, hexadecimal numbers (prefixed by ``0x``, - ``x``, ``\x``, ``U+``, ``u``, or ``\u``; e.g. ``U+262E``), or XML-style - numeric character entities (e.g. ``☮``). Other text remains as-is. - - Raise ValueError for illegal Unicode code values. - """ - try: - if code.isdigit(): # decimal number - return unichr(int(code)) - else: - match = unicode_pattern.match(code) - if match: # hex number - value = match.group(1) or match.group(2) - return unichr(int(value, 16)) - else: # other text - return code - except OverflowError, detail: - raise ValueError('code too large (%s)' % detail) - -def single_char_or_unicode(argument): - """ - A single character is returned as-is. Unicode characters codes are - converted as in `unicode_code`. (Directive option conversion function.) - """ - char = unicode_code(argument) - if len(char) > 1: - raise ValueError('%r invalid; must be a single character or ' - 'a Unicode code' % char) - return char - -def single_char_or_whitespace_or_unicode(argument): - """ - As with `single_char_or_unicode`, but "tab" and "space" are also supported. - (Directive option conversion function.) - """ - if argument == 'tab': - char = '\t' - elif argument == 'space': - char = ' ' - else: - char = single_char_or_unicode(argument) - return char - -def positive_int(argument): - """ - Converts the argument into an integer. Raises ValueError for negative, - zero, or non-integer values. (Directive option conversion function.) - """ - value = int(argument) - if value < 1: - raise ValueError('negative or zero value; must be positive') - return value - -def positive_int_list(argument): - """ - Converts a space- or comma-separated list of values into a Python list - of integers. - (Directive option conversion function.) - - Raises ValueError for non-positive-integer values. - """ - if ',' in argument: - entries = argument.split(',') - else: - entries = argument.split() - return [positive_int(entry) for entry in entries] - -def encoding(argument): - """ - Verfies the encoding argument by lookup. - (Directive option conversion function.) - - Raises ValueError for unknown encodings. - """ - try: - codecs.lookup(argument) - except LookupError: - raise ValueError('unknown encoding: "%s"' % argument) - return argument - -def choice(argument, values): - """ - Directive option utility function, supplied to enable options whose - argument must be a member of a finite set of possible values (must be - lower case). A custom conversion function must be written to use it. For - example:: - - from docutils.parsers.rst import directives - - def yesno(argument): - return directives.choice(argument, ('yes', 'no')) - - Raise ``ValueError`` if no argument is found or if the argument's value is - not valid (not an entry in the supplied list). - """ - try: - value = argument.lower().strip() - except AttributeError: - raise ValueError('must supply an argument; choose from %s' - % format_values(values)) - if value in values: - return value - else: - raise ValueError('"%s" unknown; choose from %s' - % (argument, format_values(values))) - -def format_values(values): - return '%s, or "%s"' % (', '.join(['"%s"' % s for s in values[:-1]]), - values[-1]) diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/directives/admonitions.py --- a/buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/directives/admonitions.py Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,97 +0,0 @@ -# $Id: admonitions.py 4667 2006-07-12 21:40:56Z wiemann $ -# Author: David Goodger -# Copyright: This module has been placed in the public domain. - -""" -Admonition directives. -""" - -docformat = 'reStructuredText' - - -from docutils.parsers.rst import Directive -from docutils.parsers.rst import states, directives -from docutils import nodes - - -class BaseAdmonition(Directive): - - required_arguments = 0 - optional_arguments = 0 - final_argument_whitespace = True - option_spec = {} - has_content = True - - node_class = None - """Subclasses must set this to the appropriate admonition node class.""" - - def run(self): - self.assert_has_content() - text = '\n'.join(self.content) - admonition_node = self.node_class(text) - if self.arguments: - title_text = self.arguments[0] - textnodes, messages = self.state.inline_text(title_text, - self.lineno) - admonition_node += nodes.title(title_text, '', textnodes) - admonition_node += messages - if self.options.has_key('class'): - classes = self.options['class'] - else: - classes = ['admonition-' + nodes.make_id(title_text)] - admonition_node['classes'] += classes - self.state.nested_parse(self.content, self.content_offset, - admonition_node) - return [admonition_node] - - -class Admonition(BaseAdmonition): - - required_arguments = 1 - option_spec = {'class': directives.class_option} - node_class = nodes.admonition - - -class Attention(BaseAdmonition): - - node_class = nodes.attention - - -class Caution(BaseAdmonition): - - node_class = nodes.caution - - -class Danger(BaseAdmonition): - - node_class = nodes.danger - - -class Error(BaseAdmonition): - - node_class = nodes.error - - -class Hint(BaseAdmonition): - - node_class = nodes.hint - - -class Important(BaseAdmonition): - - node_class = nodes.important - - -class Note(BaseAdmonition): - - node_class = nodes.note - - -class Tip(BaseAdmonition): - - node_class = nodes.tip - - -class Warning(BaseAdmonition): - - node_class = nodes.warning diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/directives/body.py --- a/buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/directives/body.py Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,192 +0,0 @@ -# $Id: body.py 4667 2006-07-12 21:40:56Z wiemann $ -# Author: David Goodger -# Copyright: This module has been placed in the public domain. - -""" -Directives for additional body elements. - -See `docutils.parsers.rst.directives` for API details. -""" - -docformat = 'reStructuredText' - - -import sys -from docutils import nodes -from docutils.parsers.rst import Directive -from docutils.parsers.rst import directives -from docutils.parsers.rst.roles import set_classes - - -class BasePseudoSection(Directive): - - required_arguments = 1 - optional_arguments = 0 - final_argument_whitespace = True - option_spec = {'class': directives.class_option} - has_content = True - - node_class = None - """Node class to be used (must be set in subclasses).""" - - def run(self): - if not (self.state_machine.match_titles - or isinstance(self.state_machine.node, nodes.sidebar)): - raise self.error('The "%s" directive may not be used within ' - 'topics or body elements.' % self.name) - self.assert_has_content() - title_text = self.arguments[0] - textnodes, messages = self.state.inline_text(title_text, self.lineno) - titles = [nodes.title(title_text, '', textnodes)] - # Sidebar uses this code. - if self.options.has_key('subtitle'): - textnodes, more_messages = self.state.inline_text( - self.options['subtitle'], self.lineno) - titles.append(nodes.subtitle(self.options['subtitle'], '', - textnodes)) - messages.extend(more_messages) - text = '\n'.join(self.content) - node = self.node_class(text, (titles + messages)) - node['classes'] += self.options.get('class', []) - if text: - self.state.nested_parse(self.content, self.content_offset, node) - return [node] - - -class Topic(BasePseudoSection): - - node_class = nodes.topic - - -class Sidebar(BasePseudoSection): - - node_class = nodes.sidebar - - option_spec = BasePseudoSection.option_spec.copy() - option_spec['subtitle'] = directives.unchanged_required - - def run(self): - if isinstance(self.state_machine.node, nodes.sidebar): - raise self.error('The "%s" directive may not be used within a ' - 'sidebar element.' % self.name) - return BasePseudoSection.run(self) - - -class LineBlock(Directive): - - option_spec = {'class': directives.class_option} - has_content = True - - def run(self): - self.assert_has_content() - block = nodes.line_block(classes=self.options.get('class', [])) - node_list = [block] - for line_text in self.content: - text_nodes, messages = self.state.inline_text( - line_text.strip(), self.lineno + self.content_offset) - line = nodes.line(line_text, '', text_nodes) - if line_text.strip(): - line.indent = len(line_text) - len(line_text.lstrip()) - block += line - node_list.extend(messages) - self.content_offset += 1 - self.state.nest_line_block_lines(block) - return node_list - - -class ParsedLiteral(Directive): - - option_spec = {'class': directives.class_option} - has_content = True - - def run(self): - set_classes(self.options) - self.assert_has_content() - text = '\n'.join(self.content) - text_nodes, messages = self.state.inline_text(text, self.lineno) - node = nodes.literal_block(text, '', *text_nodes, **self.options) - node.line = self.content_offset + 1 - return [node] + messages - - -class Rubric(Directive): - - required_arguments = 1 - optional_arguments = 0 - final_argument_whitespace = True - option_spec = {'class': directives.class_option} - - def run(self): - set_classes(self.options) - rubric_text = self.arguments[0] - textnodes, messages = self.state.inline_text(rubric_text, self.lineno) - rubric = nodes.rubric(rubric_text, '', textnodes, self.options) - return [rubric] + messages - - -class BlockQuote(Directive): - - has_content = True - classes = [] - - def run(self): - self.assert_has_content() - elements = self.state.block_quote(self.content, self.content_offset) - for element in elements: - if isinstance(element, nodes.block_quote): - element['classes'] += self.classes - return elements - - -class Epigraph(BlockQuote): - - classes = ['epigraph'] - - -class Highlights(BlockQuote): - - classes = ['highlights'] - - -class PullQuote(BlockQuote): - - classes = ['pull-quote'] - - -class Compound(Directive): - - option_spec = {'class': directives.class_option} - has_content = True - - def run(self): - self.assert_has_content() - text = '\n'.join(self.content) - node = nodes.compound(text) - node['classes'] += self.options.get('class', []) - self.state.nested_parse(self.content, self.content_offset, node) - return [node] - - -class Container(Directive): - - required_arguments = 0 - optional_arguments = 1 - final_argument_whitespace = True - has_content = True - - def run(self): - self.assert_has_content() - text = '\n'.join(self.content) - try: - if self.arguments: - classes = directives.class_option(self.arguments[0]) - else: - classes = [] - except ValueError: - raise self.error( - 'Invalid class attribute value for "%s" directive: "%s".' - % (self.name, self.arguments[0])) - node = nodes.container(text) - node['classes'].extend(classes) - self.state.nested_parse(self.content, self.content_offset, node) - return [node] diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/directives/html.py --- a/buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/directives/html.py Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,88 +0,0 @@ -# $Id: html.py 4667 2006-07-12 21:40:56Z wiemann $ -# Author: David Goodger -# Copyright: This module has been placed in the public domain. - -""" -Directives for typically HTML-specific constructs. -""" - -docformat = 'reStructuredText' - -import sys -from docutils import nodes, utils -from docutils.parsers.rst import Directive -from docutils.parsers.rst import states -from docutils.transforms import components - - -class MetaBody(states.SpecializedBody): - - class meta(nodes.Special, nodes.PreBibliographic, nodes.Element): - """HTML-specific "meta" element.""" - pass - - def field_marker(self, match, context, next_state): - """Meta element.""" - node, blank_finish = self.parsemeta(match) - self.parent += node - return [], next_state, [] - - def parsemeta(self, match): - name = self.parse_field_marker(match) - indented, indent, line_offset, blank_finish = \ - self.state_machine.get_first_known_indented(match.end()) - node = self.meta() - pending = nodes.pending(components.Filter, - {'component': 'writer', - 'format': 'html', - 'nodes': [node]}) - node['content'] = ' '.join(indented) - if not indented: - line = self.state_machine.line - msg = self.reporter.info( - 'No content for meta tag "%s".' % name, - nodes.literal_block(line, line), - line=self.state_machine.abs_line_number()) - return msg, blank_finish - tokens = name.split() - try: - attname, val = utils.extract_name_value(tokens[0])[0] - node[attname.lower()] = val - except utils.NameValueError: - node['name'] = tokens[0] - for token in tokens[1:]: - try: - attname, val = utils.extract_name_value(token)[0] - node[attname.lower()] = val - except utils.NameValueError, detail: - line = self.state_machine.line - msg = self.reporter.error( - 'Error parsing meta tag attribute "%s": %s.' - % (token, detail), nodes.literal_block(line, line), - line=self.state_machine.abs_line_number()) - return msg, blank_finish - self.document.note_pending(pending) - return pending, blank_finish - - -class Meta(Directive): - - has_content = True - - SMkwargs = {'state_classes': (MetaBody,)} - - def run(self): - self.assert_has_content() - node = nodes.Element() - new_line_offset, blank_finish = self.state.nested_list_parse( - self.content, self.content_offset, node, - initial_state='MetaBody', blank_finish=1, - state_machine_kwargs=self.SMkwargs) - if (new_line_offset - self.content_offset) != len(self.content): - # incomplete parse of block? - error = self.state_machine.reporter.error( - 'Invalid meta directive.', - nodes.literal_block(self.block_text, self.block_text), - line=self.lineno) - node += error - return node.children diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/directives/images.py --- a/buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/directives/images.py Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,160 +0,0 @@ -# $Id: images.py 4667 2006-07-12 21:40:56Z wiemann $ -# Author: David Goodger -# Copyright: This module has been placed in the public domain. - -""" -Directives for figures and simple images. -""" - -docformat = 'reStructuredText' - - -import sys -from docutils import nodes, utils -from docutils.parsers.rst import Directive -from docutils.parsers.rst import directives, states -from docutils.nodes import fully_normalize_name, whitespace_normalize_name -from docutils.parsers.rst.roles import set_classes - -try: - import Image as PIL # PIL -except ImportError: - PIL = None - - -class Image(Directive): - - align_h_values = ('left', 'center', 'right') - align_v_values = ('top', 'middle', 'bottom') - align_values = align_v_values + align_h_values - - def align(argument): - # This is not callable as self.align. We cannot make it a - # staticmethod because we're saving an unbound method in - # option_spec below. - return directives.choice(argument, Image.align_values) - - required_arguments = 1 - optional_arguments = 0 - final_argument_whitespace = True - option_spec = {'alt': directives.unchanged, - 'height': directives.length_or_unitless, - 'width': directives.length_or_percentage_or_unitless, - 'scale': directives.nonnegative_int, - 'align': align, - 'target': directives.unchanged_required, - 'class': directives.class_option} - - def run(self): - if self.options.has_key('align'): - if isinstance(self.state, states.SubstitutionDef): - # Check for align_v_values. - if self.options['align'] not in self.align_v_values: - raise self.error( - 'Error in "%s" directive: "%s" is not a valid value ' - 'for the "align" option within a substitution ' - 'definition. Valid values for "align" are: "%s".' - % (self.name, self.options['align'], - '", "'.join(self.align_v_values))) - elif self.options['align'] not in self.align_h_values: - raise self.error( - 'Error in "%s" directive: "%s" is not a valid value for ' - 'the "align" option. Valid values for "align" are: "%s".' - % (self.name, self.options['align'], - '", "'.join(self.align_h_values))) - messages = [] - reference = directives.uri(self.arguments[0]) - self.options['uri'] = reference - reference_node = None - if self.options.has_key('target'): - block = states.escape2null( - self.options['target']).splitlines() - block = [line for line in block] - target_type, data = self.state.parse_target( - block, self.block_text, self.lineno) - if target_type == 'refuri': - reference_node = nodes.reference(refuri=data) - elif target_type == 'refname': - reference_node = nodes.reference( - refname=fully_normalize_name(data), - name=whitespace_normalize_name(data)) - reference_node.indirect_reference_name = data - self.state.document.note_refname(reference_node) - else: # malformed target - messages.append(data) # data is a system message - del self.options['target'] - set_classes(self.options) - image_node = nodes.image(self.block_text, self.options) - if reference_node: - reference_node += image_node - return messages + [reference_node] - else: - return messages + [image_node] - - -class Figure(Image): - - def align(argument): - return directives.choice(argument, Figure.align_h_values) - - def figwidth_value(argument): - if argument.lower() == 'image': - return 'image' - else: - return directives.nonnegative_int(argument) - - option_spec = Image.option_spec.copy() - option_spec['figwidth'] = figwidth_value - option_spec['figclass'] = directives.class_option - option_spec['align'] = align - has_content = True - - def run(self): - figwidth = self.options.get('figwidth') - if figwidth: - del self.options['figwidth'] - figclasses = self.options.get('figclass') - if figclasses: - del self.options['figclass'] - align = self.options.get('align') - if align: - del self.options['align'] - (image_node,) = Image.run(self) - if isinstance(image_node, nodes.system_message): - return [image_node] - figure_node = nodes.figure('', image_node) - if figwidth == 'image': - if PIL and self.state.document.settings.file_insertion_enabled: - # PIL doesn't like Unicode paths: - try: - i = PIL.open(str(image_node['uri'])) - except (IOError, UnicodeError): - pass - else: - self.state.document.settings.record_dependencies.add( - image_node['uri']) - figure_node['width'] = i.size[0] - elif figwidth is not None: - figure_node['width'] = figwidth - if figclasses: - figure_node['classes'] += figclasses - if align: - figure_node['align'] = align - if self.content: - node = nodes.Element() # anonymous container for parsing - self.state.nested_parse(self.content, self.content_offset, node) - first_node = node[0] - if isinstance(first_node, nodes.paragraph): - caption = nodes.caption(first_node.rawsource, '', - first_node.children) - figure_node += caption - elif not (isinstance(first_node, nodes.comment) - and len(first_node) == 0): - error = self.state_machine.reporter.error( - 'Figure caption must be a paragraph or empty comment.', - nodes.literal_block(self.block_text, self.block_text), - line=self.lineno) - return [figure_node, error] - if len(node) > 1: - figure_node += nodes.legend('', node[1:]) - return [figure_node] diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/directives/misc.py --- a/buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/directives/misc.py Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,462 +0,0 @@ -# $Id: misc.py 5015 2007-03-12 20:25:40Z wiemann $ -# Authors: David Goodger ; Dethe Elza -# Copyright: This module has been placed in the public domain. - -"""Miscellaneous directives.""" - -docformat = 'reStructuredText' - -import sys -import os.path -import re -import time -from docutils import io, nodes, statemachine, utils -from docutils.parsers.rst import Directive, convert_directive_function -from docutils.parsers.rst import directives, roles, states -from docutils.transforms import misc - - -class Include(Directive): - - """ - Include content read from a separate source file. - - Content may be parsed by the parser, or included as a literal - block. The encoding of the included file can be specified. Only - a part of the given file argument may be included by specifying - text to match before and/or after the text to be used. - """ - - required_arguments = 1 - optional_arguments = 0 - final_argument_whitespace = True - option_spec = {'literal': directives.flag, - 'encoding': directives.encoding, - 'start-after': directives.unchanged_required, - 'end-before': directives.unchanged_required} - - standard_include_path = os.path.join(os.path.dirname(states.file), - 'include') - - def run(self): - """Include a reST file as part of the content of this reST file.""" - if not self.state.document.settings.file_insertion_enabled: - raise self.warning('"%s" directive disabled.' % self.name) - source = self.state_machine.input_lines.source( - self.lineno - self.state_machine.input_offset - 1) - source_dir = os.path.dirname(os.path.abspath(source)) - path = directives.path(self.arguments[0]) - if path.startswith('<') and path.endswith('>'): - path = os.path.join(self.standard_include_path, path[1:-1]) - path = os.path.normpath(os.path.join(source_dir, path)) - path = utils.relative_path(None, path) - encoding = self.options.get( - 'encoding', self.state.document.settings.input_encoding) - try: - self.state.document.settings.record_dependencies.add(path) - include_file = io.FileInput( - source_path=path, encoding=encoding, - error_handler=(self.state.document.settings.\ - input_encoding_error_handler), - handle_io_errors=None) - except IOError, error: - raise self.severe('Problems with "%s" directive path:\n%s: %s.' - % (self.name, error.class.name, error)) - try: - include_text = include_file.read() - except UnicodeError, error: - raise self.severe( - 'Problem with "%s" directive:\n%s: %s' - % (self.name, error.class.name, error)) - # start-after/end-before: no restrictions on newlines in match-text, - # and no restrictions on matching inside lines vs. line boundaries - after_text = self.options.get('start-after', None) - if after_text: - # skip content in include_text before and incl.* a matching text - after_index = include_text.find(after_text) - if after_index < 0: - raise self.severe('Problem with "start-after" option of "%s" ' - 'directive:\nText not found.' % self.name) - include_text = include_text[after_index + len(after_text):] - before_text = self.options.get('end-before', None) - if before_text: - # skip content in include_text after and incl. a matching text - before_index = include_text.find(before_text) - if before_index < 0: - raise self.severe('Problem with "end-before" option of "%s" ' - 'directive:\nText not found.' % self.name) - include_text = include_text[:before_index] - if self.options.has_key('literal'): - literal_block = nodes.literal_block(include_text, include_text, - source=path) - literal_block.line = 1 - return [literal_block] - else: - include_lines = statemachine.string2lines(include_text, - convert_whitespace=1) - self.state_machine.insert_input(include_lines, path) - return [] - - -class Raw(Directive): - - """ - Pass through content unchanged - - Content is included in output based on type argument - - Content may be included inline (content section of directive) or - imported from a file or url. - """ - - required_arguments = 1 - optional_arguments = 0 - final_argument_whitespace = True - option_spec = {'file': directives.path, - 'url': directives.uri, - 'encoding': directives.encoding} - has_content = True - - def run(self): - if (not self.state.document.settings.raw_enabled - or (not self.state.document.settings.file_insertion_enabled - and (self.options.has_key('file') - or self.options.has_key('url')))): - raise self.warning('"%s" directive disabled.' % self.name) - attributes = {'format': ' '.join(self.arguments[0].lower().split())} - encoding = self.options.get( - 'encoding', self.state.document.settings.input_encoding) - if self.content: - if self.options.has_key('file') or self.options.has_key('url'): - raise self.error( - '"%s" directive may not both specify an external file ' - 'and have content.' % self.name) - text = '\n'.join(self.content) - elif self.options.has_key('file'): - if self.options.has_key('url'): - raise self.error( - 'The "file" and "url" options may not be simultaneously ' - 'specified for the "%s" directive.' % self.name) - source_dir = os.path.dirname( - os.path.abspath(self.state.document.current_source)) - path = os.path.normpath(os.path.join(source_dir, - self.options['file'])) - path = utils.relative_path(None, path) - try: - self.state.document.settings.record_dependencies.add(path) - raw_file = io.FileInput( - source_path=path, encoding=encoding, - error_handler=(self.state.document.settings.\ - input_encoding_error_handler), - handle_io_errors=None) - except IOError, error: - raise self.severe('Problems with "%s" directive path:\n%s.' - % (self.name, error)) - try: - text = raw_file.read() - except UnicodeError, error: - raise self.severe( - 'Problem with "%s" directive:\n%s: %s' - % (self.name, error.class.name, error)) - attributes['source'] = path - elif self.options.has_key('url'): - source = self.options['url'] - # Do not import urllib2 at the top of the module because - # it may fail due to broken SSL dependencies, and it takes - # about 0.15 seconds to load. - import urllib2 - try: - raw_text = urllib2.urlopen(source).read() - except (urllib2.URLError, IOError, OSError), error: - raise self.severe( - 'Problems with "%s" directive URL "%s":\n%s.' - % (self.name, self.options['url'], error)) - raw_file = io.StringInput( - source=raw_text, source_path=source, encoding=encoding, - error_handler=(self.state.document.settings.\ - input_encoding_error_handler)) - try: - text = raw_file.read() - except UnicodeError, error: - raise self.severe( - 'Problem with "%s" directive:\n%s: %s' - % (self.name, error.class.name, error)) - attributes['source'] = source - else: - # This will always fail because there is no content. - self.assert_has_content() - raw_node = nodes.raw('', text, **attributes) - return [raw_node] - - -class Replace(Directive): - - has_content = True - - def run(self): - if not isinstance(self.state, states.SubstitutionDef): - raise self.error( - 'Invalid context: the "%s" directive can only be used within ' - 'a substitution definition.' % self.name) - self.assert_has_content() - text = '\n'.join(self.content) - element = nodes.Element(text) - self.state.nested_parse(self.content, self.content_offset, - element) - if ( len(element) != 1 - or not isinstance(element[0], nodes.paragraph)): - messages = [] - for node in element: - if isinstance(node, nodes.system_message): - node['backrefs'] = [] - messages.append(node) - error = self.state_machine.reporter.error( - 'Error in "%s" directive: may contain a single paragraph ' - 'only.' % (self.name), line=self.lineno) - messages.append(error) - return messages - else: - return element[0].children - - -class Unicode(Directive): - - r""" - Convert Unicode character codes (numbers) to characters. Codes may be - decimal numbers, hexadecimal numbers (prefixed by ``0x``, ``x``, ``\x``, - ``U+``, ``u``, or ``\u``; e.g. ``U+262E``), or XML-style numeric character - entities (e.g. ``☮``). Text following ".." is a comment and is - ignored. Spaces are ignored, and any other text remains as-is. - """ - - required_arguments = 1 - optional_arguments = 0 - final_argument_whitespace = True - option_spec = {'trim': directives.flag, - 'ltrim': directives.flag, - 'rtrim': directives.flag} - - comment_pattern = re.compile(r'( |\n|^)\.\. ') - - def run(self): - if not isinstance(self.state, states.SubstitutionDef): - raise self.error( - 'Invalid context: the "%s" directive can only be used within ' - 'a substitution definition.' % self.name) - substitution_definition = self.state_machine.node - if self.options.has_key('trim'): - substitution_definition.attributes['ltrim'] = 1 - substitution_definition.attributes['rtrim'] = 1 - if self.options.has_key('ltrim'): - substitution_definition.attributes['ltrim'] = 1 - if self.options.has_key('rtrim'): - substitution_definition.attributes['rtrim'] = 1 - codes = self.comment_pattern.split(self.arguments[0])[0].split() - element = nodes.Element() - for code in codes: - try: - decoded = directives.unicode_code(code) - except ValueError, err: - raise self.error( - 'Invalid character code: %s\n%s: %s' - % (code, err.class.name, err)) - element += nodes.Text(decoded) - return element.children - - -class Class(Directive): - - """ - Set a "class" attribute on the directive content or the next element. - When applied to the next element, a "pending" element is inserted, and a - transform does the work later. - """ - - required_arguments = 1 - optional_arguments = 0 - final_argument_whitespace = True - has_content = True - - def run(self): - try: - class_value = directives.class_option(self.arguments[0]) - except ValueError: - raise self.error( - 'Invalid class attribute value for "%s" directive: "%s".' - % (self.name, self.arguments[0])) - node_list = [] - if self.content: - container = nodes.Element() - self.state.nested_parse(self.content, self.content_offset, - container) - for node in container: - node['classes'].extend(class_value) - node_list.extend(container.children) - else: - pending = nodes.pending( - misc.ClassAttribute, - {'class': class_value, 'directive': self.name}, - self.block_text) - self.state_machine.document.note_pending(pending) - node_list.append(pending) - return node_list - - -class Role(Directive): - - has_content = True - - argument_pattern = re.compile(r'(%s)\s($\s(%s)\s$\s)?$' - % ((states.Inliner.simplename,) * 2)) - - def run(self): - """Dynamically create and register a custom interpreted text role.""" - if self.content_offset > self.lineno or not self.content: - raise self.error('"%s" directive requires arguments on the first ' - 'line.' % self.name) - args = self.content[0] - match = self.argument_pattern.match(args) - if not match: - raise self.error('"%s" directive arguments not valid role names: ' - '"%s".' % (self.name, args)) - new_role_name = match.group(1) - base_role_name = match.group(3) - messages = [] - if base_role_name: - base_role, messages = roles.role( - base_role_name, self.state_machine.language, self.lineno, - self.state.reporter) - if base_role is None: - error = self.state.reporter.error( - 'Unknown interpreted text role "%s".' % base_role_name, - nodes.literal_block(self.block_text, self.block_text), - line=self.lineno) - return messages + [error] - else: - base_role = roles.generic_custom_role - assert not hasattr(base_role, 'arguments'), ( - 'Supplemental directive arguments for "%s" directive not ' - 'supported (specified by "%r" role).' % (self.name, base_role)) - try: - converted_role = convert_directive_function(base_role) - (arguments, options, content, content_offset) = ( - self.state.parse_directive_block( - self.content[1:], self.content_offset, converted_role, - option_presets={})) - except states.MarkupError, detail: - error = self.state_machine.reporter.error( - 'Error in "%s" directive:\n%s.' % (self.name, detail), - nodes.literal_block(self.block_text, self.block_text), - line=self.lineno) - return messages + [error] - if not options.has_key('class'): - try: - options['class'] = directives.class_option(new_role_name) - except ValueError, detail: - error = self.state_machine.reporter.error( - 'Invalid argument for "%s" directive:\n%s.' - % (self.name, detail), nodes.literal_block( - self.block_text, self.block_text), line=self.lineno) - return messages + [error] - role = roles.CustomRole(new_role_name, base_role, options, content) - roles.register_local_role(new_role_name, role) - return messages - - -class DefaultRole(Directive): - - """Set the default interpreted text role.""" - - required_arguments = 0 - optional_arguments = 1 - final_argument_whitespace = False - - def run(self): - if not self.arguments: - if roles._roles.has_key(''): - # restore the "default" default role - del roles._roles[''] - return [] - role_name = self.arguments[0] - role, messages = roles.role(role_name, self.state_machine.language, - self.lineno, self.state.reporter) - if role is None: - error = self.state.reporter.error( - 'Unknown interpreted text role "%s".' % role_name, - nodes.literal_block(self.block_text, self.block_text), - line=self.lineno) - return messages + [error] - roles._roles[''] = role - # @@@ should this be local to the document, not the parser? - return messages - - -class Title(Directive): - - required_arguments = 1 - optional_arguments = 0 - final_argument_whitespace = True - - def run(self): - self.state_machine.document['title'] = self.arguments[0] - return [] - - -class Date(Directive): - - has_content = True - - def run(self): - if not isinstance(self.state, states.SubstitutionDef): - raise self.error( - 'Invalid context: the "%s" directive can only be used within ' - 'a substitution definition.' % self.name) - format = '\n'.join(self.content) or '%Y-%m-%d' - text = time.strftime(format) - return [nodes.Text(text)] - - -class TestDirective(Directive): - - """This directive is useful only for testing purposes.""" - - required_arguments = 0 - optional_arguments = 1 - final_argument_whitespace = True - option_spec = {'option': directives.unchanged_required} - has_content = True - - def run(self): - if self.content: - text = '\n'.join(self.content) - info = self.state_machine.reporter.info( - 'Directive processed. Type="%s", arguments=%r, options=%r, ' - 'content:' % (self.name, self.arguments, self.options), - nodes.literal_block(text, text), line=self.lineno) - else: - info = self.state_machine.reporter.info( - 'Directive processed. Type="%s", arguments=%r, options=%r, ' - 'content: None' % (self.name, self.arguments, self.options), - line=self.lineno) - return [info] - -# Old-style, functional definition: -# -# def directive_test_function(name, arguments, options, content, lineno, -# content_offset, block_text, state, state_machine): -# """This directive is useful only for testing purposes.""" -# if content: -# text = '\n'.join(content) -# info = state_machine.reporter.info( -# 'Directive processed. Type="%s", arguments=%r, options=%r, ' -# 'content:' % (name, arguments, options), -# nodes.literal_block(text, text), line=lineno) -# else: -# info = state_machine.reporter.info( -# 'Directive processed. Type="%s", arguments=%r, options=%r, ' -# 'content: None' % (name, arguments, options), line=lineno) -# return [info] -# -# directive_test_function.arguments = (0, 1, 1) -# directive_test_function.options = {'option': directives.unchanged_required} -# directive_test_function.content = 1 diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/directives/parts.py --- a/buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/directives/parts.py Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,123 +0,0 @@ -# $Id: parts.py 4667 2006-07-12 21:40:56Z wiemann $ -# Authors: David Goodger ; Dmitry Jemerov -# Copyright: This module has been placed in the public domain. - -""" -Directives for document parts. -""" - -docformat = 'reStructuredText' - -from docutils import nodes, languages -from docutils.transforms import parts -from docutils.parsers.rst import Directive -from docutils.parsers.rst import directives - - -class Contents(Directive): - - """ - Table of contents. - - The table of contents is generated in two passes: initial parse and - transform. During the initial parse, a 'pending' element is generated - which acts as a placeholder, storing the TOC title and any options - internally. At a later stage in the processing, the 'pending' element is - replaced by a 'topic' element, a title and the table of contents proper. - """ - - backlinks_values = ('top', 'entry', 'none') - - def backlinks(arg): - value = directives.choice(arg, Contents.backlinks_values) - if value == 'none': - return None - else: - return value - - required_arguments = 0 - optional_arguments = 1 - final_argument_whitespace = True - option_spec = {'depth': directives.nonnegative_int, - 'local': directives.flag, - 'backlinks': backlinks, - 'class': directives.class_option} - - def run(self): - if not (self.state_machine.match_titles - or isinstance(self.state_machine.node, nodes.sidebar)): - raise self.error('The "%s" directive may not be used within ' - 'topics or body elements.' % self.name) - document = self.state_machine.document - language = languages.get_language(document.settings.language_code) - if self.arguments: - title_text = self.arguments[0] - text_nodes, messages = self.state.inline_text(title_text, - self.lineno) - title = nodes.title(title_text, '', text_nodes) - else: - messages = [] - if self.options.has_key('local'): - title = None - else: - title = nodes.title('', language.labels['contents']) - topic = nodes.topic(classes=['contents']) - topic['classes'] += self.options.get('class', []) - if self.options.has_key('local'): - topic['classes'].append('local') - if title: - name = title.astext() - topic += title - else: - name = language.labels['contents'] - name = nodes.fully_normalize_name(name) - if not document.has_name(name): - topic['names'].append(name) - document.note_implicit_target(topic) - pending = nodes.pending(parts.Contents, rawsource=self.block_text) - pending.details.update(self.options) - document.note_pending(pending) - topic += pending - return [topic] + messages - - -class Sectnum(Directive): - - """Automatic section numbering.""" - - option_spec = {'depth': int, - 'start': int, - 'prefix': directives.unchanged_required, - 'suffix': directives.unchanged_required} - - def run(self): - pending = nodes.pending(parts.SectNum) - pending.details.update(self.options) - self.state_machine.document.note_pending(pending) - return [pending] - - -class Header(Directive): - - """Contents of document header.""" - - has_content = True - - def run(self): - self.assert_has_content() - header = self.state_machine.document.get_decoration().get_header() - self.state.nested_parse(self.content, self.content_offset, header) - return [] - - -class Footer(Directive): - - """Contents of document footer.""" - - has_content = True - - def run(self): - self.assert_has_content() - footer = self.state_machine.document.get_decoration().get_footer() - self.state.nested_parse(self.content, self.content_offset, footer) - return [] diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/directives/references.py --- a/buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/directives/references.py Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,28 +0,0 @@ -# $Id: references.py 4667 2006-07-12 21:40:56Z wiemann $ -# Authors: David Goodger ; Dmitry Jemerov -# Copyright: This module has been placed in the public domain. - -""" -Directives for references and targets. -""" - -docformat = 'reStructuredText' - -from docutils import nodes -from docutils.transforms import references -from docutils.parsers.rst import Directive -from docutils.parsers.rst import directives - - -class TargetNotes(Directive): - - """Target footnote generation.""" - - option_spec = {'class': directives.class_option} - - def run(self): - pending = nodes.pending(references.TargetNotes) - pending.details.update(self.options) - self.state_machine.document.note_pending(pending) - nodelist = [pending] - return nodelist diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/directives/tables.py --- a/buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/directives/tables.py Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,444 +0,0 @@ -# $Id: tables.py 4667 2006-07-12 21:40:56Z wiemann $ -# Authors: David Goodger ; David Priest -# Copyright: This module has been placed in the public domain. - -""" -Directives for table elements. -""" - -docformat = 'reStructuredText' - - -import sys -import os.path -from docutils import io, nodes, statemachine, utils -from docutils.utils import SystemMessagePropagation -from docutils.parsers.rst import Directive -from docutils.parsers.rst import directives - -try: - import csv # new in Python 2.3 -except ImportError: - csv = None - - -class Table(Directive): - - """ - Generic table base class. - """ - - required_arguments = 0 - optional_arguments = 1 - final_argument_whitespace = True - option_spec = {'class': directives.class_option} - has_content = True - - def make_title(self): - if self.arguments: - title_text = self.arguments[0] - text_nodes, messages = self.state.inline_text(title_text, - self.lineno) - title = nodes.title(title_text, '', text_nodes) - else: - title = None - messages = [] - return title, messages - - def process_header_option(self): - source = self.state_machine.get_source(self.lineno - 1) - table_head = [] - max_header_cols = 0 - if self.options.has_key('header'): # separate table header in option - rows, max_header_cols = self.parse_csv_data_into_rows( - self.options['header'].split('\n'), self.HeaderDialect(), - source) - table_head.extend(rows) - return table_head, max_header_cols - - def check_table_dimensions(self, rows, header_rows, stub_columns): - if len(rows) < header_rows: - error = self.state_machine.reporter.error( - '%s header row(s) specified but only %s row(s) of data ' - 'supplied ("%s" directive).' - % (header_rows, len(rows), self.name), nodes.literal_block( - self.block_text, self.block_text), line=self.lineno) - raise SystemMessagePropagation(error) - if len(rows) == header_rows > 0: - error = self.state_machine.reporter.error( - 'Insufficient data supplied (%s row(s)); no data remaining ' - 'for table body, required by "%s" directive.' - % (len(rows), self.name), nodes.literal_block( - self.block_text, self.block_text), line=self.lineno) - raise SystemMessagePropagation(error) - for row in rows: - if len(row) < stub_columns: - error = self.state_machine.reporter.error( - '%s stub column(s) specified but only %s columns(s) of ' - 'data supplied ("%s" directive).' % - (stub_columns, len(row), self.name), nodes.literal_block( - self.block_text, self.block_text), line=self.lineno) - raise SystemMessagePropagation(error) - if len(row) == stub_columns > 0: - error = self.state_machine.reporter.error( - 'Insufficient data supplied (%s columns(s)); no data remaining ' - 'for table body, required by "%s" directive.' - % (len(row), self.name), nodes.literal_block( - self.block_text, self.block_text), line=self.lineno) - raise SystemMessagePropagation(error) - - def get_column_widths(self, max_cols): - if self.options.has_key('widths'): - col_widths = self.options['widths'] - if len(col_widths) != max_cols: - error = self.state_machine.reporter.error( - '"%s" widths do not match the number of columns in table ' - '(%s).' % (self.name, max_cols), nodes.literal_block( - self.block_text, self.block_text), line=self.lineno) - raise SystemMessagePropagation(error) - elif max_cols: - col_widths = [100 // max_cols] * max_cols - else: - error = self.state_machine.reporter.error( - 'No table data detected in CSV file.', nodes.literal_block( - self.block_text, self.block_text), line=self.lineno) - raise SystemMessagePropagation(error) - return col_widths - - def extend_short_rows_with_empty_cells(self, columns, parts): - for part in parts: - for row in part: - if len(row) < columns: - row.extend([(0, 0, 0, [])] * (columns - len(row))) - - -class RSTTable(Table): - - def run(self): - if not self.content: - warning = self.state_machine.reporter.warning( - 'Content block expected for the "%s" directive; none found.' - % self.name, nodes.literal_block( - self.block_text, self.block_text), line=self.lineno) - return [warning] - title, messages = self.make_title() - node = nodes.Element() # anonymous container for parsing - self.state.nested_parse(self.content, self.content_offset, node) - if len(node) != 1 or not isinstance(node[0], nodes.table): - error = self.state_machine.reporter.error( - 'Error parsing content block for the "%s" directive: exactly ' - 'one table expected.' % self.name, nodes.literal_block( - self.block_text, self.block_text), line=self.lineno) - return [error] - table_node = node[0] - table_node['classes'] += self.options.get('class', []) - if title: - table_node.insert(0, title) - return [table_node] + messages - - -class CSVTable(Table): - - option_spec = {'header-rows': directives.nonnegative_int, - 'stub-columns': directives.nonnegative_int, - 'header': directives.unchanged, - 'widths': directives.positive_int_list, - 'file': directives.path, - 'url': directives.uri, - 'encoding': directives.encoding, - 'class': directives.class_option, - # field delimiter char - 'delim': directives.single_char_or_whitespace_or_unicode, - # treat whitespace after delimiter as significant - 'keepspace': directives.flag, - # text field quote/unquote char: - 'quote': directives.single_char_or_unicode, - # char used to escape delim & quote as-needed: - 'escape': directives.single_char_or_unicode,} - - if csv: - - class DocutilsDialect(csv.Dialect): - - """CSV dialect for `csv_table` directive.""" - - delimiter = ',' - quotechar = '"' - doublequote = True - skipinitialspace = True - lineterminator = '\n' - quoting = csv.QUOTE_MINIMAL - - def init(self, options): - if options.has_key('delim'): - self.delimiter = str(options['delim']) - if options.has_key('keepspace'): - self.skipinitialspace = False - if options.has_key('quote'): - self.quotechar = str(options['quote']) - if options.has_key('escape'): - self.doublequote = False - self.escapechar = str(options['escape']) - csv.Dialect.init(self) - - - class HeaderDialect(csv.Dialect): - - """CSV dialect to use for the "header" option data.""" - - delimiter = ',' - quotechar = '"' - escapechar = '\\' - doublequote = False - skipinitialspace = True - lineterminator = '\n' - quoting = csv.QUOTE_MINIMAL - - def check_requirements(self): - if not csv: - error = self.state_machine.reporter.error( - 'The "%s" directive is not compatible with this version of ' - 'Python (%s). Requires the "csv" module, new in Python 2.3.' - % (self.name, sys.version.split()[0]), nodes.literal_block( - self.block_text, self.block_text), line=self.lineno) - raise SystemMessagePropagation(error) - - def run(self): - try: - if (not self.state.document.settings.file_insertion_enabled - and (self.options.has_key('file') - or self.options.has_key('url'))): - warning = self.state_machine.reporter.warning( - 'File and URL access deactivated; ignoring "%s" ' - 'directive.' % self.name, nodes.literal_block( - self.block_text, self.block_text), line=self.lineno) - return [warning] - self.check_requirements() - title, messages = self.make_title() - csv_data, source = self.get_csv_data() - table_head, max_header_cols = self.process_header_option() - rows, max_cols = self.parse_csv_data_into_rows( - csv_data, self.DocutilsDialect(self.options), source) - max_cols = max(max_cols, max_header_cols) - header_rows = self.options.get('header-rows', 0) - stub_columns = self.options.get('stub-columns', 0) - self.check_table_dimensions(rows, header_rows, stub_columns) - table_head.extend(rows[:header_rows]) - table_body = rows[header_rows:] - col_widths = self.get_column_widths(max_cols) - self.extend_short_rows_with_empty_cells(max_cols, - (table_head, table_body)) - except SystemMessagePropagation, detail: - return [detail.args[0]] - except csv.Error, detail: - error = self.state_machine.reporter.error( - 'Error with CSV data in "%s" directive:\n%s' - % (self.name, detail), nodes.literal_block( - self.block_text, self.block_text), line=self.lineno) - return [error] - table = (col_widths, table_head, table_body) - table_node = self.state.build_table(table, self.content_offset, - stub_columns) - table_node['classes'] += self.options.get('class', []) - if title: - table_node.insert(0, title) - return [table_node] + messages - - def get_csv_data(self): - """ - Get CSV data from the directive content, from an external - file, or from a URL reference. - """ - encoding = self.options.get( - 'encoding', self.state.document.settings.input_encoding) - if self.content: - # CSV data is from directive content. - if self.options.has_key('file') or self.options.has_key('url'): - error = self.state_machine.reporter.error( - '"%s" directive may not both specify an external file and' - ' have content.' % self.name, nodes.literal_block( - self.block_text, self.block_text), line=self.lineno) - raise SystemMessagePropagation(error) - source = self.content.source(0) - csv_data = self.content - elif self.options.has_key('file'): - # CSV data is from an external file. - if self.options.has_key('url'): - error = self.state_machine.reporter.error( - 'The "file" and "url" options may not be simultaneously' - ' specified for the "%s" directive.' % self.name, - nodes.literal_block(self.block_text, self.block_text), - line=self.lineno) - raise SystemMessagePropagation(error) - source_dir = os.path.dirname( - os.path.abspath(self.state.document.current_source)) - source = os.path.normpath(os.path.join(source_dir, - self.options['file'])) - source = utils.relative_path(None, source) - try: - self.state.document.settings.record_dependencies.add(source) - csv_file = io.FileInput( - source_path=source, encoding=encoding, - error_handler=(self.state.document.settings.\ - input_encoding_error_handler), - handle_io_errors=None) - csv_data = csv_file.read().splitlines() - except IOError, error: - severe = self.state_machine.reporter.severe( - 'Problems with "%s" directive path:\n%s.' - % (self.name, error), nodes.literal_block( - self.block_text, self.block_text), line=self.lineno) - raise SystemMessagePropagation(severe) - elif self.options.has_key('url'): - # CSV data is from a URL. - # Do not import urllib2 at the top of the module because - # it may fail due to broken SSL dependencies, and it takes - # about 0.15 seconds to load. - import urllib2 - source = self.options['url'] - try: - csv_text = urllib2.urlopen(source).read() - except (urllib2.URLError, IOError, OSError, ValueError), error: - severe = self.state_machine.reporter.severe( - 'Problems with "%s" directive URL "%s":\n%s.' - % (self.name, self.options['url'], error), - nodes.literal_block(self.block_text, self.block_text), - line=self.lineno) - raise SystemMessagePropagation(severe) - csv_file = io.StringInput( - source=csv_text, source_path=source, encoding=encoding, - error_handler=(self.state.document.settings.\ - input_encoding_error_handler)) - csv_data = csv_file.read().splitlines() - else: - error = self.state_machine.reporter.warning( - 'The "%s" directive requires content; none supplied.' - % self.name, nodes.literal_block( - self.block_text, self.block_text), line=self.lineno) - raise SystemMessagePropagation(error) - return csv_data, source - - def parse_csv_data_into_rows(self, csv_data, dialect, source): - # csv.py doesn't do Unicode; encode temporarily as UTF-8 - csv_reader = csv.reader([(line.encode('utf-8') + '\n') - for line in csv_data], - dialect=dialect) - rows = [] - max_cols = 0 - for row in csv_reader: - row_data = [] - for cell in row: - # decode UTF-8 back to Unicode - cell_text = unicode(cell, 'utf-8') - cell_data = (0, 0, 0, statemachine.StringList( - cell_text.splitlines(), source=source)) - row_data.append(cell_data) - rows.append(row_data) - max_cols = max(max_cols, len(row)) - return rows, max_cols - - -class ListTable(Table): - - """ - Implement tables whose data is encoded as a uniform two-level bullet list. - For further ideas, see - http://docutils.sf.net/docs/dev/rst/alternatives.html#list-driven-tables - """ - - option_spec = {'header-rows': directives.nonnegative_int, - 'stub-columns': directives.nonnegative_int, - 'widths': directives.positive_int_list, - 'class': directives.class_option} - - def run(self): - if not self.content: - error = self.state_machine.reporter.error( - 'The "%s" directive is empty; content required.' % self.name, - nodes.literal_block(self.block_text, self.block_text), - line=self.lineno) - return [error] - title, messages = self.make_title() - node = nodes.Element() # anonymous container for parsing - self.state.nested_parse(self.content, self.content_offset, node) - try: - num_cols, col_widths = self.check_list_content(node) - table_data = [[item.children for item in row_list[0]] - for row_list in node[0]] - header_rows = self.options.get('header-rows', 0) - stub_columns = self.options.get('stub-columns', 0) - self.check_table_dimensions(table_data, header_rows, stub_columns) - except SystemMessagePropagation, detail: - return [detail.args[0]] - table_node = self.build_table_from_list(table_data, col_widths, - header_rows, stub_columns) - table_node['classes'] += self.options.get('class', []) - if title: - table_node.insert(0, title) - return [table_node] + messages - - def check_list_content(self, node): - if len(node) != 1 or not isinstance(node[0], nodes.bullet_list): - error = self.state_machine.reporter.error( - 'Error parsing content block for the "%s" directive: ' - 'exactly one bullet list expected.' % self.name, - nodes.literal_block(self.block_text, self.block_text), - line=self.lineno) - raise SystemMessagePropagation(error) - list_node = node[0] - # Check for a uniform two-level bullet list: - for item_index in range(len(list_node)): - item = list_node[item_index] - if len(item) != 1 or not isinstance(item[0], nodes.bullet_list): - error = self.state_machine.reporter.error( - 'Error parsing content block for the "%s" directive: ' - 'two-level bullet list expected, but row %s does not ' - 'contain a second-level bullet list.' - % (self.name, item_index + 1), nodes.literal_block( - self.block_text, self.block_text), line=self.lineno) - raise SystemMessagePropagation(error) - elif item_index: - # ATTN pychecker users: num_cols is guaranteed to be set in the - # "else" clause below for item_index==0, before this branch is - # triggered. - if len(item[0]) != num_cols: - error = self.state_machine.reporter.error( - 'Error parsing content block for the "%s" directive: ' - 'uniform two-level bullet list expected, but row %s ' - 'does not contain the same number of items as row 1 ' - '(%s vs %s).' - % (self.name, item_index + 1, len(item[0]), num_cols), - nodes.literal_block(self.block_text, self.block_text), - line=self.lineno) - raise SystemMessagePropagation(error) - else: - num_cols = len(item[0]) - col_widths = self.get_column_widths(num_cols) - return num_cols, col_widths - - def build_table_from_list(self, table_data, col_widths, header_rows, stub_columns): - table = nodes.table() - tgroup = nodes.tgroup(cols=len(col_widths)) - table += tgroup - for col_width in col_widths: - colspec = nodes.colspec(colwidth=col_width) - if stub_columns: - colspec.attributes['stub'] = 1 - stub_columns -= 1 - tgroup += colspec - rows = [] - for row in table_data: - row_node = nodes.row() - for cell in row: - entry = nodes.entry() - entry += cell - row_node += entry - rows.append(row_node) - if header_rows: - thead = nodes.thead() - thead.extend(rows[:header_rows]) - tgroup += thead - tbody = nodes.tbody() - tbody.extend(rows[header_rows:]) - tgroup += tbody - return table diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/README.txt --- a/buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/README.txt Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,17 +0,0 @@ -============================================ - ``docutils/parsers/rst/include`` Directory -============================================ - -This directory contains standard data files intended for inclusion in -reStructuredText documents. To access these files, use the "include" -directive with the special syntax for standard "include" data files, -angle brackets around the file name:: - - .. include:: - -See the documentation for the `"include" directive` and -`reStructuredText Standard Substitution Definition Sets` for -details. - - http://docutils.sf.net/docs/ref/rst/directives.html#include - http://docutils.sf.net/docs/ref/rst/substitutions.html diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/isoamsa.txt --- a/buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/isoamsa.txt Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,162 +0,0 @@ -.. This data file has been placed in the public domain. -.. Derived from the Unicode character mappings available from - . - Processed by unicode2rstsubs.py, part of Docutils: - . - -.. |angzarr| unicode:: U+0237C .. RIGHT ANGLE WITH DOWNWARDS ZIGZAG ARROW -.. |cirmid| unicode:: U+02AEF .. VERTICAL LINE WITH CIRCLE ABOVE -.. |cudarrl| unicode:: U+02938 .. RIGHT-SIDE ARC CLOCKWISE ARROW -.. |cudarrr| unicode:: U+02935 .. ARROW POINTING RIGHTWARDS THEN CURVING DOWNWARDS -.. |cularr| unicode:: U+021B6 .. ANTICLOCKWISE TOP SEMICIRCLE ARROW -.. |cularrp| unicode:: U+0293D .. TOP ARC ANTICLOCKWISE ARROW WITH PLUS -.. |curarr| unicode:: U+021B7 .. CLOCKWISE TOP SEMICIRCLE ARROW -.. |curarrm| unicode:: U+0293C .. TOP ARC CLOCKWISE ARROW WITH MINUS -.. |Darr| unicode:: U+021A1 .. DOWNWARDS TWO HEADED ARROW -.. |dArr| unicode:: U+021D3 .. DOWNWARDS DOUBLE ARROW -.. |darr2| unicode:: U+021CA .. DOWNWARDS PAIRED ARROWS -.. |ddarr| unicode:: U+021CA .. DOWNWARDS PAIRED ARROWS -.. |DDotrahd| unicode:: U+02911 .. RIGHTWARDS ARROW WITH DOTTED STEM -.. |dfisht| unicode:: U+0297F .. DOWN FISH TAIL -.. |dHar| unicode:: U+02965 .. DOWNWARDS HARPOON WITH BARB LEFT BESIDE DOWNWARDS HARPOON WITH BARB RIGHT -.. |dharl| unicode:: U+021C3 .. DOWNWARDS HARPOON WITH BARB LEFTWARDS -.. |dharr| unicode:: U+021C2 .. DOWNWARDS HARPOON WITH BARB RIGHTWARDS -.. |dlarr| unicode:: U+02199 .. SOUTH WEST ARROW -.. |drarr| unicode:: U+02198 .. SOUTH EAST ARROW -.. |duarr| unicode:: U+021F5 .. DOWNWARDS ARROW LEFTWARDS OF UPWARDS ARROW -.. |duhar| unicode:: U+0296F .. DOWNWARDS HARPOON WITH BARB LEFT BESIDE UPWARDS HARPOON WITH BARB RIGHT -.. |dzigrarr| unicode:: U+027FF .. LONG RIGHTWARDS SQUIGGLE ARROW -.. |erarr| unicode:: U+02971 .. EQUALS SIGN ABOVE RIGHTWARDS ARROW -.. |hArr| unicode:: U+021D4 .. LEFT RIGHT DOUBLE ARROW -.. |harr| unicode:: U+02194 .. LEFT RIGHT ARROW -.. |harrcir| unicode:: U+02948 .. LEFT RIGHT ARROW THROUGH SMALL CIRCLE -.. |harrw| unicode:: U+021AD .. LEFT RIGHT WAVE ARROW -.. |hoarr| unicode:: U+021FF .. LEFT RIGHT OPEN-HEADED ARROW -.. |imof| unicode:: U+022B7 .. IMAGE OF -.. |lAarr| unicode:: U+021DA .. LEFTWARDS TRIPLE ARROW -.. |Larr| unicode:: U+0219E .. LEFTWARDS TWO HEADED ARROW -.. |larr2| unicode:: U+021C7 .. LEFTWARDS PAIRED ARROWS -.. |larrbfs| unicode:: U+0291F .. LEFTWARDS ARROW FROM BAR TO BLACK DIAMOND -.. |larrfs| unicode:: U+0291D .. LEFTWARDS ARROW TO BLACK DIAMOND -.. |larrhk| unicode:: U+021A9 .. LEFTWARDS ARROW WITH HOOK -.. |larrlp| unicode:: U+021AB .. LEFTWARDS ARROW WITH LOOP -.. |larrpl| unicode:: U+02939 .. LEFT-SIDE ARC ANTICLOCKWISE ARROW -.. |larrsim| unicode:: U+02973 .. LEFTWARDS ARROW ABOVE TILDE OPERATOR -.. |larrtl| unicode:: U+021A2 .. LEFTWARDS ARROW WITH TAIL -.. |lAtail| unicode:: U+0291B .. LEFTWARDS DOUBLE ARROW-TAIL -.. |latail| unicode:: U+02919 .. LEFTWARDS ARROW-TAIL -.. |lBarr| unicode:: U+0290E .. LEFTWARDS TRIPLE DASH ARROW -.. |lbarr| unicode:: U+0290C .. LEFTWARDS DOUBLE DASH ARROW -.. |ldca| unicode:: U+02936 .. ARROW POINTING DOWNWARDS THEN CURVING LEFTWARDS -.. |ldrdhar| unicode:: U+02967 .. LEFTWARDS HARPOON WITH BARB DOWN ABOVE RIGHTWARDS HARPOON WITH BARB DOWN -.. |ldrushar| unicode:: U+0294B .. LEFT BARB DOWN RIGHT BARB UP HARPOON -.. |ldsh| unicode:: U+021B2 .. DOWNWARDS ARROW WITH TIP LEFTWARDS -.. |lfisht| unicode:: U+0297C .. LEFT FISH TAIL -.. |lHar| unicode:: U+02962 .. LEFTWARDS HARPOON WITH BARB UP ABOVE LEFTWARDS HARPOON WITH BARB DOWN -.. |lhard| unicode:: U+021BD .. LEFTWARDS HARPOON WITH BARB DOWNWARDS -.. |lharu| unicode:: U+021BC .. LEFTWARDS HARPOON WITH BARB UPWARDS -.. |lharul| unicode:: U+0296A .. LEFTWARDS HARPOON WITH BARB UP ABOVE LONG DASH -.. |llarr| unicode:: U+021C7 .. LEFTWARDS PAIRED ARROWS -.. |llhard| unicode:: U+0296B .. LEFTWARDS HARPOON WITH BARB DOWN BELOW LONG DASH -.. |loarr| unicode:: U+021FD .. LEFTWARDS OPEN-HEADED ARROW -.. |lrarr| unicode:: U+021C6 .. LEFTWARDS ARROW OVER RIGHTWARDS ARROW -.. |lrarr2| unicode:: U+021C6 .. LEFTWARDS ARROW OVER RIGHTWARDS ARROW -.. |lrhar| unicode:: U+021CB .. LEFTWARDS HARPOON OVER RIGHTWARDS HARPOON -.. |lrhar2| unicode:: U+021CB .. LEFTWARDS HARPOON OVER RIGHTWARDS HARPOON -.. |lrhard| unicode:: U+0296D .. RIGHTWARDS HARPOON WITH BARB DOWN BELOW LONG DASH -.. |lsh| unicode:: U+021B0 .. UPWARDS ARROW WITH TIP LEFTWARDS -.. |lurdshar| unicode:: U+0294A .. LEFT BARB UP RIGHT BARB DOWN HARPOON -.. |luruhar| unicode:: U+02966 .. LEFTWARDS HARPOON WITH BARB UP ABOVE RIGHTWARDS HARPOON WITH BARB UP -.. |Map| unicode:: U+02905 .. RIGHTWARDS TWO-HEADED ARROW FROM BAR -.. |map| unicode:: U+021A6 .. RIGHTWARDS ARROW FROM BAR -.. |midcir| unicode:: U+02AF0 .. VERTICAL LINE WITH CIRCLE BELOW -.. |mumap| unicode:: U+022B8 .. MULTIMAP -.. |nearhk| unicode:: U+02924 .. NORTH EAST ARROW WITH HOOK -.. |neArr| unicode:: U+021D7 .. NORTH EAST DOUBLE ARROW -.. |nearr| unicode:: U+02197 .. NORTH EAST ARROW -.. |nesear| unicode:: U+02928 .. NORTH EAST ARROW AND SOUTH EAST ARROW -.. |nhArr| unicode:: U+021CE .. LEFT RIGHT DOUBLE ARROW WITH STROKE -.. |nharr| unicode:: U+021AE .. LEFT RIGHT ARROW WITH STROKE -.. |nlArr| unicode:: U+021CD .. LEFTWARDS DOUBLE ARROW WITH STROKE -.. |nlarr| unicode:: U+0219A .. LEFTWARDS ARROW WITH STROKE -.. |nrArr| unicode:: U+021CF .. RIGHTWARDS DOUBLE ARROW WITH STROKE -.. |nrarr| unicode:: U+0219B .. RIGHTWARDS ARROW WITH STROKE -.. |nrarrc| unicode:: U+02933 U+00338 .. WAVE ARROW POINTING DIRECTLY RIGHT with slash -.. |nrarrw| unicode:: U+0219D U+00338 .. RIGHTWARDS WAVE ARROW with slash -.. |nvHarr| unicode:: U+02904 .. LEFT RIGHT DOUBLE ARROW WITH VERTICAL STROKE -.. |nvlArr| unicode:: U+02902 .. LEFTWARDS DOUBLE ARROW WITH VERTICAL STROKE -.. |nvrArr| unicode:: U+02903 .. RIGHTWARDS DOUBLE ARROW WITH VERTICAL STROKE -.. |nwarhk| unicode:: U+02923 .. NORTH WEST ARROW WITH HOOK -.. |nwArr| unicode:: U+021D6 .. NORTH WEST DOUBLE ARROW -.. |nwarr| unicode:: U+02196 .. NORTH WEST ARROW -.. |nwnear| unicode:: U+02927 .. NORTH WEST ARROW AND NORTH EAST ARROW -.. |olarr| unicode:: U+021BA .. ANTICLOCKWISE OPEN CIRCLE ARROW -.. |orarr| unicode:: U+021BB .. CLOCKWISE OPEN CIRCLE ARROW -.. |origof| unicode:: U+022B6 .. ORIGINAL OF -.. |rAarr| unicode:: U+021DB .. RIGHTWARDS TRIPLE ARROW -.. |Rarr| unicode:: U+021A0 .. RIGHTWARDS TWO HEADED ARROW -.. |rarr2| unicode:: U+021C9 .. RIGHTWARDS PAIRED ARROWS -.. |rarrap| unicode:: U+02975 .. RIGHTWARDS ARROW ABOVE ALMOST EQUAL TO -.. |rarrbfs| unicode:: U+02920 .. RIGHTWARDS ARROW FROM BAR TO BLACK DIAMOND -.. |rarrc| unicode:: U+02933 .. WAVE ARROW POINTING DIRECTLY RIGHT -.. |rarrfs| unicode:: U+0291E .. RIGHTWARDS ARROW TO BLACK DIAMOND -.. |rarrhk| unicode:: U+021AA .. RIGHTWARDS ARROW WITH HOOK -.. |rarrlp| unicode:: U+021AC .. RIGHTWARDS ARROW WITH LOOP -.. |rarrpl| unicode:: U+02945 .. RIGHTWARDS ARROW WITH PLUS BELOW -.. |rarrsim| unicode:: U+02974 .. RIGHTWARDS ARROW ABOVE TILDE OPERATOR -.. |Rarrtl| unicode:: U+02916 .. RIGHTWARDS TWO-HEADED ARROW WITH TAIL -.. |rarrtl| unicode:: U+021A3 .. RIGHTWARDS ARROW WITH TAIL -.. |rarrw| unicode:: U+0219D .. RIGHTWARDS WAVE ARROW -.. |rAtail| unicode:: U+0291C .. RIGHTWARDS DOUBLE ARROW-TAIL -.. |ratail| unicode:: U+0291A .. RIGHTWARDS ARROW-TAIL -.. |RBarr| unicode:: U+02910 .. RIGHTWARDS TWO-HEADED TRIPLE DASH ARROW -.. |rBarr| unicode:: U+0290F .. RIGHTWARDS TRIPLE DASH ARROW -.. |rbarr| unicode:: U+0290D .. RIGHTWARDS DOUBLE DASH ARROW -.. |rdca| unicode:: U+02937 .. ARROW POINTING DOWNWARDS THEN CURVING RIGHTWARDS -.. |rdldhar| unicode:: U+02969 .. RIGHTWARDS HARPOON WITH BARB DOWN ABOVE LEFTWARDS HARPOON WITH BARB DOWN -.. |rdsh| unicode:: U+021B3 .. DOWNWARDS ARROW WITH TIP RIGHTWARDS -.. |rfisht| unicode:: U+0297D .. RIGHT FISH TAIL -.. |rHar| unicode:: U+02964 .. RIGHTWARDS HARPOON WITH BARB UP ABOVE RIGHTWARDS HARPOON WITH BARB DOWN -.. |rhard| unicode:: U+021C1 .. RIGHTWARDS HARPOON WITH BARB DOWNWARDS -.. |rharu| unicode:: U+021C0 .. RIGHTWARDS HARPOON WITH BARB UPWARDS -.. |rharul| unicode:: U+0296C .. RIGHTWARDS HARPOON WITH BARB UP ABOVE LONG DASH -.. |rlarr| unicode:: U+021C4 .. RIGHTWARDS ARROW OVER LEFTWARDS ARROW -.. |rlarr2| unicode:: U+021C4 .. RIGHTWARDS ARROW OVER LEFTWARDS ARROW -.. |rlhar| unicode:: U+021CC .. RIGHTWARDS HARPOON OVER LEFTWARDS HARPOON -.. |rlhar2| unicode:: U+021CC .. RIGHTWARDS HARPOON OVER LEFTWARDS HARPOON -.. |roarr| unicode:: U+021FE .. RIGHTWARDS OPEN-HEADED ARROW -.. |rrarr| unicode:: U+021C9 .. RIGHTWARDS PAIRED ARROWS -.. |rsh| unicode:: U+021B1 .. UPWARDS ARROW WITH TIP RIGHTWARDS -.. |ruluhar| unicode:: U+02968 .. RIGHTWARDS HARPOON WITH BARB UP ABOVE LEFTWARDS HARPOON WITH BARB UP -.. |searhk| unicode:: U+02925 .. SOUTH EAST ARROW WITH HOOK -.. |seArr| unicode:: U+021D8 .. SOUTH EAST DOUBLE ARROW -.. |searr| unicode:: U+02198 .. SOUTH EAST ARROW -.. |seswar| unicode:: U+02929 .. SOUTH EAST ARROW AND SOUTH WEST ARROW -.. |simrarr| unicode:: U+02972 .. TILDE OPERATOR ABOVE RIGHTWARDS ARROW -.. |slarr| unicode:: U+02190 .. LEFTWARDS ARROW -.. |srarr| unicode:: U+02192 .. RIGHTWARDS ARROW -.. |swarhk| unicode:: U+02926 .. SOUTH WEST ARROW WITH HOOK -.. |swArr| unicode:: U+021D9 .. SOUTH WEST DOUBLE ARROW -.. |swarr| unicode:: U+02199 .. SOUTH WEST ARROW -.. |swnwar| unicode:: U+0292A .. SOUTH WEST ARROW AND NORTH WEST ARROW -.. |Uarr| unicode:: U+0219F .. UPWARDS TWO HEADED ARROW -.. |uArr| unicode:: U+021D1 .. UPWARDS DOUBLE ARROW -.. |uarr2| unicode:: U+021C8 .. UPWARDS PAIRED ARROWS -.. |Uarrocir| unicode:: U+02949 .. UPWARDS TWO-HEADED ARROW FROM SMALL CIRCLE -.. |udarr| unicode:: U+021C5 .. UPWARDS ARROW LEFTWARDS OF DOWNWARDS ARROW -.. |udhar| unicode:: U+0296E .. UPWARDS HARPOON WITH BARB LEFT BESIDE DOWNWARDS HARPOON WITH BARB RIGHT -.. |ufisht| unicode:: U+0297E .. UP FISH TAIL -.. |uHar| unicode:: U+02963 .. UPWARDS HARPOON WITH BARB LEFT BESIDE UPWARDS HARPOON WITH BARB RIGHT -.. |uharl| unicode:: U+021BF .. UPWARDS HARPOON WITH BARB LEFTWARDS -.. |uharr| unicode:: U+021BE .. UPWARDS HARPOON WITH BARB RIGHTWARDS -.. |uuarr| unicode:: U+021C8 .. UPWARDS PAIRED ARROWS -.. |vArr| unicode:: U+021D5 .. UP DOWN DOUBLE ARROW -.. |varr| unicode:: U+02195 .. UP DOWN ARROW -.. |xhArr| unicode:: U+027FA .. LONG LEFT RIGHT DOUBLE ARROW -.. |xharr| unicode:: U+027F7 .. LONG LEFT RIGHT ARROW -.. |xlArr| unicode:: U+027F8 .. LONG LEFTWARDS DOUBLE ARROW -.. |xlarr| unicode:: U+027F5 .. LONG LEFTWARDS ARROW -.. |xmap| unicode:: U+027FC .. LONG RIGHTWARDS ARROW FROM BAR -.. |xrArr| unicode:: U+027F9 .. LONG RIGHTWARDS DOUBLE ARROW -.. |xrarr| unicode:: U+027F6 .. LONG RIGHTWARDS ARROW -.. |zigrarr| unicode:: U+021DD .. RIGHTWARDS SQUIGGLE ARROW diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/isoamsb.txt --- a/buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/isoamsb.txt Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,126 +0,0 @@ -.. This data file has been placed in the public domain. -.. Derived from the Unicode character mappings available from - . - Processed by unicode2rstsubs.py, part of Docutils: - . - -.. |ac| unicode:: U+0223E .. INVERTED LAZY S -.. |acE| unicode:: U+0223E U+00333 .. INVERTED LAZY S with double underline -.. |amalg| unicode:: U+02A3F .. AMALGAMATION OR COPRODUCT -.. |barvee| unicode:: U+022BD .. NOR -.. |Barwed| unicode:: U+02306 .. PERSPECTIVE -.. |barwed| unicode:: U+02305 .. PROJECTIVE -.. |bsolb| unicode:: U+029C5 .. SQUARED FALLING DIAGONAL SLASH -.. |Cap| unicode:: U+022D2 .. DOUBLE INTERSECTION -.. |capand| unicode:: U+02A44 .. INTERSECTION WITH LOGICAL AND -.. |capbrcup| unicode:: U+02A49 .. INTERSECTION ABOVE BAR ABOVE UNION -.. |capcap| unicode:: U+02A4B .. INTERSECTION BESIDE AND JOINED WITH INTERSECTION -.. |capcup| unicode:: U+02A47 .. INTERSECTION ABOVE UNION -.. |capdot| unicode:: U+02A40 .. INTERSECTION WITH DOT -.. |caps| unicode:: U+02229 U+0FE00 .. INTERSECTION with serifs -.. |ccaps| unicode:: U+02A4D .. CLOSED INTERSECTION WITH SERIFS -.. |ccups| unicode:: U+02A4C .. CLOSED UNION WITH SERIFS -.. |ccupssm| unicode:: U+02A50 .. CLOSED UNION WITH SERIFS AND SMASH PRODUCT -.. |coprod| unicode:: U+02210 .. N-ARY COPRODUCT -.. |Cup| unicode:: U+022D3 .. DOUBLE UNION -.. |cupbrcap| unicode:: U+02A48 .. UNION ABOVE BAR ABOVE INTERSECTION -.. |cupcap| unicode:: U+02A46 .. UNION ABOVE INTERSECTION -.. |cupcup| unicode:: U+02A4A .. UNION BESIDE AND JOINED WITH UNION -.. |cupdot| unicode:: U+0228D .. MULTISET MULTIPLICATION -.. |cupor| unicode:: U+02A45 .. UNION WITH LOGICAL OR -.. |cups| unicode:: U+0222A U+0FE00 .. UNION with serifs -.. |cuvee| unicode:: U+022CE .. CURLY LOGICAL OR -.. |cuwed| unicode:: U+022CF .. CURLY LOGICAL AND -.. |Dagger| unicode:: U+02021 .. DOUBLE DAGGER -.. |dagger| unicode:: U+02020 .. DAGGER -.. |diam| unicode:: U+022C4 .. DIAMOND OPERATOR -.. |divonx| unicode:: U+022C7 .. DIVISION TIMES -.. |eplus| unicode:: U+02A71 .. EQUALS SIGN ABOVE PLUS SIGN -.. |hercon| unicode:: U+022B9 .. HERMITIAN CONJUGATE MATRIX -.. |intcal| unicode:: U+022BA .. INTERCALATE -.. |iprod| unicode:: U+02A3C .. INTERIOR PRODUCT -.. |loplus| unicode:: U+02A2D .. PLUS SIGN IN LEFT HALF CIRCLE -.. |lotimes| unicode:: U+02A34 .. MULTIPLICATION SIGN IN LEFT HALF CIRCLE -.. |lthree| unicode:: U+022CB .. LEFT SEMIDIRECT PRODUCT -.. |ltimes| unicode:: U+022C9 .. LEFT NORMAL FACTOR SEMIDIRECT PRODUCT -.. |midast| unicode:: U+0002A .. ASTERISK -.. |minusb| unicode:: U+0229F .. SQUARED MINUS -.. |minusd| unicode:: U+02238 .. DOT MINUS -.. |minusdu| unicode:: U+02A2A .. MINUS SIGN WITH DOT BELOW -.. |ncap| unicode:: U+02A43 .. INTERSECTION WITH OVERBAR -.. |ncup| unicode:: U+02A42 .. UNION WITH OVERBAR -.. |oast| unicode:: U+0229B .. CIRCLED ASTERISK OPERATOR -.. |ocir| unicode:: U+0229A .. CIRCLED RING OPERATOR -.. |odash| unicode:: U+0229D .. CIRCLED DASH -.. |odiv| unicode:: U+02A38 .. CIRCLED DIVISION SIGN -.. |odot| unicode:: U+02299 .. CIRCLED DOT OPERATOR -.. |odsold| unicode:: U+029BC .. CIRCLED ANTICLOCKWISE-ROTATED DIVISION SIGN -.. |ofcir| unicode:: U+029BF .. CIRCLED BULLET -.. |ogt| unicode:: U+029C1 .. CIRCLED GREATER-THAN -.. |ohbar| unicode:: U+029B5 .. CIRCLE WITH HORIZONTAL BAR -.. |olcir| unicode:: U+029BE .. CIRCLED WHITE BULLET -.. |olt| unicode:: U+029C0 .. CIRCLED LESS-THAN -.. |omid| unicode:: U+029B6 .. CIRCLED VERTICAL BAR -.. |ominus| unicode:: U+02296 .. CIRCLED MINUS -.. |opar| unicode:: U+029B7 .. CIRCLED PARALLEL -.. |operp| unicode:: U+029B9 .. CIRCLED PERPENDICULAR -.. |oplus| unicode:: U+02295 .. CIRCLED PLUS -.. |osol| unicode:: U+02298 .. CIRCLED DIVISION SLASH -.. |Otimes| unicode:: U+02A37 .. MULTIPLICATION SIGN IN DOUBLE CIRCLE -.. |otimes| unicode:: U+02297 .. CIRCLED TIMES -.. |otimesas| unicode:: U+02A36 .. CIRCLED MULTIPLICATION SIGN WITH CIRCUMFLEX ACCENT -.. |ovbar| unicode:: U+0233D .. APL FUNCTIONAL SYMBOL CIRCLE STILE -.. |plusacir| unicode:: U+02A23 .. PLUS SIGN WITH CIRCUMFLEX ACCENT ABOVE -.. |plusb| unicode:: U+0229E .. SQUARED PLUS -.. |pluscir| unicode:: U+02A22 .. PLUS SIGN WITH SMALL CIRCLE ABOVE -.. |plusdo| unicode:: U+02214 .. DOT PLUS -.. |plusdu| unicode:: U+02A25 .. PLUS SIGN WITH DOT BELOW -.. |pluse| unicode:: U+02A72 .. PLUS SIGN ABOVE EQUALS SIGN -.. |plussim| unicode:: U+02A26 .. PLUS SIGN WITH TILDE BELOW -.. |plustwo| unicode:: U+02A27 .. PLUS SIGN WITH SUBSCRIPT TWO -.. |prod| unicode:: U+0220F .. N-ARY PRODUCT -.. |race| unicode:: U+029DA .. LEFT DOUBLE WIGGLY FENCE -.. |roplus| unicode:: U+02A2E .. PLUS SIGN IN RIGHT HALF CIRCLE -.. |rotimes| unicode:: U+02A35 .. MULTIPLICATION SIGN IN RIGHT HALF CIRCLE -.. |rthree| unicode:: U+022CC .. RIGHT SEMIDIRECT PRODUCT -.. |rtimes| unicode:: U+022CA .. RIGHT NORMAL FACTOR SEMIDIRECT PRODUCT -.. |sdot| unicode:: U+022C5 .. DOT OPERATOR -.. |sdotb| unicode:: U+022A1 .. SQUARED DOT OPERATOR -.. |setmn| unicode:: U+02216 .. SET MINUS -.. |simplus| unicode:: U+02A24 .. PLUS SIGN WITH TILDE ABOVE -.. |smashp| unicode:: U+02A33 .. SMASH PRODUCT -.. |solb| unicode:: U+029C4 .. SQUARED RISING DIAGONAL SLASH -.. |sqcap| unicode:: U+02293 .. SQUARE CAP -.. |sqcaps| unicode:: U+02293 U+0FE00 .. SQUARE CAP with serifs -.. |sqcup| unicode:: U+02294 .. SQUARE CUP -.. |sqcups| unicode:: U+02294 U+0FE00 .. SQUARE CUP with serifs -.. |ssetmn| unicode:: U+02216 .. SET MINUS -.. |sstarf| unicode:: U+022C6 .. STAR OPERATOR -.. |subdot| unicode:: U+02ABD .. SUBSET WITH DOT -.. |sum| unicode:: U+02211 .. N-ARY SUMMATION -.. |supdot| unicode:: U+02ABE .. SUPERSET WITH DOT -.. |timesb| unicode:: U+022A0 .. SQUARED TIMES -.. |timesbar| unicode:: U+02A31 .. MULTIPLICATION SIGN WITH UNDERBAR -.. |timesd| unicode:: U+02A30 .. MULTIPLICATION SIGN WITH DOT ABOVE -.. |top| unicode:: U+022A4 .. DOWN TACK -.. |tridot| unicode:: U+025EC .. WHITE UP-POINTING TRIANGLE WITH DOT -.. |triminus| unicode:: U+02A3A .. MINUS SIGN IN TRIANGLE -.. |triplus| unicode:: U+02A39 .. PLUS SIGN IN TRIANGLE -.. |trisb| unicode:: U+029CD .. TRIANGLE WITH SERIFS AT BOTTOM -.. |tritime| unicode:: U+02A3B .. MULTIPLICATION SIGN IN TRIANGLE -.. |uplus| unicode:: U+0228E .. MULTISET UNION -.. |veebar| unicode:: U+022BB .. XOR -.. |wedbar| unicode:: U+02A5F .. LOGICAL AND WITH UNDERBAR -.. |wreath| unicode:: U+02240 .. WREATH PRODUCT -.. |xcap| unicode:: U+022C2 .. N-ARY INTERSECTION -.. |xcirc| unicode:: U+025EF .. LARGE CIRCLE -.. |xcup| unicode:: U+022C3 .. N-ARY UNION -.. |xdtri| unicode:: U+025BD .. WHITE DOWN-POINTING TRIANGLE -.. |xodot| unicode:: U+02A00 .. N-ARY CIRCLED DOT OPERATOR -.. |xoplus| unicode:: U+02A01 .. N-ARY CIRCLED PLUS OPERATOR -.. |xotime| unicode:: U+02A02 .. N-ARY CIRCLED TIMES OPERATOR -.. |xsqcup| unicode:: U+02A06 .. N-ARY SQUARE UNION OPERATOR -.. |xuplus| unicode:: U+02A04 .. N-ARY UNION OPERATOR WITH PLUS -.. |xutri| unicode:: U+025B3 .. WHITE UP-POINTING TRIANGLE -.. |xvee| unicode:: U+022C1 .. N-ARY LOGICAL OR -.. |xwedge| unicode:: U+022C0 .. N-ARY LOGICAL AND diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/isoamsc.txt --- a/buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/isoamsc.txt Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,29 +0,0 @@ -.. This data file has been placed in the public domain. -.. Derived from the Unicode character mappings available from - . - Processed by unicode2rstsubs.py, part of Docutils: - . - -.. |dlcorn| unicode:: U+0231E .. BOTTOM LEFT CORNER -.. |drcorn| unicode:: U+0231F .. BOTTOM RIGHT CORNER -.. |gtlPar| unicode:: U+02995 .. DOUBLE LEFT ARC GREATER-THAN BRACKET -.. |langd| unicode:: U+02991 .. LEFT ANGLE BRACKET WITH DOT -.. |lbrke| unicode:: U+0298B .. LEFT SQUARE BRACKET WITH UNDERBAR -.. |lbrksld| unicode:: U+0298F .. LEFT SQUARE BRACKET WITH TICK IN BOTTOM CORNER -.. |lbrkslu| unicode:: U+0298D .. LEFT SQUARE BRACKET WITH TICK IN TOP CORNER -.. |lceil| unicode:: U+02308 .. LEFT CEILING -.. |lfloor| unicode:: U+0230A .. LEFT FLOOR -.. |lmoust| unicode:: U+023B0 .. UPPER LEFT OR LOWER RIGHT CURLY BRACKET SECTION -.. |lpargt| unicode:: U+029A0 .. SPHERICAL ANGLE OPENING LEFT -.. |lparlt| unicode:: U+02993 .. LEFT ARC LESS-THAN BRACKET -.. |ltrPar| unicode:: U+02996 .. DOUBLE RIGHT ARC LESS-THAN BRACKET -.. |rangd| unicode:: U+02992 .. RIGHT ANGLE BRACKET WITH DOT -.. |rbrke| unicode:: U+0298C .. RIGHT SQUARE BRACKET WITH UNDERBAR -.. |rbrksld| unicode:: U+0298E .. RIGHT SQUARE BRACKET WITH TICK IN BOTTOM CORNER -.. |rbrkslu| unicode:: U+02990 .. RIGHT SQUARE BRACKET WITH TICK IN TOP CORNER -.. |rceil| unicode:: U+02309 .. RIGHT CEILING -.. |rfloor| unicode:: U+0230B .. RIGHT FLOOR -.. |rmoust| unicode:: U+023B1 .. UPPER RIGHT OR LOWER LEFT CURLY BRACKET SECTION -.. |rpargt| unicode:: U+02994 .. RIGHT ARC GREATER-THAN BRACKET -.. |ulcorn| unicode:: U+0231C .. TOP LEFT CORNER -.. |urcorn| unicode:: U+0231D .. TOP RIGHT CORNER diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/isoamsn.txt --- a/buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/isoamsn.txt Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,96 +0,0 @@ -.. This data file has been placed in the public domain. -.. Derived from the Unicode character mappings available from - . - Processed by unicode2rstsubs.py, part of Docutils: - . - -.. |gnap| unicode:: U+02A8A .. GREATER-THAN AND NOT APPROXIMATE -.. |gnE| unicode:: U+02269 .. GREATER-THAN BUT NOT EQUAL TO -.. |gne| unicode:: U+02A88 .. GREATER-THAN AND SINGLE-LINE NOT EQUAL TO -.. |gnsim| unicode:: U+022E7 .. GREATER-THAN BUT NOT EQUIVALENT TO -.. |gvnE| unicode:: U+02269 U+0FE00 .. GREATER-THAN BUT NOT EQUAL TO - with vertical stroke -.. |lnap| unicode:: U+02A89 .. LESS-THAN AND NOT APPROXIMATE -.. |lnE| unicode:: U+02268 .. LESS-THAN BUT NOT EQUAL TO -.. |lne| unicode:: U+02A87 .. LESS-THAN AND SINGLE-LINE NOT EQUAL TO -.. |lnsim| unicode:: U+022E6 .. LESS-THAN BUT NOT EQUIVALENT TO -.. |lvnE| unicode:: U+02268 U+0FE00 .. LESS-THAN BUT NOT EQUAL TO - with vertical stroke -.. |nap| unicode:: U+02249 .. NOT ALMOST EQUAL TO -.. |napE| unicode:: U+02A70 U+00338 .. APPROXIMATELY EQUAL OR EQUAL TO with slash -.. |napid| unicode:: U+0224B U+00338 .. TRIPLE TILDE with slash -.. |ncong| unicode:: U+02247 .. NEITHER APPROXIMATELY NOR ACTUALLY EQUAL TO -.. |ncongdot| unicode:: U+02A6D U+00338 .. CONGRUENT WITH DOT ABOVE with slash -.. |nequiv| unicode:: U+02262 .. NOT IDENTICAL TO -.. |ngE| unicode:: U+02267 U+00338 .. GREATER-THAN OVER EQUAL TO with slash -.. |nge| unicode:: U+02271 .. NEITHER GREATER-THAN NOR EQUAL TO -.. |nges| unicode:: U+02A7E U+00338 .. GREATER-THAN OR SLANTED EQUAL TO with slash -.. |nGg| unicode:: U+022D9 U+00338 .. VERY MUCH GREATER-THAN with slash -.. |ngsim| unicode:: U+02275 .. NEITHER GREATER-THAN NOR EQUIVALENT TO -.. |nGt| unicode:: U+0226B U+020D2 .. MUCH GREATER THAN with vertical line -.. |ngt| unicode:: U+0226F .. NOT GREATER-THAN -.. |nGtv| unicode:: U+0226B U+00338 .. MUCH GREATER THAN with slash -.. |nlE| unicode:: U+02266 U+00338 .. LESS-THAN OVER EQUAL TO with slash -.. |nle| unicode:: U+02270 .. NEITHER LESS-THAN NOR EQUAL TO -.. |nles| unicode:: U+02A7D U+00338 .. LESS-THAN OR SLANTED EQUAL TO with slash -.. |nLl| unicode:: U+022D8 U+00338 .. VERY MUCH LESS-THAN with slash -.. |nlsim| unicode:: U+02274 .. NEITHER LESS-THAN NOR EQUIVALENT TO -.. |nLt| unicode:: U+0226A U+020D2 .. MUCH LESS THAN with vertical line -.. |nlt| unicode:: U+0226E .. NOT LESS-THAN -.. |nltri| unicode:: U+022EA .. NOT NORMAL SUBGROUP OF -.. |nltrie| unicode:: U+022EC .. NOT NORMAL SUBGROUP OF OR EQUAL TO -.. |nLtv| unicode:: U+0226A U+00338 .. MUCH LESS THAN with slash -.. |nmid| unicode:: U+02224 .. DOES NOT DIVIDE -.. |npar| unicode:: U+02226 .. NOT PARALLEL TO -.. |npr| unicode:: U+02280 .. DOES NOT PRECEDE -.. |nprcue| unicode:: U+022E0 .. DOES NOT PRECEDE OR EQUAL -.. |npre| unicode:: U+02AAF U+00338 .. PRECEDES ABOVE SINGLE-LINE EQUALS SIGN with slash -.. |nrtri| unicode:: U+022EB .. DOES NOT CONTAIN AS NORMAL SUBGROUP -.. |nrtrie| unicode:: U+022ED .. DOES NOT CONTAIN AS NORMAL SUBGROUP OR EQUAL -.. |nsc| unicode:: U+02281 .. DOES NOT SUCCEED -.. |nsccue| unicode:: U+022E1 .. DOES NOT SUCCEED OR EQUAL -.. |nsce| unicode:: U+02AB0 U+00338 .. SUCCEEDS ABOVE SINGLE-LINE EQUALS SIGN with slash -.. |nsim| unicode:: U+02241 .. NOT TILDE -.. |nsime| unicode:: U+02244 .. NOT ASYMPTOTICALLY EQUAL TO -.. |nsmid| unicode:: U+02224 .. DOES NOT DIVIDE -.. |nspar| unicode:: U+02226 .. NOT PARALLEL TO -.. |nsqsube| unicode:: U+022E2 .. NOT SQUARE IMAGE OF OR EQUAL TO -.. |nsqsupe| unicode:: U+022E3 .. NOT SQUARE ORIGINAL OF OR EQUAL TO -.. |nsub| unicode:: U+02284 .. NOT A SUBSET OF -.. |nsubE| unicode:: U+02AC5 U+00338 .. SUBSET OF ABOVE EQUALS SIGN with slash -.. |nsube| unicode:: U+02288 .. NEITHER A SUBSET OF NOR EQUAL TO -.. |nsup| unicode:: U+02285 .. NOT A SUPERSET OF -.. |nsupE| unicode:: U+02AC6 U+00338 .. SUPERSET OF ABOVE EQUALS SIGN with slash -.. |nsupe| unicode:: U+02289 .. NEITHER A SUPERSET OF NOR EQUAL TO -.. |ntgl| unicode:: U+02279 .. NEITHER GREATER-THAN NOR LESS-THAN -.. |ntlg| unicode:: U+02278 .. NEITHER LESS-THAN NOR GREATER-THAN -.. |nvap| unicode:: U+0224D U+020D2 .. EQUIVALENT TO with vertical line -.. |nVDash| unicode:: U+022AF .. NEGATED DOUBLE VERTICAL BAR DOUBLE RIGHT TURNSTILE -.. |nVdash| unicode:: U+022AE .. DOES NOT FORCE -.. |nvDash| unicode:: U+022AD .. NOT TRUE -.. |nvdash| unicode:: U+022AC .. DOES NOT PROVE -.. |nvge| unicode:: U+02265 U+020D2 .. GREATER-THAN OR EQUAL TO with vertical line -.. |nvgt| unicode:: U+0003E U+020D2 .. GREATER-THAN SIGN with vertical line -.. |nvle| unicode:: U+02264 U+020D2 .. LESS-THAN OR EQUAL TO with vertical line -.. |nvlt| unicode:: U+0003C U+020D2 .. LESS-THAN SIGN with vertical line -.. |nvltrie| unicode:: U+022B4 U+020D2 .. NORMAL SUBGROUP OF OR EQUAL TO with vertical line -.. |nvrtrie| unicode:: U+022B5 U+020D2 .. CONTAINS AS NORMAL SUBGROUP OR EQUAL TO with vertical line -.. |nvsim| unicode:: U+0223C U+020D2 .. TILDE OPERATOR with vertical line -.. |parsim| unicode:: U+02AF3 .. PARALLEL WITH TILDE OPERATOR -.. |prnap| unicode:: U+02AB9 .. PRECEDES ABOVE NOT ALMOST EQUAL TO -.. |prnE| unicode:: U+02AB5 .. PRECEDES ABOVE NOT EQUAL TO -.. |prnsim| unicode:: U+022E8 .. PRECEDES BUT NOT EQUIVALENT TO -.. |rnmid| unicode:: U+02AEE .. DOES NOT DIVIDE WITH REVERSED NEGATION SLASH -.. |scnap| unicode:: U+02ABA .. SUCCEEDS ABOVE NOT ALMOST EQUAL TO -.. |scnE| unicode:: U+02AB6 .. SUCCEEDS ABOVE NOT EQUAL TO -.. |scnsim| unicode:: U+022E9 .. SUCCEEDS BUT NOT EQUIVALENT TO -.. |simne| unicode:: U+02246 .. APPROXIMATELY BUT NOT ACTUALLY EQUAL TO -.. |solbar| unicode:: U+0233F .. APL FUNCTIONAL SYMBOL SLASH BAR -.. |subnE| unicode:: U+02ACB .. SUBSET OF ABOVE NOT EQUAL TO -.. |subne| unicode:: U+0228A .. SUBSET OF WITH NOT EQUAL TO -.. |supnE| unicode:: U+02ACC .. SUPERSET OF ABOVE NOT EQUAL TO -.. |supne| unicode:: U+0228B .. SUPERSET OF WITH NOT EQUAL TO -.. |vnsub| unicode:: U+02282 U+020D2 .. SUBSET OF with vertical line -.. |vnsup| unicode:: U+02283 U+020D2 .. SUPERSET OF with vertical line -.. |vsubnE| unicode:: U+02ACB U+0FE00 .. SUBSET OF ABOVE NOT EQUAL TO - variant with stroke through bottom members -.. |vsubne| unicode:: U+0228A U+0FE00 .. SUBSET OF WITH NOT EQUAL TO - variant with stroke through bottom members -.. |vsupnE| unicode:: U+02ACC U+0FE00 .. SUPERSET OF ABOVE NOT EQUAL TO - variant with stroke through bottom members -.. |vsupne| unicode:: U+0228B U+0FE00 .. SUPERSET OF WITH NOT EQUAL TO - variant with stroke through bottom members diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/isoamso.txt --- a/buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/isoamso.txt Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,62 +0,0 @@ -.. This data file has been placed in the public domain. -.. Derived from the Unicode character mappings available from - . - Processed by unicode2rstsubs.py, part of Docutils: - . - -.. |ang| unicode:: U+02220 .. ANGLE -.. |ange| unicode:: U+029A4 .. ANGLE WITH UNDERBAR -.. |angmsd| unicode:: U+02221 .. MEASURED ANGLE -.. |angmsdaa| unicode:: U+029A8 .. MEASURED ANGLE WITH OPEN ARM ENDING IN ARROW POINTING UP AND RIGHT -.. |angmsdab| unicode:: U+029A9 .. MEASURED ANGLE WITH OPEN ARM ENDING IN ARROW POINTING UP AND LEFT -.. |angmsdac| unicode:: U+029AA .. MEASURED ANGLE WITH OPEN ARM ENDING IN ARROW POINTING DOWN AND RIGHT -.. |angmsdad| unicode:: U+029AB .. MEASURED ANGLE WITH OPEN ARM ENDING IN ARROW POINTING DOWN AND LEFT -.. |angmsdae| unicode:: U+029AC .. MEASURED ANGLE WITH OPEN ARM ENDING IN ARROW POINTING RIGHT AND UP -.. |angmsdaf| unicode:: U+029AD .. MEASURED ANGLE WITH OPEN ARM ENDING IN ARROW POINTING LEFT AND UP -.. |angmsdag| unicode:: U+029AE .. MEASURED ANGLE WITH OPEN ARM ENDING IN ARROW POINTING RIGHT AND DOWN -.. |angmsdah| unicode:: U+029AF .. MEASURED ANGLE WITH OPEN ARM ENDING IN ARROW POINTING LEFT AND DOWN -.. |angrtvb| unicode:: U+022BE .. RIGHT ANGLE WITH ARC -.. |angrtvbd| unicode:: U+0299D .. MEASURED RIGHT ANGLE WITH DOT -.. |bbrk| unicode:: U+023B5 .. BOTTOM SQUARE BRACKET -.. |bbrktbrk| unicode:: U+023B6 .. BOTTOM SQUARE BRACKET OVER TOP SQUARE BRACKET -.. |bemptyv| unicode:: U+029B0 .. REVERSED EMPTY SET -.. |beth| unicode:: U+02136 .. BET SYMBOL -.. |boxbox| unicode:: U+029C9 .. TWO JOINED SQUARES -.. |bprime| unicode:: U+02035 .. REVERSED PRIME -.. |bsemi| unicode:: U+0204F .. REVERSED SEMICOLON -.. |cemptyv| unicode:: U+029B2 .. EMPTY SET WITH SMALL CIRCLE ABOVE -.. |cirE| unicode:: U+029C3 .. CIRCLE WITH TWO HORIZONTAL STROKES TO THE RIGHT -.. |cirscir| unicode:: U+029C2 .. CIRCLE WITH SMALL CIRCLE TO THE RIGHT -.. |comp| unicode:: U+02201 .. COMPLEMENT -.. |daleth| unicode:: U+02138 .. DALET SYMBOL -.. |demptyv| unicode:: U+029B1 .. EMPTY SET WITH OVERBAR -.. |ell| unicode:: U+02113 .. SCRIPT SMALL L -.. |empty| unicode:: U+02205 .. EMPTY SET -.. |emptyv| unicode:: U+02205 .. EMPTY SET -.. |gimel| unicode:: U+02137 .. GIMEL SYMBOL -.. |iiota| unicode:: U+02129 .. TURNED GREEK SMALL LETTER IOTA -.. |image| unicode:: U+02111 .. BLACK-LETTER CAPITAL I -.. |imath| unicode:: U+00131 .. LATIN SMALL LETTER DOTLESS I -.. |inodot| unicode:: U+00131 .. LATIN SMALL LETTER DOTLESS I -.. |jmath| unicode:: U+0006A .. LATIN SMALL LETTER J -.. |jnodot| unicode:: U+0006A .. LATIN SMALL LETTER J -.. |laemptyv| unicode:: U+029B4 .. EMPTY SET WITH LEFT ARROW ABOVE -.. |lltri| unicode:: U+025FA .. LOWER LEFT TRIANGLE -.. |lrtri| unicode:: U+022BF .. RIGHT TRIANGLE -.. |mho| unicode:: U+02127 .. INVERTED OHM SIGN -.. |nang| unicode:: U+02220 U+020D2 .. ANGLE with vertical line -.. |nexist| unicode:: U+02204 .. THERE DOES NOT EXIST -.. |oS| unicode:: U+024C8 .. CIRCLED LATIN CAPITAL LETTER S -.. |planck| unicode:: U+0210F .. PLANCK CONSTANT OVER TWO PI -.. |plankv| unicode:: U+0210F .. PLANCK CONSTANT OVER TWO PI -.. |raemptyv| unicode:: U+029B3 .. EMPTY SET WITH RIGHT ARROW ABOVE -.. |range| unicode:: U+029A5 .. REVERSED ANGLE WITH UNDERBAR -.. |real| unicode:: U+0211C .. BLACK-LETTER CAPITAL R -.. |sbsol| unicode:: U+0FE68 .. SMALL REVERSE SOLIDUS -.. |tbrk| unicode:: U+023B4 .. TOP SQUARE BRACKET -.. |trpezium| unicode:: U+0FFFD .. REPLACEMENT CHARACTER -.. |ultri| unicode:: U+025F8 .. UPPER LEFT TRIANGLE -.. |urtri| unicode:: U+025F9 .. UPPER RIGHT TRIANGLE -.. |vprime| unicode:: U+02032 .. PRIME -.. |vzigzag| unicode:: U+0299A .. VERTICAL ZIGZAG LINE -.. |weierp| unicode:: U+02118 .. SCRIPT CAPITAL P diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/isoamsr.txt --- a/buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/isoamsr.txt Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,191 +0,0 @@ -.. This data file has been placed in the public domain. -.. Derived from the Unicode character mappings available from - . - Processed by unicode2rstsubs.py, part of Docutils: - . - -.. |apE| unicode:: U+02A70 .. APPROXIMATELY EQUAL OR EQUAL TO -.. |ape| unicode:: U+0224A .. ALMOST EQUAL OR EQUAL TO -.. |apid| unicode:: U+0224B .. TRIPLE TILDE -.. |asymp| unicode:: U+02248 .. ALMOST EQUAL TO -.. |Barv| unicode:: U+02AE7 .. SHORT DOWN TACK WITH OVERBAR -.. |bcong| unicode:: U+0224C .. ALL EQUAL TO -.. |bepsi| unicode:: U+003F6 .. GREEK REVERSED LUNATE EPSILON SYMBOL -.. |bowtie| unicode:: U+022C8 .. BOWTIE -.. |bsim| unicode:: U+0223D .. REVERSED TILDE -.. |bsime| unicode:: U+022CD .. REVERSED TILDE EQUALS -.. |bsolhsub| unicode:: U+0005C U+02282 .. REVERSE SOLIDUS, SUBSET OF -.. |bump| unicode:: U+0224E .. GEOMETRICALLY EQUIVALENT TO -.. |bumpE| unicode:: U+02AAE .. EQUALS SIGN WITH BUMPY ABOVE -.. |bumpe| unicode:: U+0224F .. DIFFERENCE BETWEEN -.. |cire| unicode:: U+02257 .. RING EQUAL TO -.. |Colon| unicode:: U+02237 .. PROPORTION -.. |Colone| unicode:: U+02A74 .. DOUBLE COLON EQUAL -.. |colone| unicode:: U+02254 .. COLON EQUALS -.. |congdot| unicode:: U+02A6D .. CONGRUENT WITH DOT ABOVE -.. |csub| unicode:: U+02ACF .. CLOSED SUBSET -.. |csube| unicode:: U+02AD1 .. CLOSED SUBSET OR EQUAL TO -.. |csup| unicode:: U+02AD0 .. CLOSED SUPERSET -.. |csupe| unicode:: U+02AD2 .. CLOSED SUPERSET OR EQUAL TO -.. |cuepr| unicode:: U+022DE .. EQUAL TO OR PRECEDES -.. |cuesc| unicode:: U+022DF .. EQUAL TO OR SUCCEEDS -.. |cupre| unicode:: U+0227C .. PRECEDES OR EQUAL TO -.. |Dashv| unicode:: U+02AE4 .. VERTICAL BAR DOUBLE LEFT TURNSTILE -.. |dashv| unicode:: U+022A3 .. LEFT TACK -.. |easter| unicode:: U+02A6E .. EQUALS WITH ASTERISK -.. |ecir| unicode:: U+02256 .. RING IN EQUAL TO -.. |ecolon| unicode:: U+02255 .. EQUALS COLON -.. |eDDot| unicode:: U+02A77 .. EQUALS SIGN WITH TWO DOTS ABOVE AND TWO DOTS BELOW -.. |eDot| unicode:: U+02251 .. GEOMETRICALLY EQUAL TO -.. |efDot| unicode:: U+02252 .. APPROXIMATELY EQUAL TO OR THE IMAGE OF -.. |eg| unicode:: U+02A9A .. DOUBLE-LINE EQUAL TO OR GREATER-THAN -.. |egs| unicode:: U+02A96 .. SLANTED EQUAL TO OR GREATER-THAN -.. |egsdot| unicode:: U+02A98 .. SLANTED EQUAL TO OR GREATER-THAN WITH DOT INSIDE -.. |el| unicode:: U+02A99 .. DOUBLE-LINE EQUAL TO OR LESS-THAN -.. |els| unicode:: U+02A95 .. SLANTED EQUAL TO OR LESS-THAN -.. |elsdot| unicode:: U+02A97 .. SLANTED EQUAL TO OR LESS-THAN WITH DOT INSIDE -.. |equest| unicode:: U+0225F .. QUESTIONED EQUAL TO -.. |equivDD| unicode:: U+02A78 .. EQUIVALENT WITH FOUR DOTS ABOVE -.. |erDot| unicode:: U+02253 .. IMAGE OF OR APPROXIMATELY EQUAL TO -.. |esdot| unicode:: U+02250 .. APPROACHES THE LIMIT -.. |Esim| unicode:: U+02A73 .. EQUALS SIGN ABOVE TILDE OPERATOR -.. |esim| unicode:: U+02242 .. MINUS TILDE -.. |fork| unicode:: U+022D4 .. PITCHFORK -.. |forkv| unicode:: U+02AD9 .. ELEMENT OF OPENING DOWNWARDS -.. |frown| unicode:: U+02322 .. FROWN -.. |gap| unicode:: U+02A86 .. GREATER-THAN OR APPROXIMATE -.. |gE| unicode:: U+02267 .. GREATER-THAN OVER EQUAL TO -.. |gEl| unicode:: U+02A8C .. GREATER-THAN ABOVE DOUBLE-LINE EQUAL ABOVE LESS-THAN -.. |gel| unicode:: U+022DB .. GREATER-THAN EQUAL TO OR LESS-THAN -.. |ges| unicode:: U+02A7E .. GREATER-THAN OR SLANTED EQUAL TO -.. |gescc| unicode:: U+02AA9 .. GREATER-THAN CLOSED BY CURVE ABOVE SLANTED EQUAL -.. |gesdot| unicode:: U+02A80 .. GREATER-THAN OR SLANTED EQUAL TO WITH DOT INSIDE -.. |gesdoto| unicode:: U+02A82 .. GREATER-THAN OR SLANTED EQUAL TO WITH DOT ABOVE -.. |gesdotol| unicode:: U+02A84 .. GREATER-THAN OR SLANTED EQUAL TO WITH DOT ABOVE LEFT -.. |gesl| unicode:: U+022DB U+0FE00 .. GREATER-THAN slanted EQUAL TO OR LESS-THAN -.. |gesles| unicode:: U+02A94 .. GREATER-THAN ABOVE SLANTED EQUAL ABOVE LESS-THAN ABOVE SLANTED EQUAL -.. |Gg| unicode:: U+022D9 .. VERY MUCH GREATER-THAN -.. |gl| unicode:: U+02277 .. GREATER-THAN OR LESS-THAN -.. |gla| unicode:: U+02AA5 .. GREATER-THAN BESIDE LESS-THAN -.. |glE| unicode:: U+02A92 .. GREATER-THAN ABOVE LESS-THAN ABOVE DOUBLE-LINE EQUAL -.. |glj| unicode:: U+02AA4 .. GREATER-THAN OVERLAPPING LESS-THAN -.. |gsdot| unicode:: U+022D7 .. GREATER-THAN WITH DOT -.. |gsim| unicode:: U+02273 .. GREATER-THAN OR EQUIVALENT TO -.. |gsime| unicode:: U+02A8E .. GREATER-THAN ABOVE SIMILAR OR EQUAL -.. |gsiml| unicode:: U+02A90 .. GREATER-THAN ABOVE SIMILAR ABOVE LESS-THAN -.. |Gt| unicode:: U+0226B .. MUCH GREATER-THAN -.. |gtcc| unicode:: U+02AA7 .. GREATER-THAN CLOSED BY CURVE -.. |gtcir| unicode:: U+02A7A .. GREATER-THAN WITH CIRCLE INSIDE -.. |gtdot| unicode:: U+022D7 .. GREATER-THAN WITH DOT -.. |gtquest| unicode:: U+02A7C .. GREATER-THAN WITH QUESTION MARK ABOVE -.. |gtrarr| unicode:: U+02978 .. GREATER-THAN ABOVE RIGHTWARDS ARROW -.. |homtht| unicode:: U+0223B .. HOMOTHETIC -.. |lap| unicode:: U+02A85 .. LESS-THAN OR APPROXIMATE -.. |lat| unicode:: U+02AAB .. LARGER THAN -.. |late| unicode:: U+02AAD .. LARGER THAN OR EQUAL TO -.. |lates| unicode:: U+02AAD U+0FE00 .. LARGER THAN OR slanted EQUAL -.. |ldot| unicode:: U+022D6 .. LESS-THAN WITH DOT -.. |lE| unicode:: U+02266 .. LESS-THAN OVER EQUAL TO -.. |lEg| unicode:: U+02A8B .. LESS-THAN ABOVE DOUBLE-LINE EQUAL ABOVE GREATER-THAN -.. |leg| unicode:: U+022DA .. LESS-THAN EQUAL TO OR GREATER-THAN -.. |les| unicode:: U+02A7D .. LESS-THAN OR SLANTED EQUAL TO -.. |lescc| unicode:: U+02AA8 .. LESS-THAN CLOSED BY CURVE ABOVE SLANTED EQUAL -.. |lesdot| unicode:: U+02A7F .. LESS-THAN OR SLANTED EQUAL TO WITH DOT INSIDE -.. |lesdoto| unicode:: U+02A81 .. LESS-THAN OR SLANTED EQUAL TO WITH DOT ABOVE -.. |lesdotor| unicode:: U+02A83 .. LESS-THAN OR SLANTED EQUAL TO WITH DOT ABOVE RIGHT -.. |lesg| unicode:: U+022DA U+0FE00 .. LESS-THAN slanted EQUAL TO OR GREATER-THAN -.. |lesges| unicode:: U+02A93 .. LESS-THAN ABOVE SLANTED EQUAL ABOVE GREATER-THAN ABOVE SLANTED EQUAL -.. |lg| unicode:: U+02276 .. LESS-THAN OR GREATER-THAN -.. |lgE| unicode:: U+02A91 .. LESS-THAN ABOVE GREATER-THAN ABOVE DOUBLE-LINE EQUAL -.. |Ll| unicode:: U+022D8 .. VERY MUCH LESS-THAN -.. |lsim| unicode:: U+02272 .. LESS-THAN OR EQUIVALENT TO -.. |lsime| unicode:: U+02A8D .. LESS-THAN ABOVE SIMILAR OR EQUAL -.. |lsimg| unicode:: U+02A8F .. LESS-THAN ABOVE SIMILAR ABOVE GREATER-THAN -.. |Lt| unicode:: U+0226A .. MUCH LESS-THAN -.. |ltcc| unicode:: U+02AA6 .. LESS-THAN CLOSED BY CURVE -.. |ltcir| unicode:: U+02A79 .. LESS-THAN WITH CIRCLE INSIDE -.. |ltdot| unicode:: U+022D6 .. LESS-THAN WITH DOT -.. |ltlarr| unicode:: U+02976 .. LESS-THAN ABOVE LEFTWARDS ARROW -.. |ltquest| unicode:: U+02A7B .. LESS-THAN WITH QUESTION MARK ABOVE -.. |ltrie| unicode:: U+022B4 .. NORMAL SUBGROUP OF OR EQUAL TO -.. |mcomma| unicode:: U+02A29 .. MINUS SIGN WITH COMMA ABOVE -.. |mDDot| unicode:: U+0223A .. GEOMETRIC PROPORTION -.. |mid| unicode:: U+02223 .. DIVIDES -.. |mlcp| unicode:: U+02ADB .. TRANSVERSAL INTERSECTION -.. |models| unicode:: U+022A7 .. MODELS -.. |mstpos| unicode:: U+0223E .. INVERTED LAZY S -.. |Pr| unicode:: U+02ABB .. DOUBLE PRECEDES -.. |pr| unicode:: U+0227A .. PRECEDES -.. |prap| unicode:: U+02AB7 .. PRECEDES ABOVE ALMOST EQUAL TO -.. |prcue| unicode:: U+0227C .. PRECEDES OR EQUAL TO -.. |prE| unicode:: U+02AB3 .. PRECEDES ABOVE EQUALS SIGN -.. |pre| unicode:: U+02AAF .. PRECEDES ABOVE SINGLE-LINE EQUALS SIGN -.. |prsim| unicode:: U+0227E .. PRECEDES OR EQUIVALENT TO -.. |prurel| unicode:: U+022B0 .. PRECEDES UNDER RELATION -.. |ratio| unicode:: U+02236 .. RATIO -.. |rtrie| unicode:: U+022B5 .. CONTAINS AS NORMAL SUBGROUP OR EQUAL TO -.. |rtriltri| unicode:: U+029CE .. RIGHT TRIANGLE ABOVE LEFT TRIANGLE -.. |samalg| unicode:: U+02210 .. N-ARY COPRODUCT -.. |Sc| unicode:: U+02ABC .. DOUBLE SUCCEEDS -.. |sc| unicode:: U+0227B .. SUCCEEDS -.. |scap| unicode:: U+02AB8 .. SUCCEEDS ABOVE ALMOST EQUAL TO -.. |sccue| unicode:: U+0227D .. SUCCEEDS OR EQUAL TO -.. |scE| unicode:: U+02AB4 .. SUCCEEDS ABOVE EQUALS SIGN -.. |sce| unicode:: U+02AB0 .. SUCCEEDS ABOVE SINGLE-LINE EQUALS SIGN -.. |scsim| unicode:: U+0227F .. SUCCEEDS OR EQUIVALENT TO -.. |sdote| unicode:: U+02A66 .. EQUALS SIGN WITH DOT BELOW -.. |sfrown| unicode:: U+02322 .. FROWN -.. |simg| unicode:: U+02A9E .. SIMILAR OR GREATER-THAN -.. |simgE| unicode:: U+02AA0 .. SIMILAR ABOVE GREATER-THAN ABOVE EQUALS SIGN -.. |siml| unicode:: U+02A9D .. SIMILAR OR LESS-THAN -.. |simlE| unicode:: U+02A9F .. SIMILAR ABOVE LESS-THAN ABOVE EQUALS SIGN -.. |smid| unicode:: U+02223 .. DIVIDES -.. |smile| unicode:: U+02323 .. SMILE -.. |smt| unicode:: U+02AAA .. SMALLER THAN -.. |smte| unicode:: U+02AAC .. SMALLER THAN OR EQUAL TO -.. |smtes| unicode:: U+02AAC U+0FE00 .. SMALLER THAN OR slanted EQUAL -.. |spar| unicode:: U+02225 .. PARALLEL TO -.. |sqsub| unicode:: U+0228F .. SQUARE IMAGE OF -.. |sqsube| unicode:: U+02291 .. SQUARE IMAGE OF OR EQUAL TO -.. |sqsup| unicode:: U+02290 .. SQUARE ORIGINAL OF -.. |sqsupe| unicode:: U+02292 .. SQUARE ORIGINAL OF OR EQUAL TO -.. |ssmile| unicode:: U+02323 .. SMILE -.. |Sub| unicode:: U+022D0 .. DOUBLE SUBSET -.. |subE| unicode:: U+02AC5 .. SUBSET OF ABOVE EQUALS SIGN -.. |subedot| unicode:: U+02AC3 .. SUBSET OF OR EQUAL TO WITH DOT ABOVE -.. |submult| unicode:: U+02AC1 .. SUBSET WITH MULTIPLICATION SIGN BELOW -.. |subplus| unicode:: U+02ABF .. SUBSET WITH PLUS SIGN BELOW -.. |subrarr| unicode:: U+02979 .. SUBSET ABOVE RIGHTWARDS ARROW -.. |subsim| unicode:: U+02AC7 .. SUBSET OF ABOVE TILDE OPERATOR -.. |subsub| unicode:: U+02AD5 .. SUBSET ABOVE SUBSET -.. |subsup| unicode:: U+02AD3 .. SUBSET ABOVE SUPERSET -.. |Sup| unicode:: U+022D1 .. DOUBLE SUPERSET -.. |supdsub| unicode:: U+02AD8 .. SUPERSET BESIDE AND JOINED BY DASH WITH SUBSET -.. |supE| unicode:: U+02AC6 .. SUPERSET OF ABOVE EQUALS SIGN -.. |supedot| unicode:: U+02AC4 .. SUPERSET OF OR EQUAL TO WITH DOT ABOVE -.. |suphsol| unicode:: U+02283 U+0002F .. SUPERSET OF, SOLIDUS -.. |suphsub| unicode:: U+02AD7 .. SUPERSET BESIDE SUBSET -.. |suplarr| unicode:: U+0297B .. SUPERSET ABOVE LEFTWARDS ARROW -.. |supmult| unicode:: U+02AC2 .. SUPERSET WITH MULTIPLICATION SIGN BELOW -.. |supplus| unicode:: U+02AC0 .. SUPERSET WITH PLUS SIGN BELOW -.. |supsim| unicode:: U+02AC8 .. SUPERSET OF ABOVE TILDE OPERATOR -.. |supsub| unicode:: U+02AD4 .. SUPERSET ABOVE SUBSET -.. |supsup| unicode:: U+02AD6 .. SUPERSET ABOVE SUPERSET -.. |thkap| unicode:: U+02248 .. ALMOST EQUAL TO -.. |thksim| unicode:: U+0223C .. TILDE OPERATOR -.. |topfork| unicode:: U+02ADA .. PITCHFORK WITH TEE TOP -.. |trie| unicode:: U+0225C .. DELTA EQUAL TO -.. |twixt| unicode:: U+0226C .. BETWEEN -.. |Vbar| unicode:: U+02AEB .. DOUBLE UP TACK -.. |vBar| unicode:: U+02AE8 .. SHORT UP TACK WITH UNDERBAR -.. |vBarv| unicode:: U+02AE9 .. SHORT UP TACK ABOVE SHORT DOWN TACK -.. |VDash| unicode:: U+022AB .. DOUBLE VERTICAL BAR DOUBLE RIGHT TURNSTILE -.. |Vdash| unicode:: U+022A9 .. FORCES -.. |vDash| unicode:: U+022A8 .. TRUE -.. |vdash| unicode:: U+022A2 .. RIGHT TACK -.. |Vdashl| unicode:: U+02AE6 .. LONG DASH FROM LEFT MEMBER OF DOUBLE VERTICAL -.. |veebar| unicode:: U+022BB .. XOR -.. |vltri| unicode:: U+022B2 .. NORMAL SUBGROUP OF -.. |vprop| unicode:: U+0221D .. PROPORTIONAL TO -.. |vrtri| unicode:: U+022B3 .. CONTAINS AS NORMAL SUBGROUP -.. |Vvdash| unicode:: U+022AA .. TRIPLE VERTICAL BAR RIGHT TURNSTILE diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/isobox.txt --- a/buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/isobox.txt Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,46 +0,0 @@ -.. This data file has been placed in the public domain. -.. Derived from the Unicode character mappings available from - . - Processed by unicode2rstsubs.py, part of Docutils: - . - -.. |boxDL| unicode:: U+02557 .. BOX DRAWINGS DOUBLE DOWN AND LEFT -.. |boxDl| unicode:: U+02556 .. BOX DRAWINGS DOWN DOUBLE AND LEFT SINGLE -.. |boxdL| unicode:: U+02555 .. BOX DRAWINGS DOWN SINGLE AND LEFT DOUBLE -.. |boxdl| unicode:: U+02510 .. BOX DRAWINGS LIGHT DOWN AND LEFT -.. |boxDR| unicode:: U+02554 .. BOX DRAWINGS DOUBLE DOWN AND RIGHT -.. |boxDr| unicode:: U+02553 .. BOX DRAWINGS DOWN DOUBLE AND RIGHT SINGLE -.. |boxdR| unicode:: U+02552 .. BOX DRAWINGS DOWN SINGLE AND RIGHT DOUBLE -.. |boxdr| unicode:: U+0250C .. BOX DRAWINGS LIGHT DOWN AND RIGHT -.. |boxH| unicode:: U+02550 .. BOX DRAWINGS DOUBLE HORIZONTAL -.. |boxh| unicode:: U+02500 .. BOX DRAWINGS LIGHT HORIZONTAL -.. |boxHD| unicode:: U+02566 .. BOX DRAWINGS DOUBLE DOWN AND HORIZONTAL -.. |boxHd| unicode:: U+02564 .. BOX DRAWINGS DOWN SINGLE AND HORIZONTAL DOUBLE -.. |boxhD| unicode:: U+02565 .. BOX DRAWINGS DOWN DOUBLE AND HORIZONTAL SINGLE -.. |boxhd| unicode:: U+0252C .. BOX DRAWINGS LIGHT DOWN AND HORIZONTAL -.. |boxHU| unicode:: U+02569 .. BOX DRAWINGS DOUBLE UP AND HORIZONTAL -.. |boxHu| unicode:: U+02567 .. BOX DRAWINGS UP SINGLE AND HORIZONTAL DOUBLE -.. |boxhU| unicode:: U+02568 .. BOX DRAWINGS UP DOUBLE AND HORIZONTAL SINGLE -.. |boxhu| unicode:: U+02534 .. BOX DRAWINGS LIGHT UP AND HORIZONTAL -.. |boxUL| unicode:: U+0255D .. BOX DRAWINGS DOUBLE UP AND LEFT -.. |boxUl| unicode:: U+0255C .. BOX DRAWINGS UP DOUBLE AND LEFT SINGLE -.. |boxuL| unicode:: U+0255B .. BOX DRAWINGS UP SINGLE AND LEFT DOUBLE -.. |boxul| unicode:: U+02518 .. BOX DRAWINGS LIGHT UP AND LEFT -.. |boxUR| unicode:: U+0255A .. BOX DRAWINGS DOUBLE UP AND RIGHT -.. |boxUr| unicode:: U+02559 .. BOX DRAWINGS UP DOUBLE AND RIGHT SINGLE -.. |boxuR| unicode:: U+02558 .. BOX DRAWINGS UP SINGLE AND RIGHT DOUBLE -.. |boxur| unicode:: U+02514 .. BOX DRAWINGS LIGHT UP AND RIGHT -.. |boxV| unicode:: U+02551 .. BOX DRAWINGS DOUBLE VERTICAL -.. |boxv| unicode:: U+02502 .. BOX DRAWINGS LIGHT VERTICAL -.. |boxVH| unicode:: U+0256C .. BOX DRAWINGS DOUBLE VERTICAL AND HORIZONTAL -.. |boxVh| unicode:: U+0256B .. BOX DRAWINGS VERTICAL DOUBLE AND HORIZONTAL SINGLE -.. |boxvH| unicode:: U+0256A .. BOX DRAWINGS VERTICAL SINGLE AND HORIZONTAL DOUBLE -.. |boxvh| unicode:: U+0253C .. BOX DRAWINGS LIGHT VERTICAL AND HORIZONTAL -.. |boxVL| unicode:: U+02563 .. BOX DRAWINGS DOUBLE VERTICAL AND LEFT -.. |boxVl| unicode:: U+02562 .. BOX DRAWINGS VERTICAL DOUBLE AND LEFT SINGLE -.. |boxvL| unicode:: U+02561 .. BOX DRAWINGS VERTICAL SINGLE AND LEFT DOUBLE -.. |boxvl| unicode:: U+02524 .. BOX DRAWINGS LIGHT VERTICAL AND LEFT -.. |boxVR| unicode:: U+02560 .. BOX DRAWINGS DOUBLE VERTICAL AND RIGHT -.. |boxVr| unicode:: U+0255F .. BOX DRAWINGS VERTICAL DOUBLE AND RIGHT SINGLE -.. |boxvR| unicode:: U+0255E .. BOX DRAWINGS VERTICAL SINGLE AND RIGHT DOUBLE -.. |boxvr| unicode:: U+0251C .. BOX DRAWINGS LIGHT VERTICAL AND RIGHT diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/isocyr1.txt --- a/buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/isocyr1.txt Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,73 +0,0 @@ -.. This data file has been placed in the public domain. -.. Derived from the Unicode character mappings available from - . - Processed by unicode2rstsubs.py, part of Docutils: - . - -.. |Acy| unicode:: U+00410 .. CYRILLIC CAPITAL LETTER A -.. |acy| unicode:: U+00430 .. CYRILLIC SMALL LETTER A -.. |Bcy| unicode:: U+00411 .. CYRILLIC CAPITAL LETTER BE -.. |bcy| unicode:: U+00431 .. CYRILLIC SMALL LETTER BE -.. |CHcy| unicode:: U+00427 .. CYRILLIC CAPITAL LETTER CHE -.. |chcy| unicode:: U+00447 .. CYRILLIC SMALL LETTER CHE -.. |Dcy| unicode:: U+00414 .. CYRILLIC CAPITAL LETTER DE -.. |dcy| unicode:: U+00434 .. CYRILLIC SMALL LETTER DE -.. |Ecy| unicode:: U+0042D .. CYRILLIC CAPITAL LETTER E -.. |ecy| unicode:: U+0044D .. CYRILLIC SMALL LETTER E -.. |Fcy| unicode:: U+00424 .. CYRILLIC CAPITAL LETTER EF -.. |fcy| unicode:: U+00444 .. CYRILLIC SMALL LETTER EF -.. |Gcy| unicode:: U+00413 .. CYRILLIC CAPITAL LETTER GHE -.. |gcy| unicode:: U+00433 .. CYRILLIC SMALL LETTER GHE -.. |HARDcy| unicode:: U+0042A .. CYRILLIC CAPITAL LETTER HARD SIGN -.. |hardcy| unicode:: U+0044A .. CYRILLIC SMALL LETTER HARD SIGN -.. |Icy| unicode:: U+00418 .. CYRILLIC CAPITAL LETTER I -.. |icy| unicode:: U+00438 .. CYRILLIC SMALL LETTER I -.. |IEcy| unicode:: U+00415 .. CYRILLIC CAPITAL LETTER IE -.. |iecy| unicode:: U+00435 .. CYRILLIC SMALL LETTER IE -.. |IOcy| unicode:: U+00401 .. CYRILLIC CAPITAL LETTER IO -.. |iocy| unicode:: U+00451 .. CYRILLIC SMALL LETTER IO -.. |Jcy| unicode:: U+00419 .. CYRILLIC CAPITAL LETTER SHORT I -.. |jcy| unicode:: U+00439 .. CYRILLIC SMALL LETTER SHORT I -.. |Kcy| unicode:: U+0041A .. CYRILLIC CAPITAL LETTER KA -.. |kcy| unicode:: U+0043A .. CYRILLIC SMALL LETTER KA -.. |KHcy| unicode:: U+00425 .. CYRILLIC CAPITAL LETTER HA -.. |khcy| unicode:: U+00445 .. CYRILLIC SMALL LETTER HA -.. |Lcy| unicode:: U+0041B .. CYRILLIC CAPITAL LETTER EL -.. |lcy| unicode:: U+0043B .. CYRILLIC SMALL LETTER EL -.. |Mcy| unicode:: U+0041C .. CYRILLIC CAPITAL LETTER EM -.. |mcy| unicode:: U+0043C .. CYRILLIC SMALL LETTER EM -.. |Ncy| unicode:: U+0041D .. CYRILLIC CAPITAL LETTER EN -.. |ncy| unicode:: U+0043D .. CYRILLIC SMALL LETTER EN -.. |numero| unicode:: U+02116 .. NUMERO SIGN -.. |Ocy| unicode:: U+0041E .. CYRILLIC CAPITAL LETTER O -.. |ocy| unicode:: U+0043E .. CYRILLIC SMALL LETTER O -.. |Pcy| unicode:: U+0041F .. CYRILLIC CAPITAL LETTER PE -.. |pcy| unicode:: U+0043F .. CYRILLIC SMALL LETTER PE -.. |Rcy| unicode:: U+00420 .. CYRILLIC CAPITAL LETTER ER -.. |rcy| unicode:: U+00440 .. CYRILLIC SMALL LETTER ER -.. |Scy| unicode:: U+00421 .. CYRILLIC CAPITAL LETTER ES -.. |scy| unicode:: U+00441 .. CYRILLIC SMALL LETTER ES -.. |SHCHcy| unicode:: U+00429 .. CYRILLIC CAPITAL LETTER SHCHA -.. |shchcy| unicode:: U+00449 .. CYRILLIC SMALL LETTER SHCHA -.. |SHcy| unicode:: U+00428 .. CYRILLIC CAPITAL LETTER SHA -.. |shcy| unicode:: U+00448 .. CYRILLIC SMALL LETTER SHA -.. |SOFTcy| unicode:: U+0042C .. CYRILLIC CAPITAL LETTER SOFT SIGN -.. |softcy| unicode:: U+0044C .. CYRILLIC SMALL LETTER SOFT SIGN -.. |Tcy| unicode:: U+00422 .. CYRILLIC CAPITAL LETTER TE -.. |tcy| unicode:: U+00442 .. CYRILLIC SMALL LETTER TE -.. |TScy| unicode:: U+00426 .. CYRILLIC CAPITAL LETTER TSE -.. |tscy| unicode:: U+00446 .. CYRILLIC SMALL LETTER TSE -.. |Ucy| unicode:: U+00423 .. CYRILLIC CAPITAL LETTER U -.. |ucy| unicode:: U+00443 .. CYRILLIC SMALL LETTER U -.. |Vcy| unicode:: U+00412 .. CYRILLIC CAPITAL LETTER VE -.. |vcy| unicode:: U+00432 .. CYRILLIC SMALL LETTER VE -.. |YAcy| unicode:: U+0042F .. CYRILLIC CAPITAL LETTER YA -.. |yacy| unicode:: U+0044F .. CYRILLIC SMALL LETTER YA -.. |Ycy| unicode:: U+0042B .. CYRILLIC CAPITAL LETTER YERU -.. |ycy| unicode:: U+0044B .. CYRILLIC SMALL LETTER YERU -.. |YUcy| unicode:: U+0042E .. CYRILLIC CAPITAL LETTER YU -.. |yucy| unicode:: U+0044E .. CYRILLIC SMALL LETTER YU -.. |Zcy| unicode:: U+00417 .. CYRILLIC CAPITAL LETTER ZE -.. |zcy| unicode:: U+00437 .. CYRILLIC SMALL LETTER ZE -.. |ZHcy| unicode:: U+00416 .. CYRILLIC CAPITAL LETTER ZHE -.. |zhcy| unicode:: U+00436 .. CYRILLIC SMALL LETTER ZHE diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/isocyr2.txt --- a/buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/isocyr2.txt Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,32 +0,0 @@ -.. This data file has been placed in the public domain. -.. Derived from the Unicode character mappings available from - . - Processed by unicode2rstsubs.py, part of Docutils: - . - -.. |DJcy| unicode:: U+00402 .. CYRILLIC CAPITAL LETTER DJE -.. |djcy| unicode:: U+00452 .. CYRILLIC SMALL LETTER DJE -.. |DScy| unicode:: U+00405 .. CYRILLIC CAPITAL LETTER DZE -.. |dscy| unicode:: U+00455 .. CYRILLIC SMALL LETTER DZE -.. |DZcy| unicode:: U+0040F .. CYRILLIC CAPITAL LETTER DZHE -.. |dzcy| unicode:: U+0045F .. CYRILLIC SMALL LETTER DZHE -.. |GJcy| unicode:: U+00403 .. CYRILLIC CAPITAL LETTER GJE -.. |gjcy| unicode:: U+00453 .. CYRILLIC SMALL LETTER GJE -.. |Iukcy| unicode:: U+00406 .. CYRILLIC CAPITAL LETTER BYELORUSSIAN-UKRAINIAN I -.. |iukcy| unicode:: U+00456 .. CYRILLIC SMALL LETTER BYELORUSSIAN-UKRAINIAN I -.. |Jsercy| unicode:: U+00408 .. CYRILLIC CAPITAL LETTER JE -.. |jsercy| unicode:: U+00458 .. CYRILLIC SMALL LETTER JE -.. |Jukcy| unicode:: U+00404 .. CYRILLIC CAPITAL LETTER UKRAINIAN IE -.. |jukcy| unicode:: U+00454 .. CYRILLIC SMALL LETTER UKRAINIAN IE -.. |KJcy| unicode:: U+0040C .. CYRILLIC CAPITAL LETTER KJE -.. |kjcy| unicode:: U+0045C .. CYRILLIC SMALL LETTER KJE -.. |LJcy| unicode:: U+00409 .. CYRILLIC CAPITAL LETTER LJE -.. |ljcy| unicode:: U+00459 .. CYRILLIC SMALL LETTER LJE -.. |NJcy| unicode:: U+0040A .. CYRILLIC CAPITAL LETTER NJE -.. |njcy| unicode:: U+0045A .. CYRILLIC SMALL LETTER NJE -.. |TSHcy| unicode:: U+0040B .. CYRILLIC CAPITAL LETTER TSHE -.. |tshcy| unicode:: U+0045B .. CYRILLIC SMALL LETTER TSHE -.. |Ubrcy| unicode:: U+0040E .. CYRILLIC CAPITAL LETTER SHORT U -.. |ubrcy| unicode:: U+0045E .. CYRILLIC SMALL LETTER SHORT U -.. |YIcy| unicode:: U+00407 .. CYRILLIC CAPITAL LETTER YI -.. |yicy| unicode:: U+00457 .. CYRILLIC SMALL LETTER YI diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/isodia.txt --- a/buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/isodia.txt Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,20 +0,0 @@ -.. This data file has been placed in the public domain. -.. Derived from the Unicode character mappings available from - . - Processed by unicode2rstsubs.py, part of Docutils: - . - -.. |acute| unicode:: U+000B4 .. ACUTE ACCENT -.. |breve| unicode:: U+002D8 .. BREVE -.. |caron| unicode:: U+002C7 .. CARON -.. |cedil| unicode:: U+000B8 .. CEDILLA -.. |circ| unicode:: U+002C6 .. MODIFIER LETTER CIRCUMFLEX ACCENT -.. |dblac| unicode:: U+002DD .. DOUBLE ACUTE ACCENT -.. |die| unicode:: U+000A8 .. DIAERESIS -.. |dot| unicode:: U+002D9 .. DOT ABOVE -.. |grave| unicode:: U+00060 .. GRAVE ACCENT -.. |macr| unicode:: U+000AF .. MACRON -.. |ogon| unicode:: U+002DB .. OGONEK -.. |ring| unicode:: U+002DA .. RING ABOVE -.. |tilde| unicode:: U+002DC .. SMALL TILDE -.. |uml| unicode:: U+000A8 .. DIAERESIS diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/isogrk1.txt --- a/buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/isogrk1.txt Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,55 +0,0 @@ -.. This data file has been placed in the public domain. -.. Derived from the Unicode character mappings available from - . - Processed by unicode2rstsubs.py, part of Docutils: - . - -.. |Agr| unicode:: U+00391 .. GREEK CAPITAL LETTER ALPHA -.. |agr| unicode:: U+003B1 .. GREEK SMALL LETTER ALPHA -.. |Bgr| unicode:: U+00392 .. GREEK CAPITAL LETTER BETA -.. |bgr| unicode:: U+003B2 .. GREEK SMALL LETTER BETA -.. |Dgr| unicode:: U+00394 .. GREEK CAPITAL LETTER DELTA -.. |dgr| unicode:: U+003B4 .. GREEK SMALL LETTER DELTA -.. |EEgr| unicode:: U+00397 .. GREEK CAPITAL LETTER ETA -.. |eegr| unicode:: U+003B7 .. GREEK SMALL LETTER ETA -.. |Egr| unicode:: U+00395 .. GREEK CAPITAL LETTER EPSILON -.. |egr| unicode:: U+003B5 .. GREEK SMALL LETTER EPSILON -.. |Ggr| unicode:: U+00393 .. GREEK CAPITAL LETTER GAMMA -.. |ggr| unicode:: U+003B3 .. GREEK SMALL LETTER GAMMA -.. |Igr| unicode:: U+00399 .. GREEK CAPITAL LETTER IOTA -.. |igr| unicode:: U+003B9 .. GREEK SMALL LETTER IOTA -.. |Kgr| unicode:: U+0039A .. GREEK CAPITAL LETTER KAPPA -.. |kgr| unicode:: U+003BA .. GREEK SMALL LETTER KAPPA -.. |KHgr| unicode:: U+003A7 .. GREEK CAPITAL LETTER CHI -.. |khgr| unicode:: U+003C7 .. GREEK SMALL LETTER CHI -.. |Lgr| unicode:: U+0039B .. GREEK CAPITAL LETTER LAMDA -.. |lgr| unicode:: U+003BB .. GREEK SMALL LETTER LAMDA -.. |Mgr| unicode:: U+0039C .. GREEK CAPITAL LETTER MU -.. |mgr| unicode:: U+003BC .. GREEK SMALL LETTER MU -.. |Ngr| unicode:: U+0039D .. GREEK CAPITAL LETTER NU -.. |ngr| unicode:: U+003BD .. GREEK SMALL LETTER NU -.. |Ogr| unicode:: U+0039F .. GREEK CAPITAL LETTER OMICRON -.. |ogr| unicode:: U+003BF .. GREEK SMALL LETTER OMICRON -.. |OHgr| unicode:: U+003A9 .. GREEK CAPITAL LETTER OMEGA -.. |ohgr| unicode:: U+003C9 .. GREEK SMALL LETTER OMEGA -.. |Pgr| unicode:: U+003A0 .. GREEK CAPITAL LETTER PI -.. |pgr| unicode:: U+003C0 .. GREEK SMALL LETTER PI -.. |PHgr| unicode:: U+003A6 .. GREEK CAPITAL LETTER PHI -.. |phgr| unicode:: U+003C6 .. GREEK SMALL LETTER PHI -.. |PSgr| unicode:: U+003A8 .. GREEK CAPITAL LETTER PSI -.. |psgr| unicode:: U+003C8 .. GREEK SMALL LETTER PSI -.. |Rgr| unicode:: U+003A1 .. GREEK CAPITAL LETTER RHO -.. |rgr| unicode:: U+003C1 .. GREEK SMALL LETTER RHO -.. |sfgr| unicode:: U+003C2 .. GREEK SMALL LETTER FINAL SIGMA -.. |Sgr| unicode:: U+003A3 .. GREEK CAPITAL LETTER SIGMA -.. |sgr| unicode:: U+003C3 .. GREEK SMALL LETTER SIGMA -.. |Tgr| unicode:: U+003A4 .. GREEK CAPITAL LETTER TAU -.. |tgr| unicode:: U+003C4 .. GREEK SMALL LETTER TAU -.. |THgr| unicode:: U+00398 .. GREEK CAPITAL LETTER THETA -.. |thgr| unicode:: U+003B8 .. GREEK SMALL LETTER THETA -.. |Ugr| unicode:: U+003A5 .. GREEK CAPITAL LETTER UPSILON -.. |ugr| unicode:: U+003C5 .. GREEK SMALL LETTER UPSILON -.. |Xgr| unicode:: U+0039E .. GREEK CAPITAL LETTER XI -.. |xgr| unicode:: U+003BE .. GREEK SMALL LETTER XI -.. |Zgr| unicode:: U+00396 .. GREEK CAPITAL LETTER ZETA -.. |zgr| unicode:: U+003B6 .. GREEK SMALL LETTER ZETA diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/isogrk2.txt --- a/buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/isogrk2.txt Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,26 +0,0 @@ -.. This data file has been placed in the public domain. -.. Derived from the Unicode character mappings available from - . - Processed by unicode2rstsubs.py, part of Docutils: - . - -.. |Aacgr| unicode:: U+00386 .. GREEK CAPITAL LETTER ALPHA WITH TONOS -.. |aacgr| unicode:: U+003AC .. GREEK SMALL LETTER ALPHA WITH TONOS -.. |Eacgr| unicode:: U+00388 .. GREEK CAPITAL LETTER EPSILON WITH TONOS -.. |eacgr| unicode:: U+003AD .. GREEK SMALL LETTER EPSILON WITH TONOS -.. |EEacgr| unicode:: U+00389 .. GREEK CAPITAL LETTER ETA WITH TONOS -.. |eeacgr| unicode:: U+003AE .. GREEK SMALL LETTER ETA WITH TONOS -.. |Iacgr| unicode:: U+0038A .. GREEK CAPITAL LETTER IOTA WITH TONOS -.. |iacgr| unicode:: U+003AF .. GREEK SMALL LETTER IOTA WITH TONOS -.. |idiagr| unicode:: U+00390 .. GREEK SMALL LETTER IOTA WITH DIALYTIKA AND TONOS -.. |Idigr| unicode:: U+003AA .. GREEK CAPITAL LETTER IOTA WITH DIALYTIKA -.. |idigr| unicode:: U+003CA .. GREEK SMALL LETTER IOTA WITH DIALYTIKA -.. |Oacgr| unicode:: U+0038C .. GREEK CAPITAL LETTER OMICRON WITH TONOS -.. |oacgr| unicode:: U+003CC .. GREEK SMALL LETTER OMICRON WITH TONOS -.. |OHacgr| unicode:: U+0038F .. GREEK CAPITAL LETTER OMEGA WITH TONOS -.. |ohacgr| unicode:: U+003CE .. GREEK SMALL LETTER OMEGA WITH TONOS -.. |Uacgr| unicode:: U+0038E .. GREEK CAPITAL LETTER UPSILON WITH TONOS -.. |uacgr| unicode:: U+003CD .. GREEK SMALL LETTER UPSILON WITH TONOS -.. |udiagr| unicode:: U+003B0 .. GREEK SMALL LETTER UPSILON WITH DIALYTIKA AND TONOS -.. |Udigr| unicode:: U+003AB .. GREEK CAPITAL LETTER UPSILON WITH DIALYTIKA -.. |udigr| unicode:: U+003CB .. GREEK SMALL LETTER UPSILON WITH DIALYTIKA diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/isogrk3.txt --- a/buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/isogrk3.txt Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,52 +0,0 @@ -.. This data file has been placed in the public domain. -.. Derived from the Unicode character mappings available from - . - Processed by unicode2rstsubs.py, part of Docutils: - . - -.. |alpha| unicode:: U+003B1 .. GREEK SMALL LETTER ALPHA -.. |beta| unicode:: U+003B2 .. GREEK SMALL LETTER BETA -.. |chi| unicode:: U+003C7 .. GREEK SMALL LETTER CHI -.. |Delta| unicode:: U+00394 .. GREEK CAPITAL LETTER DELTA -.. |delta| unicode:: U+003B4 .. GREEK SMALL LETTER DELTA -.. |epsi| unicode:: U+003F5 .. GREEK LUNATE EPSILON SYMBOL -.. |epsis| unicode:: U+003F5 .. GREEK LUNATE EPSILON SYMBOL -.. |epsiv| unicode:: U+003B5 .. GREEK SMALL LETTER EPSILON -.. |eta| unicode:: U+003B7 .. GREEK SMALL LETTER ETA -.. |Gamma| unicode:: U+00393 .. GREEK CAPITAL LETTER GAMMA -.. |gamma| unicode:: U+003B3 .. GREEK SMALL LETTER GAMMA -.. |Gammad| unicode:: U+003DC .. GREEK LETTER DIGAMMA -.. |gammad| unicode:: U+003DD .. GREEK SMALL LETTER DIGAMMA -.. |iota| unicode:: U+003B9 .. GREEK SMALL LETTER IOTA -.. |kappa| unicode:: U+003BA .. GREEK SMALL LETTER KAPPA -.. |kappav| unicode:: U+003F0 .. GREEK KAPPA SYMBOL -.. |Lambda| unicode:: U+0039B .. GREEK CAPITAL LETTER LAMDA -.. |lambda| unicode:: U+003BB .. GREEK SMALL LETTER LAMDA -.. |mu| unicode:: U+003BC .. GREEK SMALL LETTER MU -.. |nu| unicode:: U+003BD .. GREEK SMALL LETTER NU -.. |Omega| unicode:: U+003A9 .. GREEK CAPITAL LETTER OMEGA -.. |omega| unicode:: U+003C9 .. GREEK SMALL LETTER OMEGA -.. |Phi| unicode:: U+003A6 .. GREEK CAPITAL LETTER PHI -.. |phi| unicode:: U+003D5 .. GREEK PHI SYMBOL -.. |phis| unicode:: U+003D5 .. GREEK PHI SYMBOL -.. |phiv| unicode:: U+003C6 .. GREEK SMALL LETTER PHI -.. |Pi| unicode:: U+003A0 .. GREEK CAPITAL LETTER PI -.. |pi| unicode:: U+003C0 .. GREEK SMALL LETTER PI -.. |piv| unicode:: U+003D6 .. GREEK PI SYMBOL -.. |Psi| unicode:: U+003A8 .. GREEK CAPITAL LETTER PSI -.. |psi| unicode:: U+003C8 .. GREEK SMALL LETTER PSI -.. |rho| unicode:: U+003C1 .. GREEK SMALL LETTER RHO -.. |rhov| unicode:: U+003F1 .. GREEK RHO SYMBOL -.. |Sigma| unicode:: U+003A3 .. GREEK CAPITAL LETTER SIGMA -.. |sigma| unicode:: U+003C3 .. GREEK SMALL LETTER SIGMA -.. |sigmav| unicode:: U+003C2 .. GREEK SMALL LETTER FINAL SIGMA -.. |tau| unicode:: U+003C4 .. GREEK SMALL LETTER TAU -.. |Theta| unicode:: U+00398 .. GREEK CAPITAL LETTER THETA -.. |theta| unicode:: U+003B8 .. GREEK SMALL LETTER THETA -.. |thetas| unicode:: U+003B8 .. GREEK SMALL LETTER THETA -.. |thetav| unicode:: U+003D1 .. GREEK THETA SYMBOL -.. |Upsi| unicode:: U+003D2 .. GREEK UPSILON WITH HOOK SYMBOL -.. |upsi| unicode:: U+003C5 .. GREEK SMALL LETTER UPSILON -.. |Xi| unicode:: U+0039E .. GREEK CAPITAL LETTER XI -.. |xi| unicode:: U+003BE .. GREEK SMALL LETTER XI -.. |zeta| unicode:: U+003B6 .. GREEK SMALL LETTER ZETA diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/isogrk4-wide.txt --- a/buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/isogrk4-wide.txt Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,49 +0,0 @@ -.. This data file has been placed in the public domain. -.. Derived from the Unicode character mappings available from - . - Processed by unicode2rstsubs.py, part of Docutils: - . - -.. |b.alpha| unicode:: U+1D6C2 .. MATHEMATICAL BOLD SMALL ALPHA -.. |b.beta| unicode:: U+1D6C3 .. MATHEMATICAL BOLD SMALL BETA -.. |b.chi| unicode:: U+1D6D8 .. MATHEMATICAL BOLD SMALL CHI -.. |b.Delta| unicode:: U+1D6AB .. MATHEMATICAL BOLD CAPITAL DELTA -.. |b.delta| unicode:: U+1D6C5 .. MATHEMATICAL BOLD SMALL DELTA -.. |b.epsi| unicode:: U+1D6C6 .. MATHEMATICAL BOLD SMALL EPSILON -.. |b.epsiv| unicode:: U+1D6DC .. MATHEMATICAL BOLD EPSILON SYMBOL -.. |b.eta| unicode:: U+1D6C8 .. MATHEMATICAL BOLD SMALL ETA -.. |b.Gamma| unicode:: U+1D6AA .. MATHEMATICAL BOLD CAPITAL GAMMA -.. |b.gamma| unicode:: U+1D6C4 .. MATHEMATICAL BOLD SMALL GAMMA -.. |b.Gammad| unicode:: U+003DC .. GREEK LETTER DIGAMMA -.. |b.gammad| unicode:: U+003DD .. GREEK SMALL LETTER DIGAMMA -.. |b.iota| unicode:: U+1D6CA .. MATHEMATICAL BOLD SMALL IOTA -.. |b.kappa| unicode:: U+1D6CB .. MATHEMATICAL BOLD SMALL KAPPA -.. |b.kappav| unicode:: U+1D6DE .. MATHEMATICAL BOLD KAPPA SYMBOL -.. |b.Lambda| unicode:: U+1D6B2 .. MATHEMATICAL BOLD CAPITAL LAMDA -.. |b.lambda| unicode:: U+1D6CC .. MATHEMATICAL BOLD SMALL LAMDA -.. |b.mu| unicode:: U+1D6CD .. MATHEMATICAL BOLD SMALL MU -.. |b.nu| unicode:: U+1D6CE .. MATHEMATICAL BOLD SMALL NU -.. |b.Omega| unicode:: U+1D6C0 .. MATHEMATICAL BOLD CAPITAL OMEGA -.. |b.omega| unicode:: U+1D6DA .. MATHEMATICAL BOLD SMALL OMEGA -.. |b.Phi| unicode:: U+1D6BD .. MATHEMATICAL BOLD CAPITAL PHI -.. |b.phi| unicode:: U+1D6D7 .. MATHEMATICAL BOLD SMALL PHI -.. |b.phiv| unicode:: U+1D6DF .. MATHEMATICAL BOLD PHI SYMBOL -.. |b.Pi| unicode:: U+1D6B7 .. MATHEMATICAL BOLD CAPITAL PI -.. |b.pi| unicode:: U+1D6D1 .. MATHEMATICAL BOLD SMALL PI -.. |b.piv| unicode:: U+1D6E1 .. MATHEMATICAL BOLD PI SYMBOL -.. |b.Psi| unicode:: U+1D6BF .. MATHEMATICAL BOLD CAPITAL PSI -.. |b.psi| unicode:: U+1D6D9 .. MATHEMATICAL BOLD SMALL PSI -.. |b.rho| unicode:: U+1D6D2 .. MATHEMATICAL BOLD SMALL RHO -.. |b.rhov| unicode:: U+1D6E0 .. MATHEMATICAL BOLD RHO SYMBOL -.. |b.Sigma| unicode:: U+1D6BA .. MATHEMATICAL BOLD CAPITAL SIGMA -.. |b.sigma| unicode:: U+1D6D4 .. MATHEMATICAL BOLD SMALL SIGMA -.. |b.sigmav| unicode:: U+1D6D3 .. MATHEMATICAL BOLD SMALL FINAL SIGMA -.. |b.tau| unicode:: U+1D6D5 .. MATHEMATICAL BOLD SMALL TAU -.. |b.Theta| unicode:: U+1D6AF .. MATHEMATICAL BOLD CAPITAL THETA -.. |b.thetas| unicode:: U+1D6C9 .. MATHEMATICAL BOLD SMALL THETA -.. |b.thetav| unicode:: U+1D6DD .. MATHEMATICAL BOLD THETA SYMBOL -.. |b.Upsi| unicode:: U+1D6BC .. MATHEMATICAL BOLD CAPITAL UPSILON -.. |b.upsi| unicode:: U+1D6D6 .. MATHEMATICAL BOLD SMALL UPSILON -.. |b.Xi| unicode:: U+1D6B5 .. MATHEMATICAL BOLD CAPITAL XI -.. |b.xi| unicode:: U+1D6CF .. MATHEMATICAL BOLD SMALL XI -.. |b.zeta| unicode:: U+1D6C7 .. MATHEMATICAL BOLD SMALL ZETA diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/isogrk4.txt --- a/buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/isogrk4.txt Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,8 +0,0 @@ -.. This data file has been placed in the public domain. -.. Derived from the Unicode character mappings available from - . - Processed by unicode2rstsubs.py, part of Docutils: - . - -.. |b.Gammad| unicode:: U+003DC .. GREEK LETTER DIGAMMA -.. |b.gammad| unicode:: U+003DD .. GREEK SMALL LETTER DIGAMMA diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/isolat1.txt --- a/buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/isolat1.txt Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,68 +0,0 @@ -.. This data file has been placed in the public domain. -.. Derived from the Unicode character mappings available from - . - Processed by unicode2rstsubs.py, part of Docutils: - . - -.. |Aacute| unicode:: U+000C1 .. LATIN CAPITAL LETTER A WITH ACUTE -.. |aacute| unicode:: U+000E1 .. LATIN SMALL LETTER A WITH ACUTE -.. |Acirc| unicode:: U+000C2 .. LATIN CAPITAL LETTER A WITH CIRCUMFLEX -.. |acirc| unicode:: U+000E2 .. LATIN SMALL LETTER A WITH CIRCUMFLEX -.. |AElig| unicode:: U+000C6 .. LATIN CAPITAL LETTER AE -.. |aelig| unicode:: U+000E6 .. LATIN SMALL LETTER AE -.. |Agrave| unicode:: U+000C0 .. LATIN CAPITAL LETTER A WITH GRAVE -.. |agrave| unicode:: U+000E0 .. LATIN SMALL LETTER A WITH GRAVE -.. |Aring| unicode:: U+000C5 .. LATIN CAPITAL LETTER A WITH RING ABOVE -.. |aring| unicode:: U+000E5 .. LATIN SMALL LETTER A WITH RING ABOVE -.. |Atilde| unicode:: U+000C3 .. LATIN CAPITAL LETTER A WITH TILDE -.. |atilde| unicode:: U+000E3 .. LATIN SMALL LETTER A WITH TILDE -.. |Auml| unicode:: U+000C4 .. LATIN CAPITAL LETTER A WITH DIAERESIS -.. |auml| unicode:: U+000E4 .. LATIN SMALL LETTER A WITH DIAERESIS -.. |Ccedil| unicode:: U+000C7 .. LATIN CAPITAL LETTER C WITH CEDILLA -.. |ccedil| unicode:: U+000E7 .. LATIN SMALL LETTER C WITH CEDILLA -.. |Eacute| unicode:: U+000C9 .. LATIN CAPITAL LETTER E WITH ACUTE -.. |eacute| unicode:: U+000E9 .. LATIN SMALL LETTER E WITH ACUTE -.. |Ecirc| unicode:: U+000CA .. LATIN CAPITAL LETTER E WITH CIRCUMFLEX -.. |ecirc| unicode:: U+000EA .. LATIN SMALL LETTER E WITH CIRCUMFLEX -.. |Egrave| unicode:: U+000C8 .. LATIN CAPITAL LETTER E WITH GRAVE -.. |egrave| unicode:: U+000E8 .. LATIN SMALL LETTER E WITH GRAVE -.. |ETH| unicode:: U+000D0 .. LATIN CAPITAL LETTER ETH -.. |eth| unicode:: U+000F0 .. LATIN SMALL LETTER ETH -.. |Euml| unicode:: U+000CB .. LATIN CAPITAL LETTER E WITH DIAERESIS -.. |euml| unicode:: U+000EB .. LATIN SMALL LETTER E WITH DIAERESIS -.. |Iacute| unicode:: U+000CD .. LATIN CAPITAL LETTER I WITH ACUTE -.. |iacute| unicode:: U+000ED .. LATIN SMALL LETTER I WITH ACUTE -.. |Icirc| unicode:: U+000CE .. LATIN CAPITAL LETTER I WITH CIRCUMFLEX -.. |icirc| unicode:: U+000EE .. LATIN SMALL LETTER I WITH CIRCUMFLEX -.. |Igrave| unicode:: U+000CC .. LATIN CAPITAL LETTER I WITH GRAVE -.. |igrave| unicode:: U+000EC .. LATIN SMALL LETTER I WITH GRAVE -.. |Iuml| unicode:: U+000CF .. LATIN CAPITAL LETTER I WITH DIAERESIS -.. |iuml| unicode:: U+000EF .. LATIN SMALL LETTER I WITH DIAERESIS -.. |Ntilde| unicode:: U+000D1 .. LATIN CAPITAL LETTER N WITH TILDE -.. |ntilde| unicode:: U+000F1 .. LATIN SMALL LETTER N WITH TILDE -.. |Oacute| unicode:: U+000D3 .. LATIN CAPITAL LETTER O WITH ACUTE -.. |oacute| unicode:: U+000F3 .. LATIN SMALL LETTER O WITH ACUTE -.. |Ocirc| unicode:: U+000D4 .. LATIN CAPITAL LETTER O WITH CIRCUMFLEX -.. |ocirc| unicode:: U+000F4 .. LATIN SMALL LETTER O WITH CIRCUMFLEX -.. |Ograve| unicode:: U+000D2 .. LATIN CAPITAL LETTER O WITH GRAVE -.. |ograve| unicode:: U+000F2 .. LATIN SMALL LETTER O WITH GRAVE -.. |Oslash| unicode:: U+000D8 .. LATIN CAPITAL LETTER O WITH STROKE -.. |oslash| unicode:: U+000F8 .. LATIN SMALL LETTER O WITH STROKE -.. |Otilde| unicode:: U+000D5 .. LATIN CAPITAL LETTER O WITH TILDE -.. |otilde| unicode:: U+000F5 .. LATIN SMALL LETTER O WITH TILDE -.. |Ouml| unicode:: U+000D6 .. LATIN CAPITAL LETTER O WITH DIAERESIS -.. |ouml| unicode:: U+000F6 .. LATIN SMALL LETTER O WITH DIAERESIS -.. |szlig| unicode:: U+000DF .. LATIN SMALL LETTER SHARP S -.. |THORN| unicode:: U+000DE .. LATIN CAPITAL LETTER THORN -.. |thorn| unicode:: U+000FE .. LATIN SMALL LETTER THORN -.. |Uacute| unicode:: U+000DA .. LATIN CAPITAL LETTER U WITH ACUTE -.. |uacute| unicode:: U+000FA .. LATIN SMALL LETTER U WITH ACUTE -.. |Ucirc| unicode:: U+000DB .. LATIN CAPITAL LETTER U WITH CIRCUMFLEX -.. |ucirc| unicode:: U+000FB .. LATIN SMALL LETTER U WITH CIRCUMFLEX -.. |Ugrave| unicode:: U+000D9 .. LATIN CAPITAL LETTER U WITH GRAVE -.. |ugrave| unicode:: U+000F9 .. LATIN SMALL LETTER U WITH GRAVE -.. |Uuml| unicode:: U+000DC .. LATIN CAPITAL LETTER U WITH DIAERESIS -.. |uuml| unicode:: U+000FC .. LATIN SMALL LETTER U WITH DIAERESIS -.. |Yacute| unicode:: U+000DD .. LATIN CAPITAL LETTER Y WITH ACUTE -.. |yacute| unicode:: U+000FD .. LATIN SMALL LETTER Y WITH ACUTE -.. |yuml| unicode:: U+000FF .. LATIN SMALL LETTER Y WITH DIAERESIS diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/isolat2.txt --- a/buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/isolat2.txt Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,128 +0,0 @@ -.. This data file has been placed in the public domain. -.. Derived from the Unicode character mappings available from - . - Processed by unicode2rstsubs.py, part of Docutils: - . - -.. |Abreve| unicode:: U+00102 .. LATIN CAPITAL LETTER A WITH BREVE -.. |abreve| unicode:: U+00103 .. LATIN SMALL LETTER A WITH BREVE -.. |Amacr| unicode:: U+00100 .. LATIN CAPITAL LETTER A WITH MACRON -.. |amacr| unicode:: U+00101 .. LATIN SMALL LETTER A WITH MACRON -.. |Aogon| unicode:: U+00104 .. LATIN CAPITAL LETTER A WITH OGONEK -.. |aogon| unicode:: U+00105 .. LATIN SMALL LETTER A WITH OGONEK -.. |Cacute| unicode:: U+00106 .. LATIN CAPITAL LETTER C WITH ACUTE -.. |cacute| unicode:: U+00107 .. LATIN SMALL LETTER C WITH ACUTE -.. |Ccaron| unicode:: U+0010C .. LATIN CAPITAL LETTER C WITH CARON -.. |ccaron| unicode:: U+0010D .. LATIN SMALL LETTER C WITH CARON -.. |Ccirc| unicode:: U+00108 .. LATIN CAPITAL LETTER C WITH CIRCUMFLEX -.. |ccirc| unicode:: U+00109 .. LATIN SMALL LETTER C WITH CIRCUMFLEX -.. |Cdot| unicode:: U+0010A .. LATIN CAPITAL LETTER C WITH DOT ABOVE -.. |cdot| unicode:: U+0010B .. LATIN SMALL LETTER C WITH DOT ABOVE -.. |Dcaron| unicode:: U+0010E .. LATIN CAPITAL LETTER D WITH CARON -.. |dcaron| unicode:: U+0010F .. LATIN SMALL LETTER D WITH CARON -.. |Dstrok| unicode:: U+00110 .. LATIN CAPITAL LETTER D WITH STROKE -.. |dstrok| unicode:: U+00111 .. LATIN SMALL LETTER D WITH STROKE -.. |Ecaron| unicode:: U+0011A .. LATIN CAPITAL LETTER E WITH CARON -.. |ecaron| unicode:: U+0011B .. LATIN SMALL LETTER E WITH CARON -.. |Edot| unicode:: U+00116 .. LATIN CAPITAL LETTER E WITH DOT ABOVE -.. |edot| unicode:: U+00117 .. LATIN SMALL LETTER E WITH DOT ABOVE -.. |Emacr| unicode:: U+00112 .. LATIN CAPITAL LETTER E WITH MACRON -.. |emacr| unicode:: U+00113 .. LATIN SMALL LETTER E WITH MACRON -.. |ENG| unicode:: U+0014A .. LATIN CAPITAL LETTER ENG -.. |eng| unicode:: U+0014B .. LATIN SMALL LETTER ENG -.. |Eogon| unicode:: U+00118 .. LATIN CAPITAL LETTER E WITH OGONEK -.. |eogon| unicode:: U+00119 .. LATIN SMALL LETTER E WITH OGONEK -.. |gacute| unicode:: U+001F5 .. LATIN SMALL LETTER G WITH ACUTE -.. |Gbreve| unicode:: U+0011E .. LATIN CAPITAL LETTER G WITH BREVE -.. |gbreve| unicode:: U+0011F .. LATIN SMALL LETTER G WITH BREVE -.. |Gcedil| unicode:: U+00122 .. LATIN CAPITAL LETTER G WITH CEDILLA -.. |gcedil| unicode:: U+00123 .. LATIN SMALL LETTER G WITH CEDILLA -.. |Gcirc| unicode:: U+0011C .. LATIN CAPITAL LETTER G WITH CIRCUMFLEX -.. |gcirc| unicode:: U+0011D .. LATIN SMALL LETTER G WITH CIRCUMFLEX -.. |Gdot| unicode:: U+00120 .. LATIN CAPITAL LETTER G WITH DOT ABOVE -.. |gdot| unicode:: U+00121 .. LATIN SMALL LETTER G WITH DOT ABOVE -.. |Hcirc| unicode:: U+00124 .. LATIN CAPITAL LETTER H WITH CIRCUMFLEX -.. |hcirc| unicode:: U+00125 .. LATIN SMALL LETTER H WITH CIRCUMFLEX -.. |Hstrok| unicode:: U+00126 .. LATIN CAPITAL LETTER H WITH STROKE -.. |hstrok| unicode:: U+00127 .. LATIN SMALL LETTER H WITH STROKE -.. |Idot| unicode:: U+00130 .. LATIN CAPITAL LETTER I WITH DOT ABOVE -.. |IJlig| unicode:: U+00132 .. LATIN CAPITAL LIGATURE IJ -.. |ijlig| unicode:: U+00133 .. LATIN SMALL LIGATURE IJ -.. |Imacr| unicode:: U+0012A .. LATIN CAPITAL LETTER I WITH MACRON -.. |imacr| unicode:: U+0012B .. LATIN SMALL LETTER I WITH MACRON -.. |inodot| unicode:: U+00131 .. LATIN SMALL LETTER DOTLESS I -.. |Iogon| unicode:: U+0012E .. LATIN CAPITAL LETTER I WITH OGONEK -.. |iogon| unicode:: U+0012F .. LATIN SMALL LETTER I WITH OGONEK -.. |Itilde| unicode:: U+00128 .. LATIN CAPITAL LETTER I WITH TILDE -.. |itilde| unicode:: U+00129 .. LATIN SMALL LETTER I WITH TILDE -.. |Jcirc| unicode:: U+00134 .. LATIN CAPITAL LETTER J WITH CIRCUMFLEX -.. |jcirc| unicode:: U+00135 .. LATIN SMALL LETTER J WITH CIRCUMFLEX -.. |Kcedil| unicode:: U+00136 .. LATIN CAPITAL LETTER K WITH CEDILLA -.. |kcedil| unicode:: U+00137 .. LATIN SMALL LETTER K WITH CEDILLA -.. |kgreen| unicode:: U+00138 .. LATIN SMALL LETTER KRA -.. |Lacute| unicode:: U+00139 .. LATIN CAPITAL LETTER L WITH ACUTE -.. |lacute| unicode:: U+0013A .. LATIN SMALL LETTER L WITH ACUTE -.. |Lcaron| unicode:: U+0013D .. LATIN CAPITAL LETTER L WITH CARON -.. |lcaron| unicode:: U+0013E .. LATIN SMALL LETTER L WITH CARON -.. |Lcedil| unicode:: U+0013B .. LATIN CAPITAL LETTER L WITH CEDILLA -.. |lcedil| unicode:: U+0013C .. LATIN SMALL LETTER L WITH CEDILLA -.. |Lmidot| unicode:: U+0013F .. LATIN CAPITAL LETTER L WITH MIDDLE DOT -.. |lmidot| unicode:: U+00140 .. LATIN SMALL LETTER L WITH MIDDLE DOT -.. |Lstrok| unicode:: U+00141 .. LATIN CAPITAL LETTER L WITH STROKE -.. |lstrok| unicode:: U+00142 .. LATIN SMALL LETTER L WITH STROKE -.. |Nacute| unicode:: U+00143 .. LATIN CAPITAL LETTER N WITH ACUTE -.. |nacute| unicode:: U+00144 .. LATIN SMALL LETTER N WITH ACUTE -.. |napos| unicode:: U+00149 .. LATIN SMALL LETTER N PRECEDED BY APOSTROPHE -.. |Ncaron| unicode:: U+00147 .. LATIN CAPITAL LETTER N WITH CARON -.. |ncaron| unicode:: U+00148 .. LATIN SMALL LETTER N WITH CARON -.. |Ncedil| unicode:: U+00145 .. LATIN CAPITAL LETTER N WITH CEDILLA -.. |ncedil| unicode:: U+00146 .. LATIN SMALL LETTER N WITH CEDILLA -.. |Odblac| unicode:: U+00150 .. LATIN CAPITAL LETTER O WITH DOUBLE ACUTE -.. |odblac| unicode:: U+00151 .. LATIN SMALL LETTER O WITH DOUBLE ACUTE -.. |OElig| unicode:: U+00152 .. LATIN CAPITAL LIGATURE OE -.. |oelig| unicode:: U+00153 .. LATIN SMALL LIGATURE OE -.. |Omacr| unicode:: U+0014C .. LATIN CAPITAL LETTER O WITH MACRON -.. |omacr| unicode:: U+0014D .. LATIN SMALL LETTER O WITH MACRON -.. |Racute| unicode:: U+00154 .. LATIN CAPITAL LETTER R WITH ACUTE -.. |racute| unicode:: U+00155 .. LATIN SMALL LETTER R WITH ACUTE -.. |Rcaron| unicode:: U+00158 .. LATIN CAPITAL LETTER R WITH CARON -.. |rcaron| unicode:: U+00159 .. LATIN SMALL LETTER R WITH CARON -.. |Rcedil| unicode:: U+00156 .. LATIN CAPITAL LETTER R WITH CEDILLA -.. |rcedil| unicode:: U+00157 .. LATIN SMALL LETTER R WITH CEDILLA -.. |Sacute| unicode:: U+0015A .. LATIN CAPITAL LETTER S WITH ACUTE -.. |sacute| unicode:: U+0015B .. LATIN SMALL LETTER S WITH ACUTE -.. |Scaron| unicode:: U+00160 .. LATIN CAPITAL LETTER S WITH CARON -.. |scaron| unicode:: U+00161 .. LATIN SMALL LETTER S WITH CARON -.. |Scedil| unicode:: U+0015E .. LATIN CAPITAL LETTER S WITH CEDILLA -.. |scedil| unicode:: U+0015F .. LATIN SMALL LETTER S WITH CEDILLA -.. |Scirc| unicode:: U+0015C .. LATIN CAPITAL LETTER S WITH CIRCUMFLEX -.. |scirc| unicode:: U+0015D .. LATIN SMALL LETTER S WITH CIRCUMFLEX -.. |Tcaron| unicode:: U+00164 .. LATIN CAPITAL LETTER T WITH CARON -.. |tcaron| unicode:: U+00165 .. LATIN SMALL LETTER T WITH CARON -.. |Tcedil| unicode:: U+00162 .. LATIN CAPITAL LETTER T WITH CEDILLA -.. |tcedil| unicode:: U+00163 .. LATIN SMALL LETTER T WITH CEDILLA -.. |Tstrok| unicode:: U+00166 .. LATIN CAPITAL LETTER T WITH STROKE -.. |tstrok| unicode:: U+00167 .. LATIN SMALL LETTER T WITH STROKE -.. |Ubreve| unicode:: U+0016C .. LATIN CAPITAL LETTER U WITH BREVE -.. |ubreve| unicode:: U+0016D .. LATIN SMALL LETTER U WITH BREVE -.. |Udblac| unicode:: U+00170 .. LATIN CAPITAL LETTER U WITH DOUBLE ACUTE -.. |udblac| unicode:: U+00171 .. LATIN SMALL LETTER U WITH DOUBLE ACUTE -.. |Umacr| unicode:: U+0016A .. LATIN CAPITAL LETTER U WITH MACRON -.. |umacr| unicode:: U+0016B .. LATIN SMALL LETTER U WITH MACRON -.. |Uogon| unicode:: U+00172 .. LATIN CAPITAL LETTER U WITH OGONEK -.. |uogon| unicode:: U+00173 .. LATIN SMALL LETTER U WITH OGONEK -.. |Uring| unicode:: U+0016E .. LATIN CAPITAL LETTER U WITH RING ABOVE -.. |uring| unicode:: U+0016F .. LATIN SMALL LETTER U WITH RING ABOVE -.. |Utilde| unicode:: U+00168 .. LATIN CAPITAL LETTER U WITH TILDE -.. |utilde| unicode:: U+00169 .. LATIN SMALL LETTER U WITH TILDE -.. |Wcirc| unicode:: U+00174 .. LATIN CAPITAL LETTER W WITH CIRCUMFLEX -.. |wcirc| unicode:: U+00175 .. LATIN SMALL LETTER W WITH CIRCUMFLEX -.. |Ycirc| unicode:: U+00176 .. LATIN CAPITAL LETTER Y WITH CIRCUMFLEX -.. |ycirc| unicode:: U+00177 .. LATIN SMALL LETTER Y WITH CIRCUMFLEX -.. |Yuml| unicode:: U+00178 .. LATIN CAPITAL LETTER Y WITH DIAERESIS -.. |Zacute| unicode:: U+00179 .. LATIN CAPITAL LETTER Z WITH ACUTE -.. |zacute| unicode:: U+0017A .. LATIN SMALL LETTER Z WITH ACUTE -.. |Zcaron| unicode:: U+0017D .. LATIN CAPITAL LETTER Z WITH CARON -.. |zcaron| unicode:: U+0017E .. LATIN SMALL LETTER Z WITH CARON -.. |Zdot| unicode:: U+0017B .. LATIN CAPITAL LETTER Z WITH DOT ABOVE -.. |zdot| unicode:: U+0017C .. LATIN SMALL LETTER Z WITH DOT ABOVE diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/isomfrk-wide.txt --- a/buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/isomfrk-wide.txt Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,58 +0,0 @@ -.. This data file has been placed in the public domain. -.. Derived from the Unicode character mappings available from - . - Processed by unicode2rstsubs.py, part of Docutils: - . - -.. |Afr| unicode:: U+1D504 .. MATHEMATICAL FRAKTUR CAPITAL A -.. |afr| unicode:: U+1D51E .. MATHEMATICAL FRAKTUR SMALL A -.. |Bfr| unicode:: U+1D505 .. MATHEMATICAL FRAKTUR CAPITAL B -.. |bfr| unicode:: U+1D51F .. MATHEMATICAL FRAKTUR SMALL B -.. |Cfr| unicode:: U+0212D .. BLACK-LETTER CAPITAL C -.. |cfr| unicode:: U+1D520 .. MATHEMATICAL FRAKTUR SMALL C -.. |Dfr| unicode:: U+1D507 .. MATHEMATICAL FRAKTUR CAPITAL D -.. |dfr| unicode:: U+1D521 .. MATHEMATICAL FRAKTUR SMALL D -.. |Efr| unicode:: U+1D508 .. MATHEMATICAL FRAKTUR CAPITAL E -.. |efr| unicode:: U+1D522 .. MATHEMATICAL FRAKTUR SMALL E -.. |Ffr| unicode:: U+1D509 .. MATHEMATICAL FRAKTUR CAPITAL F -.. |ffr| unicode:: U+1D523 .. MATHEMATICAL FRAKTUR SMALL F -.. |Gfr| unicode:: U+1D50A .. MATHEMATICAL FRAKTUR CAPITAL G -.. |gfr| unicode:: U+1D524 .. MATHEMATICAL FRAKTUR SMALL G -.. |Hfr| unicode:: U+0210C .. BLACK-LETTER CAPITAL H -.. |hfr| unicode:: U+1D525 .. MATHEMATICAL FRAKTUR SMALL H -.. |Ifr| unicode:: U+02111 .. BLACK-LETTER CAPITAL I -.. |ifr| unicode:: U+1D526 .. MATHEMATICAL FRAKTUR SMALL I -.. |Jfr| unicode:: U+1D50D .. MATHEMATICAL FRAKTUR CAPITAL J -.. |jfr| unicode:: U+1D527 .. MATHEMATICAL FRAKTUR SMALL J -.. |Kfr| unicode:: U+1D50E .. MATHEMATICAL FRAKTUR CAPITAL K -.. |kfr| unicode:: U+1D528 .. MATHEMATICAL FRAKTUR SMALL K -.. |Lfr| unicode:: U+1D50F .. MATHEMATICAL FRAKTUR CAPITAL L -.. |lfr| unicode:: U+1D529 .. MATHEMATICAL FRAKTUR SMALL L -.. |Mfr| unicode:: U+1D510 .. MATHEMATICAL FRAKTUR CAPITAL M -.. |mfr| unicode:: U+1D52A .. MATHEMATICAL FRAKTUR SMALL M -.. |Nfr| unicode:: U+1D511 .. MATHEMATICAL FRAKTUR CAPITAL N -.. |nfr| unicode:: U+1D52B .. MATHEMATICAL FRAKTUR SMALL N -.. |Ofr| unicode:: U+1D512 .. MATHEMATICAL FRAKTUR CAPITAL O -.. |ofr| unicode:: U+1D52C .. MATHEMATICAL FRAKTUR SMALL O -.. |Pfr| unicode:: U+1D513 .. MATHEMATICAL FRAKTUR CAPITAL P -.. |pfr| unicode:: U+1D52D .. MATHEMATICAL FRAKTUR SMALL P -.. |Qfr| unicode:: U+1D514 .. MATHEMATICAL FRAKTUR CAPITAL Q -.. |qfr| unicode:: U+1D52E .. MATHEMATICAL FRAKTUR SMALL Q -.. |Rfr| unicode:: U+0211C .. BLACK-LETTER CAPITAL R -.. |rfr| unicode:: U+1D52F .. MATHEMATICAL FRAKTUR SMALL R -.. |Sfr| unicode:: U+1D516 .. MATHEMATICAL FRAKTUR CAPITAL S -.. |sfr| unicode:: U+1D530 .. MATHEMATICAL FRAKTUR SMALL S -.. |Tfr| unicode:: U+1D517 .. MATHEMATICAL FRAKTUR CAPITAL T -.. |tfr| unicode:: U+1D531 .. MATHEMATICAL FRAKTUR SMALL T -.. |Ufr| unicode:: U+1D518 .. MATHEMATICAL FRAKTUR CAPITAL U -.. |ufr| unicode:: U+1D532 .. MATHEMATICAL FRAKTUR SMALL U -.. |Vfr| unicode:: U+1D519 .. MATHEMATICAL FRAKTUR CAPITAL V -.. |vfr| unicode:: U+1D533 .. MATHEMATICAL FRAKTUR SMALL V -.. |Wfr| unicode:: U+1D51A .. MATHEMATICAL FRAKTUR CAPITAL W -.. |wfr| unicode:: U+1D534 .. MATHEMATICAL FRAKTUR SMALL W -.. |Xfr| unicode:: U+1D51B .. MATHEMATICAL FRAKTUR CAPITAL X -.. |xfr| unicode:: U+1D535 .. MATHEMATICAL FRAKTUR SMALL X -.. |Yfr| unicode:: U+1D51C .. MATHEMATICAL FRAKTUR CAPITAL Y -.. |yfr| unicode:: U+1D536 .. MATHEMATICAL FRAKTUR SMALL Y -.. |Zfr| unicode:: U+02128 .. BLACK-LETTER CAPITAL Z -.. |zfr| unicode:: U+1D537 .. MATHEMATICAL FRAKTUR SMALL Z diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/isomfrk.txt --- a/buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/isomfrk.txt Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,11 +0,0 @@ -.. This data file has been placed in the public domain. -.. Derived from the Unicode character mappings available from - . - Processed by unicode2rstsubs.py, part of Docutils: - . - -.. |Cfr| unicode:: U+0212D .. BLACK-LETTER CAPITAL C -.. |Hfr| unicode:: U+0210C .. BLACK-LETTER CAPITAL H -.. |Ifr| unicode:: U+02111 .. BLACK-LETTER CAPITAL I -.. |Rfr| unicode:: U+0211C .. BLACK-LETTER CAPITAL R -.. |Zfr| unicode:: U+02128 .. BLACK-LETTER CAPITAL Z diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/isomopf-wide.txt --- a/buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/isomopf-wide.txt Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,32 +0,0 @@ -.. This data file has been placed in the public domain. -.. Derived from the Unicode character mappings available from - . - Processed by unicode2rstsubs.py, part of Docutils: - . - -.. |Aopf| unicode:: U+1D538 .. MATHEMATICAL DOUBLE-STRUCK CAPITAL A -.. |Bopf| unicode:: U+1D539 .. MATHEMATICAL DOUBLE-STRUCK CAPITAL B -.. |Copf| unicode:: U+02102 .. DOUBLE-STRUCK CAPITAL C -.. |Dopf| unicode:: U+1D53B .. MATHEMATICAL DOUBLE-STRUCK CAPITAL D -.. |Eopf| unicode:: U+1D53C .. MATHEMATICAL DOUBLE-STRUCK CAPITAL E -.. |Fopf| unicode:: U+1D53D .. MATHEMATICAL DOUBLE-STRUCK CAPITAL F -.. |Gopf| unicode:: U+1D53E .. MATHEMATICAL DOUBLE-STRUCK CAPITAL G -.. |Hopf| unicode:: U+0210D .. DOUBLE-STRUCK CAPITAL H -.. |Iopf| unicode:: U+1D540 .. MATHEMATICAL DOUBLE-STRUCK CAPITAL I -.. |Jopf| unicode:: U+1D541 .. MATHEMATICAL DOUBLE-STRUCK CAPITAL J -.. |Kopf| unicode:: U+1D542 .. MATHEMATICAL DOUBLE-STRUCK CAPITAL K -.. |Lopf| unicode:: U+1D543 .. MATHEMATICAL DOUBLE-STRUCK CAPITAL L -.. |Mopf| unicode:: U+1D544 .. MATHEMATICAL DOUBLE-STRUCK CAPITAL M -.. |Nopf| unicode:: U+02115 .. DOUBLE-STRUCK CAPITAL N -.. |Oopf| unicode:: U+1D546 .. MATHEMATICAL DOUBLE-STRUCK CAPITAL O -.. |Popf| unicode:: U+02119 .. DOUBLE-STRUCK CAPITAL P -.. |Qopf| unicode:: U+0211A .. DOUBLE-STRUCK CAPITAL Q -.. |Ropf| unicode:: U+0211D .. DOUBLE-STRUCK CAPITAL R -.. |Sopf| unicode:: U+1D54A .. MATHEMATICAL DOUBLE-STRUCK CAPITAL S -.. |Topf| unicode:: U+1D54B .. MATHEMATICAL DOUBLE-STRUCK CAPITAL T -.. |Uopf| unicode:: U+1D54C .. MATHEMATICAL DOUBLE-STRUCK CAPITAL U -.. |Vopf| unicode:: U+1D54D .. MATHEMATICAL DOUBLE-STRUCK CAPITAL V -.. |Wopf| unicode:: U+1D54E .. MATHEMATICAL DOUBLE-STRUCK CAPITAL W -.. |Xopf| unicode:: U+1D54F .. MATHEMATICAL DOUBLE-STRUCK CAPITAL X -.. |Yopf| unicode:: U+1D550 .. MATHEMATICAL DOUBLE-STRUCK CAPITAL Y -.. |Zopf| unicode:: U+02124 .. DOUBLE-STRUCK CAPITAL Z diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/isomopf.txt --- a/buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/isomopf.txt Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,13 +0,0 @@ -.. This data file has been placed in the public domain. -.. Derived from the Unicode character mappings available from - . - Processed by unicode2rstsubs.py, part of Docutils: - . - -.. |Copf| unicode:: U+02102 .. DOUBLE-STRUCK CAPITAL C -.. |Hopf| unicode:: U+0210D .. DOUBLE-STRUCK CAPITAL H -.. |Nopf| unicode:: U+02115 .. DOUBLE-STRUCK CAPITAL N -.. |Popf| unicode:: U+02119 .. DOUBLE-STRUCK CAPITAL P -.. |Qopf| unicode:: U+0211A .. DOUBLE-STRUCK CAPITAL Q -.. |Ropf| unicode:: U+0211D .. DOUBLE-STRUCK CAPITAL R -.. |Zopf| unicode:: U+02124 .. DOUBLE-STRUCK CAPITAL Z diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/isomscr-wide.txt --- a/buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/isomscr-wide.txt Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,58 +0,0 @@ -.. This data file has been placed in the public domain. -.. Derived from the Unicode character mappings available from - . - Processed by unicode2rstsubs.py, part of Docutils: - . - -.. |Ascr| unicode:: U+1D49C .. MATHEMATICAL SCRIPT CAPITAL A -.. |ascr| unicode:: U+1D4B6 .. MATHEMATICAL SCRIPT SMALL A -.. |Bscr| unicode:: U+0212C .. SCRIPT CAPITAL B -.. |bscr| unicode:: U+1D4B7 .. MATHEMATICAL SCRIPT SMALL B -.. |Cscr| unicode:: U+1D49E .. MATHEMATICAL SCRIPT CAPITAL C -.. |cscr| unicode:: U+1D4B8 .. MATHEMATICAL SCRIPT SMALL C -.. |Dscr| unicode:: U+1D49F .. MATHEMATICAL SCRIPT CAPITAL D -.. |dscr| unicode:: U+1D4B9 .. MATHEMATICAL SCRIPT SMALL D -.. |Escr| unicode:: U+02130 .. SCRIPT CAPITAL E -.. |escr| unicode:: U+0212F .. SCRIPT SMALL E -.. |Fscr| unicode:: U+02131 .. SCRIPT CAPITAL F -.. |fscr| unicode:: U+1D4BB .. MATHEMATICAL SCRIPT SMALL F -.. |Gscr| unicode:: U+1D4A2 .. MATHEMATICAL SCRIPT CAPITAL G -.. |gscr| unicode:: U+0210A .. SCRIPT SMALL G -.. |Hscr| unicode:: U+0210B .. SCRIPT CAPITAL H -.. |hscr| unicode:: U+1D4BD .. MATHEMATICAL SCRIPT SMALL H -.. |Iscr| unicode:: U+02110 .. SCRIPT CAPITAL I -.. |iscr| unicode:: U+1D4BE .. MATHEMATICAL SCRIPT SMALL I -.. |Jscr| unicode:: U+1D4A5 .. MATHEMATICAL SCRIPT CAPITAL J -.. |jscr| unicode:: U+1D4BF .. MATHEMATICAL SCRIPT SMALL J -.. |Kscr| unicode:: U+1D4A6 .. MATHEMATICAL SCRIPT CAPITAL K -.. |kscr| unicode:: U+1D4C0 .. MATHEMATICAL SCRIPT SMALL K -.. |Lscr| unicode:: U+02112 .. SCRIPT CAPITAL L -.. |lscr| unicode:: U+1D4C1 .. MATHEMATICAL SCRIPT SMALL L -.. |Mscr| unicode:: U+02133 .. SCRIPT CAPITAL M -.. |mscr| unicode:: U+1D4C2 .. MATHEMATICAL SCRIPT SMALL M -.. |Nscr| unicode:: U+1D4A9 .. MATHEMATICAL SCRIPT CAPITAL N -.. |nscr| unicode:: U+1D4C3 .. MATHEMATICAL SCRIPT SMALL N -.. |Oscr| unicode:: U+1D4AA .. MATHEMATICAL SCRIPT CAPITAL O -.. |oscr| unicode:: U+02134 .. SCRIPT SMALL O -.. |Pscr| unicode:: U+1D4AB .. MATHEMATICAL SCRIPT CAPITAL P -.. |pscr| unicode:: U+1D4C5 .. MATHEMATICAL SCRIPT SMALL P -.. |Qscr| unicode:: U+1D4AC .. MATHEMATICAL SCRIPT CAPITAL Q -.. |qscr| unicode:: U+1D4C6 .. MATHEMATICAL SCRIPT SMALL Q -.. |Rscr| unicode:: U+0211B .. SCRIPT CAPITAL R -.. |rscr| unicode:: U+1D4C7 .. MATHEMATICAL SCRIPT SMALL R -.. |Sscr| unicode:: U+1D4AE .. MATHEMATICAL SCRIPT CAPITAL S -.. |sscr| unicode:: U+1D4C8 .. MATHEMATICAL SCRIPT SMALL S -.. |Tscr| unicode:: U+1D4AF .. MATHEMATICAL SCRIPT CAPITAL T -.. |tscr| unicode:: U+1D4C9 .. MATHEMATICAL SCRIPT SMALL T -.. |Uscr| unicode:: U+1D4B0 .. MATHEMATICAL SCRIPT CAPITAL U -.. |uscr| unicode:: U+1D4CA .. MATHEMATICAL SCRIPT SMALL U -.. |Vscr| unicode:: U+1D4B1 .. MATHEMATICAL SCRIPT CAPITAL V -.. |vscr| unicode:: U+1D4CB .. MATHEMATICAL SCRIPT SMALL V -.. |Wscr| unicode:: U+1D4B2 .. MATHEMATICAL SCRIPT CAPITAL W -.. |wscr| unicode:: U+1D4CC .. MATHEMATICAL SCRIPT SMALL W -.. |Xscr| unicode:: U+1D4B3 .. MATHEMATICAL SCRIPT CAPITAL X -.. |xscr| unicode:: U+1D4CD .. MATHEMATICAL SCRIPT SMALL X -.. |Yscr| unicode:: U+1D4B4 .. MATHEMATICAL SCRIPT CAPITAL Y -.. |yscr| unicode:: U+1D4CE .. MATHEMATICAL SCRIPT SMALL Y -.. |Zscr| unicode:: U+1D4B5 .. MATHEMATICAL SCRIPT CAPITAL Z -.. |zscr| unicode:: U+1D4CF .. MATHEMATICAL SCRIPT SMALL Z diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/isomscr.txt --- a/buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/isomscr.txt Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,17 +0,0 @@ -.. This data file has been placed in the public domain. -.. Derived from the Unicode character mappings available from - . - Processed by unicode2rstsubs.py, part of Docutils: - . - -.. |Bscr| unicode:: U+0212C .. SCRIPT CAPITAL B -.. |Escr| unicode:: U+02130 .. SCRIPT CAPITAL E -.. |escr| unicode:: U+0212F .. SCRIPT SMALL E -.. |Fscr| unicode:: U+02131 .. SCRIPT CAPITAL F -.. |gscr| unicode:: U+0210A .. SCRIPT SMALL G -.. |Hscr| unicode:: U+0210B .. SCRIPT CAPITAL H -.. |Iscr| unicode:: U+02110 .. SCRIPT CAPITAL I -.. |Lscr| unicode:: U+02112 .. SCRIPT CAPITAL L -.. |Mscr| unicode:: U+02133 .. SCRIPT CAPITAL M -.. |oscr| unicode:: U+02134 .. SCRIPT SMALL O -.. |Rscr| unicode:: U+0211B .. SCRIPT CAPITAL R diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/isonum.txt --- a/buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/isonum.txt Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,82 +0,0 @@ -.. This data file has been placed in the public domain. -.. Derived from the Unicode character mappings available from - . - Processed by unicode2rstsubs.py, part of Docutils: - . - -.. |amp| unicode:: U+00026 .. AMPERSAND -.. |apos| unicode:: U+00027 .. APOSTROPHE -.. |ast| unicode:: U+0002A .. ASTERISK -.. |brvbar| unicode:: U+000A6 .. BROKEN BAR -.. |bsol| unicode:: U+0005C .. REVERSE SOLIDUS -.. |cent| unicode:: U+000A2 .. CENT SIGN -.. |colon| unicode:: U+0003A .. COLON -.. |comma| unicode:: U+0002C .. COMMA -.. |commat| unicode:: U+00040 .. COMMERCIAL AT -.. |copy| unicode:: U+000A9 .. COPYRIGHT SIGN -.. |curren| unicode:: U+000A4 .. CURRENCY SIGN -.. |darr| unicode:: U+02193 .. DOWNWARDS ARROW -.. |deg| unicode:: U+000B0 .. DEGREE SIGN -.. |divide| unicode:: U+000F7 .. DIVISION SIGN -.. |dollar| unicode:: U+00024 .. DOLLAR SIGN -.. |equals| unicode:: U+0003D .. EQUALS SIGN -.. |excl| unicode:: U+00021 .. EXCLAMATION MARK -.. |frac12| unicode:: U+000BD .. VULGAR FRACTION ONE HALF -.. |frac14| unicode:: U+000BC .. VULGAR FRACTION ONE QUARTER -.. |frac18| unicode:: U+0215B .. VULGAR FRACTION ONE EIGHTH -.. |frac34| unicode:: U+000BE .. VULGAR FRACTION THREE QUARTERS -.. |frac38| unicode:: U+0215C .. VULGAR FRACTION THREE EIGHTHS -.. |frac58| unicode:: U+0215D .. VULGAR FRACTION FIVE EIGHTHS -.. |frac78| unicode:: U+0215E .. VULGAR FRACTION SEVEN EIGHTHS -.. |gt| unicode:: U+0003E .. GREATER-THAN SIGN -.. |half| unicode:: U+000BD .. VULGAR FRACTION ONE HALF -.. |horbar| unicode:: U+02015 .. HORIZONTAL BAR -.. |hyphen| unicode:: U+02010 .. HYPHEN -.. |iexcl| unicode:: U+000A1 .. INVERTED EXCLAMATION MARK -.. |iquest| unicode:: U+000BF .. INVERTED QUESTION MARK -.. |laquo| unicode:: U+000AB .. LEFT-POINTING DOUBLE ANGLE QUOTATION MARK -.. |larr| unicode:: U+02190 .. LEFTWARDS ARROW -.. |lcub| unicode:: U+0007B .. LEFT CURLY BRACKET -.. |ldquo| unicode:: U+0201C .. LEFT DOUBLE QUOTATION MARK -.. |lowbar| unicode:: U+0005F .. LOW LINE -.. |lpar| unicode:: U+00028 .. LEFT PARENTHESIS -.. |lsqb| unicode:: U+0005B .. LEFT SQUARE BRACKET -.. |lsquo| unicode:: U+02018 .. LEFT SINGLE QUOTATION MARK -.. |lt| unicode:: U+0003C .. LESS-THAN SIGN -.. |micro| unicode:: U+000B5 .. MICRO SIGN -.. |middot| unicode:: U+000B7 .. MIDDLE DOT -.. |nbsp| unicode:: U+000A0 .. NO-BREAK SPACE -.. |not| unicode:: U+000AC .. NOT SIGN -.. |num| unicode:: U+00023 .. NUMBER SIGN -.. |ohm| unicode:: U+02126 .. OHM SIGN -.. |ordf| unicode:: U+000AA .. FEMININE ORDINAL INDICATOR -.. |ordm| unicode:: U+000BA .. MASCULINE ORDINAL INDICATOR -.. |para| unicode:: U+000B6 .. PILCROW SIGN -.. |percnt| unicode:: U+00025 .. PERCENT SIGN -.. |period| unicode:: U+0002E .. FULL STOP -.. |plus| unicode:: U+0002B .. PLUS SIGN -.. |plusmn| unicode:: U+000B1 .. PLUS-MINUS SIGN -.. |pound| unicode:: U+000A3 .. POUND SIGN -.. |quest| unicode:: U+0003F .. QUESTION MARK -.. |quot| unicode:: U+00022 .. QUOTATION MARK -.. |raquo| unicode:: U+000BB .. RIGHT-POINTING DOUBLE ANGLE QUOTATION MARK -.. |rarr| unicode:: U+02192 .. RIGHTWARDS ARROW -.. |rcub| unicode:: U+0007D .. RIGHT CURLY BRACKET -.. |rdquo| unicode:: U+0201D .. RIGHT DOUBLE QUOTATION MARK -.. |reg| unicode:: U+000AE .. REGISTERED SIGN -.. |rpar| unicode:: U+00029 .. RIGHT PARENTHESIS -.. |rsqb| unicode:: U+0005D .. RIGHT SQUARE BRACKET -.. |rsquo| unicode:: U+02019 .. RIGHT SINGLE QUOTATION MARK -.. |sect| unicode:: U+000A7 .. SECTION SIGN -.. |semi| unicode:: U+0003B .. SEMICOLON -.. |shy| unicode:: U+000AD .. SOFT HYPHEN -.. |sol| unicode:: U+0002F .. SOLIDUS -.. |sung| unicode:: U+0266A .. EIGHTH NOTE -.. |sup1| unicode:: U+000B9 .. SUPERSCRIPT ONE -.. |sup2| unicode:: U+000B2 .. SUPERSCRIPT TWO -.. |sup3| unicode:: U+000B3 .. SUPERSCRIPT THREE -.. |times| unicode:: U+000D7 .. MULTIPLICATION SIGN -.. |trade| unicode:: U+02122 .. TRADE MARK SIGN -.. |uarr| unicode:: U+02191 .. UPWARDS ARROW -.. |verbar| unicode:: U+0007C .. VERTICAL LINE -.. |yen| unicode:: U+000A5 .. YEN SIGN diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/isopub.txt --- a/buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/isopub.txt Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,90 +0,0 @@ -.. This data file has been placed in the public domain. -.. Derived from the Unicode character mappings available from - . - Processed by unicode2rstsubs.py, part of Docutils: - . - -.. |blank| unicode:: U+02423 .. OPEN BOX -.. |blk12| unicode:: U+02592 .. MEDIUM SHADE -.. |blk14| unicode:: U+02591 .. LIGHT SHADE -.. |blk34| unicode:: U+02593 .. DARK SHADE -.. |block| unicode:: U+02588 .. FULL BLOCK -.. |bull| unicode:: U+02022 .. BULLET -.. |caret| unicode:: U+02041 .. CARET INSERTION POINT -.. |check| unicode:: U+02713 .. CHECK MARK -.. |cir| unicode:: U+025CB .. WHITE CIRCLE -.. |clubs| unicode:: U+02663 .. BLACK CLUB SUIT -.. |copysr| unicode:: U+02117 .. SOUND RECORDING COPYRIGHT -.. |cross| unicode:: U+02717 .. BALLOT X -.. |Dagger| unicode:: U+02021 .. DOUBLE DAGGER -.. |dagger| unicode:: U+02020 .. DAGGER -.. |dash| unicode:: U+02010 .. HYPHEN -.. |diams| unicode:: U+02666 .. BLACK DIAMOND SUIT -.. |dlcrop| unicode:: U+0230D .. BOTTOM LEFT CROP -.. |drcrop| unicode:: U+0230C .. BOTTOM RIGHT CROP -.. |dtri| unicode:: U+025BF .. WHITE DOWN-POINTING SMALL TRIANGLE -.. |dtrif| unicode:: U+025BE .. BLACK DOWN-POINTING SMALL TRIANGLE -.. |emsp| unicode:: U+02003 .. EM SPACE -.. |emsp13| unicode:: U+02004 .. THREE-PER-EM SPACE -.. |emsp14| unicode:: U+02005 .. FOUR-PER-EM SPACE -.. |ensp| unicode:: U+02002 .. EN SPACE -.. |female| unicode:: U+02640 .. FEMALE SIGN -.. |ffilig| unicode:: U+0FB03 .. LATIN SMALL LIGATURE FFI -.. |fflig| unicode:: U+0FB00 .. LATIN SMALL LIGATURE FF -.. |ffllig| unicode:: U+0FB04 .. LATIN SMALL LIGATURE FFL -.. |filig| unicode:: U+0FB01 .. LATIN SMALL LIGATURE FI -.. |flat| unicode:: U+0266D .. MUSIC FLAT SIGN -.. |fllig| unicode:: U+0FB02 .. LATIN SMALL LIGATURE FL -.. |frac13| unicode:: U+02153 .. VULGAR FRACTION ONE THIRD -.. |frac15| unicode:: U+02155 .. VULGAR FRACTION ONE FIFTH -.. |frac16| unicode:: U+02159 .. VULGAR FRACTION ONE SIXTH -.. |frac23| unicode:: U+02154 .. VULGAR FRACTION TWO THIRDS -.. |frac25| unicode:: U+02156 .. VULGAR FRACTION TWO FIFTHS -.. |frac35| unicode:: U+02157 .. VULGAR FRACTION THREE FIFTHS -.. |frac45| unicode:: U+02158 .. VULGAR FRACTION FOUR FIFTHS -.. |frac56| unicode:: U+0215A .. VULGAR FRACTION FIVE SIXTHS -.. |hairsp| unicode:: U+0200A .. HAIR SPACE -.. |hearts| unicode:: U+02665 .. BLACK HEART SUIT -.. |hellip| unicode:: U+02026 .. HORIZONTAL ELLIPSIS -.. |hybull| unicode:: U+02043 .. HYPHEN BULLET -.. |incare| unicode:: U+02105 .. CARE OF -.. |ldquor| unicode:: U+0201E .. DOUBLE LOW-9 QUOTATION MARK -.. |lhblk| unicode:: U+02584 .. LOWER HALF BLOCK -.. |loz| unicode:: U+025CA .. LOZENGE -.. |lozf| unicode:: U+029EB .. BLACK LOZENGE -.. |lsquor| unicode:: U+0201A .. SINGLE LOW-9 QUOTATION MARK -.. |ltri| unicode:: U+025C3 .. WHITE LEFT-POINTING SMALL TRIANGLE -.. |ltrif| unicode:: U+025C2 .. BLACK LEFT-POINTING SMALL TRIANGLE -.. |male| unicode:: U+02642 .. MALE SIGN -.. |malt| unicode:: U+02720 .. MALTESE CROSS -.. |marker| unicode:: U+025AE .. BLACK VERTICAL RECTANGLE -.. |mdash| unicode:: U+02014 .. EM DASH -.. |mldr| unicode:: U+02026 .. HORIZONTAL ELLIPSIS -.. |natur| unicode:: U+0266E .. MUSIC NATURAL SIGN -.. |ndash| unicode:: U+02013 .. EN DASH -.. |nldr| unicode:: U+02025 .. TWO DOT LEADER -.. |numsp| unicode:: U+02007 .. FIGURE SPACE -.. |phone| unicode:: U+0260E .. BLACK TELEPHONE -.. |puncsp| unicode:: U+02008 .. PUNCTUATION SPACE -.. |rdquor| unicode:: U+0201D .. RIGHT DOUBLE QUOTATION MARK -.. |rect| unicode:: U+025AD .. WHITE RECTANGLE -.. |rsquor| unicode:: U+02019 .. RIGHT SINGLE QUOTATION MARK -.. |rtri| unicode:: U+025B9 .. WHITE RIGHT-POINTING SMALL TRIANGLE -.. |rtrif| unicode:: U+025B8 .. BLACK RIGHT-POINTING SMALL TRIANGLE -.. |rx| unicode:: U+0211E .. PRESCRIPTION TAKE -.. |sext| unicode:: U+02736 .. SIX POINTED BLACK STAR -.. |sharp| unicode:: U+0266F .. MUSIC SHARP SIGN -.. |spades| unicode:: U+02660 .. BLACK SPADE SUIT -.. |squ| unicode:: U+025A1 .. WHITE SQUARE -.. |squf| unicode:: U+025AA .. BLACK SMALL SQUARE -.. |star| unicode:: U+02606 .. WHITE STAR -.. |starf| unicode:: U+02605 .. BLACK STAR -.. |target| unicode:: U+02316 .. POSITION INDICATOR -.. |telrec| unicode:: U+02315 .. TELEPHONE RECORDER -.. |thinsp| unicode:: U+02009 .. THIN SPACE -.. |uhblk| unicode:: U+02580 .. UPPER HALF BLOCK -.. |ulcrop| unicode:: U+0230F .. TOP LEFT CROP -.. |urcrop| unicode:: U+0230E .. TOP RIGHT CROP -.. |utri| unicode:: U+025B5 .. WHITE UP-POINTING SMALL TRIANGLE -.. |utrif| unicode:: U+025B4 .. BLACK UP-POINTING SMALL TRIANGLE -.. |vellip| unicode:: U+022EE .. VERTICAL ELLIPSIS diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/isotech.txt --- a/buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/isotech.txt Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,168 +0,0 @@ -.. This data file has been placed in the public domain. -.. Derived from the Unicode character mappings available from - . - Processed by unicode2rstsubs.py, part of Docutils: - . - -.. |acd| unicode:: U+0223F .. SINE WAVE -.. |aleph| unicode:: U+02135 .. ALEF SYMBOL -.. |And| unicode:: U+02A53 .. DOUBLE LOGICAL AND -.. |and| unicode:: U+02227 .. LOGICAL AND -.. |andand| unicode:: U+02A55 .. TWO INTERSECTING LOGICAL AND -.. |andd| unicode:: U+02A5C .. LOGICAL AND WITH HORIZONTAL DASH -.. |andslope| unicode:: U+02A58 .. SLOPING LARGE AND -.. |andv| unicode:: U+02A5A .. LOGICAL AND WITH MIDDLE STEM -.. |ang90| unicode:: U+0221F .. RIGHT ANGLE -.. |angrt| unicode:: U+0221F .. RIGHT ANGLE -.. |angsph| unicode:: U+02222 .. SPHERICAL ANGLE -.. |angst| unicode:: U+0212B .. ANGSTROM SIGN -.. |ap| unicode:: U+02248 .. ALMOST EQUAL TO -.. |apacir| unicode:: U+02A6F .. ALMOST EQUAL TO WITH CIRCUMFLEX ACCENT -.. |awconint| unicode:: U+02233 .. ANTICLOCKWISE CONTOUR INTEGRAL -.. |awint| unicode:: U+02A11 .. ANTICLOCKWISE INTEGRATION -.. |becaus| unicode:: U+02235 .. BECAUSE -.. |bernou| unicode:: U+0212C .. SCRIPT CAPITAL B -.. |bne| unicode:: U+0003D U+020E5 .. EQUALS SIGN with reverse slash -.. |bnequiv| unicode:: U+02261 U+020E5 .. IDENTICAL TO with reverse slash -.. |bNot| unicode:: U+02AED .. REVERSED DOUBLE STROKE NOT SIGN -.. |bnot| unicode:: U+02310 .. REVERSED NOT SIGN -.. |bottom| unicode:: U+022A5 .. UP TACK -.. |cap| unicode:: U+02229 .. INTERSECTION -.. |Cconint| unicode:: U+02230 .. VOLUME INTEGRAL -.. |cirfnint| unicode:: U+02A10 .. CIRCULATION FUNCTION -.. |compfn| unicode:: U+02218 .. RING OPERATOR -.. |cong| unicode:: U+02245 .. APPROXIMATELY EQUAL TO -.. |Conint| unicode:: U+0222F .. SURFACE INTEGRAL -.. |conint| unicode:: U+0222E .. CONTOUR INTEGRAL -.. |ctdot| unicode:: U+022EF .. MIDLINE HORIZONTAL ELLIPSIS -.. |cup| unicode:: U+0222A .. UNION -.. |cwconint| unicode:: U+02232 .. CLOCKWISE CONTOUR INTEGRAL -.. |cwint| unicode:: U+02231 .. CLOCKWISE INTEGRAL -.. |cylcty| unicode:: U+0232D .. CYLINDRICITY -.. |disin| unicode:: U+022F2 .. ELEMENT OF WITH LONG HORIZONTAL STROKE -.. |Dot| unicode:: U+000A8 .. DIAERESIS -.. |DotDot| unicode:: U+020DC .. COMBINING FOUR DOTS ABOVE -.. |dsol| unicode:: U+029F6 .. SOLIDUS WITH OVERBAR -.. |dtdot| unicode:: U+022F1 .. DOWN RIGHT DIAGONAL ELLIPSIS -.. |dwangle| unicode:: U+029A6 .. OBLIQUE ANGLE OPENING UP -.. |elinters| unicode:: U+0FFFD .. REPLACEMENT CHARACTER -.. |epar| unicode:: U+022D5 .. EQUAL AND PARALLEL TO -.. |eparsl| unicode:: U+029E3 .. EQUALS SIGN AND SLANTED PARALLEL -.. |equiv| unicode:: U+02261 .. IDENTICAL TO -.. |eqvparsl| unicode:: U+029E5 .. IDENTICAL TO AND SLANTED PARALLEL -.. |exist| unicode:: U+02203 .. THERE EXISTS -.. |fltns| unicode:: U+025B1 .. WHITE PARALLELOGRAM -.. |fnof| unicode:: U+00192 .. LATIN SMALL LETTER F WITH HOOK -.. |forall| unicode:: U+02200 .. FOR ALL -.. |fpartint| unicode:: U+02A0D .. FINITE PART INTEGRAL -.. |ge| unicode:: U+02265 .. GREATER-THAN OR EQUAL TO -.. |hamilt| unicode:: U+0210B .. SCRIPT CAPITAL H -.. |iff| unicode:: U+021D4 .. LEFT RIGHT DOUBLE ARROW -.. |iinfin| unicode:: U+029DC .. INCOMPLETE INFINITY -.. |imped| unicode:: U+001B5 .. LATIN CAPITAL LETTER Z WITH STROKE -.. |infin| unicode:: U+0221E .. INFINITY -.. |infintie| unicode:: U+029DD .. TIE OVER INFINITY -.. |Int| unicode:: U+0222C .. DOUBLE INTEGRAL -.. |int| unicode:: U+0222B .. INTEGRAL -.. |intlarhk| unicode:: U+02A17 .. INTEGRAL WITH LEFTWARDS ARROW WITH HOOK -.. |isin| unicode:: U+02208 .. ELEMENT OF -.. |isindot| unicode:: U+022F5 .. ELEMENT OF WITH DOT ABOVE -.. |isinE| unicode:: U+022F9 .. ELEMENT OF WITH TWO HORIZONTAL STROKES -.. |isins| unicode:: U+022F4 .. SMALL ELEMENT OF WITH VERTICAL BAR AT END OF HORIZONTAL STROKE -.. |isinsv| unicode:: U+022F3 .. ELEMENT OF WITH VERTICAL BAR AT END OF HORIZONTAL STROKE -.. |isinv| unicode:: U+02208 .. ELEMENT OF -.. |lagran| unicode:: U+02112 .. SCRIPT CAPITAL L -.. |Lang| unicode:: U+0300A .. LEFT DOUBLE ANGLE BRACKET -.. |lang| unicode:: U+02329 .. LEFT-POINTING ANGLE BRACKET -.. |lArr| unicode:: U+021D0 .. LEFTWARDS DOUBLE ARROW -.. |lbbrk| unicode:: U+03014 .. LEFT TORTOISE SHELL BRACKET -.. |le| unicode:: U+02264 .. LESS-THAN OR EQUAL TO -.. |loang| unicode:: U+03018 .. LEFT WHITE TORTOISE SHELL BRACKET -.. |lobrk| unicode:: U+0301A .. LEFT WHITE SQUARE BRACKET -.. |lopar| unicode:: U+02985 .. LEFT WHITE PARENTHESIS -.. |lowast| unicode:: U+02217 .. ASTERISK OPERATOR -.. |minus| unicode:: U+02212 .. MINUS SIGN -.. |mnplus| unicode:: U+02213 .. MINUS-OR-PLUS SIGN -.. |nabla| unicode:: U+02207 .. NABLA -.. |ne| unicode:: U+02260 .. NOT EQUAL TO -.. |nedot| unicode:: U+02250 U+00338 .. APPROACHES THE LIMIT with slash -.. |nhpar| unicode:: U+02AF2 .. PARALLEL WITH HORIZONTAL STROKE -.. |ni| unicode:: U+0220B .. CONTAINS AS MEMBER -.. |nis| unicode:: U+022FC .. SMALL CONTAINS WITH VERTICAL BAR AT END OF HORIZONTAL STROKE -.. |nisd| unicode:: U+022FA .. CONTAINS WITH LONG HORIZONTAL STROKE -.. |niv| unicode:: U+0220B .. CONTAINS AS MEMBER -.. |Not| unicode:: U+02AEC .. DOUBLE STROKE NOT SIGN -.. |notin| unicode:: U+02209 .. NOT AN ELEMENT OF -.. |notindot| unicode:: U+022F5 U+00338 .. ELEMENT OF WITH DOT ABOVE with slash -.. |notinE| unicode:: U+022F9 U+00338 .. ELEMENT OF WITH TWO HORIZONTAL STROKES with slash -.. |notinva| unicode:: U+02209 .. NOT AN ELEMENT OF -.. |notinvb| unicode:: U+022F7 .. SMALL ELEMENT OF WITH OVERBAR -.. |notinvc| unicode:: U+022F6 .. ELEMENT OF WITH OVERBAR -.. |notni| unicode:: U+0220C .. DOES NOT CONTAIN AS MEMBER -.. |notniva| unicode:: U+0220C .. DOES NOT CONTAIN AS MEMBER -.. |notnivb| unicode:: U+022FE .. SMALL CONTAINS WITH OVERBAR -.. |notnivc| unicode:: U+022FD .. CONTAINS WITH OVERBAR -.. |nparsl| unicode:: U+02AFD U+020E5 .. DOUBLE SOLIDUS OPERATOR with reverse slash -.. |npart| unicode:: U+02202 U+00338 .. PARTIAL DIFFERENTIAL with slash -.. |npolint| unicode:: U+02A14 .. LINE INTEGRATION NOT INCLUDING THE POLE -.. |nvinfin| unicode:: U+029DE .. INFINITY NEGATED WITH VERTICAL BAR -.. |olcross| unicode:: U+029BB .. CIRCLE WITH SUPERIMPOSED X -.. |Or| unicode:: U+02A54 .. DOUBLE LOGICAL OR -.. |or| unicode:: U+02228 .. LOGICAL OR -.. |ord| unicode:: U+02A5D .. LOGICAL OR WITH HORIZONTAL DASH -.. |order| unicode:: U+02134 .. SCRIPT SMALL O -.. |oror| unicode:: U+02A56 .. TWO INTERSECTING LOGICAL OR -.. |orslope| unicode:: U+02A57 .. SLOPING LARGE OR -.. |orv| unicode:: U+02A5B .. LOGICAL OR WITH MIDDLE STEM -.. |par| unicode:: U+02225 .. PARALLEL TO -.. |parsl| unicode:: U+02AFD .. DOUBLE SOLIDUS OPERATOR -.. |part| unicode:: U+02202 .. PARTIAL DIFFERENTIAL -.. |permil| unicode:: U+02030 .. PER MILLE SIGN -.. |perp| unicode:: U+022A5 .. UP TACK -.. |pertenk| unicode:: U+02031 .. PER TEN THOUSAND SIGN -.. |phmmat| unicode:: U+02133 .. SCRIPT CAPITAL M -.. |pointint| unicode:: U+02A15 .. INTEGRAL AROUND A POINT OPERATOR -.. |Prime| unicode:: U+02033 .. DOUBLE PRIME -.. |prime| unicode:: U+02032 .. PRIME -.. |profalar| unicode:: U+0232E .. ALL AROUND-PROFILE -.. |profline| unicode:: U+02312 .. ARC -.. |profsurf| unicode:: U+02313 .. SEGMENT -.. |prop| unicode:: U+0221D .. PROPORTIONAL TO -.. |qint| unicode:: U+02A0C .. QUADRUPLE INTEGRAL OPERATOR -.. |qprime| unicode:: U+02057 .. QUADRUPLE PRIME -.. |quatint| unicode:: U+02A16 .. QUATERNION INTEGRAL OPERATOR -.. |radic| unicode:: U+0221A .. SQUARE ROOT -.. |Rang| unicode:: U+0300B .. RIGHT DOUBLE ANGLE BRACKET -.. |rang| unicode:: U+0232A .. RIGHT-POINTING ANGLE BRACKET -.. |rArr| unicode:: U+021D2 .. RIGHTWARDS DOUBLE ARROW -.. |rbbrk| unicode:: U+03015 .. RIGHT TORTOISE SHELL BRACKET -.. |roang| unicode:: U+03019 .. RIGHT WHITE TORTOISE SHELL BRACKET -.. |robrk| unicode:: U+0301B .. RIGHT WHITE SQUARE BRACKET -.. |ropar| unicode:: U+02986 .. RIGHT WHITE PARENTHESIS -.. |rppolint| unicode:: U+02A12 .. LINE INTEGRATION WITH RECTANGULAR PATH AROUND POLE -.. |scpolint| unicode:: U+02A13 .. LINE INTEGRATION WITH SEMICIRCULAR PATH AROUND POLE -.. |sim| unicode:: U+0223C .. TILDE OPERATOR -.. |simdot| unicode:: U+02A6A .. TILDE OPERATOR WITH DOT ABOVE -.. |sime| unicode:: U+02243 .. ASYMPTOTICALLY EQUAL TO -.. |smeparsl| unicode:: U+029E4 .. EQUALS SIGN AND SLANTED PARALLEL WITH TILDE ABOVE -.. |square| unicode:: U+025A1 .. WHITE SQUARE -.. |squarf| unicode:: U+025AA .. BLACK SMALL SQUARE -.. |strns| unicode:: U+000AF .. MACRON -.. |sub| unicode:: U+02282 .. SUBSET OF -.. |sube| unicode:: U+02286 .. SUBSET OF OR EQUAL TO -.. |sup| unicode:: U+02283 .. SUPERSET OF -.. |supe| unicode:: U+02287 .. SUPERSET OF OR EQUAL TO -.. |tdot| unicode:: U+020DB .. COMBINING THREE DOTS ABOVE -.. |there4| unicode:: U+02234 .. THEREFORE -.. |tint| unicode:: U+0222D .. TRIPLE INTEGRAL -.. |top| unicode:: U+022A4 .. DOWN TACK -.. |topbot| unicode:: U+02336 .. APL FUNCTIONAL SYMBOL I-BEAM -.. |topcir| unicode:: U+02AF1 .. DOWN TACK WITH CIRCLE BELOW -.. |tprime| unicode:: U+02034 .. TRIPLE PRIME -.. |utdot| unicode:: U+022F0 .. UP RIGHT DIAGONAL ELLIPSIS -.. |uwangle| unicode:: U+029A7 .. OBLIQUE ANGLE OPENING DOWN -.. |vangrt| unicode:: U+0299C .. RIGHT ANGLE VARIANT WITH SQUARE -.. |veeeq| unicode:: U+0225A .. EQUIANGULAR TO -.. |Verbar| unicode:: U+02016 .. DOUBLE VERTICAL LINE -.. |wedgeq| unicode:: U+02259 .. ESTIMATES -.. |xnis| unicode:: U+022FB .. CONTAINS WITH VERTICAL BAR AT END OF HORIZONTAL STROKE diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/mmlalias.txt --- a/buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/mmlalias.txt Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,554 +0,0 @@ -.. This data file has been placed in the public domain. -.. Derived from the Unicode character mappings available from - . - Processed by unicode2rstsubs.py, part of Docutils: - . - -.. |angle| unicode:: U+02220 .. ANGLE -.. |ApplyFunction| unicode:: U+02061 .. FUNCTION APPLICATION -.. |approx| unicode:: U+02248 .. ALMOST EQUAL TO -.. |approxeq| unicode:: U+0224A .. ALMOST EQUAL OR EQUAL TO -.. |Assign| unicode:: U+02254 .. COLON EQUALS -.. |backcong| unicode:: U+0224C .. ALL EQUAL TO -.. |backepsilon| unicode:: U+003F6 .. GREEK REVERSED LUNATE EPSILON SYMBOL -.. |backprime| unicode:: U+02035 .. REVERSED PRIME -.. |backsim| unicode:: U+0223D .. REVERSED TILDE -.. |backsimeq| unicode:: U+022CD .. REVERSED TILDE EQUALS -.. |Backslash| unicode:: U+02216 .. SET MINUS -.. |barwedge| unicode:: U+02305 .. PROJECTIVE -.. |Because| unicode:: U+02235 .. BECAUSE -.. |because| unicode:: U+02235 .. BECAUSE -.. |Bernoullis| unicode:: U+0212C .. SCRIPT CAPITAL B -.. |between| unicode:: U+0226C .. BETWEEN -.. |bigcap| unicode:: U+022C2 .. N-ARY INTERSECTION -.. |bigcirc| unicode:: U+025EF .. LARGE CIRCLE -.. |bigcup| unicode:: U+022C3 .. N-ARY UNION -.. |bigodot| unicode:: U+02A00 .. N-ARY CIRCLED DOT OPERATOR -.. |bigoplus| unicode:: U+02A01 .. N-ARY CIRCLED PLUS OPERATOR -.. |bigotimes| unicode:: U+02A02 .. N-ARY CIRCLED TIMES OPERATOR -.. |bigsqcup| unicode:: U+02A06 .. N-ARY SQUARE UNION OPERATOR -.. |bigstar| unicode:: U+02605 .. BLACK STAR -.. |bigtriangledown| unicode:: U+025BD .. WHITE DOWN-POINTING TRIANGLE -.. |bigtriangleup| unicode:: U+025B3 .. WHITE UP-POINTING TRIANGLE -.. |biguplus| unicode:: U+02A04 .. N-ARY UNION OPERATOR WITH PLUS -.. |bigvee| unicode:: U+022C1 .. N-ARY LOGICAL OR -.. |bigwedge| unicode:: U+022C0 .. N-ARY LOGICAL AND -.. |bkarow| unicode:: U+0290D .. RIGHTWARDS DOUBLE DASH ARROW -.. |blacklozenge| unicode:: U+029EB .. BLACK LOZENGE -.. |blacksquare| unicode:: U+025AA .. BLACK SMALL SQUARE -.. |blacktriangle| unicode:: U+025B4 .. BLACK UP-POINTING SMALL TRIANGLE -.. |blacktriangledown| unicode:: U+025BE .. BLACK DOWN-POINTING SMALL TRIANGLE -.. |blacktriangleleft| unicode:: U+025C2 .. BLACK LEFT-POINTING SMALL TRIANGLE -.. |blacktriangleright| unicode:: U+025B8 .. BLACK RIGHT-POINTING SMALL TRIANGLE -.. |bot| unicode:: U+022A5 .. UP TACK -.. |boxminus| unicode:: U+0229F .. SQUARED MINUS -.. |boxplus| unicode:: U+0229E .. SQUARED PLUS -.. |boxtimes| unicode:: U+022A0 .. SQUARED TIMES -.. |Breve| unicode:: U+002D8 .. BREVE -.. |bullet| unicode:: U+02022 .. BULLET -.. |Bumpeq| unicode:: U+0224E .. GEOMETRICALLY EQUIVALENT TO -.. |bumpeq| unicode:: U+0224F .. DIFFERENCE BETWEEN -.. |CapitalDifferentialD| unicode:: U+02145 .. DOUBLE-STRUCK ITALIC CAPITAL D -.. |Cayleys| unicode:: U+0212D .. BLACK-LETTER CAPITAL C -.. |Cedilla| unicode:: U+000B8 .. CEDILLA -.. |CenterDot| unicode:: U+000B7 .. MIDDLE DOT -.. |centerdot| unicode:: U+000B7 .. MIDDLE DOT -.. |checkmark| unicode:: U+02713 .. CHECK MARK -.. |circeq| unicode:: U+02257 .. RING EQUAL TO -.. |circlearrowleft| unicode:: U+021BA .. ANTICLOCKWISE OPEN CIRCLE ARROW -.. |circlearrowright| unicode:: U+021BB .. CLOCKWISE OPEN CIRCLE ARROW -.. |circledast| unicode:: U+0229B .. CIRCLED ASTERISK OPERATOR -.. |circledcirc| unicode:: U+0229A .. CIRCLED RING OPERATOR -.. |circleddash| unicode:: U+0229D .. CIRCLED DASH -.. |CircleDot| unicode:: U+02299 .. CIRCLED DOT OPERATOR -.. |circledR| unicode:: U+000AE .. REGISTERED SIGN -.. |circledS| unicode:: U+024C8 .. CIRCLED LATIN CAPITAL LETTER S -.. |CircleMinus| unicode:: U+02296 .. CIRCLED MINUS -.. |CirclePlus| unicode:: U+02295 .. CIRCLED PLUS -.. |CircleTimes| unicode:: U+02297 .. CIRCLED TIMES -.. |ClockwiseContourIntegral| unicode:: U+02232 .. CLOCKWISE CONTOUR INTEGRAL -.. |CloseCurlyDoubleQuote| unicode:: U+0201D .. RIGHT DOUBLE QUOTATION MARK -.. |CloseCurlyQuote| unicode:: U+02019 .. RIGHT SINGLE QUOTATION MARK -.. |clubsuit| unicode:: U+02663 .. BLACK CLUB SUIT -.. |coloneq| unicode:: U+02254 .. COLON EQUALS -.. |complement| unicode:: U+02201 .. COMPLEMENT -.. |complexes| unicode:: U+02102 .. DOUBLE-STRUCK CAPITAL C -.. |Congruent| unicode:: U+02261 .. IDENTICAL TO -.. |ContourIntegral| unicode:: U+0222E .. CONTOUR INTEGRAL -.. |Coproduct| unicode:: U+02210 .. N-ARY COPRODUCT -.. |CounterClockwiseContourIntegral| unicode:: U+02233 .. ANTICLOCKWISE CONTOUR INTEGRAL -.. |CupCap| unicode:: U+0224D .. EQUIVALENT TO -.. |curlyeqprec| unicode:: U+022DE .. EQUAL TO OR PRECEDES -.. |curlyeqsucc| unicode:: U+022DF .. EQUAL TO OR SUCCEEDS -.. |curlyvee| unicode:: U+022CE .. CURLY LOGICAL OR -.. |curlywedge| unicode:: U+022CF .. CURLY LOGICAL AND -.. |curvearrowleft| unicode:: U+021B6 .. ANTICLOCKWISE TOP SEMICIRCLE ARROW -.. |curvearrowright| unicode:: U+021B7 .. CLOCKWISE TOP SEMICIRCLE ARROW -.. |dbkarow| unicode:: U+0290F .. RIGHTWARDS TRIPLE DASH ARROW -.. |ddagger| unicode:: U+02021 .. DOUBLE DAGGER -.. |ddotseq| unicode:: U+02A77 .. EQUALS SIGN WITH TWO DOTS ABOVE AND TWO DOTS BELOW -.. |Del| unicode:: U+02207 .. NABLA -.. |DiacriticalAcute| unicode:: U+000B4 .. ACUTE ACCENT -.. |DiacriticalDot| unicode:: U+002D9 .. DOT ABOVE -.. |DiacriticalDoubleAcute| unicode:: U+002DD .. DOUBLE ACUTE ACCENT -.. |DiacriticalGrave| unicode:: U+00060 .. GRAVE ACCENT -.. |DiacriticalTilde| unicode:: U+002DC .. SMALL TILDE -.. |Diamond| unicode:: U+022C4 .. DIAMOND OPERATOR -.. |diamond| unicode:: U+022C4 .. DIAMOND OPERATOR -.. |diamondsuit| unicode:: U+02666 .. BLACK DIAMOND SUIT -.. |DifferentialD| unicode:: U+02146 .. DOUBLE-STRUCK ITALIC SMALL D -.. |digamma| unicode:: U+003DD .. GREEK SMALL LETTER DIGAMMA -.. |div| unicode:: U+000F7 .. DIVISION SIGN -.. |divideontimes| unicode:: U+022C7 .. DIVISION TIMES -.. |doteq| unicode:: U+02250 .. APPROACHES THE LIMIT -.. |doteqdot| unicode:: U+02251 .. GEOMETRICALLY EQUAL TO -.. |DotEqual| unicode:: U+02250 .. APPROACHES THE LIMIT -.. |dotminus| unicode:: U+02238 .. DOT MINUS -.. |dotplus| unicode:: U+02214 .. DOT PLUS -.. |dotsquare| unicode:: U+022A1 .. SQUARED DOT OPERATOR -.. |doublebarwedge| unicode:: U+02306 .. PERSPECTIVE -.. |DoubleContourIntegral| unicode:: U+0222F .. SURFACE INTEGRAL -.. |DoubleDot| unicode:: U+000A8 .. DIAERESIS -.. |DoubleDownArrow| unicode:: U+021D3 .. DOWNWARDS DOUBLE ARROW -.. |DoubleLeftArrow| unicode:: U+021D0 .. LEFTWARDS DOUBLE ARROW -.. |DoubleLeftRightArrow| unicode:: U+021D4 .. LEFT RIGHT DOUBLE ARROW -.. |DoubleLeftTee| unicode:: U+02AE4 .. VERTICAL BAR DOUBLE LEFT TURNSTILE -.. |DoubleLongLeftArrow| unicode:: U+027F8 .. LONG LEFTWARDS DOUBLE ARROW -.. |DoubleLongLeftRightArrow| unicode:: U+027FA .. LONG LEFT RIGHT DOUBLE ARROW -.. |DoubleLongRightArrow| unicode:: U+027F9 .. LONG RIGHTWARDS DOUBLE ARROW -.. |DoubleRightArrow| unicode:: U+021D2 .. RIGHTWARDS DOUBLE ARROW -.. |DoubleRightTee| unicode:: U+022A8 .. TRUE -.. |DoubleUpArrow| unicode:: U+021D1 .. UPWARDS DOUBLE ARROW -.. |DoubleUpDownArrow| unicode:: U+021D5 .. UP DOWN DOUBLE ARROW -.. |DoubleVerticalBar| unicode:: U+02225 .. PARALLEL TO -.. |DownArrow| unicode:: U+02193 .. DOWNWARDS ARROW -.. |Downarrow| unicode:: U+021D3 .. DOWNWARDS DOUBLE ARROW -.. |downarrow| unicode:: U+02193 .. DOWNWARDS ARROW -.. |DownArrowUpArrow| unicode:: U+021F5 .. DOWNWARDS ARROW LEFTWARDS OF UPWARDS ARROW -.. |downdownarrows| unicode:: U+021CA .. DOWNWARDS PAIRED ARROWS -.. |downharpoonleft| unicode:: U+021C3 .. DOWNWARDS HARPOON WITH BARB LEFTWARDS -.. |downharpoonright| unicode:: U+021C2 .. DOWNWARDS HARPOON WITH BARB RIGHTWARDS -.. |DownLeftVector| unicode:: U+021BD .. LEFTWARDS HARPOON WITH BARB DOWNWARDS -.. |DownRightVector| unicode:: U+021C1 .. RIGHTWARDS HARPOON WITH BARB DOWNWARDS -.. |DownTee| unicode:: U+022A4 .. DOWN TACK -.. |DownTeeArrow| unicode:: U+021A7 .. DOWNWARDS ARROW FROM BAR -.. |drbkarow| unicode:: U+02910 .. RIGHTWARDS TWO-HEADED TRIPLE DASH ARROW -.. |Element| unicode:: U+02208 .. ELEMENT OF -.. |emptyset| unicode:: U+02205 .. EMPTY SET -.. |eqcirc| unicode:: U+02256 .. RING IN EQUAL TO -.. |eqcolon| unicode:: U+02255 .. EQUALS COLON -.. |eqsim| unicode:: U+02242 .. MINUS TILDE -.. |eqslantgtr| unicode:: U+02A96 .. SLANTED EQUAL TO OR GREATER-THAN -.. |eqslantless| unicode:: U+02A95 .. SLANTED EQUAL TO OR LESS-THAN -.. |EqualTilde| unicode:: U+02242 .. MINUS TILDE -.. |Equilibrium| unicode:: U+021CC .. RIGHTWARDS HARPOON OVER LEFTWARDS HARPOON -.. |Exists| unicode:: U+02203 .. THERE EXISTS -.. |expectation| unicode:: U+02130 .. SCRIPT CAPITAL E -.. |ExponentialE| unicode:: U+02147 .. DOUBLE-STRUCK ITALIC SMALL E -.. |exponentiale| unicode:: U+02147 .. DOUBLE-STRUCK ITALIC SMALL E -.. |fallingdotseq| unicode:: U+02252 .. APPROXIMATELY EQUAL TO OR THE IMAGE OF -.. |ForAll| unicode:: U+02200 .. FOR ALL -.. |Fouriertrf| unicode:: U+02131 .. SCRIPT CAPITAL F -.. |geq| unicode:: U+02265 .. GREATER-THAN OR EQUAL TO -.. |geqq| unicode:: U+02267 .. GREATER-THAN OVER EQUAL TO -.. |geqslant| unicode:: U+02A7E .. GREATER-THAN OR SLANTED EQUAL TO -.. |gg| unicode:: U+0226B .. MUCH GREATER-THAN -.. |ggg| unicode:: U+022D9 .. VERY MUCH GREATER-THAN -.. |gnapprox| unicode:: U+02A8A .. GREATER-THAN AND NOT APPROXIMATE -.. |gneq| unicode:: U+02A88 .. GREATER-THAN AND SINGLE-LINE NOT EQUAL TO -.. |gneqq| unicode:: U+02269 .. GREATER-THAN BUT NOT EQUAL TO -.. |GreaterEqual| unicode:: U+02265 .. GREATER-THAN OR EQUAL TO -.. |GreaterEqualLess| unicode:: U+022DB .. GREATER-THAN EQUAL TO OR LESS-THAN -.. |GreaterFullEqual| unicode:: U+02267 .. GREATER-THAN OVER EQUAL TO -.. |GreaterLess| unicode:: U+02277 .. GREATER-THAN OR LESS-THAN -.. |GreaterSlantEqual| unicode:: U+02A7E .. GREATER-THAN OR SLANTED EQUAL TO -.. |GreaterTilde| unicode:: U+02273 .. GREATER-THAN OR EQUIVALENT TO -.. |gtrapprox| unicode:: U+02A86 .. GREATER-THAN OR APPROXIMATE -.. |gtrdot| unicode:: U+022D7 .. GREATER-THAN WITH DOT -.. |gtreqless| unicode:: U+022DB .. GREATER-THAN EQUAL TO OR LESS-THAN -.. |gtreqqless| unicode:: U+02A8C .. GREATER-THAN ABOVE DOUBLE-LINE EQUAL ABOVE LESS-THAN -.. |gtrless| unicode:: U+02277 .. GREATER-THAN OR LESS-THAN -.. |gtrsim| unicode:: U+02273 .. GREATER-THAN OR EQUIVALENT TO -.. |gvertneqq| unicode:: U+02269 U+0FE00 .. GREATER-THAN BUT NOT EQUAL TO - with vertical stroke -.. |Hacek| unicode:: U+002C7 .. CARON -.. |hbar| unicode:: U+0210F .. PLANCK CONSTANT OVER TWO PI -.. |heartsuit| unicode:: U+02665 .. BLACK HEART SUIT -.. |HilbertSpace| unicode:: U+0210B .. SCRIPT CAPITAL H -.. |hksearow| unicode:: U+02925 .. SOUTH EAST ARROW WITH HOOK -.. |hkswarow| unicode:: U+02926 .. SOUTH WEST ARROW WITH HOOK -.. |hookleftarrow| unicode:: U+021A9 .. LEFTWARDS ARROW WITH HOOK -.. |hookrightarrow| unicode:: U+021AA .. RIGHTWARDS ARROW WITH HOOK -.. |hslash| unicode:: U+0210F .. PLANCK CONSTANT OVER TWO PI -.. |HumpDownHump| unicode:: U+0224E .. GEOMETRICALLY EQUIVALENT TO -.. |HumpEqual| unicode:: U+0224F .. DIFFERENCE BETWEEN -.. |iiiint| unicode:: U+02A0C .. QUADRUPLE INTEGRAL OPERATOR -.. |iiint| unicode:: U+0222D .. TRIPLE INTEGRAL -.. |Im| unicode:: U+02111 .. BLACK-LETTER CAPITAL I -.. |ImaginaryI| unicode:: U+02148 .. DOUBLE-STRUCK ITALIC SMALL I -.. |imagline| unicode:: U+02110 .. SCRIPT CAPITAL I -.. |imagpart| unicode:: U+02111 .. BLACK-LETTER CAPITAL I -.. |Implies| unicode:: U+021D2 .. RIGHTWARDS DOUBLE ARROW -.. |in| unicode:: U+02208 .. ELEMENT OF -.. |integers| unicode:: U+02124 .. DOUBLE-STRUCK CAPITAL Z -.. |Integral| unicode:: U+0222B .. INTEGRAL -.. |intercal| unicode:: U+022BA .. INTERCALATE -.. |Intersection| unicode:: U+022C2 .. N-ARY INTERSECTION -.. |intprod| unicode:: U+02A3C .. INTERIOR PRODUCT -.. |InvisibleComma| unicode:: U+02063 .. INVISIBLE SEPARATOR -.. |InvisibleTimes| unicode:: U+02062 .. INVISIBLE TIMES -.. |langle| unicode:: U+02329 .. LEFT-POINTING ANGLE BRACKET -.. |Laplacetrf| unicode:: U+02112 .. SCRIPT CAPITAL L -.. |lbrace| unicode:: U+0007B .. LEFT CURLY BRACKET -.. |lbrack| unicode:: U+0005B .. LEFT SQUARE BRACKET -.. |LeftAngleBracket| unicode:: U+02329 .. LEFT-POINTING ANGLE BRACKET -.. |LeftArrow| unicode:: U+02190 .. LEFTWARDS ARROW -.. |Leftarrow| unicode:: U+021D0 .. LEFTWARDS DOUBLE ARROW -.. |leftarrow| unicode:: U+02190 .. LEFTWARDS ARROW -.. |LeftArrowBar| unicode:: U+021E4 .. LEFTWARDS ARROW TO BAR -.. |LeftArrowRightArrow| unicode:: U+021C6 .. LEFTWARDS ARROW OVER RIGHTWARDS ARROW -.. |leftarrowtail| unicode:: U+021A2 .. LEFTWARDS ARROW WITH TAIL -.. |LeftCeiling| unicode:: U+02308 .. LEFT CEILING -.. |LeftDoubleBracket| unicode:: U+0301A .. LEFT WHITE SQUARE BRACKET -.. |LeftDownVector| unicode:: U+021C3 .. DOWNWARDS HARPOON WITH BARB LEFTWARDS -.. |LeftFloor| unicode:: U+0230A .. LEFT FLOOR -.. |leftharpoondown| unicode:: U+021BD .. LEFTWARDS HARPOON WITH BARB DOWNWARDS -.. |leftharpoonup| unicode:: U+021BC .. LEFTWARDS HARPOON WITH BARB UPWARDS -.. |leftleftarrows| unicode:: U+021C7 .. LEFTWARDS PAIRED ARROWS -.. |LeftRightArrow| unicode:: U+02194 .. LEFT RIGHT ARROW -.. |Leftrightarrow| unicode:: U+021D4 .. LEFT RIGHT DOUBLE ARROW -.. |leftrightarrow| unicode:: U+02194 .. LEFT RIGHT ARROW -.. |leftrightarrows| unicode:: U+021C6 .. LEFTWARDS ARROW OVER RIGHTWARDS ARROW -.. |leftrightharpoons| unicode:: U+021CB .. LEFTWARDS HARPOON OVER RIGHTWARDS HARPOON -.. |leftrightsquigarrow| unicode:: U+021AD .. LEFT RIGHT WAVE ARROW -.. |LeftTee| unicode:: U+022A3 .. LEFT TACK -.. |LeftTeeArrow| unicode:: U+021A4 .. LEFTWARDS ARROW FROM BAR -.. |leftthreetimes| unicode:: U+022CB .. LEFT SEMIDIRECT PRODUCT -.. |LeftTriangle| unicode:: U+022B2 .. NORMAL SUBGROUP OF -.. |LeftTriangleEqual| unicode:: U+022B4 .. NORMAL SUBGROUP OF OR EQUAL TO -.. |LeftUpVector| unicode:: U+021BF .. UPWARDS HARPOON WITH BARB LEFTWARDS -.. |LeftVector| unicode:: U+021BC .. LEFTWARDS HARPOON WITH BARB UPWARDS -.. |leq| unicode:: U+02264 .. LESS-THAN OR EQUAL TO -.. |leqq| unicode:: U+02266 .. LESS-THAN OVER EQUAL TO -.. |leqslant| unicode:: U+02A7D .. LESS-THAN OR SLANTED EQUAL TO -.. |lessapprox| unicode:: U+02A85 .. LESS-THAN OR APPROXIMATE -.. |lessdot| unicode:: U+022D6 .. LESS-THAN WITH DOT -.. |lesseqgtr| unicode:: U+022DA .. LESS-THAN EQUAL TO OR GREATER-THAN -.. |lesseqqgtr| unicode:: U+02A8B .. LESS-THAN ABOVE DOUBLE-LINE EQUAL ABOVE GREATER-THAN -.. |LessEqualGreater| unicode:: U+022DA .. LESS-THAN EQUAL TO OR GREATER-THAN -.. |LessFullEqual| unicode:: U+02266 .. LESS-THAN OVER EQUAL TO -.. |LessGreater| unicode:: U+02276 .. LESS-THAN OR GREATER-THAN -.. |lessgtr| unicode:: U+02276 .. LESS-THAN OR GREATER-THAN -.. |lesssim| unicode:: U+02272 .. LESS-THAN OR EQUIVALENT TO -.. |LessSlantEqual| unicode:: U+02A7D .. LESS-THAN OR SLANTED EQUAL TO -.. |LessTilde| unicode:: U+02272 .. LESS-THAN OR EQUIVALENT TO -.. |ll| unicode:: U+0226A .. MUCH LESS-THAN -.. |llcorner| unicode:: U+0231E .. BOTTOM LEFT CORNER -.. |Lleftarrow| unicode:: U+021DA .. LEFTWARDS TRIPLE ARROW -.. |lmoustache| unicode:: U+023B0 .. UPPER LEFT OR LOWER RIGHT CURLY BRACKET SECTION -.. |lnapprox| unicode:: U+02A89 .. LESS-THAN AND NOT APPROXIMATE -.. |lneq| unicode:: U+02A87 .. LESS-THAN AND SINGLE-LINE NOT EQUAL TO -.. |lneqq| unicode:: U+02268 .. LESS-THAN BUT NOT EQUAL TO -.. |LongLeftArrow| unicode:: U+027F5 .. LONG LEFTWARDS ARROW -.. |Longleftarrow| unicode:: U+027F8 .. LONG LEFTWARDS DOUBLE ARROW -.. |longleftarrow| unicode:: U+027F5 .. LONG LEFTWARDS ARROW -.. |LongLeftRightArrow| unicode:: U+027F7 .. LONG LEFT RIGHT ARROW -.. |Longleftrightarrow| unicode:: U+027FA .. LONG LEFT RIGHT DOUBLE ARROW -.. |longleftrightarrow| unicode:: U+027F7 .. LONG LEFT RIGHT ARROW -.. |longmapsto| unicode:: U+027FC .. LONG RIGHTWARDS ARROW FROM BAR -.. |LongRightArrow| unicode:: U+027F6 .. LONG RIGHTWARDS ARROW -.. |Longrightarrow| unicode:: U+027F9 .. LONG RIGHTWARDS DOUBLE ARROW -.. |longrightarrow| unicode:: U+027F6 .. LONG RIGHTWARDS ARROW -.. |looparrowleft| unicode:: U+021AB .. LEFTWARDS ARROW WITH LOOP -.. |looparrowright| unicode:: U+021AC .. RIGHTWARDS ARROW WITH LOOP -.. |LowerLeftArrow| unicode:: U+02199 .. SOUTH WEST ARROW -.. |LowerRightArrow| unicode:: U+02198 .. SOUTH EAST ARROW -.. |lozenge| unicode:: U+025CA .. LOZENGE -.. |lrcorner| unicode:: U+0231F .. BOTTOM RIGHT CORNER -.. |Lsh| unicode:: U+021B0 .. UPWARDS ARROW WITH TIP LEFTWARDS -.. |lvertneqq| unicode:: U+02268 U+0FE00 .. LESS-THAN BUT NOT EQUAL TO - with vertical stroke -.. |maltese| unicode:: U+02720 .. MALTESE CROSS -.. |mapsto| unicode:: U+021A6 .. RIGHTWARDS ARROW FROM BAR -.. |measuredangle| unicode:: U+02221 .. MEASURED ANGLE -.. |Mellintrf| unicode:: U+02133 .. SCRIPT CAPITAL M -.. |MinusPlus| unicode:: U+02213 .. MINUS-OR-PLUS SIGN -.. |mp| unicode:: U+02213 .. MINUS-OR-PLUS SIGN -.. |multimap| unicode:: U+022B8 .. MULTIMAP -.. |napprox| unicode:: U+02249 .. NOT ALMOST EQUAL TO -.. |natural| unicode:: U+0266E .. MUSIC NATURAL SIGN -.. |naturals| unicode:: U+02115 .. DOUBLE-STRUCK CAPITAL N -.. |nearrow| unicode:: U+02197 .. NORTH EAST ARROW -.. |NegativeMediumSpace| unicode:: U+0200B .. ZERO WIDTH SPACE -.. |NegativeThickSpace| unicode:: U+0200B .. ZERO WIDTH SPACE -.. |NegativeThinSpace| unicode:: U+0200B .. ZERO WIDTH SPACE -.. |NegativeVeryThinSpace| unicode:: U+0200B .. ZERO WIDTH SPACE -.. |NestedGreaterGreater| unicode:: U+0226B .. MUCH GREATER-THAN -.. |NestedLessLess| unicode:: U+0226A .. MUCH LESS-THAN -.. |nexists| unicode:: U+02204 .. THERE DOES NOT EXIST -.. |ngeq| unicode:: U+02271 .. NEITHER GREATER-THAN NOR EQUAL TO -.. |ngeqq| unicode:: U+02267 U+00338 .. GREATER-THAN OVER EQUAL TO with slash -.. |ngeqslant| unicode:: U+02A7E U+00338 .. GREATER-THAN OR SLANTED EQUAL TO with slash -.. |ngtr| unicode:: U+0226F .. NOT GREATER-THAN -.. |nLeftarrow| unicode:: U+021CD .. LEFTWARDS DOUBLE ARROW WITH STROKE -.. |nleftarrow| unicode:: U+0219A .. LEFTWARDS ARROW WITH STROKE -.. |nLeftrightarrow| unicode:: U+021CE .. LEFT RIGHT DOUBLE ARROW WITH STROKE -.. |nleftrightarrow| unicode:: U+021AE .. LEFT RIGHT ARROW WITH STROKE -.. |nleq| unicode:: U+02270 .. NEITHER LESS-THAN NOR EQUAL TO -.. |nleqq| unicode:: U+02266 U+00338 .. LESS-THAN OVER EQUAL TO with slash -.. |nleqslant| unicode:: U+02A7D U+00338 .. LESS-THAN OR SLANTED EQUAL TO with slash -.. |nless| unicode:: U+0226E .. NOT LESS-THAN -.. |NonBreakingSpace| unicode:: U+000A0 .. NO-BREAK SPACE -.. |NotCongruent| unicode:: U+02262 .. NOT IDENTICAL TO -.. |NotDoubleVerticalBar| unicode:: U+02226 .. NOT PARALLEL TO -.. |NotElement| unicode:: U+02209 .. NOT AN ELEMENT OF -.. |NotEqual| unicode:: U+02260 .. NOT EQUAL TO -.. |NotEqualTilde| unicode:: U+02242 U+00338 .. MINUS TILDE with slash -.. |NotExists| unicode:: U+02204 .. THERE DOES NOT EXIST -.. |NotGreater| unicode:: U+0226F .. NOT GREATER-THAN -.. |NotGreaterEqual| unicode:: U+02271 .. NEITHER GREATER-THAN NOR EQUAL TO -.. |NotGreaterFullEqual| unicode:: U+02266 U+00338 .. LESS-THAN OVER EQUAL TO with slash -.. |NotGreaterGreater| unicode:: U+0226B U+00338 .. MUCH GREATER THAN with slash -.. |NotGreaterLess| unicode:: U+02279 .. NEITHER GREATER-THAN NOR LESS-THAN -.. |NotGreaterSlantEqual| unicode:: U+02A7E U+00338 .. GREATER-THAN OR SLANTED EQUAL TO with slash -.. |NotGreaterTilde| unicode:: U+02275 .. NEITHER GREATER-THAN NOR EQUIVALENT TO -.. |NotHumpDownHump| unicode:: U+0224E U+00338 .. GEOMETRICALLY EQUIVALENT TO with slash -.. |NotLeftTriangle| unicode:: U+022EA .. NOT NORMAL SUBGROUP OF -.. |NotLeftTriangleEqual| unicode:: U+022EC .. NOT NORMAL SUBGROUP OF OR EQUAL TO -.. |NotLess| unicode:: U+0226E .. NOT LESS-THAN -.. |NotLessEqual| unicode:: U+02270 .. NEITHER LESS-THAN NOR EQUAL TO -.. |NotLessGreater| unicode:: U+02278 .. NEITHER LESS-THAN NOR GREATER-THAN -.. |NotLessLess| unicode:: U+0226A U+00338 .. MUCH LESS THAN with slash -.. |NotLessSlantEqual| unicode:: U+02A7D U+00338 .. LESS-THAN OR SLANTED EQUAL TO with slash -.. |NotLessTilde| unicode:: U+02274 .. NEITHER LESS-THAN NOR EQUIVALENT TO -.. |NotPrecedes| unicode:: U+02280 .. DOES NOT PRECEDE -.. |NotPrecedesEqual| unicode:: U+02AAF U+00338 .. PRECEDES ABOVE SINGLE-LINE EQUALS SIGN with slash -.. |NotPrecedesSlantEqual| unicode:: U+022E0 .. DOES NOT PRECEDE OR EQUAL -.. |NotReverseElement| unicode:: U+0220C .. DOES NOT CONTAIN AS MEMBER -.. |NotRightTriangle| unicode:: U+022EB .. DOES NOT CONTAIN AS NORMAL SUBGROUP -.. |NotRightTriangleEqual| unicode:: U+022ED .. DOES NOT CONTAIN AS NORMAL SUBGROUP OR EQUAL -.. |NotSquareSubsetEqual| unicode:: U+022E2 .. NOT SQUARE IMAGE OF OR EQUAL TO -.. |NotSquareSupersetEqual| unicode:: U+022E3 .. NOT SQUARE ORIGINAL OF OR EQUAL TO -.. |NotSubset| unicode:: U+02282 U+020D2 .. SUBSET OF with vertical line -.. |NotSubsetEqual| unicode:: U+02288 .. NEITHER A SUBSET OF NOR EQUAL TO -.. |NotSucceeds| unicode:: U+02281 .. DOES NOT SUCCEED -.. |NotSucceedsEqual| unicode:: U+02AB0 U+00338 .. SUCCEEDS ABOVE SINGLE-LINE EQUALS SIGN with slash -.. |NotSucceedsSlantEqual| unicode:: U+022E1 .. DOES NOT SUCCEED OR EQUAL -.. |NotSuperset| unicode:: U+02283 U+020D2 .. SUPERSET OF with vertical line -.. |NotSupersetEqual| unicode:: U+02289 .. NEITHER A SUPERSET OF NOR EQUAL TO -.. |NotTilde| unicode:: U+02241 .. NOT TILDE -.. |NotTildeEqual| unicode:: U+02244 .. NOT ASYMPTOTICALLY EQUAL TO -.. |NotTildeFullEqual| unicode:: U+02247 .. NEITHER APPROXIMATELY NOR ACTUALLY EQUAL TO -.. |NotTildeTilde| unicode:: U+02249 .. NOT ALMOST EQUAL TO -.. |NotVerticalBar| unicode:: U+02224 .. DOES NOT DIVIDE -.. |nparallel| unicode:: U+02226 .. NOT PARALLEL TO -.. |nprec| unicode:: U+02280 .. DOES NOT PRECEDE -.. |npreceq| unicode:: U+02AAF U+00338 .. PRECEDES ABOVE SINGLE-LINE EQUALS SIGN with slash -.. |nRightarrow| unicode:: U+021CF .. RIGHTWARDS DOUBLE ARROW WITH STROKE -.. |nrightarrow| unicode:: U+0219B .. RIGHTWARDS ARROW WITH STROKE -.. |nshortmid| unicode:: U+02224 .. DOES NOT DIVIDE -.. |nshortparallel| unicode:: U+02226 .. NOT PARALLEL TO -.. |nsimeq| unicode:: U+02244 .. NOT ASYMPTOTICALLY EQUAL TO -.. |nsubset| unicode:: U+02282 U+020D2 .. SUBSET OF with vertical line -.. |nsubseteq| unicode:: U+02288 .. NEITHER A SUBSET OF NOR EQUAL TO -.. |nsubseteqq| unicode:: U+02AC5 U+00338 .. SUBSET OF ABOVE EQUALS SIGN with slash -.. |nsucc| unicode:: U+02281 .. DOES NOT SUCCEED -.. |nsucceq| unicode:: U+02AB0 U+00338 .. SUCCEEDS ABOVE SINGLE-LINE EQUALS SIGN with slash -.. |nsupset| unicode:: U+02283 U+020D2 .. SUPERSET OF with vertical line -.. |nsupseteq| unicode:: U+02289 .. NEITHER A SUPERSET OF NOR EQUAL TO -.. |nsupseteqq| unicode:: U+02AC6 U+00338 .. SUPERSET OF ABOVE EQUALS SIGN with slash -.. |ntriangleleft| unicode:: U+022EA .. NOT NORMAL SUBGROUP OF -.. |ntrianglelefteq| unicode:: U+022EC .. NOT NORMAL SUBGROUP OF OR EQUAL TO -.. |ntriangleright| unicode:: U+022EB .. DOES NOT CONTAIN AS NORMAL SUBGROUP -.. |ntrianglerighteq| unicode:: U+022ED .. DOES NOT CONTAIN AS NORMAL SUBGROUP OR EQUAL -.. |nwarrow| unicode:: U+02196 .. NORTH WEST ARROW -.. |oint| unicode:: U+0222E .. CONTOUR INTEGRAL -.. |OpenCurlyDoubleQuote| unicode:: U+0201C .. LEFT DOUBLE QUOTATION MARK -.. |OpenCurlyQuote| unicode:: U+02018 .. LEFT SINGLE QUOTATION MARK -.. |orderof| unicode:: U+02134 .. SCRIPT SMALL O -.. |parallel| unicode:: U+02225 .. PARALLEL TO -.. |PartialD| unicode:: U+02202 .. PARTIAL DIFFERENTIAL -.. |pitchfork| unicode:: U+022D4 .. PITCHFORK -.. |PlusMinus| unicode:: U+000B1 .. PLUS-MINUS SIGN -.. |pm| unicode:: U+000B1 .. PLUS-MINUS SIGN -.. |Poincareplane| unicode:: U+0210C .. BLACK-LETTER CAPITAL H -.. |prec| unicode:: U+0227A .. PRECEDES -.. |precapprox| unicode:: U+02AB7 .. PRECEDES ABOVE ALMOST EQUAL TO -.. |preccurlyeq| unicode:: U+0227C .. PRECEDES OR EQUAL TO -.. |Precedes| unicode:: U+0227A .. PRECEDES -.. |PrecedesEqual| unicode:: U+02AAF .. PRECEDES ABOVE SINGLE-LINE EQUALS SIGN -.. |PrecedesSlantEqual| unicode:: U+0227C .. PRECEDES OR EQUAL TO -.. |PrecedesTilde| unicode:: U+0227E .. PRECEDES OR EQUIVALENT TO -.. |preceq| unicode:: U+02AAF .. PRECEDES ABOVE SINGLE-LINE EQUALS SIGN -.. |precnapprox| unicode:: U+02AB9 .. PRECEDES ABOVE NOT ALMOST EQUAL TO -.. |precneqq| unicode:: U+02AB5 .. PRECEDES ABOVE NOT EQUAL TO -.. |precnsim| unicode:: U+022E8 .. PRECEDES BUT NOT EQUIVALENT TO -.. |precsim| unicode:: U+0227E .. PRECEDES OR EQUIVALENT TO -.. |primes| unicode:: U+02119 .. DOUBLE-STRUCK CAPITAL P -.. |Proportion| unicode:: U+02237 .. PROPORTION -.. |Proportional| unicode:: U+0221D .. PROPORTIONAL TO -.. |propto| unicode:: U+0221D .. PROPORTIONAL TO -.. |quaternions| unicode:: U+0210D .. DOUBLE-STRUCK CAPITAL H -.. |questeq| unicode:: U+0225F .. QUESTIONED EQUAL TO -.. |rangle| unicode:: U+0232A .. RIGHT-POINTING ANGLE BRACKET -.. |rationals| unicode:: U+0211A .. DOUBLE-STRUCK CAPITAL Q -.. |rbrace| unicode:: U+0007D .. RIGHT CURLY BRACKET -.. |rbrack| unicode:: U+0005D .. RIGHT SQUARE BRACKET -.. |Re| unicode:: U+0211C .. BLACK-LETTER CAPITAL R -.. |realine| unicode:: U+0211B .. SCRIPT CAPITAL R -.. |realpart| unicode:: U+0211C .. BLACK-LETTER CAPITAL R -.. |reals| unicode:: U+0211D .. DOUBLE-STRUCK CAPITAL R -.. |ReverseElement| unicode:: U+0220B .. CONTAINS AS MEMBER -.. |ReverseEquilibrium| unicode:: U+021CB .. LEFTWARDS HARPOON OVER RIGHTWARDS HARPOON -.. |ReverseUpEquilibrium| unicode:: U+0296F .. DOWNWARDS HARPOON WITH BARB LEFT BESIDE UPWARDS HARPOON WITH BARB RIGHT -.. |RightAngleBracket| unicode:: U+0232A .. RIGHT-POINTING ANGLE BRACKET -.. |RightArrow| unicode:: U+02192 .. RIGHTWARDS ARROW -.. |Rightarrow| unicode:: U+021D2 .. RIGHTWARDS DOUBLE ARROW -.. |rightarrow| unicode:: U+02192 .. RIGHTWARDS ARROW -.. |RightArrowBar| unicode:: U+021E5 .. RIGHTWARDS ARROW TO BAR -.. |RightArrowLeftArrow| unicode:: U+021C4 .. RIGHTWARDS ARROW OVER LEFTWARDS ARROW -.. |rightarrowtail| unicode:: U+021A3 .. RIGHTWARDS ARROW WITH TAIL -.. |RightCeiling| unicode:: U+02309 .. RIGHT CEILING -.. |RightDoubleBracket| unicode:: U+0301B .. RIGHT WHITE SQUARE BRACKET -.. |RightDownVector| unicode:: U+021C2 .. DOWNWARDS HARPOON WITH BARB RIGHTWARDS -.. |RightFloor| unicode:: U+0230B .. RIGHT FLOOR -.. |rightharpoondown| unicode:: U+021C1 .. RIGHTWARDS HARPOON WITH BARB DOWNWARDS -.. |rightharpoonup| unicode:: U+021C0 .. RIGHTWARDS HARPOON WITH BARB UPWARDS -.. |rightleftarrows| unicode:: U+021C4 .. RIGHTWARDS ARROW OVER LEFTWARDS ARROW -.. |rightleftharpoons| unicode:: U+021CC .. RIGHTWARDS HARPOON OVER LEFTWARDS HARPOON -.. |rightrightarrows| unicode:: U+021C9 .. RIGHTWARDS PAIRED ARROWS -.. |rightsquigarrow| unicode:: U+0219D .. RIGHTWARDS WAVE ARROW -.. |RightTee| unicode:: U+022A2 .. RIGHT TACK -.. |RightTeeArrow| unicode:: U+021A6 .. RIGHTWARDS ARROW FROM BAR -.. |rightthreetimes| unicode:: U+022CC .. RIGHT SEMIDIRECT PRODUCT -.. |RightTriangle| unicode:: U+022B3 .. CONTAINS AS NORMAL SUBGROUP -.. |RightTriangleEqual| unicode:: U+022B5 .. CONTAINS AS NORMAL SUBGROUP OR EQUAL TO -.. |RightUpVector| unicode:: U+021BE .. UPWARDS HARPOON WITH BARB RIGHTWARDS -.. |RightVector| unicode:: U+021C0 .. RIGHTWARDS HARPOON WITH BARB UPWARDS -.. |risingdotseq| unicode:: U+02253 .. IMAGE OF OR APPROXIMATELY EQUAL TO -.. |rmoustache| unicode:: U+023B1 .. UPPER RIGHT OR LOWER LEFT CURLY BRACKET SECTION -.. |Rrightarrow| unicode:: U+021DB .. RIGHTWARDS TRIPLE ARROW -.. |Rsh| unicode:: U+021B1 .. UPWARDS ARROW WITH TIP RIGHTWARDS -.. |searrow| unicode:: U+02198 .. SOUTH EAST ARROW -.. |setminus| unicode:: U+02216 .. SET MINUS -.. |ShortDownArrow| unicode:: U+02193 .. DOWNWARDS ARROW -.. |ShortLeftArrow| unicode:: U+02190 .. LEFTWARDS ARROW -.. |shortmid| unicode:: U+02223 .. DIVIDES -.. |shortparallel| unicode:: U+02225 .. PARALLEL TO -.. |ShortRightArrow| unicode:: U+02192 .. RIGHTWARDS ARROW -.. |ShortUpArrow| unicode:: U+02191 .. UPWARDS ARROW -.. |simeq| unicode:: U+02243 .. ASYMPTOTICALLY EQUAL TO -.. |SmallCircle| unicode:: U+02218 .. RING OPERATOR -.. |smallsetminus| unicode:: U+02216 .. SET MINUS -.. |spadesuit| unicode:: U+02660 .. BLACK SPADE SUIT -.. |Sqrt| unicode:: U+0221A .. SQUARE ROOT -.. |sqsubset| unicode:: U+0228F .. SQUARE IMAGE OF -.. |sqsubseteq| unicode:: U+02291 .. SQUARE IMAGE OF OR EQUAL TO -.. |sqsupset| unicode:: U+02290 .. SQUARE ORIGINAL OF -.. |sqsupseteq| unicode:: U+02292 .. SQUARE ORIGINAL OF OR EQUAL TO -.. |Square| unicode:: U+025A1 .. WHITE SQUARE -.. |SquareIntersection| unicode:: U+02293 .. SQUARE CAP -.. |SquareSubset| unicode:: U+0228F .. SQUARE IMAGE OF -.. |SquareSubsetEqual| unicode:: U+02291 .. SQUARE IMAGE OF OR EQUAL TO -.. |SquareSuperset| unicode:: U+02290 .. SQUARE ORIGINAL OF -.. |SquareSupersetEqual| unicode:: U+02292 .. SQUARE ORIGINAL OF OR EQUAL TO -.. |SquareUnion| unicode:: U+02294 .. SQUARE CUP -.. |Star| unicode:: U+022C6 .. STAR OPERATOR -.. |straightepsilon| unicode:: U+003F5 .. GREEK LUNATE EPSILON SYMBOL -.. |straightphi| unicode:: U+003D5 .. GREEK PHI SYMBOL -.. |Subset| unicode:: U+022D0 .. DOUBLE SUBSET -.. |subset| unicode:: U+02282 .. SUBSET OF -.. |subseteq| unicode:: U+02286 .. SUBSET OF OR EQUAL TO -.. |subseteqq| unicode:: U+02AC5 .. SUBSET OF ABOVE EQUALS SIGN -.. |SubsetEqual| unicode:: U+02286 .. SUBSET OF OR EQUAL TO -.. |subsetneq| unicode:: U+0228A .. SUBSET OF WITH NOT EQUAL TO -.. |subsetneqq| unicode:: U+02ACB .. SUBSET OF ABOVE NOT EQUAL TO -.. |succ| unicode:: U+0227B .. SUCCEEDS -.. |succapprox| unicode:: U+02AB8 .. SUCCEEDS ABOVE ALMOST EQUAL TO -.. |succcurlyeq| unicode:: U+0227D .. SUCCEEDS OR EQUAL TO -.. |Succeeds| unicode:: U+0227B .. SUCCEEDS -.. |SucceedsEqual| unicode:: U+02AB0 .. SUCCEEDS ABOVE SINGLE-LINE EQUALS SIGN -.. |SucceedsSlantEqual| unicode:: U+0227D .. SUCCEEDS OR EQUAL TO -.. |SucceedsTilde| unicode:: U+0227F .. SUCCEEDS OR EQUIVALENT TO -.. |succeq| unicode:: U+02AB0 .. SUCCEEDS ABOVE SINGLE-LINE EQUALS SIGN -.. |succnapprox| unicode:: U+02ABA .. SUCCEEDS ABOVE NOT ALMOST EQUAL TO -.. |succneqq| unicode:: U+02AB6 .. SUCCEEDS ABOVE NOT EQUAL TO -.. |succnsim| unicode:: U+022E9 .. SUCCEEDS BUT NOT EQUIVALENT TO -.. |succsim| unicode:: U+0227F .. SUCCEEDS OR EQUIVALENT TO -.. |SuchThat| unicode:: U+0220B .. CONTAINS AS MEMBER -.. |Sum| unicode:: U+02211 .. N-ARY SUMMATION -.. |Superset| unicode:: U+02283 .. SUPERSET OF -.. |SupersetEqual| unicode:: U+02287 .. SUPERSET OF OR EQUAL TO -.. |Supset| unicode:: U+022D1 .. DOUBLE SUPERSET -.. |supset| unicode:: U+02283 .. SUPERSET OF -.. |supseteq| unicode:: U+02287 .. SUPERSET OF OR EQUAL TO -.. |supseteqq| unicode:: U+02AC6 .. SUPERSET OF ABOVE EQUALS SIGN -.. |supsetneq| unicode:: U+0228B .. SUPERSET OF WITH NOT EQUAL TO -.. |supsetneqq| unicode:: U+02ACC .. SUPERSET OF ABOVE NOT EQUAL TO -.. |swarrow| unicode:: U+02199 .. SOUTH WEST ARROW -.. |Therefore| unicode:: U+02234 .. THEREFORE -.. |therefore| unicode:: U+02234 .. THEREFORE -.. |thickapprox| unicode:: U+02248 .. ALMOST EQUAL TO -.. |thicksim| unicode:: U+0223C .. TILDE OPERATOR -.. |ThinSpace| unicode:: U+02009 .. THIN SPACE -.. |Tilde| unicode:: U+0223C .. TILDE OPERATOR -.. |TildeEqual| unicode:: U+02243 .. ASYMPTOTICALLY EQUAL TO -.. |TildeFullEqual| unicode:: U+02245 .. APPROXIMATELY EQUAL TO -.. |TildeTilde| unicode:: U+02248 .. ALMOST EQUAL TO -.. |toea| unicode:: U+02928 .. NORTH EAST ARROW AND SOUTH EAST ARROW -.. |tosa| unicode:: U+02929 .. SOUTH EAST ARROW AND SOUTH WEST ARROW -.. |triangle| unicode:: U+025B5 .. WHITE UP-POINTING SMALL TRIANGLE -.. |triangledown| unicode:: U+025BF .. WHITE DOWN-POINTING SMALL TRIANGLE -.. |triangleleft| unicode:: U+025C3 .. WHITE LEFT-POINTING SMALL TRIANGLE -.. |trianglelefteq| unicode:: U+022B4 .. NORMAL SUBGROUP OF OR EQUAL TO -.. |triangleq| unicode:: U+0225C .. DELTA EQUAL TO -.. |triangleright| unicode:: U+025B9 .. WHITE RIGHT-POINTING SMALL TRIANGLE -.. |trianglerighteq| unicode:: U+022B5 .. CONTAINS AS NORMAL SUBGROUP OR EQUAL TO -.. |TripleDot| unicode:: U+020DB .. COMBINING THREE DOTS ABOVE -.. |twoheadleftarrow| unicode:: U+0219E .. LEFTWARDS TWO HEADED ARROW -.. |twoheadrightarrow| unicode:: U+021A0 .. RIGHTWARDS TWO HEADED ARROW -.. |ulcorner| unicode:: U+0231C .. TOP LEFT CORNER -.. |Union| unicode:: U+022C3 .. N-ARY UNION -.. |UnionPlus| unicode:: U+0228E .. MULTISET UNION -.. |UpArrow| unicode:: U+02191 .. UPWARDS ARROW -.. |Uparrow| unicode:: U+021D1 .. UPWARDS DOUBLE ARROW -.. |uparrow| unicode:: U+02191 .. UPWARDS ARROW -.. |UpArrowDownArrow| unicode:: U+021C5 .. UPWARDS ARROW LEFTWARDS OF DOWNWARDS ARROW -.. |UpDownArrow| unicode:: U+02195 .. UP DOWN ARROW -.. |Updownarrow| unicode:: U+021D5 .. UP DOWN DOUBLE ARROW -.. |updownarrow| unicode:: U+02195 .. UP DOWN ARROW -.. |UpEquilibrium| unicode:: U+0296E .. UPWARDS HARPOON WITH BARB LEFT BESIDE DOWNWARDS HARPOON WITH BARB RIGHT -.. |upharpoonleft| unicode:: U+021BF .. UPWARDS HARPOON WITH BARB LEFTWARDS -.. |upharpoonright| unicode:: U+021BE .. UPWARDS HARPOON WITH BARB RIGHTWARDS -.. |UpperLeftArrow| unicode:: U+02196 .. NORTH WEST ARROW -.. |UpperRightArrow| unicode:: U+02197 .. NORTH EAST ARROW -.. |upsilon| unicode:: U+003C5 .. GREEK SMALL LETTER UPSILON -.. |UpTee| unicode:: U+022A5 .. UP TACK -.. |UpTeeArrow| unicode:: U+021A5 .. UPWARDS ARROW FROM BAR -.. |upuparrows| unicode:: U+021C8 .. UPWARDS PAIRED ARROWS -.. |urcorner| unicode:: U+0231D .. TOP RIGHT CORNER -.. |varepsilon| unicode:: U+003B5 .. GREEK SMALL LETTER EPSILON -.. |varkappa| unicode:: U+003F0 .. GREEK KAPPA SYMBOL -.. |varnothing| unicode:: U+02205 .. EMPTY SET -.. |varphi| unicode:: U+003C6 .. GREEK SMALL LETTER PHI -.. |varpi| unicode:: U+003D6 .. GREEK PI SYMBOL -.. |varpropto| unicode:: U+0221D .. PROPORTIONAL TO -.. |varrho| unicode:: U+003F1 .. GREEK RHO SYMBOL -.. |varsigma| unicode:: U+003C2 .. GREEK SMALL LETTER FINAL SIGMA -.. |varsubsetneq| unicode:: U+0228A U+0FE00 .. SUBSET OF WITH NOT EQUAL TO - variant with stroke through bottom members -.. |varsubsetneqq| unicode:: U+02ACB U+0FE00 .. SUBSET OF ABOVE NOT EQUAL TO - variant with stroke through bottom members -.. |varsupsetneq| unicode:: U+0228B U+0FE00 .. SUPERSET OF WITH NOT EQUAL TO - variant with stroke through bottom members -.. |varsupsetneqq| unicode:: U+02ACC U+0FE00 .. SUPERSET OF ABOVE NOT EQUAL TO - variant with stroke through bottom members -.. |vartheta| unicode:: U+003D1 .. GREEK THETA SYMBOL -.. |vartriangleleft| unicode:: U+022B2 .. NORMAL SUBGROUP OF -.. |vartriangleright| unicode:: U+022B3 .. CONTAINS AS NORMAL SUBGROUP -.. |Vee| unicode:: U+022C1 .. N-ARY LOGICAL OR -.. |vee| unicode:: U+02228 .. LOGICAL OR -.. |Vert| unicode:: U+02016 .. DOUBLE VERTICAL LINE -.. |vert| unicode:: U+0007C .. VERTICAL LINE -.. |VerticalBar| unicode:: U+02223 .. DIVIDES -.. |VerticalTilde| unicode:: U+02240 .. WREATH PRODUCT -.. |VeryThinSpace| unicode:: U+0200A .. HAIR SPACE -.. |Wedge| unicode:: U+022C0 .. N-ARY LOGICAL AND -.. |wedge| unicode:: U+02227 .. LOGICAL AND -.. |wp| unicode:: U+02118 .. SCRIPT CAPITAL P -.. |wr| unicode:: U+02240 .. WREATH PRODUCT -.. |zeetrf| unicode:: U+02128 .. BLACK-LETTER CAPITAL Z diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/mmlextra-wide.txt --- a/buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/mmlextra-wide.txt Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,113 +0,0 @@ -.. This data file has been placed in the public domain. -.. Derived from the Unicode character mappings available from - . - Processed by unicode2rstsubs.py, part of Docutils: - . - -.. |af| unicode:: U+02061 .. FUNCTION APPLICATION -.. |aopf| unicode:: U+1D552 .. MATHEMATICAL DOUBLE-STRUCK SMALL A -.. |asympeq| unicode:: U+0224D .. EQUIVALENT TO -.. |bopf| unicode:: U+1D553 .. MATHEMATICAL DOUBLE-STRUCK SMALL B -.. |copf| unicode:: U+1D554 .. MATHEMATICAL DOUBLE-STRUCK SMALL C -.. |Cross| unicode:: U+02A2F .. VECTOR OR CROSS PRODUCT -.. |DD| unicode:: U+02145 .. DOUBLE-STRUCK ITALIC CAPITAL D -.. |dd| unicode:: U+02146 .. DOUBLE-STRUCK ITALIC SMALL D -.. |dopf| unicode:: U+1D555 .. MATHEMATICAL DOUBLE-STRUCK SMALL D -.. |DownArrowBar| unicode:: U+02913 .. DOWNWARDS ARROW TO BAR -.. |DownBreve| unicode:: U+00311 .. COMBINING INVERTED BREVE -.. |DownLeftRightVector| unicode:: U+02950 .. LEFT BARB DOWN RIGHT BARB DOWN HARPOON -.. |DownLeftTeeVector| unicode:: U+0295E .. LEFTWARDS HARPOON WITH BARB DOWN FROM BAR -.. |DownLeftVectorBar| unicode:: U+02956 .. LEFTWARDS HARPOON WITH BARB DOWN TO BAR -.. |DownRightTeeVector| unicode:: U+0295F .. RIGHTWARDS HARPOON WITH BARB DOWN FROM BAR -.. |DownRightVectorBar| unicode:: U+02957 .. RIGHTWARDS HARPOON WITH BARB DOWN TO BAR -.. |ee| unicode:: U+02147 .. DOUBLE-STRUCK ITALIC SMALL E -.. |EmptySmallSquare| unicode:: U+025FB .. WHITE MEDIUM SQUARE -.. |EmptyVerySmallSquare| unicode:: U+025AB .. WHITE SMALL SQUARE -.. |eopf| unicode:: U+1D556 .. MATHEMATICAL DOUBLE-STRUCK SMALL E -.. |Equal| unicode:: U+02A75 .. TWO CONSECUTIVE EQUALS SIGNS -.. |FilledSmallSquare| unicode:: U+025FC .. BLACK MEDIUM SQUARE -.. |FilledVerySmallSquare| unicode:: U+025AA .. BLACK SMALL SQUARE -.. |fopf| unicode:: U+1D557 .. MATHEMATICAL DOUBLE-STRUCK SMALL F -.. |gopf| unicode:: U+1D558 .. MATHEMATICAL DOUBLE-STRUCK SMALL G -.. |GreaterGreater| unicode:: U+02AA2 .. DOUBLE NESTED GREATER-THAN -.. |Hat| unicode:: U+0005E .. CIRCUMFLEX ACCENT -.. |hopf| unicode:: U+1D559 .. MATHEMATICAL DOUBLE-STRUCK SMALL H -.. |HorizontalLine| unicode:: U+02500 .. BOX DRAWINGS LIGHT HORIZONTAL -.. |ic| unicode:: U+02063 .. INVISIBLE SEPARATOR -.. |ii| unicode:: U+02148 .. DOUBLE-STRUCK ITALIC SMALL I -.. |iopf| unicode:: U+1D55A .. MATHEMATICAL DOUBLE-STRUCK SMALL I -.. |it| unicode:: U+02062 .. INVISIBLE TIMES -.. |jopf| unicode:: U+1D55B .. MATHEMATICAL DOUBLE-STRUCK SMALL J -.. |kopf| unicode:: U+1D55C .. MATHEMATICAL DOUBLE-STRUCK SMALL K -.. |larrb| unicode:: U+021E4 .. LEFTWARDS ARROW TO BAR -.. |LeftDownTeeVector| unicode:: U+02961 .. DOWNWARDS HARPOON WITH BARB LEFT FROM BAR -.. |LeftDownVectorBar| unicode:: U+02959 .. DOWNWARDS HARPOON WITH BARB LEFT TO BAR -.. |LeftRightVector| unicode:: U+0294E .. LEFT BARB UP RIGHT BARB UP HARPOON -.. |LeftTeeVector| unicode:: U+0295A .. LEFTWARDS HARPOON WITH BARB UP FROM BAR -.. |LeftTriangleBar| unicode:: U+029CF .. LEFT TRIANGLE BESIDE VERTICAL BAR -.. |LeftUpDownVector| unicode:: U+02951 .. UP BARB LEFT DOWN BARB LEFT HARPOON -.. |LeftUpTeeVector| unicode:: U+02960 .. UPWARDS HARPOON WITH BARB LEFT FROM BAR -.. |LeftUpVectorBar| unicode:: U+02958 .. UPWARDS HARPOON WITH BARB LEFT TO BAR -.. |LeftVectorBar| unicode:: U+02952 .. LEFTWARDS HARPOON WITH BARB UP TO BAR -.. |LessLess| unicode:: U+02AA1 .. DOUBLE NESTED LESS-THAN -.. |lopf| unicode:: U+1D55D .. MATHEMATICAL DOUBLE-STRUCK SMALL L -.. |mapstodown| unicode:: U+021A7 .. DOWNWARDS ARROW FROM BAR -.. |mapstoleft| unicode:: U+021A4 .. LEFTWARDS ARROW FROM BAR -.. |mapstoup| unicode:: U+021A5 .. UPWARDS ARROW FROM BAR -.. |MediumSpace| unicode:: U+0205F .. MEDIUM MATHEMATICAL SPACE -.. |mopf| unicode:: U+1D55E .. MATHEMATICAL DOUBLE-STRUCK SMALL M -.. |nbump| unicode:: U+0224E U+00338 .. GEOMETRICALLY EQUIVALENT TO with slash -.. |nbumpe| unicode:: U+0224F U+00338 .. DIFFERENCE BETWEEN with slash -.. |nesim| unicode:: U+02242 U+00338 .. MINUS TILDE with slash -.. |NewLine| unicode:: U+0000A .. LINE FEED (LF) -.. |NoBreak| unicode:: U+02060 .. WORD JOINER -.. |nopf| unicode:: U+1D55F .. MATHEMATICAL DOUBLE-STRUCK SMALL N -.. |NotCupCap| unicode:: U+0226D .. NOT EQUIVALENT TO -.. |NotHumpEqual| unicode:: U+0224F U+00338 .. DIFFERENCE BETWEEN with slash -.. |NotLeftTriangleBar| unicode:: U+029CF U+00338 .. LEFT TRIANGLE BESIDE VERTICAL BAR with slash -.. |NotNestedGreaterGreater| unicode:: U+02AA2 U+00338 .. DOUBLE NESTED GREATER-THAN with slash -.. |NotNestedLessLess| unicode:: U+02AA1 U+00338 .. DOUBLE NESTED LESS-THAN with slash -.. |NotRightTriangleBar| unicode:: U+029D0 U+00338 .. VERTICAL BAR BESIDE RIGHT TRIANGLE with slash -.. |NotSquareSubset| unicode:: U+0228F U+00338 .. SQUARE IMAGE OF with slash -.. |NotSquareSuperset| unicode:: U+02290 U+00338 .. SQUARE ORIGINAL OF with slash -.. |NotSucceedsTilde| unicode:: U+0227F U+00338 .. SUCCEEDS OR EQUIVALENT TO with slash -.. |oopf| unicode:: U+1D560 .. MATHEMATICAL DOUBLE-STRUCK SMALL O -.. |OverBar| unicode:: U+000AF .. MACRON -.. |OverBrace| unicode:: U+0FE37 .. PRESENTATION FORM FOR VERTICAL LEFT CURLY BRACKET -.. |OverBracket| unicode:: U+023B4 .. TOP SQUARE BRACKET -.. |OverParenthesis| unicode:: U+0FE35 .. PRESENTATION FORM FOR VERTICAL LEFT PARENTHESIS -.. |planckh| unicode:: U+0210E .. PLANCK CONSTANT -.. |popf| unicode:: U+1D561 .. MATHEMATICAL DOUBLE-STRUCK SMALL P -.. |Product| unicode:: U+0220F .. N-ARY PRODUCT -.. |qopf| unicode:: U+1D562 .. MATHEMATICAL DOUBLE-STRUCK SMALL Q -.. |rarrb| unicode:: U+021E5 .. RIGHTWARDS ARROW TO BAR -.. |RightDownTeeVector| unicode:: U+0295D .. DOWNWARDS HARPOON WITH BARB RIGHT FROM BAR -.. |RightDownVectorBar| unicode:: U+02955 .. DOWNWARDS HARPOON WITH BARB RIGHT TO BAR -.. |RightTeeVector| unicode:: U+0295B .. RIGHTWARDS HARPOON WITH BARB UP FROM BAR -.. |RightTriangleBar| unicode:: U+029D0 .. VERTICAL BAR BESIDE RIGHT TRIANGLE -.. |RightUpDownVector| unicode:: U+0294F .. UP BARB RIGHT DOWN BARB RIGHT HARPOON -.. |RightUpTeeVector| unicode:: U+0295C .. UPWARDS HARPOON WITH BARB RIGHT FROM BAR -.. |RightUpVectorBar| unicode:: U+02954 .. UPWARDS HARPOON WITH BARB RIGHT TO BAR -.. |RightVectorBar| unicode:: U+02953 .. RIGHTWARDS HARPOON WITH BARB UP TO BAR -.. |ropf| unicode:: U+1D563 .. MATHEMATICAL DOUBLE-STRUCK SMALL R -.. |RoundImplies| unicode:: U+02970 .. RIGHT DOUBLE ARROW WITH ROUNDED HEAD -.. |RuleDelayed| unicode:: U+029F4 .. RULE-DELAYED -.. |sopf| unicode:: U+1D564 .. MATHEMATICAL DOUBLE-STRUCK SMALL S -.. |Tab| unicode:: U+00009 .. CHARACTER TABULATION -.. |ThickSpace| unicode:: U+02009 U+0200A U+0200A .. space of width 5/18 em -.. |topf| unicode:: U+1D565 .. MATHEMATICAL DOUBLE-STRUCK SMALL T -.. |UnderBar| unicode:: U+00332 .. COMBINING LOW LINE -.. |UnderBrace| unicode:: U+0FE38 .. PRESENTATION FORM FOR VERTICAL RIGHT CURLY BRACKET -.. |UnderBracket| unicode:: U+023B5 .. BOTTOM SQUARE BRACKET -.. |UnderParenthesis| unicode:: U+0FE36 .. PRESENTATION FORM FOR VERTICAL RIGHT PARENTHESIS -.. |uopf| unicode:: U+1D566 .. MATHEMATICAL DOUBLE-STRUCK SMALL U -.. |UpArrowBar| unicode:: U+02912 .. UPWARDS ARROW TO BAR -.. |Upsilon| unicode:: U+003A5 .. GREEK CAPITAL LETTER UPSILON -.. |VerticalLine| unicode:: U+0007C .. VERTICAL LINE -.. |VerticalSeparator| unicode:: U+02758 .. LIGHT VERTICAL BAR -.. |vopf| unicode:: U+1D567 .. MATHEMATICAL DOUBLE-STRUCK SMALL V -.. |wopf| unicode:: U+1D568 .. MATHEMATICAL DOUBLE-STRUCK SMALL W -.. |xopf| unicode:: U+1D569 .. MATHEMATICAL DOUBLE-STRUCK SMALL X -.. |yopf| unicode:: U+1D56A .. MATHEMATICAL DOUBLE-STRUCK SMALL Y -.. |ZeroWidthSpace| unicode:: U+0200B .. ZERO WIDTH SPACE -.. |zopf| unicode:: U+1D56B .. MATHEMATICAL DOUBLE-STRUCK SMALL Z diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/mmlextra.txt --- a/buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/mmlextra.txt Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,87 +0,0 @@ -.. This data file has been placed in the public domain. -.. Derived from the Unicode character mappings available from - . - Processed by unicode2rstsubs.py, part of Docutils: - . - -.. |af| unicode:: U+02061 .. FUNCTION APPLICATION -.. |asympeq| unicode:: U+0224D .. EQUIVALENT TO -.. |Cross| unicode:: U+02A2F .. VECTOR OR CROSS PRODUCT -.. |DD| unicode:: U+02145 .. DOUBLE-STRUCK ITALIC CAPITAL D -.. |dd| unicode:: U+02146 .. DOUBLE-STRUCK ITALIC SMALL D -.. |DownArrowBar| unicode:: U+02913 .. DOWNWARDS ARROW TO BAR -.. |DownBreve| unicode:: U+00311 .. COMBINING INVERTED BREVE -.. |DownLeftRightVector| unicode:: U+02950 .. LEFT BARB DOWN RIGHT BARB DOWN HARPOON -.. |DownLeftTeeVector| unicode:: U+0295E .. LEFTWARDS HARPOON WITH BARB DOWN FROM BAR -.. |DownLeftVectorBar| unicode:: U+02956 .. LEFTWARDS HARPOON WITH BARB DOWN TO BAR -.. |DownRightTeeVector| unicode:: U+0295F .. RIGHTWARDS HARPOON WITH BARB DOWN FROM BAR -.. |DownRightVectorBar| unicode:: U+02957 .. RIGHTWARDS HARPOON WITH BARB DOWN TO BAR -.. |ee| unicode:: U+02147 .. DOUBLE-STRUCK ITALIC SMALL E -.. |EmptySmallSquare| unicode:: U+025FB .. WHITE MEDIUM SQUARE -.. |EmptyVerySmallSquare| unicode:: U+025AB .. WHITE SMALL SQUARE -.. |Equal| unicode:: U+02A75 .. TWO CONSECUTIVE EQUALS SIGNS -.. |FilledSmallSquare| unicode:: U+025FC .. BLACK MEDIUM SQUARE -.. |FilledVerySmallSquare| unicode:: U+025AA .. BLACK SMALL SQUARE -.. |GreaterGreater| unicode:: U+02AA2 .. DOUBLE NESTED GREATER-THAN -.. |Hat| unicode:: U+0005E .. CIRCUMFLEX ACCENT -.. |HorizontalLine| unicode:: U+02500 .. BOX DRAWINGS LIGHT HORIZONTAL -.. |ic| unicode:: U+02063 .. INVISIBLE SEPARATOR -.. |ii| unicode:: U+02148 .. DOUBLE-STRUCK ITALIC SMALL I -.. |it| unicode:: U+02062 .. INVISIBLE TIMES -.. |larrb| unicode:: U+021E4 .. LEFTWARDS ARROW TO BAR -.. |LeftDownTeeVector| unicode:: U+02961 .. DOWNWARDS HARPOON WITH BARB LEFT FROM BAR -.. |LeftDownVectorBar| unicode:: U+02959 .. DOWNWARDS HARPOON WITH BARB LEFT TO BAR -.. |LeftRightVector| unicode:: U+0294E .. LEFT BARB UP RIGHT BARB UP HARPOON -.. |LeftTeeVector| unicode:: U+0295A .. LEFTWARDS HARPOON WITH BARB UP FROM BAR -.. |LeftTriangleBar| unicode:: U+029CF .. LEFT TRIANGLE BESIDE VERTICAL BAR -.. |LeftUpDownVector| unicode:: U+02951 .. UP BARB LEFT DOWN BARB LEFT HARPOON -.. |LeftUpTeeVector| unicode:: U+02960 .. UPWARDS HARPOON WITH BARB LEFT FROM BAR -.. |LeftUpVectorBar| unicode:: U+02958 .. UPWARDS HARPOON WITH BARB LEFT TO BAR -.. |LeftVectorBar| unicode:: U+02952 .. LEFTWARDS HARPOON WITH BARB UP TO BAR -.. |LessLess| unicode:: U+02AA1 .. DOUBLE NESTED LESS-THAN -.. |mapstodown| unicode:: U+021A7 .. DOWNWARDS ARROW FROM BAR -.. |mapstoleft| unicode:: U+021A4 .. LEFTWARDS ARROW FROM BAR -.. |mapstoup| unicode:: U+021A5 .. UPWARDS ARROW FROM BAR -.. |MediumSpace| unicode:: U+0205F .. MEDIUM MATHEMATICAL SPACE -.. |nbump| unicode:: U+0224E U+00338 .. GEOMETRICALLY EQUIVALENT TO with slash -.. |nbumpe| unicode:: U+0224F U+00338 .. DIFFERENCE BETWEEN with slash -.. |nesim| unicode:: U+02242 U+00338 .. MINUS TILDE with slash -.. |NewLine| unicode:: U+0000A .. LINE FEED (LF) -.. |NoBreak| unicode:: U+02060 .. WORD JOINER -.. |NotCupCap| unicode:: U+0226D .. NOT EQUIVALENT TO -.. |NotHumpEqual| unicode:: U+0224F U+00338 .. DIFFERENCE BETWEEN with slash -.. |NotLeftTriangleBar| unicode:: U+029CF U+00338 .. LEFT TRIANGLE BESIDE VERTICAL BAR with slash -.. |NotNestedGreaterGreater| unicode:: U+02AA2 U+00338 .. DOUBLE NESTED GREATER-THAN with slash -.. |NotNestedLessLess| unicode:: U+02AA1 U+00338 .. DOUBLE NESTED LESS-THAN with slash -.. |NotRightTriangleBar| unicode:: U+029D0 U+00338 .. VERTICAL BAR BESIDE RIGHT TRIANGLE with slash -.. |NotSquareSubset| unicode:: U+0228F U+00338 .. SQUARE IMAGE OF with slash -.. |NotSquareSuperset| unicode:: U+02290 U+00338 .. SQUARE ORIGINAL OF with slash -.. |NotSucceedsTilde| unicode:: U+0227F U+00338 .. SUCCEEDS OR EQUIVALENT TO with slash -.. |OverBar| unicode:: U+000AF .. MACRON -.. |OverBrace| unicode:: U+0FE37 .. PRESENTATION FORM FOR VERTICAL LEFT CURLY BRACKET -.. |OverBracket| unicode:: U+023B4 .. TOP SQUARE BRACKET -.. |OverParenthesis| unicode:: U+0FE35 .. PRESENTATION FORM FOR VERTICAL LEFT PARENTHESIS -.. |planckh| unicode:: U+0210E .. PLANCK CONSTANT -.. |Product| unicode:: U+0220F .. N-ARY PRODUCT -.. |rarrb| unicode:: U+021E5 .. RIGHTWARDS ARROW TO BAR -.. |RightDownTeeVector| unicode:: U+0295D .. DOWNWARDS HARPOON WITH BARB RIGHT FROM BAR -.. |RightDownVectorBar| unicode:: U+02955 .. DOWNWARDS HARPOON WITH BARB RIGHT TO BAR -.. |RightTeeVector| unicode:: U+0295B .. RIGHTWARDS HARPOON WITH BARB UP FROM BAR -.. |RightTriangleBar| unicode:: U+029D0 .. VERTICAL BAR BESIDE RIGHT TRIANGLE -.. |RightUpDownVector| unicode:: U+0294F .. UP BARB RIGHT DOWN BARB RIGHT HARPOON -.. |RightUpTeeVector| unicode:: U+0295C .. UPWARDS HARPOON WITH BARB RIGHT FROM BAR -.. |RightUpVectorBar| unicode:: U+02954 .. UPWARDS HARPOON WITH BARB RIGHT TO BAR -.. |RightVectorBar| unicode:: U+02953 .. RIGHTWARDS HARPOON WITH BARB UP TO BAR -.. |RoundImplies| unicode:: U+02970 .. RIGHT DOUBLE ARROW WITH ROUNDED HEAD -.. |RuleDelayed| unicode:: U+029F4 .. RULE-DELAYED -.. |Tab| unicode:: U+00009 .. CHARACTER TABULATION -.. |ThickSpace| unicode:: U+02009 U+0200A U+0200A .. space of width 5/18 em -.. |UnderBar| unicode:: U+00332 .. COMBINING LOW LINE -.. |UnderBrace| unicode:: U+0FE38 .. PRESENTATION FORM FOR VERTICAL RIGHT CURLY BRACKET -.. |UnderBracket| unicode:: U+023B5 .. BOTTOM SQUARE BRACKET -.. |UnderParenthesis| unicode:: U+0FE36 .. PRESENTATION FORM FOR VERTICAL RIGHT PARENTHESIS -.. |UpArrowBar| unicode:: U+02912 .. UPWARDS ARROW TO BAR -.. |Upsilon| unicode:: U+003A5 .. GREEK CAPITAL LETTER UPSILON -.. |VerticalLine| unicode:: U+0007C .. VERTICAL LINE -.. |VerticalSeparator| unicode:: U+02758 .. LIGHT VERTICAL BAR -.. |ZeroWidthSpace| unicode:: U+0200B .. ZERO WIDTH SPACE diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/s5defs.txt --- a/buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/s5defs.txt Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,68 +0,0 @@ -.. Definitions of interpreted text roles (classes) for S5/HTML data. -.. This data file has been placed in the public domain. - -.. Colours - ======= - -.. role:: black -.. role:: gray -.. role:: silver -.. role:: white - -.. role:: maroon -.. role:: red -.. role:: magenta -.. role:: fuchsia -.. role:: pink -.. role:: orange -.. role:: yellow -.. role:: lime -.. role:: green -.. role:: olive -.. role:: teal -.. role:: cyan -.. role:: aqua -.. role:: blue -.. role:: navy -.. role:: purple - - -.. Text Sizes - ========== - -.. role:: huge -.. role:: big -.. role:: small -.. role:: tiny - - -.. Display in Slides (Presentation Mode) Only - ========================================== - -.. role:: slide - :class: slide-display - - -.. Display in Outline Mode Only - ============================ - -.. role:: outline - - -.. Display in Print Only - ===================== - -.. role:: print - - -.. Display in Handout Mode Only - ============================ - -.. role:: handout - - -.. Incremental Display - =================== - -.. role:: incremental -.. default-role:: incremental diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/xhtml1-lat1.txt --- a/buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/xhtml1-lat1.txt Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,102 +0,0 @@ -.. This data file has been placed in the public domain. -.. Derived from the Unicode character mappings available from - . - Processed by unicode2rstsubs.py, part of Docutils: - . - -.. |Aacute| unicode:: U+000C1 .. LATIN CAPITAL LETTER A WITH ACUTE -.. |aacute| unicode:: U+000E1 .. LATIN SMALL LETTER A WITH ACUTE -.. |Acirc| unicode:: U+000C2 .. LATIN CAPITAL LETTER A WITH CIRCUMFLEX -.. |acirc| unicode:: U+000E2 .. LATIN SMALL LETTER A WITH CIRCUMFLEX -.. |acute| unicode:: U+000B4 .. ACUTE ACCENT -.. |AElig| unicode:: U+000C6 .. LATIN CAPITAL LETTER AE -.. |aelig| unicode:: U+000E6 .. LATIN SMALL LETTER AE -.. |Agrave| unicode:: U+000C0 .. LATIN CAPITAL LETTER A WITH GRAVE -.. |agrave| unicode:: U+000E0 .. LATIN SMALL LETTER A WITH GRAVE -.. |Aring| unicode:: U+000C5 .. LATIN CAPITAL LETTER A WITH RING ABOVE -.. |aring| unicode:: U+000E5 .. LATIN SMALL LETTER A WITH RING ABOVE -.. |Atilde| unicode:: U+000C3 .. LATIN CAPITAL LETTER A WITH TILDE -.. |atilde| unicode:: U+000E3 .. LATIN SMALL LETTER A WITH TILDE -.. |Auml| unicode:: U+000C4 .. LATIN CAPITAL LETTER A WITH DIAERESIS -.. |auml| unicode:: U+000E4 .. LATIN SMALL LETTER A WITH DIAERESIS -.. |brvbar| unicode:: U+000A6 .. BROKEN BAR -.. |Ccedil| unicode:: U+000C7 .. LATIN CAPITAL LETTER C WITH CEDILLA -.. |ccedil| unicode:: U+000E7 .. LATIN SMALL LETTER C WITH CEDILLA -.. |cedil| unicode:: U+000B8 .. CEDILLA -.. |cent| unicode:: U+000A2 .. CENT SIGN -.. |copy| unicode:: U+000A9 .. COPYRIGHT SIGN -.. |curren| unicode:: U+000A4 .. CURRENCY SIGN -.. |deg| unicode:: U+000B0 .. DEGREE SIGN -.. |divide| unicode:: U+000F7 .. DIVISION SIGN -.. |Eacute| unicode:: U+000C9 .. LATIN CAPITAL LETTER E WITH ACUTE -.. |eacute| unicode:: U+000E9 .. LATIN SMALL LETTER E WITH ACUTE -.. |Ecirc| unicode:: U+000CA .. LATIN CAPITAL LETTER E WITH CIRCUMFLEX -.. |ecirc| unicode:: U+000EA .. LATIN SMALL LETTER E WITH CIRCUMFLEX -.. |Egrave| unicode:: U+000C8 .. LATIN CAPITAL LETTER E WITH GRAVE -.. |egrave| unicode:: U+000E8 .. LATIN SMALL LETTER E WITH GRAVE -.. |ETH| unicode:: U+000D0 .. LATIN CAPITAL LETTER ETH -.. |eth| unicode:: U+000F0 .. LATIN SMALL LETTER ETH -.. |Euml| unicode:: U+000CB .. LATIN CAPITAL LETTER E WITH DIAERESIS -.. |euml| unicode:: U+000EB .. LATIN SMALL LETTER E WITH DIAERESIS -.. |frac12| unicode:: U+000BD .. VULGAR FRACTION ONE HALF -.. |frac14| unicode:: U+000BC .. VULGAR FRACTION ONE QUARTER -.. |frac34| unicode:: U+000BE .. VULGAR FRACTION THREE QUARTERS -.. |Iacute| unicode:: U+000CD .. LATIN CAPITAL LETTER I WITH ACUTE -.. |iacute| unicode:: U+000ED .. LATIN SMALL LETTER I WITH ACUTE -.. |Icirc| unicode:: U+000CE .. LATIN CAPITAL LETTER I WITH CIRCUMFLEX -.. |icirc| unicode:: U+000EE .. LATIN SMALL LETTER I WITH CIRCUMFLEX -.. |iexcl| unicode:: U+000A1 .. INVERTED EXCLAMATION MARK -.. |Igrave| unicode:: U+000CC .. LATIN CAPITAL LETTER I WITH GRAVE -.. |igrave| unicode:: U+000EC .. LATIN SMALL LETTER I WITH GRAVE -.. |iquest| unicode:: U+000BF .. INVERTED QUESTION MARK -.. |Iuml| unicode:: U+000CF .. LATIN CAPITAL LETTER I WITH DIAERESIS -.. |iuml| unicode:: U+000EF .. LATIN SMALL LETTER I WITH DIAERESIS -.. |laquo| unicode:: U+000AB .. LEFT-POINTING DOUBLE ANGLE QUOTATION MARK -.. |macr| unicode:: U+000AF .. MACRON -.. |micro| unicode:: U+000B5 .. MICRO SIGN -.. |middot| unicode:: U+000B7 .. MIDDLE DOT -.. |nbsp| unicode:: U+000A0 .. NO-BREAK SPACE -.. |not| unicode:: U+000AC .. NOT SIGN -.. |Ntilde| unicode:: U+000D1 .. LATIN CAPITAL LETTER N WITH TILDE -.. |ntilde| unicode:: U+000F1 .. LATIN SMALL LETTER N WITH TILDE -.. |Oacute| unicode:: U+000D3 .. LATIN CAPITAL LETTER O WITH ACUTE -.. |oacute| unicode:: U+000F3 .. LATIN SMALL LETTER O WITH ACUTE -.. |Ocirc| unicode:: U+000D4 .. LATIN CAPITAL LETTER O WITH CIRCUMFLEX -.. |ocirc| unicode:: U+000F4 .. LATIN SMALL LETTER O WITH CIRCUMFLEX -.. |Ograve| unicode:: U+000D2 .. LATIN CAPITAL LETTER O WITH GRAVE -.. |ograve| unicode:: U+000F2 .. LATIN SMALL LETTER O WITH GRAVE -.. |ordf| unicode:: U+000AA .. FEMININE ORDINAL INDICATOR -.. |ordm| unicode:: U+000BA .. MASCULINE ORDINAL INDICATOR -.. |Oslash| unicode:: U+000D8 .. LATIN CAPITAL LETTER O WITH STROKE -.. |oslash| unicode:: U+000F8 .. LATIN SMALL LETTER O WITH STROKE -.. |Otilde| unicode:: U+000D5 .. LATIN CAPITAL LETTER O WITH TILDE -.. |otilde| unicode:: U+000F5 .. LATIN SMALL LETTER O WITH TILDE -.. |Ouml| unicode:: U+000D6 .. LATIN CAPITAL LETTER O WITH DIAERESIS -.. |ouml| unicode:: U+000F6 .. LATIN SMALL LETTER O WITH DIAERESIS -.. |para| unicode:: U+000B6 .. PILCROW SIGN -.. |plusmn| unicode:: U+000B1 .. PLUS-MINUS SIGN -.. |pound| unicode:: U+000A3 .. POUND SIGN -.. |raquo| unicode:: U+000BB .. RIGHT-POINTING DOUBLE ANGLE QUOTATION MARK -.. |reg| unicode:: U+000AE .. REGISTERED SIGN -.. |sect| unicode:: U+000A7 .. SECTION SIGN -.. |shy| unicode:: U+000AD .. SOFT HYPHEN -.. |sup1| unicode:: U+000B9 .. SUPERSCRIPT ONE -.. |sup2| unicode:: U+000B2 .. SUPERSCRIPT TWO -.. |sup3| unicode:: U+000B3 .. SUPERSCRIPT THREE -.. |szlig| unicode:: U+000DF .. LATIN SMALL LETTER SHARP S -.. |THORN| unicode:: U+000DE .. LATIN CAPITAL LETTER THORN -.. |thorn| unicode:: U+000FE .. LATIN SMALL LETTER THORN -.. |times| unicode:: U+000D7 .. MULTIPLICATION SIGN -.. |Uacute| unicode:: U+000DA .. LATIN CAPITAL LETTER U WITH ACUTE -.. |uacute| unicode:: U+000FA .. LATIN SMALL LETTER U WITH ACUTE -.. |Ucirc| unicode:: U+000DB .. LATIN CAPITAL LETTER U WITH CIRCUMFLEX -.. |ucirc| unicode:: U+000FB .. LATIN SMALL LETTER U WITH CIRCUMFLEX -.. |Ugrave| unicode:: U+000D9 .. LATIN CAPITAL LETTER U WITH GRAVE -.. |ugrave| unicode:: U+000F9 .. LATIN SMALL LETTER U WITH GRAVE -.. |uml| unicode:: U+000A8 .. DIAERESIS -.. |Uuml| unicode:: U+000DC .. LATIN CAPITAL LETTER U WITH DIAERESIS -.. |uuml| unicode:: U+000FC .. LATIN SMALL LETTER U WITH DIAERESIS -.. |Yacute| unicode:: U+000DD .. LATIN CAPITAL LETTER Y WITH ACUTE -.. |yacute| unicode:: U+000FD .. LATIN SMALL LETTER Y WITH ACUTE -.. |yen| unicode:: U+000A5 .. YEN SIGN -.. |yuml| unicode:: U+000FF .. LATIN SMALL LETTER Y WITH DIAERESIS diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/xhtml1-special.txt --- a/buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/xhtml1-special.txt Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,37 +0,0 @@ -.. This data file has been placed in the public domain. -.. Derived from the Unicode character mappings available from - . - Processed by unicode2rstsubs.py, part of Docutils: - . - -.. |bdquo| unicode:: U+0201E .. DOUBLE LOW-9 QUOTATION MARK -.. |circ| unicode:: U+002C6 .. MODIFIER LETTER CIRCUMFLEX ACCENT -.. |Dagger| unicode:: U+02021 .. DOUBLE DAGGER -.. |dagger| unicode:: U+02020 .. DAGGER -.. |emsp| unicode:: U+02003 .. EM SPACE -.. |ensp| unicode:: U+02002 .. EN SPACE -.. |euro| unicode:: U+020AC .. EURO SIGN -.. |gt| unicode:: U+0003E .. GREATER-THAN SIGN -.. |ldquo| unicode:: U+0201C .. LEFT DOUBLE QUOTATION MARK -.. |lrm| unicode:: U+0200E .. LEFT-TO-RIGHT MARK -.. |lsaquo| unicode:: U+02039 .. SINGLE LEFT-POINTING ANGLE QUOTATION MARK -.. |lsquo| unicode:: U+02018 .. LEFT SINGLE QUOTATION MARK -.. |lt| unicode:: U+0003C .. LESS-THAN SIGN -.. |mdash| unicode:: U+02014 .. EM DASH -.. |ndash| unicode:: U+02013 .. EN DASH -.. |OElig| unicode:: U+00152 .. LATIN CAPITAL LIGATURE OE -.. |oelig| unicode:: U+00153 .. LATIN SMALL LIGATURE OE -.. |permil| unicode:: U+02030 .. PER MILLE SIGN -.. |quot| unicode:: U+00022 .. QUOTATION MARK -.. |rdquo| unicode:: U+0201D .. RIGHT DOUBLE QUOTATION MARK -.. |rlm| unicode:: U+0200F .. RIGHT-TO-LEFT MARK -.. |rsaquo| unicode:: U+0203A .. SINGLE RIGHT-POINTING ANGLE QUOTATION MARK -.. |rsquo| unicode:: U+02019 .. RIGHT SINGLE QUOTATION MARK -.. |sbquo| unicode:: U+0201A .. SINGLE LOW-9 QUOTATION MARK -.. |Scaron| unicode:: U+00160 .. LATIN CAPITAL LETTER S WITH CARON -.. |scaron| unicode:: U+00161 .. LATIN SMALL LETTER S WITH CARON -.. |thinsp| unicode:: U+02009 .. THIN SPACE -.. |tilde| unicode:: U+002DC .. SMALL TILDE -.. |Yuml| unicode:: U+00178 .. LATIN CAPITAL LETTER Y WITH DIAERESIS -.. |zwj| unicode:: U+0200D .. ZERO WIDTH JOINER -.. |zwnj| unicode:: U+0200C .. ZERO WIDTH NON-JOINER diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/xhtml1-symbol.txt --- a/buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/xhtml1-symbol.txt Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,130 +0,0 @@ -.. This data file has been placed in the public domain. -.. Derived from the Unicode character mappings available from - . - Processed by unicode2rstsubs.py, part of Docutils: - . - -.. |alefsym| unicode:: U+02135 .. ALEF SYMBOL -.. |Alpha| unicode:: U+00391 .. GREEK CAPITAL LETTER ALPHA -.. |alpha| unicode:: U+003B1 .. GREEK SMALL LETTER ALPHA -.. |and| unicode:: U+02227 .. LOGICAL AND -.. |ang| unicode:: U+02220 .. ANGLE -.. |asymp| unicode:: U+02248 .. ALMOST EQUAL TO -.. |Beta| unicode:: U+00392 .. GREEK CAPITAL LETTER BETA -.. |beta| unicode:: U+003B2 .. GREEK SMALL LETTER BETA -.. |bull| unicode:: U+02022 .. BULLET -.. |cap| unicode:: U+02229 .. INTERSECTION -.. |Chi| unicode:: U+003A7 .. GREEK CAPITAL LETTER CHI -.. |chi| unicode:: U+003C7 .. GREEK SMALL LETTER CHI -.. |clubs| unicode:: U+02663 .. BLACK CLUB SUIT -.. |cong| unicode:: U+02245 .. APPROXIMATELY EQUAL TO -.. |crarr| unicode:: U+021B5 .. DOWNWARDS ARROW WITH CORNER LEFTWARDS -.. |cup| unicode:: U+0222A .. UNION -.. |dArr| unicode:: U+021D3 .. DOWNWARDS DOUBLE ARROW -.. |darr| unicode:: U+02193 .. DOWNWARDS ARROW -.. |Delta| unicode:: U+00394 .. GREEK CAPITAL LETTER DELTA -.. |delta| unicode:: U+003B4 .. GREEK SMALL LETTER DELTA -.. |diams| unicode:: U+02666 .. BLACK DIAMOND SUIT -.. |empty| unicode:: U+02205 .. EMPTY SET -.. |Epsilon| unicode:: U+00395 .. GREEK CAPITAL LETTER EPSILON -.. |epsilon| unicode:: U+003B5 .. GREEK SMALL LETTER EPSILON -.. |equiv| unicode:: U+02261 .. IDENTICAL TO -.. |Eta| unicode:: U+00397 .. GREEK CAPITAL LETTER ETA -.. |eta| unicode:: U+003B7 .. GREEK SMALL LETTER ETA -.. |exist| unicode:: U+02203 .. THERE EXISTS -.. |fnof| unicode:: U+00192 .. LATIN SMALL LETTER F WITH HOOK -.. |forall| unicode:: U+02200 .. FOR ALL -.. |frasl| unicode:: U+02044 .. FRACTION SLASH -.. |Gamma| unicode:: U+00393 .. GREEK CAPITAL LETTER GAMMA -.. |gamma| unicode:: U+003B3 .. GREEK SMALL LETTER GAMMA -.. |ge| unicode:: U+02265 .. GREATER-THAN OR EQUAL TO -.. |hArr| unicode:: U+021D4 .. LEFT RIGHT DOUBLE ARROW -.. |harr| unicode:: U+02194 .. LEFT RIGHT ARROW -.. |hearts| unicode:: U+02665 .. BLACK HEART SUIT -.. |hellip| unicode:: U+02026 .. HORIZONTAL ELLIPSIS -.. |image| unicode:: U+02111 .. BLACK-LETTER CAPITAL I -.. |infin| unicode:: U+0221E .. INFINITY -.. |int| unicode:: U+0222B .. INTEGRAL -.. |Iota| unicode:: U+00399 .. GREEK CAPITAL LETTER IOTA -.. |iota| unicode:: U+003B9 .. GREEK SMALL LETTER IOTA -.. |isin| unicode:: U+02208 .. ELEMENT OF -.. |Kappa| unicode:: U+0039A .. GREEK CAPITAL LETTER KAPPA -.. |kappa| unicode:: U+003BA .. GREEK SMALL LETTER KAPPA -.. |Lambda| unicode:: U+0039B .. GREEK CAPITAL LETTER LAMDA -.. |lambda| unicode:: U+003BB .. GREEK SMALL LETTER LAMDA -.. |lang| unicode:: U+02329 .. LEFT-POINTING ANGLE BRACKET -.. |lArr| unicode:: U+021D0 .. LEFTWARDS DOUBLE ARROW -.. |larr| unicode:: U+02190 .. LEFTWARDS ARROW -.. |lceil| unicode:: U+02308 .. LEFT CEILING -.. |le| unicode:: U+02264 .. LESS-THAN OR EQUAL TO -.. |lfloor| unicode:: U+0230A .. LEFT FLOOR -.. |lowast| unicode:: U+02217 .. ASTERISK OPERATOR -.. |loz| unicode:: U+025CA .. LOZENGE -.. |minus| unicode:: U+02212 .. MINUS SIGN -.. |Mu| unicode:: U+0039C .. GREEK CAPITAL LETTER MU -.. |mu| unicode:: U+003BC .. GREEK SMALL LETTER MU -.. |nabla| unicode:: U+02207 .. NABLA -.. |ne| unicode:: U+02260 .. NOT EQUAL TO -.. |ni| unicode:: U+0220B .. CONTAINS AS MEMBER -.. |notin| unicode:: U+02209 .. NOT AN ELEMENT OF -.. |nsub| unicode:: U+02284 .. NOT A SUBSET OF -.. |Nu| unicode:: U+0039D .. GREEK CAPITAL LETTER NU -.. |nu| unicode:: U+003BD .. GREEK SMALL LETTER NU -.. |oline| unicode:: U+0203E .. OVERLINE -.. |Omega| unicode:: U+003A9 .. GREEK CAPITAL LETTER OMEGA -.. |omega| unicode:: U+003C9 .. GREEK SMALL LETTER OMEGA -.. |Omicron| unicode:: U+0039F .. GREEK CAPITAL LETTER OMICRON -.. |omicron| unicode:: U+003BF .. GREEK SMALL LETTER OMICRON -.. |oplus| unicode:: U+02295 .. CIRCLED PLUS -.. |or| unicode:: U+02228 .. LOGICAL OR -.. |otimes| unicode:: U+02297 .. CIRCLED TIMES -.. |part| unicode:: U+02202 .. PARTIAL DIFFERENTIAL -.. |perp| unicode:: U+022A5 .. UP TACK -.. |Phi| unicode:: U+003A6 .. GREEK CAPITAL LETTER PHI -.. |phi| unicode:: U+003D5 .. GREEK PHI SYMBOL -.. |Pi| unicode:: U+003A0 .. GREEK CAPITAL LETTER PI -.. |pi| unicode:: U+003C0 .. GREEK SMALL LETTER PI -.. |piv| unicode:: U+003D6 .. GREEK PI SYMBOL -.. |Prime| unicode:: U+02033 .. DOUBLE PRIME -.. |prime| unicode:: U+02032 .. PRIME -.. |prod| unicode:: U+0220F .. N-ARY PRODUCT -.. |prop| unicode:: U+0221D .. PROPORTIONAL TO -.. |Psi| unicode:: U+003A8 .. GREEK CAPITAL LETTER PSI -.. |psi| unicode:: U+003C8 .. GREEK SMALL LETTER PSI -.. |radic| unicode:: U+0221A .. SQUARE ROOT -.. |rang| unicode:: U+0232A .. RIGHT-POINTING ANGLE BRACKET -.. |rArr| unicode:: U+021D2 .. RIGHTWARDS DOUBLE ARROW -.. |rarr| unicode:: U+02192 .. RIGHTWARDS ARROW -.. |rceil| unicode:: U+02309 .. RIGHT CEILING -.. |real| unicode:: U+0211C .. BLACK-LETTER CAPITAL R -.. |rfloor| unicode:: U+0230B .. RIGHT FLOOR -.. |Rho| unicode:: U+003A1 .. GREEK CAPITAL LETTER RHO -.. |rho| unicode:: U+003C1 .. GREEK SMALL LETTER RHO -.. |sdot| unicode:: U+022C5 .. DOT OPERATOR -.. |Sigma| unicode:: U+003A3 .. GREEK CAPITAL LETTER SIGMA -.. |sigma| unicode:: U+003C3 .. GREEK SMALL LETTER SIGMA -.. |sigmaf| unicode:: U+003C2 .. GREEK SMALL LETTER FINAL SIGMA -.. |sim| unicode:: U+0223C .. TILDE OPERATOR -.. |spades| unicode:: U+02660 .. BLACK SPADE SUIT -.. |sub| unicode:: U+02282 .. SUBSET OF -.. |sube| unicode:: U+02286 .. SUBSET OF OR EQUAL TO -.. |sum| unicode:: U+02211 .. N-ARY SUMMATION -.. |sup| unicode:: U+02283 .. SUPERSET OF -.. |supe| unicode:: U+02287 .. SUPERSET OF OR EQUAL TO -.. |Tau| unicode:: U+003A4 .. GREEK CAPITAL LETTER TAU -.. |tau| unicode:: U+003C4 .. GREEK SMALL LETTER TAU -.. |there4| unicode:: U+02234 .. THEREFORE -.. |Theta| unicode:: U+00398 .. GREEK CAPITAL LETTER THETA -.. |theta| unicode:: U+003B8 .. GREEK SMALL LETTER THETA -.. |thetasym| unicode:: U+003D1 .. GREEK THETA SYMBOL -.. |trade| unicode:: U+02122 .. TRADE MARK SIGN -.. |uArr| unicode:: U+021D1 .. UPWARDS DOUBLE ARROW -.. |uarr| unicode:: U+02191 .. UPWARDS ARROW -.. |upsih| unicode:: U+003D2 .. GREEK UPSILON WITH HOOK SYMBOL -.. |Upsilon| unicode:: U+003A5 .. GREEK CAPITAL LETTER UPSILON -.. |upsilon| unicode:: U+003C5 .. GREEK SMALL LETTER UPSILON -.. |weierp| unicode:: U+02118 .. SCRIPT CAPITAL P -.. |Xi| unicode:: U+0039E .. GREEK CAPITAL LETTER XI -.. |xi| unicode:: U+003BE .. GREEK SMALL LETTER XI -.. |Zeta| unicode:: U+00396 .. GREEK CAPITAL LETTER ZETA -.. |zeta| unicode:: U+003B6 .. GREEK SMALL LETTER ZETA diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/languages/init.py --- a/buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/languages/init.py Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,25 +0,0 @@ -# $Id: init.py 4564 2006-05-21 20:44:42Z wiemann $ -# Author: David Goodger -# Copyright: This module has been placed in the public domain. - -# Internationalization details are documented in -# . - -""" -This package contains modules for language-dependent features of -reStructuredText. -""" - -docformat = 'reStructuredText' - -_languages = {} - -def get_language(language_code): - if _languages.has_key(language_code): - return _languages[language_code] - try: - module = import(language_code, globals(), locals()) - except ImportError: - return None - _languages[language_code] = module - return module diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/languages/af.py --- a/buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/languages/af.py Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,102 +0,0 @@ -# $Id: af.py 4564 2006-05-21 20:44:42Z wiemann $ -# Author: Jannie Hofmeyr -# Copyright: This module has been placed in the public domain. - -# New language mappings are welcome. Before doing a new translation, please -# read . Two files must be -# translated for each language: one in docutils/languages, the other in -# docutils/parsers/rst/languages. - -""" -Afrikaans-language mappings for language-dependent features of -reStructuredText. -""" - -docformat = 'reStructuredText' - - -directives = { - 'aandag': 'attention', - 'versigtig': 'caution', - 'gevaar': 'danger', - 'fout': 'error', - 'wenk': 'hint', - 'belangrik': 'important', - 'nota': 'note', - 'tip': 'tip', # hint and tip both have the same translation: wenk - 'waarskuwing': 'warning', - 'vermaning': 'admonition', - 'kantstreep': 'sidebar', - 'onderwerp': 'topic', - 'lynblok': 'line-block', - 'parsed-literal (translation required)': 'parsed-literal', - 'rubriek': 'rubric', - 'epigraaf': 'epigraph', - 'hoogtepunte': 'highlights', - 'pull-quote (translation required)': 'pull-quote', - u'compound (translation required)': 'compound', - u'container (translation required)': 'container', - #'vrae': 'questions', - #'qa': 'questions', - #'faq': 'questions', - 'table (translation required)': 'table', - 'csv-table (translation required)': 'csv-table', - 'list-table (translation required)': 'list-table', - 'meta': 'meta', - #'beeldkaart': 'imagemap', - 'beeld': 'image', - 'figuur': 'figure', - 'insluiting': 'include', - 'rou': 'raw', - 'vervang': 'replace', - 'unicode': 'unicode', # should this be translated? unikode - 'datum': 'date', - 'klas': 'class', - 'role (translation required)': 'role', - 'default-role (translation required)': 'default-role', - 'title (translation required)': 'title', - 'inhoud': 'contents', - 'sectnum': 'sectnum', - 'section-numbering': 'sectnum', - u'header (translation required)': 'header', - u'footer (translation required)': 'footer', - #'voetnote': 'footnotes', - #'aanhalings': 'citations', - 'teikennotas': 'target-notes', - 'restructuredtext-test-directive': 'restructuredtext-test-directive'} -"""Afrikaans name to registered (in directives/init.py) directive name -mapping.""" - -roles = { - 'afkorting': 'abbreviation', - 'ab': 'abbreviation', - 'akroniem': 'acronym', - 'ac': 'acronym', - 'indeks': 'index', - 'i': 'index', - 'voetskrif': 'subscript', - 'sub': 'subscript', - 'boskrif': 'superscript', - 'sup': 'superscript', - 'titelverwysing': 'title-reference', - 'titel': 'title-reference', - 't': 'title-reference', - 'pep-verwysing': 'pep-reference', - 'pep': 'pep-reference', - 'rfc-verwysing': 'rfc-reference', - 'rfc': 'rfc-reference', - 'nadruk': 'emphasis', - 'sterk': 'strong', - 'literal (translation required)': 'literal', - 'benoemde verwysing': 'named-reference', - 'anonieme verwysing': 'anonymous-reference', - 'voetnootverwysing': 'footnote-reference', - 'aanhalingverwysing': 'citation-reference', - 'vervangingsverwysing': 'substitution-reference', - 'teiken': 'target', - 'uri-verwysing': 'uri-reference', - 'uri': 'uri-reference', - 'url': 'uri-reference', - 'rou': 'raw',} -"""Mapping of Afrikaans role names to canonical role names for interpreted text. -""" diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/languages/ca.py --- a/buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/languages/ca.py Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,121 +0,0 @@ -# $Id: ca.py 4564 2006-05-21 20:44:42Z wiemann $ -# Author: Ivan Vilata i Balaguer -# Copyright: This module has been placed in the public domain. - -# New language mappings are welcome. Before doing a new translation, please -# read . Two files must be -# translated for each language: one in docutils/languages, the other in -# docutils/parsers/rst/languages. - -""" -Catalan-language mappings for language-dependent features of -reStructuredText. -""" - -docformat = 'reStructuredText' - - -directives = { - # language-dependent: fixed - u'atenci\u00F3': 'attention', - u'compte': 'caution', - u'perill': 'danger', - u'error': 'error', - u'suggeriment': 'hint', - u'important': 'important', - u'nota': 'note', - u'consell': 'tip', - u'av\u00EDs': 'warning', - u'advertiment': 'admonition', - u'nota-al-marge': 'sidebar', - u'nota-marge': 'sidebar', - u'tema': 'topic', - u'bloc-de-l\u00EDnies': 'line-block', - u'bloc-l\u00EDnies': 'line-block', - u'literal-analitzat': 'parsed-literal', - u'r\u00FAbrica': 'rubric', - u'ep\u00EDgraf': 'epigraph', - u'sumari': 'highlights', - u'cita-destacada': 'pull-quote', - u'compost': 'compound', - u'container (translation required)': 'container', - #'questions': 'questions', - u'taula': 'table', - u'taula-csv': 'csv-table', - u'taula-llista': 'list-table', - #'qa': 'questions', - #'faq': 'questions', - u'meta': 'meta', - #'imagemap': 'imagemap', - u'imatge': 'image', - u'figura': 'figure', - u'inclou': 'include', - u'incloure': 'include', - u'cru': 'raw', - u'reempla\u00E7a': 'replace', - u'reempla\u00E7ar': 'replace', - u'unicode': 'unicode', - u'data': 'date', - u'classe': 'class', - u'rol': 'role', - u'default-role (translation required)': 'default-role', - u'title (translation required)': 'title', - u'contingut': 'contents', - u'numsec': 'sectnum', - u'numeraci\u00F3-de-seccions': 'sectnum', - u'numeraci\u00F3-seccions': 'sectnum', - u'cap\u00E7alera': 'header', - u'peu-de-p\u00E0gina': 'footer', - u'peu-p\u00E0gina': 'footer', - #'footnotes': 'footnotes', - #'citations': 'citations', - u'notes-amb-destinacions': 'target-notes', - u'notes-destinacions': 'target-notes', - u'directiva-de-prova-de-restructuredtext': 'restructuredtext-test-directive'} -"""Catalan name to registered (in directives/init.py) directive name -mapping.""" - -roles = { - # language-dependent: fixed - u'abreviatura': 'abbreviation', - u'abreviaci\u00F3': 'abbreviation', - u'abrev': 'abbreviation', - u'ab': 'abbreviation', - u'acr\u00F2nim': 'acronym', - u'ac': 'acronym', - u'\u00EDndex': 'index', - u'i': 'index', - u'sub\u00EDndex': 'subscript', - u'sub': 'subscript', - u'super\u00EDndex': 'superscript', - u'sup': 'superscript', - u'refer\u00E8ncia-a-t\u00EDtol': 'title-reference', - u'refer\u00E8ncia-t\u00EDtol': 'title-reference', - u't\u00EDtol': 'title-reference', - u't': 'title-reference', - u'refer\u00E8ncia-a-pep': 'pep-reference', - u'refer\u00E8ncia-pep': 'pep-reference', - u'pep': 'pep-reference', - u'refer\u00E8ncia-a-rfc': 'rfc-reference', - u'refer\u00E8ncia-rfc': 'rfc-reference', - u'rfc': 'rfc-reference', - u'\u00E8mfasi': 'emphasis', - u'destacat': 'strong', - u'literal': 'literal', - u'refer\u00E8ncia-amb-nom': 'named-reference', - u'refer\u00E8ncia-nom': 'named-reference', - u'refer\u00E8ncia-an\u00F2nima': 'anonymous-reference', - u'refer\u00E8ncia-a-nota-al-peu': 'footnote-reference', - u'refer\u00E8ncia-nota-al-peu': 'footnote-reference', - u'refer\u00E8ncia-a-cita': 'citation-reference', - u'refer\u00E8ncia-cita': 'citation-reference', - u'refer\u00E8ncia-a-substituci\u00F3': 'substitution-reference', - u'refer\u00E8ncia-substituci\u00F3': 'substitution-reference', - u'destinaci\u00F3': 'target', - u'refer\u00E8ncia-a-uri': 'uri-reference', - u'refer\u00E8ncia-uri': 'uri-reference', - u'uri': 'uri-reference', - u'url': 'uri-reference', - u'cru': 'raw',} -"""Mapping of Catalan role names to canonical role names for interpreted text. -""" diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/languages/cs.py --- a/buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/languages/cs.py Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,104 +0,0 @@ -# $Id: cs.py 4564 2006-05-21 20:44:42Z wiemann $ -# Author: Marek Blaha -# Copyright: This module has been placed in the public domain. - -# New language mappings are welcome. Before doing a new translation, please -# read . Two files must be -# translated for each language: one in docutils/languages, the other in -# docutils/parsers/rst/languages. - -""" -Czech-language mappings for language-dependent features of -reStructuredText. -""" - -docformat = 'reStructuredText' - - -directives = { - # language-dependent: fixed - u'pozor': 'attention', - u'caution (translation required)': 'caution', # jak rozlisit caution a warning? - u'nebezpe\u010D\u00ED': 'danger', - u'chyba': 'error', - u'rada': 'hint', - u'd\u016Fle\u017Eit\u00E9': 'important', - u'pozn\u00E1mka': 'note', - u'tip (translation required)': 'tip', - u'varov\u00E1n\u00ED': 'warning', - u'admonition (translation required)': 'admonition', - u'sidebar (translation required)': 'sidebar', - u't\u00E9ma': 'topic', - u'line-block (translation required)': 'line-block', - u'parsed-literal (translation required)': 'parsed-literal', - u'odd\u00EDl': 'rubric', - u'moto': 'epigraph', - u'highlights (translation required)': 'highlights', - u'pull-quote (translation required)': 'pull-quote', - u'compound (translation required)': 'compound', - u'container (translation required)': 'container', - #'questions': 'questions', - #'qa': 'questions', - #'faq': 'questions', - u'table (translation required)': 'table', - u'csv-table (translation required)': 'csv-table', - u'list-table (translation required)': 'list-table', - u'meta (translation required)': 'meta', - #'imagemap': 'imagemap', - u'image (translation required)': 'image', # obrazek - u'figure (translation required)': 'figure', # a tady? - u'include (translation required)': 'include', - u'raw (translation required)': 'raw', - u'replace (translation required)': 'replace', - u'unicode (translation required)': 'unicode', - u'datum': 'date', - u't\u0159\u00EDda': 'class', - u'role (translation required)': 'role', - u'default-role (translation required)': 'default-role', - u'title (translation required)': 'title', - u'obsah': 'contents', - u'sectnum (translation required)': 'sectnum', - u'section-numbering (translation required)': 'sectnum', - u'header (translation required)': 'header', - u'footer (translation required)': 'footer', - #'footnotes': 'footnotes', - #'citations': 'citations', - u'target-notes (translation required)': 'target-notes', - u'restructuredtext-test-directive': 'restructuredtext-test-directive'} -"""Czech name to registered (in directives/init.py) directive name -mapping.""" - -roles = { - # language-dependent: fixed - u'abbreviation (translation required)': 'abbreviation', - u'ab (translation required)': 'abbreviation', - u'acronym (translation required)': 'acronym', - u'ac (translation required)': 'acronym', - u'index (translation required)': 'index', - u'i (translation required)': 'index', - u'subscript (translation required)': 'subscript', - u'sub (translation required)': 'subscript', - u'superscript (translation required)': 'superscript', - u'sup (translation required)': 'superscript', - u'title-reference (translation required)': 'title-reference', - u'title (translation required)': 'title-reference', - u't (translation required)': 'title-reference', - u'pep-reference (translation required)': 'pep-reference', - u'pep (translation required)': 'pep-reference', - u'rfc-reference (translation required)': 'rfc-reference', - u'rfc (translation required)': 'rfc-reference', - u'emphasis (translation required)': 'emphasis', - u'strong (translation required)': 'strong', - u'literal (translation required)': 'literal', - u'named-reference (translation required)': 'named-reference', - u'anonymous-reference (translation required)': 'anonymous-reference', - u'footnote-reference (translation required)': 'footnote-reference', - u'citation-reference (translation required)': 'citation-reference', - u'substitution-reference (translation required)': 'substitution-reference', - u'target (translation required)': 'target', - u'uri-reference (translation required)': 'uri-reference', - u'uri (translation required)': 'uri-reference', - u'url (translation required)': 'uri-reference', - u'raw (translation required)': 'raw',} -"""Mapping of Czech role names to canonical role names for interpreted text. -""" diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/languages/de.py --- a/buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/languages/de.py Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,96 +0,0 @@ -# $Id: de.py 5174 2007-05-31 00:01:52Z wiemann $ -# Authors: Engelbert Gruber ; -# Lea Wiemann -# Copyright: This module has been placed in the public domain. - -# New language mappings are welcome. Before doing a new translation, please -# read . Two files must be -# translated for each language: one in docutils/languages, the other in -# docutils/parsers/rst/languages. - -""" -German-language mappings for language-dependent features of -reStructuredText. -""" - -docformat = 'reStructuredText' - - -directives = { - 'achtung': 'attention', - 'vorsicht': 'caution', - 'gefahr': 'danger', - 'fehler': 'error', - 'hinweis': 'hint', - 'wichtig': 'important', - 'notiz': 'note', - 'tipp': 'tip', - 'warnung': 'warning', - 'ermahnung': 'admonition', - 'kasten': 'sidebar', - 'seitenkasten': 'sidebar', - 'thema': 'topic', - 'zeilen-block': 'line-block', - 'parsed-literal (translation required)': 'parsed-literal', - 'rubrik': 'rubric', - 'epigraph': 'epigraph', - 'highlights (translation required)': 'highlights', - 'pull-quote (translation required)': 'pull-quote', # kasten too ? - 'zusammengesetzt': 'compound', - 'verbund': 'compound', - u'container (translation required)': 'container', - #'fragen': 'questions', - 'tabelle': 'table', - 'csv-tabelle': 'csv-table', - 'list-table (translation required)': 'list-table', - 'meta': 'meta', - #'imagemap': 'imagemap', - 'bild': 'image', - 'abbildung': 'figure', - u'unver\xe4ndert': 'raw', - u'roh': 'raw', - u'einf\xfcgen': 'include', - 'ersetzung': 'replace', - 'ersetzen': 'replace', - 'ersetze': 'replace', - 'unicode': 'unicode', - 'datum': 'date', - 'klasse': 'class', - 'rolle': 'role', - u'default-role (translation required)': 'default-role', - u'title (translation required)': 'title', - 'inhalt': 'contents', - 'kapitel-nummerierung': 'sectnum', - 'abschnitts-nummerierung': 'sectnum', - u'linkziel-fu\xdfnoten': 'target-notes', - u'header (translation required)': 'header', - u'footer (translation required)': 'footer', - #u'fu\xdfnoten': 'footnotes', - #'zitate': 'citations', - } -"""German name to registered (in directives/init.py) directive name -mapping.""" - -roles = { - u'abk\xfcrzung': 'abbreviation', - 'akronym': 'acronym', - 'index': 'index', - 'tiefgestellt': 'subscript', - 'hochgestellt': 'superscript', - 'titel-referenz': 'title-reference', - 'pep-referenz': 'pep-reference', - 'rfc-referenz': 'rfc-reference', - 'betonung': 'emphasis', - 'fett': 'strong', - u'w\xf6rtlich': 'literal', - 'benannte-referenz': 'named-reference', - 'unbenannte-referenz': 'anonymous-reference', - u'fu\xdfnoten-referenz': 'footnote-reference', - 'zitat-referenz': 'citation-reference', - 'ersetzungs-referenz': 'substitution-reference', - 'ziel': 'target', - 'uri-referenz': 'uri-reference', - u'unver\xe4ndert': 'raw', - u'roh': 'raw',} -"""Mapping of German role names to canonical role names for interpreted text. -""" diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/languages/en.py --- a/buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/languages/en.py Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,104 +0,0 @@ -# $Id: en.py 4564 2006-05-21 20:44:42Z wiemann $ -# Author: David Goodger -# Copyright: This module has been placed in the public domain. - -# New language mappings are welcome. Before doing a new translation, please -# read . Two files must be -# translated for each language: one in docutils/languages, the other in -# docutils/parsers/rst/languages. - -""" -English-language mappings for language-dependent features of -reStructuredText. -""" - -docformat = 'reStructuredText' - - -directives = { - # language-dependent: fixed - 'attention': 'attention', - 'caution': 'caution', - 'danger': 'danger', - 'error': 'error', - 'hint': 'hint', - 'important': 'important', - 'note': 'note', - 'tip': 'tip', - 'warning': 'warning', - 'admonition': 'admonition', - 'sidebar': 'sidebar', - 'topic': 'topic', - 'line-block': 'line-block', - 'parsed-literal': 'parsed-literal', - 'rubric': 'rubric', - 'epigraph': 'epigraph', - 'highlights': 'highlights', - 'pull-quote': 'pull-quote', - 'compound': 'compound', - 'container': 'container', - #'questions': 'questions', - 'table': 'table', - 'csv-table': 'csv-table', - 'list-table': 'list-table', - #'qa': 'questions', - #'faq': 'questions', - 'meta': 'meta', - #'imagemap': 'imagemap', - 'image': 'image', - 'figure': 'figure', - 'include': 'include', - 'raw': 'raw', - 'replace': 'replace', - 'unicode': 'unicode', - 'date': 'date', - 'class': 'class', - 'role': 'role', - 'default-role': 'default-role', - 'title': 'title', - 'contents': 'contents', - 'sectnum': 'sectnum', - 'section-numbering': 'sectnum', - 'header': 'header', - 'footer': 'footer', - #'footnotes': 'footnotes', - #'citations': 'citations', - 'target-notes': 'target-notes', - 'restructuredtext-test-directive': 'restructuredtext-test-directive'} -"""English name to registered (in directives/init.py) directive name -mapping.""" - -roles = { - # language-dependent: fixed - 'abbreviation': 'abbreviation', - 'ab': 'abbreviation', - 'acronym': 'acronym', - 'ac': 'acronym', - 'index': 'index', - 'i': 'index', - 'subscript': 'subscript', - 'sub': 'subscript', - 'superscript': 'superscript', - 'sup': 'superscript', - 'title-reference': 'title-reference', - 'title': 'title-reference', - 't': 'title-reference', - 'pep-reference': 'pep-reference', - 'pep': 'pep-reference', - 'rfc-reference': 'rfc-reference', - 'rfc': 'rfc-reference', - 'emphasis': 'emphasis', - 'strong': 'strong', - 'literal': 'literal', - 'named-reference': 'named-reference', - 'anonymous-reference': 'anonymous-reference', - 'footnote-reference': 'footnote-reference', - 'citation-reference': 'citation-reference', - 'substitution-reference': 'substitution-reference', - 'target': 'target', - 'uri-reference': 'uri-reference', - 'uri': 'uri-reference', - 'url': 'uri-reference', - 'raw': 'raw',} -"""Mapping of English role names to canonical role names for interpreted text. -""" diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/languages/eo.py --- a/buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/languages/eo.py Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,114 +0,0 @@ -# $Id: eo.py 4564 2006-05-21 20:44:42Z wiemann $ -# Author: Marcelo Huerta San Martin -# Copyright: This module has been placed in the public domain. - -# New language mappings are welcome. Before doing a new translation, please -# read . Two files must be -# translated for each language: one in docutils/languages, the other in -# docutils/parsers/rst/languages. - -""" -Esperanto-language mappings for language-dependent features of -reStructuredText. -""" - -docformat = 'reStructuredText' - - -directives = { - # language-dependent: fixed - u'atentu': 'attention', - u'zorgu': 'caution', - u'dangxero': 'danger', - u'dan\u011dero': 'danger', - u'eraro': 'error', - u'spuro': 'hint', - u'grava': 'important', - u'noto': 'note', - u'helpeto': 'tip', - u'averto': 'warning', - u'admono': 'admonition', - u'flankteksto': 'sidebar', - u'temo': 'topic', - u'linea-bloko': 'line-block', - u'analizota-literalo': 'parsed-literal', - u'rubriko': 'rubric', - u'epigrafo': 'epigraph', - u'elstarajxoj': 'highlights', - u'elstara\u0135oj': 'highlights', - u'ekstera-citajxo': 'pull-quote', - u'ekstera-cita\u0135o': 'pull-quote', - u'kombinajxo': 'compound', - u'kombina\u0135o': 'compound', - u'tekstingo': 'container', - u'enhavilo': 'container', - #'questions': 'questions', - #'qa': 'questions', - #'faq': 'questions', - u'tabelo': 'table', - u'tabelo-vdk': 'csv-table', # "valoroj disigitaj per komoj" - u'tabelo-csv': 'csv-table', - u'tabelo-lista': 'list-table', - u'meta': 'meta', - #'imagemap': 'imagemap', - u'bildo': 'image', - u'figuro': 'figure', - u'inkludi': 'include', - u'senanaliza': 'raw', - u'anstatauxi': 'replace', - u'anstata\u016di': 'replace', - u'unicode': 'unicode', - u'dato': 'date', - u'klaso': 'class', - u'rolo': 'role', - u'preterlasita-rolo': 'default-role', - u'titolo': 'title', - u'enhavo': 'contents', - u'seknum': 'sectnum', - u'sekcia-numerado': 'sectnum', - u'kapsekcio': 'header', - u'piedsekcio': 'footer', - #'footnotes': 'footnotes', - #'citations': 'citations', - u'celaj-notoj': 'target-notes', - u'restructuredtext-test-directive': 'restructuredtext-test-directive'} -"""Esperanto name to registered (in directives/init.py) directive name -mapping.""" - -roles = { - # language-dependent: fixed - u'mallongigo': 'abbreviation', - u'mall': 'abbreviation', - u'komenclitero': 'acronym', - u'kl': 'acronym', - u'indekso': 'index', - u'i': 'index', - u'subskribo': 'subscript', - u'sub': 'subscript', - u'supraskribo': 'superscript', - u'sup': 'superscript', - u'titola-referenco': 'title-reference', - u'titolo': 'title-reference', - u't': 'title-reference', - u'pep-referenco': 'pep-reference', - u'pep': 'pep-reference', - u'rfc-referenco': 'rfc-reference', - u'rfc': 'rfc-reference', - u'emfazo': 'emphasis', - u'forta': 'strong', - u'litera': 'literal', - u'nomita-referenco': 'named-reference', - u'nenomita-referenco': 'anonymous-reference', - u'piednota-referenco': 'footnote-reference', - u'citajxo-referenco': 'citation-reference', - u'cita\u0135o-referenco': 'citation-reference', - u'anstatauxa-referenco': 'substitution-reference', - u'anstata\u016da-referenco': 'substitution-reference', - u'celo': 'target', - u'uri-referenco': 'uri-reference', - u'uri': 'uri-reference', - u'url': 'uri-reference', - u'senanaliza': 'raw', -} -"""Mapping of Esperanto role names to canonical role names for interpreted text. -""" diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/languages/es.py --- a/buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/languages/es.py Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,121 +0,0 @@ -# -- coding: utf-8 -- -# $Id: es.py 4564 2006-05-21 20:44:42Z wiemann $ -# Author: Marcelo Huerta San Martín -# Copyright: This module has been placed in the public domain. - -# New language mappings are welcome. Before doing a new translation, please -# read . Two files must be -# translated for each language: one in docutils/languages, the other in -# docutils/parsers/rst/languages. - -""" -Spanish-language mappings for language-dependent features of -reStructuredText. -""" - -docformat = 'reStructuredText' - - -directives = { - u'atenci\u00f3n': 'attention', - u'atencion': 'attention', - u'precauci\u00f3n': 'caution', - u'precaucion': 'caution', - u'peligro': 'danger', - u'error': 'error', - u'sugerencia': 'hint', - u'importante': 'important', - u'nota': 'note', - u'consejo': 'tip', - u'advertencia': 'warning', - u'exhortacion': 'admonition', - u'exhortaci\u00f3n': 'admonition', - u'nota-al-margen': 'sidebar', - u'tema': 'topic', - u'bloque-de-lineas': 'line-block', - u'bloque-de-l\u00edneas': 'line-block', - u'literal-evaluado': 'parsed-literal', - u'firma': 'rubric', - u'ep\u00edgrafe': 'epigraph', - u'epigrafe': 'epigraph', - u'destacado': 'highlights', - u'cita-destacada': 'pull-quote', - u'combinacion': 'compound', - u'combinaci\u00f3n': 'compound', - u'contenedor': 'container', - #'questions': 'questions', - #'qa': 'questions', - #'faq': 'questions', - u'tabla': 'table', - u'tabla-vsc': 'csv-table', - u'tabla-csv': 'csv-table', - u'tabla-lista': 'list-table', - u'meta': 'meta', - #'imagemap': 'imagemap', - u'imagen': 'image', - u'figura': 'figure', - u'incluir': 'include', - u'sin-analisis': 'raw', - u'sin-an\u00e1lisis': 'raw', - u'reemplazar': 'replace', - u'unicode': 'unicode', - u'fecha': 'date', - u'clase': 'class', - u'rol': 'role', - u'rol-por-omision': 'default-role', - u'rol-por-omisi\u00f3n': 'default-role', - u'titulo': 'title', - u't\u00edtulo': 'title', - u'contenido': 'contents', - u'numseccion': 'sectnum', - u'numsecci\u00f3n': 'sectnum', - u'numeracion-seccion': 'sectnum', - u'numeraci\u00f3n-secci\u00f3n': 'sectnum', - u'notas-destino': 'target-notes', - u'cabecera': 'header', - u'pie': 'footer', - #'footnotes': 'footnotes', - #'citations': 'citations', - u'restructuredtext-test-directive': 'restructuredtext-test-directive'} -"""Spanish name to registered (in directives/init.py) directive name -mapping.""" - -roles = { - u'abreviatura': 'abbreviation', - u'ab': 'abbreviation', - u'acronimo': 'acronym', - u'acronimo': 'acronym', - u'ac': 'acronym', - u'indice': 'index', - u'i': 'index', - u'subindice': 'subscript', - u'sub\u00edndice': 'subscript', - u'superindice': 'superscript', - u'super\u00edndice': 'superscript', - u'referencia-titulo': 'title-reference', - u'titulo': 'title-reference', - u't': 'title-reference', - u'referencia-pep': 'pep-reference', - u'pep': 'pep-reference', - u'referencia-rfc': 'rfc-reference', - u'rfc': 'rfc-reference', - u'enfasis': 'emphasis', - u'\u00e9nfasis': 'emphasis', - u'destacado': 'strong', - u'literal': 'literal', # "literal" is also a word in Spanish :-) - u'referencia-con-nombre': 'named-reference', - u'referencia-anonima': 'anonymous-reference', - u'referencia-an\u00f3nima': 'anonymous-reference', - u'referencia-nota-al-pie': 'footnote-reference', - u'referencia-cita': 'citation-reference', - u'referencia-sustitucion': 'substitution-reference', - u'referencia-sustituci\u00f3n': 'substitution-reference', - u'destino': 'target', - u'referencia-uri': 'uri-reference', - u'uri': 'uri-reference', - u'url': 'uri-reference', - u'sin-analisis': 'raw', - u'sin-an\u00e1lisis': 'raw', -} -"""Mapping of Spanish role names to canonical role names for interpreted text. -""" diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/languages/fi.py --- a/buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/languages/fi.py Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,93 +0,0 @@ -# $Id: fi.py 4564 2006-05-21 20:44:42Z wiemann $ -# Author: Asko Soukka -# Copyright: This module has been placed in the public domain. - -# New language mappings are welcome. Before doing a new translation, please -# read . Two files must be -# translated for each language: one in docutils/languages, the other in -# docutils/parsers/rst/languages. - -""" -Finnish-language mappings for language-dependent features of -reStructuredText. -""" - -docformat = 'reStructuredText' - - -directives = { - # language-dependent: fixed - u'huomio': u'attention', - u'varo': u'caution', - u'vaara': u'danger', - u'virhe': u'error', - u'vihje': u'hint', - u't\u00e4rke\u00e4\u00e4': u'important', - u'huomautus': u'note', - u'neuvo': u'tip', - u'varoitus': u'warning', - u'kehotus': u'admonition', - u'sivupalkki': u'sidebar', - u'aihe': u'topic', - u'rivi': u'line-block', - u'tasalevyinen': u'parsed-literal', - u'ohje': u'rubric', - u'epigraafi': u'epigraph', - u'kohokohdat': u'highlights', - u'lainaus': u'pull-quote', - u'taulukko': u'table', - u'csv-taulukko': u'csv-table', - u'list-table (translation required)': 'list-table', - u'compound (translation required)': 'compound', - u'container (translation required)': 'container', - #u'kysymykset': u'questions', - u'meta': u'meta', - #u'kuvakartta': u'imagemap', - u'kuva': u'image', - u'kaavio': u'figure', - u'sis\u00e4llyt\u00e4': u'include', - u'raaka': u'raw', - u'korvaa': u'replace', - u'unicode': u'unicode', - u'p\u00e4iv\u00e4ys': u'date', - u'luokka': u'class', - u'rooli': u'role', - u'default-role (translation required)': 'default-role', - u'title (translation required)': 'title', - u'sis\u00e4llys': u'contents', - u'kappale': u'sectnum', - u'header (translation required)': 'header', - u'footer (translation required)': 'footer', - #u'alaviitteet': u'footnotes', - #u'viitaukset': u'citations', - u'target-notes (translation required)': u'target-notes'} -"""Finnish name to registered (in directives/init.py) directive name -mapping.""" - -roles = { - # language-dependent: fixed - u'lyhennys': u'abbreviation', - u'akronyymi': u'acronym', - u'kirjainsana': u'acronym', - u'hakemisto': u'index', - u'luettelo': u'index', - u'alaindeksi': u'subscript', - u'indeksi': u'subscript', - u'yl\u00e4indeksi': u'superscript', - u'title-reference (translation required)': u'title-reference', - u'title (translation required)': u'title-reference', - u'pep-reference (translation required)': u'pep-reference', - u'rfc-reference (translation required)': u'rfc-reference', - u'korostus': u'emphasis', - u'vahvistus': u'strong', - u'tasalevyinen': u'literal', - u'named-reference (translation required)': u'named-reference', - u'anonymous-reference (translation required)': u'anonymous-reference', - u'footnote-reference (translation required)': u'footnote-reference', - u'citation-reference (translation required)': u'citation-reference', - u'substitution-reference (translation required)': u'substitution-reference', - u'kohde': u'target', - u'uri-reference (translation required)': u'uri-reference', - u'raw (translation required)': 'raw',} -"""Mapping of Finnish role names to canonical role names for interpreted text. -""" diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/languages/fr.py --- a/buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/languages/fr.py Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,99 +0,0 @@ -# $Id: fr.py 4564 2006-05-21 20:44:42Z wiemann $ -# Authors: David Goodger ; William Dode -# Copyright: This module has been placed in the public domain. - -# New language mappings are welcome. Before doing a new translation, please -# read . Two files must be -# translated for each language: one in docutils/languages, the other in -# docutils/parsers/rst/languages. - -""" -French-language mappings for language-dependent features of -reStructuredText. -""" - -docformat = 'reStructuredText' - - -directives = { - u'attention': 'attention', - u'pr\u00E9caution': 'caution', - u'danger': 'danger', - u'erreur': 'error', - u'conseil': 'hint', - u'important': 'important', - u'note': 'note', - u'astuce': 'tip', - u'avertissement': 'warning', - u'admonition': 'admonition', - u'encadr\u00E9': 'sidebar', - u'sujet': 'topic', - u'bloc-textuel': 'line-block', - u'bloc-interpr\u00E9t\u00E9': 'parsed-literal', - u'code-interpr\u00E9t\u00E9': 'parsed-literal', - u'intertitre': 'rubric', - u'exergue': 'epigraph', - u'\u00E9pigraphe': 'epigraph', - u'chapeau': 'highlights', - u'accroche': 'pull-quote', - u'compound (translation required)': 'compound', - u'container (translation required)': 'container', - #u'questions': 'questions', - #u'qr': 'questions', - #u'faq': 'questions', - u'tableau': 'table', - u'csv-table (translation required)': 'csv-table', - u'list-table (translation required)': 'list-table', - u'm\u00E9ta': 'meta', - #u'imagemap (translation required)': 'imagemap', - u'image': 'image', - u'figure': 'figure', - u'inclure': 'include', - u'brut': 'raw', - u'remplacer': 'replace', - u'remplace': 'replace', - u'unicode': 'unicode', - u'date': 'date', - u'classe': 'class', - u'role (translation required)': 'role', - u'default-role (translation required)': 'default-role', - u'titre (translation required)': 'title', - u'sommaire': 'contents', - u'table-des-mati\u00E8res': 'contents', - u'sectnum': 'sectnum', - u'section-num\u00E9rot\u00E9e': 'sectnum', - u'liens': 'target-notes', - u'header (translation required)': 'header', - u'footer (translation required)': 'footer', - #u'footnotes (translation required)': 'footnotes', - #u'citations (translation required)': 'citations', - } -"""French name to registered (in directives/init.py) directive name -mapping.""" - -roles = { - u'abr\u00E9viation': 'abbreviation', - u'acronyme': 'acronym', - u'sigle': 'acronym', - u'index': 'index', - u'indice': 'subscript', - u'ind': 'subscript', - u'exposant': 'superscript', - u'exp': 'superscript', - u'titre-r\u00E9f\u00E9rence': 'title-reference', - u'titre': 'title-reference', - u'pep-r\u00E9f\u00E9rence': 'pep-reference', - u'rfc-r\u00E9f\u00E9rence': 'rfc-reference', - u'emphase': 'emphasis', - u'fort': 'strong', - u'litt\u00E9ral': 'literal', - u'nomm\u00E9e-r\u00E9f\u00E9rence': 'named-reference', - u'anonyme-r\u00E9f\u00E9rence': 'anonymous-reference', - u'note-r\u00E9f\u00E9rence': 'footnote-reference', - u'citation-r\u00E9f\u00E9rence': 'citation-reference', - u'substitution-r\u00E9f\u00E9rence': 'substitution-reference', - u'lien': 'target', - u'uri-r\u00E9f\u00E9rence': 'uri-reference', - u'brut': 'raw',} -"""Mapping of French role names to canonical role names for interpreted text. -""" diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/languages/he.py --- a/buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/languages/he.py Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,104 +0,0 @@ -# Author: Meir Kriheli -# Id: $Id: he.py 4837 2006-12-26 09:59:41Z sfcben $ -# Copyright: This module has been placed in the public domain. - -# New language mappings are welcome. Before doing a new translation, please -# read . Two files must be -# translated for each language: one in docutils/languages, the other in -# docutils/parsers/rst/languages. - -""" -English-language mappings for language-dependent features of -reStructuredText. -""" - -docformat = 'reStructuredText' - - -directives = { - # language-dependent: fixed - u'\u05ea\u05e9\u05d5\u05de\u05ea \u05dc\u05d1': 'attention', - u'\u05d6\u05d4\u05d9\u05e8\u05d5\u05ea': 'caution', - u'\u05e1\u05db\u05e0\u05d4': 'danger', - u'\u05e9\u05d2\u05d9\u05d0\u05d4' : 'error', - u'\u05e8\u05de\u05d6': 'hint', - u'\u05d7\u05e9\u05d5\u05d1': 'important', - u'\u05d4\u05e2\u05e8\u05d4': 'note', - u'\u05d8\u05d9\u05e4': 'tip', - u'\u05d0\u05d6\u05d4\u05e8\u05d4': 'warning', - 'admonition': 'admonition', - 'sidebar': 'sidebar', - 'topic': 'topic', - 'line-block': 'line-block', - 'parsed-literal': 'parsed-literal', - 'rubric': 'rubric', - 'epigraph': 'epigraph', - 'highlights': 'highlights', - 'pull-quote': 'pull-quote', - 'compound': 'compound', - 'container': 'container', - #'questions': 'questions', - 'table': 'table', - 'csv-table': 'csv-table', - 'list-table': 'list-table', - #'qa': 'questions', - #'faq': 'questions', - 'meta': 'meta', - #'imagemap': 'imagemap', - u'\u05ea\u05de\u05d5\u05e0\u05d4': 'image', - 'figure': 'figure', - 'include': 'include', - 'raw': 'raw', - 'replace': 'replace', - 'unicode': 'unicode', - 'date': 'date', - u'\u05e1\u05d2\u05e0\u05d5\u05df': 'class', - 'role': 'role', - 'default-role': 'default-role', - 'title': 'title', - u'\u05ea\u05d5\u05db\u05df': 'contents', - 'sectnum': 'sectnum', - 'section-numbering': 'sectnum', - 'header': 'header', - 'footer': 'footer', - #'footnotes': 'footnotes', - #'citations': 'citations', - 'target-notes': 'target-notes', - 'restructuredtext-test-directive': 'restructuredtext-test-directive'} -"""English name to registered (in directives/init.py) directive name -mapping.""" - -roles = { - # language-dependent: fixed - 'abbreviation': 'abbreviation', - 'ab': 'abbreviation', - 'acronym': 'acronym', - 'ac': 'acronym', - 'index': 'index', - 'i': 'index', - u'\u05ea\u05d7\u05ea\u05d9': 'subscript', - 'sub': 'subscript', - u'\u05e2\u05d9\u05dc\u05d9': 'superscript', - 'sup': 'superscript', - 'title-reference': 'title-reference', - 'title': 'title-reference', - 't': 'title-reference', - 'pep-reference': 'pep-reference', - 'pep': 'pep-reference', - 'rfc-reference': 'rfc-reference', - 'rfc': 'rfc-reference', - 'emphasis': 'emphasis', - 'strong': 'strong', - 'literal': 'literal', - 'named-reference': 'named-reference', - 'anonymous-reference': 'anonymous-reference', - 'footnote-reference': 'footnote-reference', - 'citation-reference': 'citation-reference', - 'substitution-reference': 'substitution-reference', - 'target': 'target', - 'uri-reference': 'uri-reference', - 'uri': 'uri-reference', - 'url': 'uri-reference', - 'raw': 'raw',} -"""Mapping of English role names to canonical role names for interpreted text. -""" diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/languages/it.py --- a/buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/languages/it.py Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,93 +0,0 @@ -# $Id: it.py 4564 2006-05-21 20:44:42Z wiemann $ -# Authors: Nicola Larosa ; -# Lele Gaifax -# Copyright: This module has been placed in the public domain. - -# Beware: the italian translation of the reStructuredText documentation -# at http://docit.bice.dyndns.org/static/ReST, in particular -# http://docit.bice.dyndns.org/static/ReST/ref/rst/directives.html, needs -# to be synced with the content of this file. - -""" -Italian-language mappings for language-dependent features of -reStructuredText. -""" - -docformat = 'reStructuredText' - - -directives = { - 'attenzione': 'attention', - 'cautela': 'caution', - 'pericolo': 'danger', - 'errore': 'error', - 'suggerimento': 'hint', - 'importante': 'important', - 'nota': 'note', - 'consiglio': 'tip', - 'avvertenza': 'warning', - 'ammonizione': 'admonition', - 'riquadro': 'sidebar', - 'argomento': 'topic', - 'blocco-di-righe': 'line-block', - 'blocco-interpretato': 'parsed-literal', - 'rubrica': 'rubric', - 'epigrafe': 'epigraph', - 'punti-salienti': 'highlights', - 'estratto-evidenziato': 'pull-quote', - 'composito': 'compound', - u'container (translation required)': 'container', - #'questions': 'questions', - #'qa': 'questions', - #'faq': 'questions', - 'tabella': 'table', - 'tabella-csv': 'csv-table', - 'tabella-elenco': 'list-table', - 'meta': 'meta', - #'imagemap': 'imagemap', - 'immagine': 'image', - 'figura': 'figure', - 'includi': 'include', - 'grezzo': 'raw', - 'sostituisci': 'replace', - 'unicode': 'unicode', - 'data': 'date', - 'classe': 'class', - 'ruolo': 'role', - 'ruolo-predefinito': 'default-role', - 'titolo': 'title', - 'indice': 'contents', - 'contenuti': 'contents', - 'seznum': 'sectnum', - 'sezioni-autonumerate': 'sectnum', - 'annota-riferimenti-esterni': 'target-notes', - 'intestazione': 'header', - 'piede-pagina': 'footer', - #'footnotes': 'footnotes', - #'citations': 'citations', - 'restructuredtext-test-directive': 'restructuredtext-test-directive'} -"""Italian name to registered (in directives/init.py) directive name -mapping.""" - -roles = { - 'abbreviazione': 'abbreviation', - 'acronimo': 'acronym', - 'indice': 'index', - 'deponente': 'subscript', - 'esponente': 'superscript', - 'riferimento-titolo': 'title-reference', - 'riferimento-pep': 'pep-reference', - 'riferimento-rfc': 'rfc-reference', - 'enfasi': 'emphasis', - 'forte': 'strong', - 'letterale': 'literal', - 'riferimento-con-nome': 'named-reference', - 'riferimento-anonimo': 'anonymous-reference', - 'riferimento-nota': 'footnote-reference', - 'riferimento-citazione': 'citation-reference', - 'riferimento-sostituzione': 'substitution-reference', - 'destinazione': 'target', - 'riferimento-uri': 'uri-reference', - 'grezzo': 'raw',} -"""Mapping of Italian role names to canonical role names for interpreted text. -""" diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/languages/ja.py --- a/buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/languages/ja.py Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,115 +0,0 @@ -# -- coding: utf-8 -- -# $Id: ja.py 4564 2006-05-21 20:44:42Z wiemann $ -# Author: David Goodger -# Copyright: This module has been placed in the public domain. - -# New language mappings are welcome. Before doing a new translation, please -# read . Two files must be -# translated for each language: one in docutils/languages, the other in -# docutils/parsers/rst/languages. - -""" -Japanese-language mappings for language-dependent features of -reStructuredText. -""" - -docformat = 'reStructuredText' - -# Corrections to these translations are welcome! -# 間違いがあれば、どうぞ正しい翻訳を教えて下さい。 - -directives = { - # language-dependent: fixed - u'注目': 'attention', - u'注意': 'caution', - u'危険': 'danger', - u'エラー': 'error', - u'ヒント': 'hint', - u'重要': 'important', - u'備考': 'note', - u'通報': 'tip', - u'警告': 'warning', - u'戒告': 'admonition', - u'サイドバー': 'sidebar', - u'トピック': 'topic', - u'ラインブロック': 'line-block', - u'パーズドリテラル': 'parsed-literal', - u'ルブリック': 'rubric', - u'エピグラフ': 'epigraph', - u'題言': 'epigraph', - u'ハイライト': 'highlights', - u'見所': 'highlights', - u'プルクオート': 'pull-quote', - u'合成': 'compound', - u'コンテナー': 'container', - u'容器': 'container', - u'表': 'table', - u'csv表': 'csv-table', - u'リスト表': 'list-table', - #u'質問': 'questions', - #u'問答': 'questions', - #u'faq': 'questions', - u'メタ': 'meta', - #u'イメージマプ': 'imagemap', - u'イメージ': 'image', - u'画像': 'image', - u'フィグア': 'figure', - u'図版': 'figure', - u'インクルード': 'include', - u'含む': 'include', - u'組み込み': 'include', - u'生': 'raw', - u'原': 'raw', - u'換える': 'replace', - u'取り換える': 'replace', - u'掛け替える': 'replace', - u'ユニコード': 'unicode', - u'日付': 'date', - u'クラス': 'class', - u'ロール': 'role', - u'役': 'role', - u'ディフォルトロール': 'default-role', - u'既定役': 'default-role', - u'タイトル': 'title', - u'題': 'title', # 題名　件名 - u'目次': 'contents', - u'節数': 'sectnum', - u'ヘッダ': 'header', - u'フッタ': 'footer', - #u'脚注': 'footnotes', # 脚註? - #u'サイテーション': 'citations',　　　# 出典　引証　引用 - u'ターゲットノート': 'target-notes', # 的注　的脚注 - } -"""Japanese name to registered (in directives/init.py) directive name -mapping.""" - -roles = { - # language-dependent: fixed - u'略': 'abbreviation', - u'頭字語': 'acronym', - u'インデックス': 'index', - u'索引': 'index', - u'添字': 'subscript', - u'下付': 'subscript', - u'下': 'subscript', - u'上付': 'superscript', - u'上': 'superscript', - u'題参照': 'title-reference', - u'pep参照': 'pep-reference', - u'rfc参照': 'rfc-reference', - u'強調': 'emphasis', - u'強い': 'strong', - u'リテラル': 'literal', - u'整形済み': 'literal', - u'名付参照': 'named-reference', - u'無名参照': 'anonymous-reference', - u'脚注参照': 'footnote-reference', - u'出典参照': 'citation-reference', - u'代入参照': 'substitution-reference', - u'的': 'target', - u'uri参照': 'uri-reference', - u'uri': 'uri-reference', - u'url': 'uri-reference', - u'生': 'raw',} -"""Mapping of Japanese role names to canonical role names for interpreted -text.""" diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/languages/nl.py --- a/buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/languages/nl.py Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,108 +0,0 @@ -# $Id: nl.py 4564 2006-05-21 20:44:42Z wiemann $ -# Author: Martijn Pieters -# Copyright: This module has been placed in the public domain. - -# New language mappings are welcome. Before doing a new translation, please -# read . Two files must be -# translated for each language: one in docutils/languages, the other in -# docutils/parsers/rst/languages. - -""" -Dutch-language mappings for language-dependent features of -reStructuredText. -""" - -docformat = 'reStructuredText' - - -directives = { - # language-dependent: fixed - 'attentie': 'attention', - 'let-op': 'caution', - 'gevaar': 'danger', - 'fout': 'error', - 'hint': 'hint', - 'belangrijk': 'important', - 'opmerking': 'note', - 'tip': 'tip', - 'waarschuwing': 'warning', - 'aanmaning': 'admonition', - 'katern': 'sidebar', - 'onderwerp': 'topic', - 'lijn-blok': 'line-block', - 'letterlijk-ontleed': 'parsed-literal', - 'rubriek': 'rubric', - 'opschrift': 'epigraph', - 'hoogtepunten': 'highlights', - 'pull-quote': 'pull-quote', # Dutch printers use the english term - 'samenstelling': 'compound', - 'verbinding': 'compound', - u'container (translation required)': 'container', - #'vragen': 'questions', - 'tabel': 'table', - 'csv-tabel': 'csv-table', - 'lijst-tabel': 'list-table', - #'veelgestelde-vragen': 'questions', - 'meta': 'meta', - #'imagemap': 'imagemap', - 'beeld': 'image', - 'figuur': 'figure', - 'opnemen': 'include', - 'onbewerkt': 'raw', - 'vervang': 'replace', - 'vervanging': 'replace', - 'unicode': 'unicode', - 'datum': 'date', - 'klasse': 'class', - 'rol': 'role', - u'default-role (translation required)': 'default-role', - 'title (translation required)': 'title', - 'inhoud': 'contents', - 'sectnum': 'sectnum', - 'sectie-nummering': 'sectnum', - 'hoofdstuk-nummering': 'sectnum', - u'header (translation required)': 'header', - u'footer (translation required)': 'footer', - #'voetnoten': 'footnotes', - #'citaten': 'citations', - 'verwijzing-voetnoten': 'target-notes', - 'restructuredtext-test-instructie': 'restructuredtext-test-directive'} -"""Dutch name to registered (in directives/init.py) directive name -mapping.""" - -roles = { - # language-dependent: fixed - 'afkorting': 'abbreviation', - # 'ab': 'abbreviation', - 'acroniem': 'acronym', - 'ac': 'acronym', - 'index': 'index', - 'i': 'index', - 'inferieur': 'subscript', - 'inf': 'subscript', - 'superieur': 'superscript', - 'sup': 'superscript', - 'titel-referentie': 'title-reference', - 'titel': 'title-reference', - 't': 'title-reference', - 'pep-referentie': 'pep-reference', - 'pep': 'pep-reference', - 'rfc-referentie': 'rfc-reference', - 'rfc': 'rfc-reference', - 'nadruk': 'emphasis', - 'extra': 'strong', - 'extra-nadruk': 'strong', - 'vet': 'strong', - 'letterlijk': 'literal', - 'benoemde-referentie': 'named-reference', - 'anonieme-referentie': 'anonymous-reference', - 'voetnoot-referentie': 'footnote-reference', - 'citaat-referentie': 'citation-reference', - 'substitie-reference': 'substitution-reference', - 'verwijzing': 'target', - 'uri-referentie': 'uri-reference', - 'uri': 'uri-reference', - 'url': 'uri-reference', - 'onbewerkt': 'raw',} -"""Mapping of Dutch role names to canonical role names for interpreted text. -""" diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/languages/pt_br.py --- a/buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/languages/pt_br.py Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,104 +0,0 @@ -# $Id: pt_br.py 4564 2006-05-21 20:44:42Z wiemann $ -# Author: David Goodger -# Copyright: This module has been placed in the public domain. - -# New language mappings are welcome. Before doing a new translation, please -# read . Two files must be -# translated for each language: one in docutils/languages, the other in -# docutils/parsers/rst/languages. - -""" -Brazilian Portuguese-language mappings for language-dependent features of -reStructuredText. -""" - -docformat = 'reStructuredText' - - -directives = { - # language-dependent: fixed - u'aten\u00E7\u00E3o': 'attention', - 'cuidado': 'caution', - 'perigo': 'danger', - 'erro': 'error', - u'sugest\u00E3o': 'hint', - 'importante': 'important', - 'nota': 'note', - 'dica': 'tip', - 'aviso': 'warning', - u'exorta\u00E7\u00E3o': 'admonition', - 'barra-lateral': 'sidebar', - u't\u00F3pico': 'topic', - 'bloco-de-linhas': 'line-block', - 'literal-interpretado': 'parsed-literal', - 'rubrica': 'rubric', - u'ep\u00EDgrafo': 'epigraph', - 'destaques': 'highlights', - u'cita\u00E7\u00E3o-destacada': 'pull-quote', - u'compound (translation required)': 'compound', - u'container (translation required)': 'container', - #'perguntas': 'questions', - #'qa': 'questions', - #'faq': 'questions', - u'table (translation required)': 'table', - u'csv-table (translation required)': 'csv-table', - u'list-table (translation required)': 'list-table', - 'meta': 'meta', - #'imagemap': 'imagemap', - 'imagem': 'image', - 'figura': 'figure', - u'inclus\u00E3o': 'include', - 'cru': 'raw', - u'substitui\u00E7\u00E3o': 'replace', - 'unicode': 'unicode', - 'data': 'date', - 'classe': 'class', - 'role (translation required)': 'role', - u'default-role (translation required)': 'default-role', - u'title (translation required)': 'title', - u'\u00EDndice': 'contents', - 'numsec': 'sectnum', - u'numera\u00E7\u00E3o-de-se\u00E7\u00F5es': 'sectnum', - u'header (translation required)': 'header', - u'footer (translation required)': 'footer', - #u'notas-de-rorap\u00E9': 'footnotes', - #u'cita\u00E7\u00F5es': 'citations', - u'links-no-rodap\u00E9': 'target-notes', - 'restructuredtext-test-directive': 'restructuredtext-test-directive'} -"""Brazilian Portuguese name to registered (in directives/init.py) -directive name mapping.""" - -roles = { - # language-dependent: fixed - u'abbrevia\u00E7\u00E3o': 'abbreviation', - 'ab': 'abbreviation', - u'acr\u00F4nimo': 'acronym', - 'ac': 'acronym', - u'\u00EDndice-remissivo': 'index', - 'i': 'index', - 'subscrito': 'subscript', - 'sub': 'subscript', - 'sobrescrito': 'superscript', - 'sob': 'superscript', - u'refer\u00EAncia-a-t\u00EDtulo': 'title-reference', - u't\u00EDtulo': 'title-reference', - 't': 'title-reference', - u'refer\u00EAncia-a-pep': 'pep-reference', - 'pep': 'pep-reference', - u'refer\u00EAncia-a-rfc': 'rfc-reference', - 'rfc': 'rfc-reference', - u'\u00EAnfase': 'emphasis', - 'forte': 'strong', - 'literal': 'literal', # translation required? - u'refer\u00EAncia-por-nome': 'named-reference', - u'refer\u00EAncia-an\u00F4nima': 'anonymous-reference', - u'refer\u00EAncia-a-nota-de-rodap\u00E9': 'footnote-reference', - u'refer\u00EAncia-a-cita\u00E7\u00E3o': 'citation-reference', - u'refer\u00EAncia-a-substitui\u00E7\u00E3o': 'substitution-reference', - 'alvo': 'target', - u'refer\u00EAncia-a-uri': 'uri-reference', - 'uri': 'uri-reference', - 'url': 'uri-reference', - 'cru': 'raw',} -"""Mapping of Brazilian Portuguese role names to canonical role names -for interpreted text.""" diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/languages/ru.py --- a/buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/languages/ru.py Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,103 +0,0 @@ -# $Id: ru.py 4564 2006-05-21 20:44:42Z wiemann $ -# Author: Roman Suzi -# Copyright: This module has been placed in the public domain. - -# New language mappings are welcome. Before doing a new translation, please -# read . Two files must be -# translated for each language: one in docutils/languages, the other in -# docutils/parsers/rst/languages. - -""" -Russian-language mappings for language-dependent features of -reStructuredText. -""" - -docformat = 'reStructuredText' - -directives = { - u'\u0431\u043b\u043e\u043a-\u0441\u0442\u0440\u043e\u043a': u'line-block', - u'meta': u'meta', - u'\u043e\u0431\u0440\u0430\u0431\u043e\u0442\u0430\u043d\u043d\u044b\u0439-\u043b\u0438\u0442\u0435\u0440\u0430\u043b': - u'parsed-literal', - u'\u0432\u044b\u0434\u0435\u043b\u0435\u043d\u043d\u0430\u044f-\u0446\u0438\u0442\u0430\u0442\u0430': - u'pull-quote', - u'compound (translation required)': 'compound', - u'container (translation required)': 'container', - u'table (translation required)': 'table', - u'csv-table (translation required)': 'csv-table', - u'list-table (translation required)': 'list-table', - u'\u0441\u044b\u0440\u043e\u0439': u'raw', - u'\u0437\u0430\u043c\u0435\u043d\u0430': u'replace', - u'\u0442\u0435\u0441\u0442\u043e\u0432\u0430\u044f-\u0434\u0438\u0440\u0435\u043a\u0442\u0438\u0432\u0430-restructuredtext': - u'restructuredtext-test-directive', - u'\u0446\u0435\u043b\u0435\u0432\u044b\u0435-\u0441\u043d\u043e\u0441\u043a\u0438': - u'target-notes', - u'unicode': u'unicode', - u'\u0434\u0430\u0442\u0430': u'date', - u'\u0431\u043e\u043a\u043e\u0432\u0430\u044f-\u043f\u043e\u043b\u043e\u0441\u0430': - u'sidebar', - u'\u0432\u0430\u0436\u043d\u043e': u'important', - u'\u0432\u043a\u043b\u044e\u0447\u0430\u0442\u044c': u'include', - u'\u0432\u043d\u0438\u043c\u0430\u043d\u0438\u0435': u'attention', - u'\u0432\u044b\u0434\u0435\u043b\u0435\u043d\u0438\u0435': u'highlights', - u'\u0437\u0430\u043c\u0435\u0447\u0430\u043d\u0438\u0435': u'admonition', - u'\u0438\u0437\u043e\u0431\u0440\u0430\u0436\u0435\u043d\u0438\u0435': - u'image', - u'\u043a\u043b\u0430\u0441\u0441': u'class', - u'role (translation required)': 'role', - u'default-role (translation required)': 'default-role', - u'title (translation required)': 'title', - u'\u043d\u043e\u043c\u0435\u0440-\u0440\u0430\u0437\u0434\u0435\u043b\u0430': - u'sectnum', - u'\u043d\u0443\u043c\u0435\u0440\u0430\u0446\u0438\u044f-\u0440\u0430\u0437' - u'\u0434\u0435\u043b\u043e\u0432': u'sectnum', - u'\u043e\u043f\u0430\u0441\u043d\u043e': u'danger', - u'\u043e\u0441\u0442\u043e\u0440\u043e\u0436\u043d\u043e': u'caution', - u'\u043e\u0448\u0438\u0431\u043a\u0430': u'error', - u'\u043f\u043e\u0434\u0441\u043a\u0430\u0437\u043a\u0430': u'tip', - u'\u043f\u0440\u0435\u0434\u0443\u043f\u0440\u0435\u0436\u0434\u0435\u043d' - u'\u0438\u0435': u'warning', - u'\u043f\u0440\u0438\u043c\u0435\u0447\u0430\u043d\u0438\u0435': u'note', - u'\u0440\u0438\u0441\u0443\u043d\u043e\u043a': u'figure', - u'\u0440\u0443\u0431\u0440\u0438\u043a\u0430': u'rubric', - u'\u0441\u043e\u0432\u0435\u0442': u'hint', - u'\u0441\u043e\u0434\u0435\u0440\u0436\u0430\u043d\u0438\u0435': u'contents', - u'\u0442\u0435\u043c\u0430': u'topic', - u'\u044d\u043f\u0438\u0433\u0440\u0430\u0444': u'epigraph', - u'header (translation required)': 'header', - u'footer (translation required)': 'footer',} -"""Russian name to registered (in directives/init.py) directive name -mapping.""" - -roles = { - u'\u0430\u043a\u0440\u043e\u043d\u0438\u043c': 'acronym', - u'\u0430\u043d\u043e\u043d\u0438\u043c\u043d\u0430\u044f-\u0441\u0441\u044b\u043b\u043a\u0430': - 'anonymous-reference', - u'\u0431\u0443\u043a\u0432\u0430\u043b\u044c\u043d\u043e': 'literal', - u'\u0432\u0435\u0440\u0445\u043d\u0438\u0439-\u0438\u043d\u0434\u0435\u043a\u0441': - 'superscript', - u'\u0432\u044b\u0434\u0435\u043b\u0435\u043d\u0438\u0435': 'emphasis', - u'\u0438\u043c\u0435\u043d\u043e\u0432\u0430\u043d\u043d\u0430\u044f-\u0441\u0441\u044b\u043b\u043a\u0430': - 'named-reference', - u'\u0438\u043d\u0434\u0435\u043a\u0441': 'index', - u'\u043d\u0438\u0436\u043d\u0438\u0439-\u0438\u043d\u0434\u0435\u043a\u0441': - 'subscript', - u'\u0441\u0438\u043b\u044c\u043d\u043e\u0435-\u0432\u044b\u0434\u0435\u043b\u0435\u043d\u0438\u0435': - 'strong', - u'\u0441\u043e\u043a\u0440\u0430\u0449\u0435\u043d\u0438\u0435': - 'abbreviation', - u'\u0441\u0441\u044b\u043b\u043a\u0430-\u0437\u0430\u043c\u0435\u043d\u0430': - 'substitution-reference', - u'\u0441\u0441\u044b\u043b\u043a\u0430-\u043d\u0430-pep': 'pep-reference', - u'\u0441\u0441\u044b\u043b\u043a\u0430-\u043d\u0430-rfc': 'rfc-reference', - u'\u0441\u0441\u044b\u043b\u043a\u0430-\u043d\u0430-uri': 'uri-reference', - u'\u0441\u0441\u044b\u043b\u043a\u0430-\u043d\u0430-\u0437\u0430\u0433\u043b\u0430\u0432\u0438\u0435': - 'title-reference', - u'\u0441\u0441\u044b\u043b\u043a\u0430-\u043d\u0430-\u0441\u043d\u043e\u0441\u043a\u0443': - 'footnote-reference', - u'\u0446\u0438\u0442\u0430\u0442\u043d\u0430\u044f-\u0441\u0441\u044b\u043b\u043a\u0430': - 'citation-reference', - u'\u0446\u0435\u043b\u044c': 'target', - u'raw (translation required)': 'raw',} -"""Mapping of Russian role names to canonical role names for interpreted text. -""" diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/languages/sk.py --- a/buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/languages/sk.py Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,91 +0,0 @@ -# $Id: sk.py 4564 2006-05-21 20:44:42Z wiemann $ -# Author: Miroslav Vasko -# Copyright: This module has been placed in the public domain. - -# New language mappings are welcome. Before doing a new translation, please -# read . Two files must be -# translated for each language: one in docutils/languages, the other in -# docutils/parsers/rst/languages. - -""" -Slovak-language mappings for language-dependent features of -reStructuredText. -""" - -docformat = 'reStructuredText' - - -directives = { - u'pozor': 'attention', - u'opatrne': 'caution', - u'nebezpe\xe8enstvo': 'danger', - u'chyba': 'error', - u'rada': 'hint', - u'd\xf4le\x9eit\xe9': 'important', - u'pozn\xe1mka': 'note', - u'tip (translation required)': 'tip', - u'varovanie': 'warning', - u'admonition (translation required)': 'admonition', - u'sidebar (translation required)': 'sidebar', - u't\xe9ma': 'topic', - u'blok-riadkov': 'line-block', - u'parsed-literal': 'parsed-literal', - u'rubric (translation required)': 'rubric', - u'epigraph (translation required)': 'epigraph', - u'highlights (translation required)': 'highlights', - u'pull-quote (translation required)': 'pull-quote', - u'compound (translation required)': 'compound', - u'container (translation required)': 'container', - #u'questions': 'questions', - #u'qa': 'questions', - #u'faq': 'questions', - u'table (translation required)': 'table', - u'csv-table (translation required)': 'csv-table', - u'list-table (translation required)': 'list-table', - u'meta': 'meta', - #u'imagemap': 'imagemap', - u'obr\xe1zok': 'image', - u'tvar': 'figure', - u'vlo\x9ei\x9d': 'include', - u'raw (translation required)': 'raw', - u'nahradi\x9d': 'replace', - u'unicode': 'unicode', - u'd\u00E1tum': 'date', - u'class (translation required)': 'class', - u'role (translation required)': 'role', - u'default-role (translation required)': 'default-role', - u'title (translation required)': 'title', - u'obsah': 'contents', - u'\xe8as\x9d': 'sectnum', - u'\xe8as\x9d-\xe8\xedslovanie': 'sectnum', - u'cie\xbeov\xe9-pozn\xe1mky': 'target-notes', - u'header (translation required)': 'header', - u'footer (translation required)': 'footer', - #u'footnotes': 'footnotes', - #u'citations': 'citations', - } -"""Slovak name to registered (in directives/init.py) directive name -mapping.""" - -roles = { - u'abbreviation (translation required)': 'abbreviation', - u'acronym (translation required)': 'acronym', - u'index (translation required)': 'index', - u'subscript (translation required)': 'subscript', - u'superscript (translation required)': 'superscript', - u'title-reference (translation required)': 'title-reference', - u'pep-reference (translation required)': 'pep-reference', - u'rfc-reference (translation required)': 'rfc-reference', - u'emphasis (translation required)': 'emphasis', - u'strong (translation required)': 'strong', - u'literal (translation required)': 'literal', - u'named-reference (translation required)': 'named-reference', - u'anonymous-reference (translation required)': 'anonymous-reference', - u'footnote-reference (translation required)': 'footnote-reference', - u'citation-reference (translation required)': 'citation-reference', - u'substitution-reference (translation required)': 'substitution-reference', - u'target (translation required)': 'target', - u'uri-reference (translation required)': 'uri-reference', - u'raw (translation required)': 'raw',} -"""Mapping of Slovak role names to canonical role names for interpreted text. -""" diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/languages/sv.py --- a/buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/languages/sv.py Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,90 +0,0 @@ -# $Id: sv.py 4564 2006-05-21 20:44:42Z wiemann $ -# Author: Adam Chodorowski -# Copyright: This module has been placed in the public domain. - -# New language mappings are welcome. Before doing a new translation, please -# read . Two files must be -# translated for each language: one in docutils/languages, the other in -# docutils/parsers/rst/languages. - -""" -Swedish language mappings for language-dependent features of reStructuredText. -""" - -docformat = 'reStructuredText' - - -directives = { - u'observera': 'attention', - u'caution (translation required)': 'caution', - u'fara': 'danger', - u'fel': 'error', - u'v\u00e4gledning': 'hint', - u'viktigt': 'important', - u'notera': 'note', - u'tips': 'tip', - u'varning': 'warning', - u'admonition (translation required)': 'admonition', - u'sidebar (translation required)': 'sidebar', - u'\u00e4mne': 'topic', - u'line-block (translation required)': 'line-block', - u'parsed-literal (translation required)': 'parsed-literal', - u'mellanrubrik': 'rubric', - u'epigraph (translation required)': 'epigraph', - u'highlights (translation required)': 'highlights', - u'pull-quote (translation required)': 'pull-quote', - u'compound (translation required)': 'compound', - u'container (translation required)': 'container', - # u'fr\u00e5gor': 'questions', - # NOTE: A bit long, but recommended by http://www.nada.kth.se/dataterm/: - # u'fr\u00e5gor-och-svar': 'questions', - # u'vanliga-fr\u00e5gor': 'questions', - u'table (translation required)': 'table', - u'csv-table (translation required)': 'csv-table', - u'list-table (translation required)': 'list-table', - u'meta': 'meta', - # u'bildkarta': 'imagemap', # FIXME: Translation might be too literal. - u'bild': 'image', - u'figur': 'figure', - u'inkludera': 'include', - u'r\u00e5': 'raw', # FIXME: Translation might be too literal. - u'ers\u00e4tt': 'replace', - u'unicode': 'unicode', - u'datum': 'date', - u'class (translation required)': 'class', - u'role (translation required)': 'role', - u'default-role (translation required)': 'default-role', - u'title (translation required)': 'title', - u'inneh\u00e5ll': 'contents', - u'sektionsnumrering': 'sectnum', - u'target-notes (translation required)': 'target-notes', - u'header (translation required)': 'header', - u'footer (translation required)': 'footer', - # u'fotnoter': 'footnotes', - # u'citeringar': 'citations', - } -"""Swedish name to registered (in directives/init.py) directive name -mapping.""" - -roles = { - u'abbreviation (translation required)': 'abbreviation', - u'acronym (translation required)': 'acronym', - u'index (translation required)': 'index', - u'subscript (translation required)': 'subscript', - u'superscript (translation required)': 'superscript', - u'title-reference (translation required)': 'title-reference', - u'pep-reference (translation required)': 'pep-reference', - u'rfc-reference (translation required)': 'rfc-reference', - u'emphasis (translation required)': 'emphasis', - u'strong (translation required)': 'strong', - u'literal (translation required)': 'literal', - u'named-reference (translation required)': 'named-reference', - u'anonymous-reference (translation required)': 'anonymous-reference', - u'footnote-reference (translation required)': 'footnote-reference', - u'citation-reference (translation required)': 'citation-reference', - u'substitution-reference (translation required)': 'substitution-reference', - u'target (translation required)': 'target', - u'uri-reference (translation required)': 'uri-reference', - u'r\u00e5': 'raw',} -"""Mapping of Swedish role names to canonical role names for interpreted text. -""" diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/languages/zh_cn.py --- a/buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/languages/zh_cn.py Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,100 +0,0 @@ -# -- coding: utf-8 -- -# $Id: zh_cn.py 4564 2006-05-21 20:44:42Z wiemann $ -# Author: Panjunyong -# Copyright: This module has been placed in the public domain. - -# New language mappings are welcome. Before doing a new translation, please -# read . Two files must be -# translated for each language: one in docutils/languages, the other in -# docutils/parsers/rst/languages. - -""" -Simplified Chinese language mappings for language-dependent features of -reStructuredText. -""" - -docformat = 'reStructuredText' - - -directives = { - # language-dependent: fixed - u'注意': 'attention', - u'小心': 'caution', - u'危险': 'danger', - u'错误': 'error', - u'提示': 'hint', - u'重要': 'important', - u'注解': 'note', - u'技巧': 'tip', - u'警告': 'warning', - u'忠告': 'admonition', - u'侧框': 'sidebar', - u'主题': 'topic', - u'line-block (translation required)': 'line-block', - u'parsed-literal (translation required)': 'parsed-literal', - u'醒目': 'rubric', - u'铭文': 'epigraph', - u'要点': 'highlights', - u'pull-quote (translation required)': 'pull-quote', - u'复合': 'compound', - u'容器': 'container', - #u'questions (translation required)': 'questions', - u'表格': 'table', - u'csv表格': 'csv-table', - u'列表表格': 'list-table', - #u'qa (translation required)': 'questions', - #u'faq (translation required)': 'questions', - u'元数据': 'meta', - #u'imagemap (translation required)': 'imagemap', - u'图片': 'image', - u'图例': 'figure', - u'包含': 'include', - u'原文': 'raw', - u'代替': 'replace', - u'统一码': 'unicode', - u'日期': 'date', - u'类型': 'class', - u'角色': 'role', - u'默认角色': 'default-role', - u'标题': 'title', - u'目录': 'contents', - u'章节序号': 'sectnum', - u'题头': 'header', - u'页脚': 'footer', - #u'footnotes (translation required)': 'footnotes', - #u'citations (translation required)': 'citations', - u'target-notes (translation required)': 'target-notes', - u'restructuredtext-test-directive': 'restructuredtext-test-directive'} -"""Simplified Chinese name to registered (in directives/init.py) -directive name mapping.""" - -roles = { - # language-dependent: fixed - u'缩写': 'abbreviation', - u'简称': 'acronym', - u'index (translation required)': 'index', - u'i (translation required)': 'index', - u'下标': 'subscript', - u'上标': 'superscript', - u'title-reference (translation required)': 'title-reference', - u'title (translation required)': 'title-reference', - u't (translation required)': 'title-reference', - u'pep-reference (translation required)': 'pep-reference', - u'pep (translation required)': 'pep-reference', - u'rfc-reference (translation required)': 'rfc-reference', - u'rfc (translation required)': 'rfc-reference', - u'强调': 'emphasis', - u'加粗': 'strong', - u'字面': 'literal', - u'named-reference (translation required)': 'named-reference', - u'anonymous-reference (translation required)': 'anonymous-reference', - u'footnote-reference (translation required)': 'footnote-reference', - u'citation-reference (translation required)': 'citation-reference', - u'substitution-reference (translation required)': 'substitution-reference', - u'target (translation required)': 'target', - u'uri-reference (translation required)': 'uri-reference', - u'uri (translation required)': 'uri-reference', - u'url (translation required)': 'uri-reference', - u'raw (translation required)': 'raw',} -"""Mapping of Simplified Chinese role names to canonical role names -for interpreted text.""" diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/languages/zh_tw.py --- a/buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/languages/zh_tw.py Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,105 +0,0 @@ -# -- coding: utf-8 -- -# $Id: zh_tw.py 4564 2006-05-21 20:44:42Z wiemann $ -# Author: David Goodger -# Copyright: This module has been placed in the public domain. - -# New language mappings are welcome. Before doing a new translation, please -# read . Two files must be -# translated for each language: one in docutils/languages, the other in -# docutils/parsers/rst/languages. - -""" -Traditional Chinese language mappings for language-dependent features of -reStructuredText. -""" - -docformat = 'reStructuredText' - - -directives = { - # language-dependent: fixed - 'attention (translation required)': 'attention', - 'caution (translation required)': 'caution', - 'danger (translation required)': 'danger', - 'error (translation required)': 'error', - 'hint (translation required)': 'hint', - 'important (translation required)': 'important', - 'note (translation required)': 'note', - 'tip (translation required)': 'tip', - 'warning (translation required)': 'warning', - 'admonition (translation required)': 'admonition', - 'sidebar (translation required)': 'sidebar', - 'topic (translation required)': 'topic', - 'line-block (translation required)': 'line-block', - 'parsed-literal (translation required)': 'parsed-literal', - 'rubric (translation required)': 'rubric', - 'epigraph (translation required)': 'epigraph', - 'highlights (translation required)': 'highlights', - 'pull-quote (translation required)': 'pull-quote', - 'compound (translation required)': 'compound', - u'container (translation required)': 'container', - #'questions (translation required)': 'questions', - 'table (translation required)': 'table', - 'csv-table (translation required)': 'csv-table', - 'list-table (translation required)': 'list-table', - #'qa (translation required)': 'questions', - #'faq (translation required)': 'questions', - 'meta (translation required)': 'meta', - #'imagemap (translation required)': 'imagemap', - 'image (translation required)': 'image', - 'figure (translation required)': 'figure', - 'include (translation required)': 'include', - 'raw (translation required)': 'raw', - 'replace (translation required)': 'replace', - 'unicode (translation required)': 'unicode', - u'日期': 'date', - 'class (translation required)': 'class', - 'role (translation required)': 'role', - u'default-role (translation required)': 'default-role', - u'title (translation required)': 'title', - 'contents (translation required)': 'contents', - 'sectnum (translation required)': 'sectnum', - 'section-numbering (translation required)': 'sectnum', - u'header (translation required)': 'header', - u'footer (translation required)': 'footer', - #'footnotes (translation required)': 'footnotes', - #'citations (translation required)': 'citations', - 'target-notes (translation required)': 'target-notes', - 'restructuredtext-test-directive': 'restructuredtext-test-directive'} -"""Traditional Chinese name to registered (in directives/init.py) -directive name mapping.""" - -roles = { - # language-dependent: fixed - 'abbreviation (translation required)': 'abbreviation', - 'ab (translation required)': 'abbreviation', - 'acronym (translation required)': 'acronym', - 'ac (translation required)': 'acronym', - 'index (translation required)': 'index', - 'i (translation required)': 'index', - 'subscript (translation required)': 'subscript', - 'sub (translation required)': 'subscript', - 'superscript (translation required)': 'superscript', - 'sup (translation required)': 'superscript', - 'title-reference (translation required)': 'title-reference', - 'title (translation required)': 'title-reference', - 't (translation required)': 'title-reference', - 'pep-reference (translation required)': 'pep-reference', - 'pep (translation required)': 'pep-reference', - 'rfc-reference (translation required)': 'rfc-reference', - 'rfc (translation required)': 'rfc-reference', - 'emphasis (translation required)': 'emphasis', - 'strong (translation required)': 'strong', - 'literal (translation required)': 'literal', - 'named-reference (translation required)': 'named-reference', - 'anonymous-reference (translation required)': 'anonymous-reference', - 'footnote-reference (translation required)': 'footnote-reference', - 'citation-reference (translation required)': 'citation-reference', - 'substitution-reference (translation required)': 'substitution-reference', - 'target (translation required)': 'target', - 'uri-reference (translation required)': 'uri-reference', - 'uri (translation required)': 'uri-reference', - 'url (translation required)': 'uri-reference', - 'raw (translation required)': 'raw',} -"""Mapping of Traditional Chinese role names to canonical role names for -interpreted text.""" diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/roles.py --- a/buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/roles.py Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,346 +0,0 @@ -# $Id: roles.py 4564 2006-05-21 20:44:42Z wiemann $ -# Author: Edward Loper -# Copyright: This module has been placed in the public domain. - -""" -This module defines standard interpreted text role functions, a registry for -interpreted text roles, and an API for adding to and retrieving from the -registry. - -The interface for interpreted role functions is as follows:: - - def role_fn(name, rawtext, text, lineno, inliner, - options={}, content=[]): - code... - - # Set function attributes for customization: - role_fn.options = ... - role_fn.content = ... - -Parameters: - -- ``name`` is the local name of the interpreted text role, the role name - actually used in the document. - -- ``rawtext`` is a string containing the entire interpreted text construct. - Return it as a ``problematic`` node linked to a system message if there is a - problem. - -- ``text`` is the interpreted text content, with backslash escapes converted - to nulls (``\x00``). - -- ``lineno`` is the line number where the interpreted text beings. - -- ``inliner`` is the Inliner object that called the role function. - It defines the following useful attributes: ``reporter``, - ``problematic``, ``memo``, ``parent``, ``document``. - -- ``options``: A dictionary of directive options for customization, to be - interpreted by the role function. Used for additional attributes for the - generated elements and other functionality. - -- ``content``: A list of strings, the directive content for customization - ("role" directive). To be interpreted by the role function. - -Function attributes for customization, interpreted by the "role" directive: - -- ``options``: A dictionary, mapping known option names to conversion - functions such as `int` or `float`. ``None`` or an empty dict implies no - options to parse. Several directive option conversion functions are defined - in the `directives` module. - - All role functions implicitly support the "class" option, unless disabled - with an explicit ``{'class': None}``. - -- ``content``: A boolean; true if content is allowed. Client code must handle - the case where content is required but not supplied (an empty content list - will be supplied). - -Note that unlike directives, the "arguments" function attribute is not -supported for role customization. Directive arguments are handled by the -"role" directive itself. - -Interpreted role functions return a tuple of two values: - -- A list of nodes which will be inserted into the document tree at the - point where the interpreted role was encountered (can be an empty - list). - -- A list of system messages, which will be inserted into the document tree - immediately after the end of the current inline block (can also be empty). -""" - -docformat = 'reStructuredText' - -from docutils import nodes, utils -from docutils.parsers.rst import directives -from docutils.parsers.rst.languages import en as _fallback_language_module - -DEFAULT_INTERPRETED_ROLE = 'title-reference' -""" -The canonical name of the default interpreted role. This role is used -when no role is specified for a piece of interpreted text. -""" - -_role_registry = {} -"""Mapping of canonical role names to role functions. Language-dependent role -names are defined in the ``language`` subpackage.""" - -_roles = {} -"""Mapping of local or language-dependent interpreted text role names to role -functions.""" - -def role(role_name, language_module, lineno, reporter): - """ - Locate and return a role function from its language-dependent name, along - with a list of system messages. If the role is not found in the current - language, check English. Return a 2-tuple: role function (``None`` if the - named role cannot be found) and a list of system messages. - """ - normname = role_name.lower() - messages = [] - msg_text = [] - - if _roles.has_key(normname): - return _roles[normname], messages - - if role_name: - canonicalname = None - try: - canonicalname = language_module.roles[normname] - except AttributeError, error: - msg_text.append('Problem retrieving role entry from language ' - 'module %r: %s.' % (language_module, error)) - except KeyError: - msg_text.append('No role entry for "%s" in module "%s".' - % (role_name, language_module.name)) - else: - canonicalname = DEFAULT_INTERPRETED_ROLE - - # If we didn't find it, try English as a fallback. - if not canonicalname: - try: - canonicalname = _fallback_language_module.roles[normname] - msg_text.append('Using English fallback for role "%s".' - % role_name) - except KeyError: - msg_text.append('Trying "%s" as canonical role name.' - % role_name) - # The canonical name should be an English name, but just in case: - canonicalname = normname - - # Collect any messages that we generated. - if msg_text: - message = reporter.info('\n'.join(msg_text), line=lineno) - messages.append(message) - - # Look the role up in the registry, and return it. - if _role_registry.has_key(canonicalname): - role_fn = _role_registry[canonicalname] - register_local_role(normname, role_fn) - return role_fn, messages - else: - return None, messages # Error message will be generated by caller. - -def register_canonical_role(name, role_fn): - """ - Register an interpreted text role by its canonical name. - - :Parameters: - - `name`: The canonical name of the interpreted role. - - `role_fn`: The role function. See the module docstring. - """ - set_implicit_options(role_fn) - _role_registry[name] = role_fn - -def register_local_role(name, role_fn): - """ - Register an interpreted text role by its local or language-dependent name. - - :Parameters: - - `name`: The local or language-dependent name of the interpreted role. - - `role_fn`: The role function. See the module docstring. - """ - set_implicit_options(role_fn) - _roles[name] = role_fn - -def set_implicit_options(role_fn): - """ - Add customization options to role functions, unless explicitly set or - disabled. - """ - if not hasattr(role_fn, 'options') or role_fn.options is None: - role_fn.options = {'class': directives.class_option} - elif not role_fn.options.has_key('class'): - role_fn.options['class'] = directives.class_option - -def register_generic_role(canonical_name, node_class): - """For roles which simply wrap a given `node_class` around the text.""" - role = GenericRole(canonical_name, node_class) - register_canonical_role(canonical_name, role) - - -class GenericRole: - - """ - Generic interpreted text role, where the interpreted text is simply - wrapped with the provided node class. - """ - - def init(self, role_name, node_class): - self.name = role_name - self.node_class = node_class - - def call(self, role, rawtext, text, lineno, inliner, - options={}, content=[]): - set_classes(options) - return [self.node_class(rawtext, utils.unescape(text), options)], [] - - -class CustomRole: - - """ - Wrapper for custom interpreted text roles. - """ - - def init(self, role_name, base_role, options={}, content=[]): - self.name = role_name - self.base_role = base_role - self.options = None - if hasattr(base_role, 'options'): - self.options = base_role.options - self.content = None - if hasattr(base_role, 'content'): - self.content = base_role.content - self.supplied_options = options - self.supplied_content = content - - def call(self, role, rawtext, text, lineno, inliner, - options={}, content=[]): - opts = self.supplied_options.copy() - opts.update(options) - cont = list(self.supplied_content) - if cont and content: - cont += '\n' - cont.extend(content) - return self.base_role(role, rawtext, text, lineno, inliner, - options=opts, content=cont) - - -def generic_custom_role(role, rawtext, text, lineno, inliner, - options={}, content=[]): - """""" - # Once nested inline markup is implemented, this and other methods should - # recursively call inliner.nested_parse(). - set_classes(options) - return [nodes.inline(rawtext, utils.unescape(text), options)], [] - -generic_custom_role.options = {'class': directives.class_option} - - -###################################################################### -# Define and register the standard roles: -###################################################################### - -register_generic_role('abbreviation', nodes.abbreviation) -register_generic_role('acronym', nodes.acronym) -register_generic_role('emphasis', nodes.emphasis) -register_generic_role('literal', nodes.literal) -register_generic_role('strong', nodes.strong) -register_generic_role('subscript', nodes.subscript) -register_generic_role('superscript', nodes.superscript) -register_generic_role('title-reference', nodes.title_reference) - -def pep_reference_role(role, rawtext, text, lineno, inliner, - options={}, content=[]): - try: - pepnum = int(text) - if pepnum < 0 or pepnum > 9999: - raise ValueError - except ValueError: - msg = inliner.reporter.error( - 'PEP number must be a number from 0 to 9999; "%s" is invalid.' - % text, line=lineno) - prb = inliner.problematic(rawtext, rawtext, msg) - return [prb], [msg] - # Base URL mainly used by inliner.pep_reference; so this is correct: - ref = (inliner.document.settings.pep_base_url - + inliner.document.settings.pep_file_url_template % pepnum) - set_classes(options) - return [nodes.reference(rawtext, 'PEP ' + utils.unescape(text), refuri=ref, - options)], [] - -register_canonical_role('pep-reference', pep_reference_role) - -def rfc_reference_role(role, rawtext, text, lineno, inliner, - options={}, content=[]): - try: - rfcnum = int(text) - if rfcnum <= 0: - raise ValueError - except ValueError: - msg = inliner.reporter.error( - 'RFC number must be a number greater than or equal to 1; ' - '"%s" is invalid.' % text, line=lineno) - prb = inliner.problematic(rawtext, rawtext, msg) - return [prb], [msg] - # Base URL mainly used by inliner.rfc_reference, so this is correct: - ref = inliner.document.settings.rfc_base_url + inliner.rfc_url % rfcnum - set_classes(options) - node = nodes.reference(rawtext, 'RFC ' + utils.unescape(text), refuri=ref, - options) - return [node], [] - -register_canonical_role('rfc-reference', rfc_reference_role) - -def raw_role(role, rawtext, text, lineno, inliner, options={}, content=[]): - if not options.has_key('format'): - msg = inliner.reporter.error( - 'No format (Writer name) is associated with this role: "%s".\n' - 'The "raw" role cannot be used directly.\n' - 'Instead, use the "role" directive to create a new role with ' - 'an associated format.' % role, line=lineno) - prb = inliner.problematic(rawtext, rawtext, msg) - return [prb], [msg] - set_classes(options) - node = nodes.raw(rawtext, utils.unescape(text, 1), options) - return [node], [] - -raw_role.options = {'format': directives.unchanged} - -register_canonical_role('raw', raw_role) - - -###################################################################### -# Register roles that are currently unimplemented. -###################################################################### - -def unimplemented_role(role, rawtext, text, lineno, inliner, attributes={}): - msg = inliner.reporter.error( - 'Interpreted text role "%s" not implemented.' % role, line=lineno) - prb = inliner.problematic(rawtext, rawtext, msg) - return [prb], [msg] - -register_canonical_role('index', unimplemented_role) -register_canonical_role('named-reference', unimplemented_role) -register_canonical_role('anonymous-reference', unimplemented_role) -register_canonical_role('uri-reference', unimplemented_role) -register_canonical_role('footnote-reference', unimplemented_role) -register_canonical_role('citation-reference', unimplemented_role) -register_canonical_role('substitution-reference', unimplemented_role) -register_canonical_role('target', unimplemented_role) - -# This should remain unimplemented, for testing purposes: -register_canonical_role('restructuredtext-unimplemented-role', - unimplemented_role) - - -def set_classes(options): - """ - Auxiliary function to set options['classes'] and delete - options['class']. - """ - if options.has_key('class'): - assert not options.has_key('classes') - options['classes'] = options['class'] - del options['class'] diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/states.py --- a/buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/states.py Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,2988 +0,0 @@ -# $Id: states.py 4824 2006-12-09 00:59:23Z goodger $ -# Author: David Goodger -# Copyright: This module has been placed in the public domain. - -""" -This is the ``docutils.parsers.restructuredtext.states`` module, the core of -the reStructuredText parser. It defines the following: - -:Classes: - - `RSTStateMachine`: reStructuredText parser's entry point. - - `NestedStateMachine`: recursive StateMachine. - - `RSTState`: reStructuredText State superclass. - - `Inliner`: For parsing inline markup. - - `Body`: Generic classifier of the first line of a block. - - `SpecializedBody`: Superclass for compound element members. - - `BulletList`: Second and subsequent bullet_list list_items - - `DefinitionList`: Second+ definition_list_items. - - `EnumeratedList`: Second+ enumerated_list list_items. - - `FieldList`: Second+ fields. - - `OptionList`: Second+ option_list_items. - - `RFC2822List`: Second+ RFC2822-style fields. - - `ExtensionOptions`: Parses directive option fields. - - `Explicit`: Second+ explicit markup constructs. - - `SubstitutionDef`: For embedded directives in substitution definitions. - - `Text`: Classifier of second line of a text block. - - `SpecializedText`: Superclass for continuation lines of Text-variants. - - `Definition`: Second line of potential definition_list_item. - - `Line`: Second line of overlined section title or transition marker. - - `Struct`: An auxiliary collection class. - -:Exception classes: - - `MarkupError` - - `ParserError` - - `MarkupMismatch` - -:Functions: - - `escape2null()`: Return a string, escape-backslashes converted to nulls. - - `unescape()`: Return a string, nulls removed or restored to backslashes. - -:Attributes: - - `state_classes`: set of State classes used with `RSTStateMachine`. - -Parser Overview -=============== - -The reStructuredText parser is implemented as a recursive state machine, -examining its input one line at a time. To understand how the parser works, -please first become familiar with the `docutils.statemachine` module. In the -description below, references are made to classes defined in this module; -please see the individual classes for details. - -Parsing proceeds as follows: - -1. The state machine examines each line of input, checking each of the - transition patterns of the state `Body`, in order, looking for a match. - The implicit transitions (blank lines and indentation) are checked before - any others. The 'text' transition is a catch-all (matches anything). - -2. The method associated with the matched transition pattern is called. - - A. Some transition methods are self-contained, appending elements to the - document tree (`Body.doctest` parses a doctest block). The parser's - current line index is advanced to the end of the element, and parsing - continues with step 1. - - B. Other transition methods trigger the creation of a nested state machine, - whose job is to parse a compound construct ('indent' does a block quote, - 'bullet' does a bullet list, 'overline' does a section [first checking - for a valid section header], etc.). - - - In the case of lists and explicit markup, a one-off state machine is - created and run to parse contents of the first item. - - - A new state machine is created and its initial state is set to the - appropriate specialized state (`BulletList` in the case of the - 'bullet' transition; see `SpecializedBody` for more detail). This - state machine is run to parse the compound element (or series of - explicit markup elements), and returns as soon as a non-member element - is encountered. For example, the `BulletList` state machine ends as - soon as it encounters an element which is not a list item of that - bullet list. The optional omission of inter-element blank lines is - enabled by this nested state machine. - - - The current line index is advanced to the end of the elements parsed, - and parsing continues with step 1. - - C. The result of the 'text' transition depends on the next line of text. - The current state is changed to `Text`, under which the second line is - examined. If the second line is: - - - Indented: The element is a definition list item, and parsing proceeds - similarly to step 2.B, using the `DefinitionList` state. - - - A line of uniform punctuation characters: The element is a section - header; again, parsing proceeds as in step 2.B, and `Body` is still - used. - - - Anything else: The element is a paragraph, which is examined for - inline markup and appended to the parent element. Processing - continues with step 1. -""" - -docformat = 'reStructuredText' - - -import sys -import re -import roman -from types import TupleType, FunctionType, MethodType -from docutils import nodes, statemachine, utils, urischemes -from docutils import ApplicationError, DataError -from docutils.statemachine import StateMachineWS, StateWS -from docutils.nodes import fully_normalize_name as normalize_name -from docutils.nodes import whitespace_normalize_name -from docutils.utils import escape2null, unescape, column_width -import docutils.parsers.rst -from docutils.parsers.rst import directives, languages, tableparser, roles -from docutils.parsers.rst.languages import en as _fallback_language_module - - -class MarkupError(DataError): pass -class UnknownInterpretedRoleError(DataError): pass -class InterpretedRoleNotImplementedError(DataError): pass -class ParserError(ApplicationError): pass -class MarkupMismatch(Exception): pass - - -class Struct: - - """Stores data attributes for dotted-attribute access.""" - - def init(self, keywordargs): - self.dict.update(keywordargs) - - -class RSTStateMachine(StateMachineWS): - - """ - reStructuredText's master StateMachine. - - The entry point to reStructuredText parsing is the `run()` method. - """ - - def run(self, input_lines, document, input_offset=0, match_titles=1, - inliner=None): - """ - Parse `input_lines` and modify the `document` node in place. - - Extend `StateMachineWS.run()`: set up parse-global data and - run the StateMachine. - """ - self.language = languages.get_language( - document.settings.language_code) - self.match_titles = match_titles - if inliner is None: - inliner = Inliner() - inliner.init_customizations(document.settings) - self.memo = Struct(document=document, - reporter=document.reporter, - language=self.language, - title_styles=[], - section_level=0, - section_bubble_up_kludge=0, - inliner=inliner) - self.document = document - self.attach_observer(document.note_source) - self.reporter = self.memo.reporter - self.node = document - results = StateMachineWS.run(self, input_lines, input_offset, - input_source=document['source']) - assert results == [], 'RSTStateMachine.run() results should be empty!' - self.node = self.memo = None # remove unneeded references - - -class NestedStateMachine(StateMachineWS): - - """ - StateMachine run from within other StateMachine runs, to parse nested - document structures. - """ - - def run(self, input_lines, input_offset, memo, node, match_titles=1): - """ - Parse `input_lines` and populate a `docutils.nodes.document` instance. - - Extend `StateMachineWS.run()`: set up document-wide data. - """ - self.match_titles = match_titles - self.memo = memo - self.document = memo.document - self.attach_observer(self.document.note_source) - self.reporter = memo.reporter - self.language = memo.language - self.node = node - results = StateMachineWS.run(self, input_lines, input_offset) - assert results == [], ('NestedStateMachine.run() results should be ' - 'empty!') - return results - - -class RSTState(StateWS): - - """ - reStructuredText State superclass. - - Contains methods used by all State subclasses. - """ - - nested_sm = NestedStateMachine - - def init(self, state_machine, debug=0): - self.nested_sm_kwargs = {'state_classes': state_classes, - 'initial_state': 'Body'} - StateWS.init(self, state_machine, debug) - - def runtime_init(self): - StateWS.runtime_init(self) - memo = self.state_machine.memo - self.memo = memo - self.reporter = memo.reporter - self.inliner = memo.inliner - self.document = memo.document - self.parent = self.state_machine.node - - def goto_line(self, abs_line_offset): - """ - Jump to input line `abs_line_offset`, ignoring jumps past the end. - """ - try: - self.state_machine.goto_line(abs_line_offset) - except EOFError: - pass - - def no_match(self, context, transitions): - """ - Override `StateWS.no_match` to generate a system message. - - This code should never be run. - """ - self.reporter.severe( - 'Internal error: no transition pattern match. State: "%s"; ' - 'transitions: %s; context: %s; current line: %r.' - % (self.class.name, transitions, context, - self.state_machine.line), - line=self.state_machine.abs_line_number()) - return context, None, [] - - def bof(self, context): - """Called at beginning of file.""" - return [], [] - - def nested_parse(self, block, input_offset, node, match_titles=0, - state_machine_class=None, state_machine_kwargs=None): - """ - Create a new StateMachine rooted at `node` and run it over the input - `block`. - """ - if state_machine_class is None: - state_machine_class = self.nested_sm - if state_machine_kwargs is None: - state_machine_kwargs = self.nested_sm_kwargs - block_length = len(block) - state_machine = state_machine_class(debug=self.debug, - state_machine_kwargs) - state_machine.run(block, input_offset, memo=self.memo, - node=node, match_titles=match_titles) - state_machine.unlink() - new_offset = state_machine.abs_line_offset() - # No `block.parent` implies disconnected -- lines aren't in sync: - if block.parent and (len(block) - block_length) != 0: - # Adjustment for block if modified in nested parse: - self.state_machine.next_line(len(block) - block_length) - return new_offset - - def nested_list_parse(self, block, input_offset, node, initial_state, - blank_finish, - blank_finish_state=None, - extra_settings={}, - match_titles=0, - state_machine_class=None, - state_machine_kwargs=None): - """ - Create a new StateMachine rooted at `node` and run it over the input - `block`. Also keep track of optional intermediate blank lines and the - required final one. - """ - if state_machine_class is None: - state_machine_class = self.nested_sm - if state_machine_kwargs is None: - state_machine_kwargs = self.nested_sm_kwargs.copy() - state_machine_kwargs['initial_state'] = initial_state - state_machine = state_machine_class(debug=self.debug, - state_machine_kwargs) - if blank_finish_state is None: - blank_finish_state = initial_state - state_machine.states[blank_finish_state].blank_finish = blank_finish - for key, value in extra_settings.items(): - setattr(state_machine.states[initial_state], key, value) - state_machine.run(block, input_offset, memo=self.memo, - node=node, match_titles=match_titles) - blank_finish = state_machine.states[blank_finish_state].blank_finish - state_machine.unlink() - return state_machine.abs_line_offset(), blank_finish - - def section(self, title, source, style, lineno, messages): - """Check for a valid subsection and create one if it checks out.""" - if self.check_subsection(source, style, lineno): - self.new_subsection(title, lineno, messages) - - def check_subsection(self, source, style, lineno): - """ - Check for a valid subsection header. Return 1 (true) or None (false). - - When a new section is reached that isn't a subsection of the current - section, back up the line count (use ``previous_line(-x)``), then - ``raise EOFError``. The current StateMachine will finish, then the - calling StateMachine can re-examine the title. This will work its way - back up the calling chain until the correct section level isreached. - - @@@ Alternative: Evaluate the title, store the title info & level, and - back up the chain until that level is reached. Store in memo? Or - return in results? - - :Exception: `EOFError` when a sibling or supersection encountered. - """ - memo = self.memo - title_styles = memo.title_styles - mylevel = memo.section_level - try: # check for existing title style - level = title_styles.index(style) + 1 - except ValueError: # new title style - if len(title_styles) == memo.section_level: # new subsection - title_styles.append(style) - return 1 - else: # not at lowest level - self.parent += self.title_inconsistent(source, lineno) - return None - if level <= mylevel: # sibling or supersection - memo.section_level = level # bubble up to parent section - if len(style) == 2: - memo.section_bubble_up_kludge = 1 - # back up 2 lines for underline title, 3 for overline title - self.state_machine.previous_line(len(style) + 1) - raise EOFError # let parent section re-evaluate - if level == mylevel + 1: # immediate subsection - return 1 - else: # invalid subsection - self.parent += self.title_inconsistent(source, lineno) - return None - - def title_inconsistent(self, sourcetext, lineno): - error = self.reporter.severe( - 'Title level inconsistent:', nodes.literal_block('', sourcetext), - line=lineno) - return error - - def new_subsection(self, title, lineno, messages): - """Append new subsection to document tree. On return, check level.""" - memo = self.memo - mylevel = memo.section_level - memo.section_level += 1 - section_node = nodes.section() - self.parent += section_node - textnodes, title_messages = self.inline_text(title, lineno) - titlenode = nodes.title(title, '', textnodes) - name = normalize_name(titlenode.astext()) - section_node['names'].append(name) - section_node += titlenode - section_node += messages - section_node += title_messages - self.document.note_implicit_target(section_node, section_node) - offset = self.state_machine.line_offset + 1 - absoffset = self.state_machine.abs_line_offset() + 1 - newabsoffset = self.nested_parse( - self.state_machine.input_lines[offset:], input_offset=absoffset, - node=section_node, match_titles=1) - self.goto_line(newabsoffset) - if memo.section_level <= mylevel: # can't handle next section? - raise EOFError # bubble up to supersection - # reset section_level; next pass will detect it properly - memo.section_level = mylevel - - def paragraph(self, lines, lineno): - """ - Return a list (paragraph & messages) & a boolean: literal_block next? - """ - data = '\n'.join(lines).rstrip() - if re.search(r'(?%(or_group)s)%(suffix)s' % locals() - if compile: - return re.compile(regexp, re.UNICODE) - else: - return regexp - - -class Inliner: - - """ - Parse inline markup; call the `parse()` method. - """ - - def init(self): - self.implicit_dispatch = [(self.patterns.uri, self.standalone_uri),] - """List of (pattern, bound method) tuples, used by - `self.implicit_inline`.""" - - def init_customizations(self, settings): - """Setting-based customizations; run when parsing begins.""" - if settings.pep_references: - self.implicit_dispatch.append((self.patterns.pep, - self.pep_reference)) - if settings.rfc_references: - self.implicit_dispatch.append((self.patterns.rfc, - self.rfc_reference)) - - def parse(self, text, lineno, memo, parent): - # Needs to be refactored for nested inline markup. - # Add nested_parse() method? - """ - Return 2 lists: nodes (text and inline elements), and system_messages. - - Using `self.patterns.initial`, a pattern which matches start-strings - (emphasis, strong, interpreted, phrase reference, literal, - substitution reference, and inline target) and complete constructs - (simple reference, footnote reference), search for a candidate. When - one is found, check for validity (e.g., not a quoted '' character). - If valid, search for the corresponding end string if applicable, and - check it for validity. If not found or invalid, generate a warning - and ignore the start-string. Implicit inline markup (e.g. standalone - URIs) is found last. - """ - self.reporter = memo.reporter - self.document = memo.document - self.language = memo.language - self.parent = parent - pattern_search = self.patterns.initial.search - dispatch = self.dispatch - remaining = escape2null(text) - processed = [] - unprocessed = [] - messages = [] - while remaining: - match = pattern_search(remaining) - if match: - groups = match.groupdict() - method = dispatch[groups['start'] or groups['backquote'] - or groups['refend'] or groups['fnend']] - before, inlines, remaining, sysmessages = method(self, match, - lineno) - unprocessed.append(before) - messages += sysmessages - if inlines: - processed += self.implicit_inline(''.join(unprocessed), - lineno) - processed += inlines - unprocessed = [] - else: - break - remaining = ''.join(unprocessed) + remaining - if remaining: - processed += self.implicit_inline(remaining, lineno) - return processed, messages - - openers = '\'"([{<' - closers = '\'")]}>' - start_string_prefix = (r'((?<=^)|(?<=[-/: \n%s]))' % re.escape(openers)) - end_string_suffix = (r'((?=$)|(?=[-/:.,;!? \n\x00%s]))' - % re.escape(closers)) - non_whitespace_before = r'(?]""" - # Last URI character; same as uric but no punctuation: - urilast = r"""[_~/=+a-zA-Z0-9]""" - # End of a URI (either 'urilast' or 'uric followed by a - # uri_end_delim'): - uri_end = r"""(?:%(urilast)s|%(uric)s(?=%(uri_end_delim)s))""" % locals() - emailc = r"""[-_!~'{|}/#?^`&=+$%a-zA-Z0-9\x00]""" - email_pattern = r""" - %(emailc)s+(?:\.%(emailc)s+)* # name - (?%s)(?P__?)' % simplename, - ('footnotelabel', r'\[', r'(?P\]_)', - [r'[0-9]+', # manually numbered - r'\#(%s)?' % simplename, # auto-numbered (w/ label?) - r'\', # auto-symbol - r'(?P%s)' % simplename] # citation reference - ) - ] - ), - ('backquote', # interpreted text or phrase reference - '(?P(:%s:)?)' % simplename, # optional role - non_whitespace_after, - ['`(?!`)'] # but not literal - ) - ] - ) - patterns = Struct( - initial=build_regexp(parts), - emphasis=re.compile(non_whitespace_escape_before - + r'(\)' + end_string_suffix), - strong=re.compile(non_whitespace_escape_before - + r'(\\)' + end_string_suffix), - interpreted_or_phrase_ref=re.compile( - r""" - %(non_whitespace_escape_before)s - ( - ` - (?P - (?P:%(simplename)s:)? - (?P__?)? - ) - ) - %(end_string_suffix)s - """ % locals(), re.VERBOSE | re.UNICODE), - embedded_uri=re.compile( - r""" - ( - (?:[ \n]+|^) # spaces or beginning of line/string - < # open bracket - %(non_whitespace_after)s - ([^<>\x00]+) # anything but angle brackets & nulls - %(non_whitespace_before)s - > # close bracket w/o whitespace before - ) - $ # end of string - """ % locals(), re.VERBOSE), - literal=re.compile(non_whitespace_before + '(``)' - + end_string_suffix), - target=re.compile(non_whitespace_escape_before - + r'(`)' + end_string_suffix), - substitution_ref=re.compile(non_whitespace_escape_before - + r'(\|_{0,2})' - + end_string_suffix), - email=re.compile(email_pattern % locals() + '$', re.VERBOSE), - uri=re.compile( - (r""" - %(start_string_prefix)s - (?P - (?P # absolute URI - (?P # scheme (http, ftp, mailto) - [a-zA-Z][a-zA-Z0-9.+-]* - ) - : - ( - ( # either: - (//?)? # hierarchical URI - %(uric)s* # URI characters - %(uri_end)s # final URI char - ) - ( # optional query - \?%(uric)s* - %(uri_end)s - )? - ( # optional fragment - \#%(uric)s* - %(uri_end)s - )? - ) - ) - | # OR - (?P # email address - """ + email_pattern + r""" - ) - ) - %(end_string_suffix)s - """) % locals(), re.VERBOSE), - pep=re.compile( - r""" - %(start_string_prefix)s - ( - (pep-(?P\d+)(.txt)?) # reference to source file - | - (PEP\s+(?P\d+)) # reference by name - ) - %(end_string_suffix)s""" % locals(), re.VERBOSE), - rfc=re.compile( - r""" - %(start_string_prefix)s - (RFC(-|\s+)?(?P\d+)) - %(end_string_suffix)s""" % locals(), re.VERBOSE)) - - def quoted_start(self, match): - """Return 1 if inline markup start-string is 'quoted', 0 if not.""" - string = match.string - start = match.start() - end = match.end() - if start == 0: # start-string at beginning of text - return 0 - prestart = string[start - 1] - try: - poststart = string[end] - if self.openers.index(prestart) \ - == self.closers.index(poststart): # quoted - return 1 - except IndexError: # start-string at end of text - return 1 - except ValueError: # not quoted - pass - return 0 - - def inline_obj(self, match, lineno, end_pattern, nodeclass, - restore_backslashes=0): - string = match.string - matchstart = match.start('start') - matchend = match.end('start') - if self.quoted_start(match): - return (string[:matchend], [], string[matchend:], [], '') - endmatch = end_pattern.search(string[matchend:]) - if endmatch and endmatch.start(1): # 1 or more chars - text = unescape(endmatch.string[:endmatch.start(1)], - restore_backslashes) - textend = matchend + endmatch.end(1) - rawsource = unescape(string[matchstart:textend], 1) - return (string[:matchstart], [nodeclass(rawsource, text)], - string[textend:], [], endmatch.group(1)) - msg = self.reporter.warning( - 'Inline %s start-string without end-string.' - % nodeclass.name, line=lineno) - text = unescape(string[matchstart:matchend], 1) - rawsource = unescape(string[matchstart:matchend], 1) - prb = self.problematic(text, rawsource, msg) - return string[:matchstart], [prb], string[matchend:], [msg], '' - - def problematic(self, text, rawsource, message): - msgid = self.document.set_id(message, self.parent) - problematic = nodes.problematic(rawsource, text, refid=msgid) - prbid = self.document.set_id(problematic) - message.add_backref(prbid) - return problematic - - def emphasis(self, match, lineno): - before, inlines, remaining, sysmessages, endstring = self.inline_obj( - match, lineno, self.patterns.emphasis, nodes.emphasis) - return before, inlines, remaining, sysmessages - - def strong(self, match, lineno): - before, inlines, remaining, sysmessages, endstring = self.inline_obj( - match, lineno, self.patterns.strong, nodes.strong) - return before, inlines, remaining, sysmessages - - def interpreted_or_phrase_ref(self, match, lineno): - end_pattern = self.patterns.interpreted_or_phrase_ref - string = match.string - matchstart = match.start('backquote') - matchend = match.end('backquote') - rolestart = match.start('role') - role = match.group('role') - position = '' - if role: - role = role[1:-1] - position = 'prefix' - elif self.quoted_start(match): - return (string[:matchend], [], string[matchend:], []) - endmatch = end_pattern.search(string[matchend:]) - if endmatch and endmatch.start(1): # 1 or more chars - textend = matchend + endmatch.end() - if endmatch.group('role'): - if role: - msg = self.reporter.warning( - 'Multiple roles in interpreted text (both ' - 'prefix and suffix present; only one allowed).', - line=lineno) - text = unescape(string[rolestart:textend], 1) - prb = self.problematic(text, text, msg) - return string[:rolestart], [prb], string[textend:], [msg] - role = endmatch.group('suffix')[1:-1] - position = 'suffix' - escaped = endmatch.string[:endmatch.start(1)] - rawsource = unescape(string[matchstart:textend], 1) - if rawsource[-1:] == '_': - if role: - msg = self.reporter.warning( - 'Mismatch: both interpreted text role %s and ' - 'reference suffix.' % position, line=lineno) - text = unescape(string[rolestart:textend], 1) - prb = self.problematic(text, text, msg) - return string[:rolestart], [prb], string[textend:], [msg] - return self.phrase_ref(string[:matchstart], string[textend:], - rawsource, escaped, unescape(escaped)) - else: - rawsource = unescape(string[rolestart:textend], 1) - nodelist, messages = self.interpreted(rawsource, escaped, role, - lineno) - return (string[:rolestart], nodelist, - string[textend:], messages) - msg = self.reporter.warning( - 'Inline interpreted text or phrase reference start-string ' - 'without end-string.', line=lineno) - text = unescape(string[matchstart:matchend], 1) - prb = self.problematic(text, text, msg) - return string[:matchstart], [prb], string[matchend:], [msg] - - def phrase_ref(self, before, after, rawsource, escaped, text): - match = self.patterns.embedded_uri.search(escaped) - if match: - text = unescape(escaped[:match.start(0)]) - uri_text = match.group(2) - uri = ''.join(uri_text.split()) - uri = self.adjust_uri(uri) - if uri: - target = nodes.target(match.group(1), refuri=uri) - else: - raise ApplicationError('problem with URI: %r' % uri_text) - if not text: - text = uri - else: - target = None - refname = normalize_name(text) - reference = nodes.reference(rawsource, text, - name=whitespace_normalize_name(text)) - node_list = [reference] - if rawsource[-2:] == '__': - if target: - reference['refuri'] = uri - else: - reference['anonymous'] = 1 - else: - if target: - reference['refuri'] = uri - target['names'].append(refname) - self.document.note_explicit_target(target, self.parent) - node_list.append(target) - else: - reference['refname'] = refname - self.document.note_refname(reference) - return before, node_list, after, [] - - def adjust_uri(self, uri): - match = self.patterns.email.match(uri) - if match: - return 'mailto:' + uri - else: - return uri - - def interpreted(self, rawsource, text, role, lineno): - role_fn, messages = roles.role(role, self.language, lineno, - self.reporter) - if role_fn: - nodes, messages2 = role_fn(role, rawsource, text, lineno, self) - return nodes, messages + messages2 - else: - msg = self.reporter.error( - 'Unknown interpreted text role "%s".' % role, - line=lineno) - return ([self.problematic(rawsource, rawsource, msg)], - messages + [msg]) - - def literal(self, match, lineno): - before, inlines, remaining, sysmessages, endstring = self.inline_obj( - match, lineno, self.patterns.literal, nodes.literal, - restore_backslashes=1) - return before, inlines, remaining, sysmessages - - def inline_internal_target(self, match, lineno): - before, inlines, remaining, sysmessages, endstring = self.inline_obj( - match, lineno, self.patterns.target, nodes.target) - if inlines and isinstance(inlines[0], nodes.target): - assert len(inlines) == 1 - target = inlines[0] - name = normalize_name(target.astext()) - target['names'].append(name) - self.document.note_explicit_target(target, self.parent) - return before, inlines, remaining, sysmessages - - def substitution_reference(self, match, lineno): - before, inlines, remaining, sysmessages, endstring = self.inline_obj( - match, lineno, self.patterns.substitution_ref, - nodes.substitution_reference) - if len(inlines) == 1: - subref_node = inlines[0] - if isinstance(subref_node, nodes.substitution_reference): - subref_text = subref_node.astext() - self.document.note_substitution_ref(subref_node, subref_text) - if endstring[-1:] == '_': - reference_node = nodes.reference( - '|%s%s' % (subref_text, endstring), '') - if endstring[-2:] == '__': - reference_node['anonymous'] = 1 - else: - reference_node['refname'] = normalize_name(subref_text) - self.document.note_refname(reference_node) - reference_node += subref_node - inlines = [reference_node] - return before, inlines, remaining, sysmessages - - def footnote_reference(self, match, lineno): - """ - Handles `nodes.footnote_reference` and `nodes.citation_reference` - elements. - """ - label = match.group('footnotelabel') - refname = normalize_name(label) - string = match.string - before = string[:match.start('whole')] - remaining = string[match.end('whole'):] - if match.group('citationlabel'): - refnode = nodes.citation_reference('[%s]_' % label, - refname=refname) - refnode += nodes.Text(label) - self.document.note_citation_ref(refnode) - else: - refnode = nodes.footnote_reference('[%s]_' % label) - if refname[0] == '#': - refname = refname[1:] - refnode['auto'] = 1 - self.document.note_autofootnote_ref(refnode) - elif refname == '': - refname = '' - refnode['auto'] = '' - self.document.note_symbol_footnote_ref( - refnode) - else: - refnode += nodes.Text(label) - if refname: - refnode['refname'] = refname - self.document.note_footnote_ref(refnode) - if utils.get_trim_footnote_ref_space(self.document.settings): - before = before.rstrip() - return (before, [refnode], remaining, []) - - def reference(self, match, lineno, anonymous=None): - referencename = match.group('refname') - refname = normalize_name(referencename) - referencenode = nodes.reference( - referencename + match.group('refend'), referencename, - name=whitespace_normalize_name(referencename)) - if anonymous: - referencenode['anonymous'] = 1 - else: - referencenode['refname'] = refname - self.document.note_refname(referencenode) - string = match.string - matchstart = match.start('whole') - matchend = match.end('whole') - return (string[:matchstart], [referencenode], string[matchend:], []) - - def anonymous_reference(self, match, lineno): - return self.reference(match, lineno, anonymous=1) - - def standalone_uri(self, match, lineno): - if not match.group('scheme') or urischemes.schemes.has_key( - match.group('scheme').lower()): - if match.group('email'): - addscheme = 'mailto:' - else: - addscheme = '' - text = match.group('whole') - unescaped = unescape(text, 0) - return [nodes.reference(unescape(text, 1), unescaped, - refuri=addscheme + unescaped)] - else: # not a valid scheme - raise MarkupMismatch - - def pep_reference(self, match, lineno): - text = match.group(0) - if text.startswith('pep-'): - pepnum = int(match.group('pepnum1')) - elif text.startswith('PEP'): - pepnum = int(match.group('pepnum2')) - else: - raise MarkupMismatch - ref = (self.document.settings.pep_base_url - + self.document.settings.pep_file_url_template % pepnum) - unescaped = unescape(text, 0) - return [nodes.reference(unescape(text, 1), unescaped, refuri=ref)] - - rfc_url = 'rfc%d.html' - - def rfc_reference(self, match, lineno): - text = match.group(0) - if text.startswith('RFC'): - rfcnum = int(match.group('rfcnum')) - ref = self.document.settings.rfc_base_url + self.rfc_url % rfcnum - else: - raise MarkupMismatch - unescaped = unescape(text, 0) - return [nodes.reference(unescape(text, 1), unescaped, refuri=ref)] - - def implicit_inline(self, text, lineno): - """ - Check each of the patterns in `self.implicit_dispatch` for a match, - and dispatch to the stored method for the pattern. Recursively check - the text before and after the match. Return a list of `nodes.Text` - and inline element nodes. - """ - if not text: - return [] - for pattern, method in self.implicit_dispatch: - match = pattern.search(text) - if match: - try: - # Must recurse on strings before and after the match; - # there may be multiple patterns. - return (self.implicit_inline(text[:match.start()], lineno) - + method(match, lineno) + - self.implicit_inline(text[match.end():], lineno)) - except MarkupMismatch: - pass - return [nodes.Text(unescape(text), rawsource=unescape(text, 1))] - - dispatch = {'*': emphasis, - '**': strong, - '`': interpreted_or_phrase_ref, - '``': literal, - '_`': inline_internal_target, - ']_': footnote_reference, - '|': substitution_reference, - '_': reference, - '__': anonymous_reference} - - -def _loweralpha_to_int(s, _zero=(ord('a')-1)): - return ord(s) - _zero - -def _upperalpha_to_int(s, _zero=(ord('A')-1)): - return ord(s) - _zero - -def _lowerroman_to_int(s): - return roman.fromRoman(s.upper()) - - -class Body(RSTState): - - """ - Generic classifier of the first line of a block. - """ - - double_width_pad_char = tableparser.TableParser.double_width_pad_char - """Padding character for East Asian double-width text.""" - - enum = Struct() - """Enumerated list parsing information.""" - - enum.formatinfo = { - 'parens': Struct(prefix='(', suffix=')', start=1, end=-1), - 'rparen': Struct(prefix='', suffix=')', start=0, end=-1), - 'period': Struct(prefix='', suffix='.', start=0, end=-1)} - enum.formats = enum.formatinfo.keys() - enum.sequences = ['arabic', 'loweralpha', 'upperalpha', - 'lowerroman', 'upperroman'] # ORDERED! - enum.sequencepats = {'arabic': '[0-9]+', - 'loweralpha': '[a-z]', - 'upperalpha': '[A-Z]', - 'lowerroman': '[ivxlcdm]+', - 'upperroman': '[IVXLCDM]+',} - enum.converters = {'arabic': int, - 'loweralpha': _loweralpha_to_int, - 'upperalpha': _upperalpha_to_int, - 'lowerroman': _lowerroman_to_int, - 'upperroman': roman.fromRoman} - - enum.sequenceregexps = {} - for sequence in enum.sequences: - enum.sequenceregexps[sequence] = re.compile( - enum.sequencepats[sequence] + '$') - - grid_table_top_pat = re.compile(r'\+-[-+]+-\+ $') - """Matches the top (& bottom) of a full table).""" - - simple_table_top_pat = re.compile('=+( +=+)+ $') - """Matches the top of a simple table.""" - - simple_table_border_pat = re.compile('=+[ =]$') - """Matches the bottom & header bottom of a simple table.""" - - pats = {} - """Fragments of patterns used by transitions.""" - - pats['nonalphanum7bit'] = '[!-/:-@[-`{-~]' - pats['alpha'] = '[a-zA-Z]' - pats['alphanum'] = '[a-zA-Z0-9]' - pats['alphanumplus'] = '[a-zA-Z0-9_-]' - pats['enum'] = ('(%(arabic)s|%(loweralpha)s|%(upperalpha)s|%(lowerroman)s' - '|%(upperroman)s|#)' % enum.sequencepats) - pats['optname'] = '%(alphanum)s%(alphanumplus)s' % pats - # @@@ Loosen up the pattern? Allow Unicode? - pats['optarg'] = '(%(alpha)s%(alphanumplus)s|<[^<>]+>)' % pats - pats['shortopt'] = r'(-|\+)%(alphanum)s( ?%(optarg)s)?' % pats - pats['longopt'] = r'(--|/)%(optname)s([ =]%(optarg)s)?' % pats - pats['option'] = r'(%(shortopt)s|%(longopt)s)' % pats - - for format in enum.formats: - pats[format] = '(?P<%s>%s%s%s)' % ( - format, re.escape(enum.formatinfo[format].prefix), - pats['enum'], re.escape(enum.formatinfo[format].suffix)) - - patterns = { - 'bullet': ur'[-+\u2022\u2023\u2043]( +|$)', - 'enumerator': r'(%(parens)s|%(rparen)s|%(period)s)( +|$)' % pats, - 'field_marker': r':(?![: ])([^:\\]|\\.)(?>>( +|$)', - 'line_block': r'\|( +|$)', - 'grid_table_top': grid_table_top_pat, - 'simple_table_top': simple_table_top_pat, - 'explicit_markup': r'\.\.( +|$)', - 'anonymous': r'__( +|$)', - 'line': r'(%(nonalphanum7bit)s)\1 $' % pats, - 'text': r''} - initial_transitions = ( - 'bullet', - 'enumerator', - 'field_marker', - 'option_marker', - 'doctest', - 'line_block', - 'grid_table_top', - 'simple_table_top', - 'explicit_markup', - 'anonymous', - 'line', - 'text') - - def indent(self, match, context, next_state): - """Block quote.""" - indented, indent, line_offset, blank_finish = \ - self.state_machine.get_indented() - elements = self.block_quote(indented, line_offset) - self.parent += elements - if not blank_finish: - self.parent += self.unindent_warning('Block quote') - return context, next_state, [] - - def block_quote(self, indented, line_offset): - elements = [] - while indented: - (blockquote_lines, - attribution_lines, - attribution_offset, - indented, - new_line_offset) = self.split_attribution(indented, line_offset) - blockquote = nodes.block_quote() - self.nested_parse(blockquote_lines, line_offset, blockquote) - elements.append(blockquote) - if attribution_lines: - attribution, messages = self.parse_attribution( - attribution_lines, attribution_offset) - blockquote += attribution - elements += messages - line_offset = new_line_offset - while indented and not indented[0]: - indented = indented[1:] - line_offset += 1 - return elements - - # U+2014 is an em-dash: - attribution_pattern = re.compile(ur'(---?(?!-)|\u2014) (?=[^ \n])') - - def split_attribution(self, indented, line_offset): - """ - Check for a block quote attribution and split it off: - - First line after a blank line must begin with a dash ("--", "---", - em-dash; matches `self.attribution_pattern`). - Every line after that must have consistent indentation. - * Attributions must be preceded by block quote content. - - Return a tuple of: (block quote content lines, content offset, - attribution lines, attribution offset, remaining indented lines). - """ - blank = None - nonblank_seen = False - for i in range(len(indented)): - line = indented[i].rstrip() - if line: - if nonblank_seen and blank == i - 1: # last line blank - match = self.attribution_pattern.match(line) - if match: - attribution_end, indent = self.check_attribution( - indented, i) - if attribution_end: - a_lines = indented[i:attribution_end] - a_lines.trim_left(match.end(), end=1) - a_lines.trim_left(indent, start=1) - return (indented[:i], a_lines, - i, indented[attribution_end:], - line_offset + attribution_end) - nonblank_seen = True - else: - blank = i - else: - return (indented, None, None, None, None) - - def check_attribution(self, indented, attribution_start): - """ - Check attribution shape. - Return the index past the end of the attribution, and the indent. - """ - indent = None - i = attribution_start + 1 - for i in range(attribution_start + 1, len(indented)): - line = indented[i].rstrip() - if not line: - break - if indent is None: - indent = len(line) - len(line.lstrip()) - elif len(line) - len(line.lstrip()) != indent: - return None, None # bad shape; not an attribution - else: - # return index of line after last attribution line: - i += 1 - return i, (indent or 0) - - def parse_attribution(self, indented, line_offset): - text = '\n'.join(indented).rstrip() - lineno = self.state_machine.abs_line_number() + line_offset - textnodes, messages = self.inline_text(text, lineno) - node = nodes.attribution(text, '', textnodes) - node.line = lineno - return node, messages - - def bullet(self, match, context, next_state): - """Bullet list item.""" - bulletlist = nodes.bullet_list() - self.parent += bulletlist - bulletlist['bullet'] = match.string[0] - i, blank_finish = self.list_item(match.end()) - bulletlist += i - offset = self.state_machine.line_offset + 1 # next line - new_line_offset, blank_finish = self.nested_list_parse( - self.state_machine.input_lines[offset:], - input_offset=self.state_machine.abs_line_offset() + 1, - node=bulletlist, initial_state='BulletList', - blank_finish=blank_finish) - self.goto_line(new_line_offset) - if not blank_finish: - self.parent += self.unindent_warning('Bullet list') - return [], next_state, [] - - def list_item(self, indent): - if self.state_machine.line[indent:]: - indented, line_offset, blank_finish = ( - self.state_machine.get_known_indented(indent)) - else: - indented, indent, line_offset, blank_finish = ( - self.state_machine.get_first_known_indented(indent)) - listitem = nodes.list_item('\n'.join(indented)) - if indented: - self.nested_parse(indented, input_offset=line_offset, - node=listitem) - return listitem, blank_finish - - def enumerator(self, match, context, next_state): - """Enumerated List Item""" - format, sequence, text, ordinal = self.parse_enumerator(match) - if not self.is_enumerated_list_item(ordinal, sequence, format): - raise statemachine.TransitionCorrection('text') - enumlist = nodes.enumerated_list() - self.parent += enumlist - if sequence == '#': - enumlist['enumtype'] = 'arabic' - else: - enumlist['enumtype'] = sequence - enumlist['prefix'] = self.enum.formatinfo[format].prefix - enumlist['suffix'] = self.enum.formatinfo[format].suffix - if ordinal != 1: - enumlist['start'] = ordinal - msg = self.reporter.info( - 'Enumerated list start value not ordinal-1: "%s" (ordinal %s)' - % (text, ordinal), line=self.state_machine.abs_line_number()) - self.parent += msg - listitem, blank_finish = self.list_item(match.end()) - enumlist += listitem - offset = self.state_machine.line_offset + 1 # next line - newline_offset, blank_finish = self.nested_list_parse( - self.state_machine.input_lines[offset:], - input_offset=self.state_machine.abs_line_offset() + 1, - node=enumlist, initial_state='EnumeratedList', - blank_finish=blank_finish, - extra_settings={'lastordinal': ordinal, - 'format': format, - 'auto': sequence == '#'}) - self.goto_line(newline_offset) - if not blank_finish: - self.parent += self.unindent_warning('Enumerated list') - return [], next_state, [] - - def parse_enumerator(self, match, expected_sequence=None): - """ - Analyze an enumerator and return the results. - - :Return: - - the enumerator format ('period', 'parens', or 'rparen'), - - the sequence used ('arabic', 'loweralpha', 'upperroman', etc.), - - the text of the enumerator, stripped of formatting, and - - the ordinal value of the enumerator ('a' -> 1, 'ii' -> 2, etc.; - ``None`` is returned for invalid enumerator text). - - The enumerator format has already been determined by the regular - expression match. If `expected_sequence` is given, that sequence is - tried first. If not, we check for Roman numeral 1. This way, - single-character Roman numerals (which are also alphabetical) can be - matched. If no sequence has been matched, all sequences are checked in - order. - """ - groupdict = match.groupdict() - sequence = '' - for format in self.enum.formats: - if groupdict[format]: # was this the format matched? - break # yes; keep `format` - else: # shouldn't happen - raise ParserError('enumerator format not matched') - text = groupdict[format][self.enum.formatinfo[format].start - :self.enum.formatinfo[format].end] - if text == '#': - sequence = '#' - elif expected_sequence: - try: - if self.enum.sequenceregexps[expected_sequence].match(text): - sequence = expected_sequence - except KeyError: # shouldn't happen - raise ParserError('unknown enumerator sequence: %s' - % sequence) - elif text == 'i': - sequence = 'lowerroman' - elif text == 'I': - sequence = 'upperroman' - if not sequence: - for sequence in self.enum.sequences: - if self.enum.sequenceregexps[sequence].match(text): - break - else: # shouldn't happen - raise ParserError('enumerator sequence not matched') - if sequence == '#': - ordinal = 1 - else: - try: - ordinal = self.enum.converters[sequence](text) - except roman.InvalidRomanNumeralError: - ordinal = None - return format, sequence, text, ordinal - - def is_enumerated_list_item(self, ordinal, sequence, format): - """ - Check validity based on the ordinal value and the second line. - - Return true iff the ordinal is valid and the second line is blank, - indented, or starts with the next enumerator or an auto-enumerator. - """ - if ordinal is None: - return None - try: - next_line = self.state_machine.next_line() - except EOFError: # end of input lines - self.state_machine.previous_line() - return 1 - else: - self.state_machine.previous_line() - if not next_line[:1].strip(): # blank or indented - return 1 - result = self.make_enumerator(ordinal + 1, sequence, format) - if result: - next_enumerator, auto_enumerator = result - try: - if ( next_line.startswith(next_enumerator) or - next_line.startswith(auto_enumerator) ): - return 1 - except TypeError: - pass - return None - - def make_enumerator(self, ordinal, sequence, format): - """ - Construct and return the next enumerated list item marker, and an - auto-enumerator ("#" instead of the regular enumerator). - - Return ``None`` for invalid (out of range) ordinals. - """ #" - if sequence == '#': - enumerator = '#' - elif sequence == 'arabic': - enumerator = str(ordinal) - else: - if sequence.endswith('alpha'): - if ordinal > 26: - return None - enumerator = chr(ordinal + ord('a') - 1) - elif sequence.endswith('roman'): - try: - enumerator = roman.toRoman(ordinal) - except roman.RomanError: - return None - else: # shouldn't happen - raise ParserError('unknown enumerator sequence: "%s"' - % sequence) - if sequence.startswith('lower'): - enumerator = enumerator.lower() - elif sequence.startswith('upper'): - enumerator = enumerator.upper() - else: # shouldn't happen - raise ParserError('unknown enumerator sequence: "%s"' - % sequence) - formatinfo = self.enum.formatinfo[format] - next_enumerator = (formatinfo.prefix + enumerator + formatinfo.suffix - + ' ') - auto_enumerator = formatinfo.prefix + '#' + formatinfo.suffix + ' ' - return next_enumerator, auto_enumerator - - def field_marker(self, match, context, next_state): - """Field list item.""" - field_list = nodes.field_list() - self.parent += field_list - field, blank_finish = self.field(match) - field_list += field - offset = self.state_machine.line_offset + 1 # next line - newline_offset, blank_finish = self.nested_list_parse( - self.state_machine.input_lines[offset:], - input_offset=self.state_machine.abs_line_offset() + 1, - node=field_list, initial_state='FieldList', - blank_finish=blank_finish) - self.goto_line(newline_offset) - if not blank_finish: - self.parent += self.unindent_warning('Field list') - return [], next_state, [] - - def field(self, match): - name = self.parse_field_marker(match) - lineno = self.state_machine.abs_line_number() - indented, indent, line_offset, blank_finish = \ - self.state_machine.get_first_known_indented(match.end()) - field_node = nodes.field() - field_node.line = lineno - name_nodes, name_messages = self.inline_text(name, lineno) - field_node += nodes.field_name(name, '', name_nodes) - field_body = nodes.field_body('\n'.join(indented), name_messages) - field_node += field_body - if indented: - self.parse_field_body(indented, line_offset, field_body) - return field_node, blank_finish - - def parse_field_marker(self, match): - """Extract & return field name from a field marker match.""" - field = match.group()[1:] # strip off leading ':' - field = field[:field.rfind(':')] # strip off trailing ':' etc. - return field - - def parse_field_body(self, indented, offset, node): - self.nested_parse(indented, input_offset=offset, node=node) - - def option_marker(self, match, context, next_state): - """Option list item.""" - optionlist = nodes.option_list() - try: - listitem, blank_finish = self.option_list_item(match) - except MarkupError, (message, lineno): - # This shouldn't happen; pattern won't match. - msg = self.reporter.error( - 'Invalid option list marker: %s' % message, line=lineno) - self.parent += msg - indented, indent, line_offset, blank_finish = \ - self.state_machine.get_first_known_indented(match.end()) - elements = self.block_quote(indented, line_offset) - self.parent += elements - if not blank_finish: - self.parent += self.unindent_warning('Option list') - return [], next_state, [] - self.parent += optionlist - optionlist += listitem - offset = self.state_machine.line_offset + 1 # next line - newline_offset, blank_finish = self.nested_list_parse( - self.state_machine.input_lines[offset:], - input_offset=self.state_machine.abs_line_offset() + 1, - node=optionlist, initial_state='OptionList', - blank_finish=blank_finish) - self.goto_line(newline_offset) - if not blank_finish: - self.parent += self.unindent_warning('Option list') - return [], next_state, [] - - def option_list_item(self, match): - offset = self.state_machine.abs_line_offset() - options = self.parse_option_marker(match) - indented, indent, line_offset, blank_finish = \ - self.state_machine.get_first_known_indented(match.end()) - if not indented: # not an option list item - self.goto_line(offset) - raise statemachine.TransitionCorrection('text') - option_group = nodes.option_group('', options) - description = nodes.description('\n'.join(indented)) - option_list_item = nodes.option_list_item('', option_group, - description) - if indented: - self.nested_parse(indented, input_offset=line_offset, - node=description) - return option_list_item, blank_finish - - def parse_option_marker(self, match): - """ - Return a list of `node.option` and `node.option_argument` objects, - parsed from an option marker match. - - :Exception: `MarkupError` for invalid option markers. - """ - optlist = [] - optionstrings = match.group().rstrip().split(', ') - for optionstring in optionstrings: - tokens = optionstring.split() - delimiter = ' ' - firstopt = tokens[0].split('=') - if len(firstopt) > 1: - # "--opt=value" form - tokens[:1] = firstopt - delimiter = '=' - elif (len(tokens[0]) > 2 - and ((tokens[0].startswith('-') - and not tokens[0].startswith('--')) - or tokens[0].startswith('+'))): - # "-ovalue" form - tokens[:1] = [tokens[0][:2], tokens[0][2:]] - delimiter = '' - if len(tokens) > 1 and (tokens[1].startswith('<') - and tokens[-1].endswith('>')): - # "-o " form; join all values into one token - tokens[1:] = [' '.join(tokens[1:])] - if 0 < len(tokens) <= 2: - option = nodes.option(optionstring) - option += nodes.option_string(tokens[0], tokens[0]) - if len(tokens) > 1: - option += nodes.option_argument(tokens[1], tokens[1], - delimiter=delimiter) - optlist.append(option) - else: - raise MarkupError( - 'wrong number of option tokens (=%s), should be 1 or 2: ' - '"%s"' % (len(tokens), optionstring), - self.state_machine.abs_line_number() + 1) - return optlist - - def doctest(self, match, context, next_state): - data = '\n'.join(self.state_machine.get_text_block()) - self.parent += nodes.doctest_block(data, data) - return [], next_state, [] - - def line_block(self, match, context, next_state): - """First line of a line block.""" - block = nodes.line_block() - self.parent += block - lineno = self.state_machine.abs_line_number() - line, messages, blank_finish = self.line_block_line(match, lineno) - block += line - self.parent += messages - if not blank_finish: - offset = self.state_machine.line_offset + 1 # next line - new_line_offset, blank_finish = self.nested_list_parse( - self.state_machine.input_lines[offset:], - input_offset=self.state_machine.abs_line_offset() + 1, - node=block, initial_state='LineBlock', - blank_finish=0) - self.goto_line(new_line_offset) - if not blank_finish: - self.parent += self.reporter.warning( - 'Line block ends without a blank line.', - line=(self.state_machine.abs_line_number() + 1)) - if len(block): - if block[0].indent is None: - block[0].indent = 0 - self.nest_line_block_lines(block) - return [], next_state, [] - - def line_block_line(self, match, lineno): - """Return one line element of a line_block.""" - indented, indent, line_offset, blank_finish = \ - self.state_machine.get_first_known_indented(match.end(), - until_blank=1) - text = u'\n'.join(indented) - text_nodes, messages = self.inline_text(text, lineno) - line = nodes.line(text, '', *text_nodes) - if match.string.rstrip() != '|': # not empty - line.indent = len(match.group(1)) - 1 - return line, messages, blank_finish - - def nest_line_block_lines(self, block): - for index in range(1, len(block)): - if block[index].indent is None: - block[index].indent = block[index - 1].indent - self.nest_line_block_segment(block) - - def nest_line_block_segment(self, block): - indents = [item.indent for item in block] - least = min(indents) - new_items = [] - new_block = nodes.line_block() - for item in block: - if item.indent > least: - new_block.append(item) - else: - if len(new_block): - self.nest_line_block_segment(new_block) - new_items.append(new_block) - new_block = nodes.line_block() - new_items.append(item) - if len(new_block): - self.nest_line_block_segment(new_block) - new_items.append(new_block) - block[:] = new_items - - def grid_table_top(self, match, context, next_state): - """Top border of a full table.""" - return self.table_top(match, context, next_state, - self.isolate_grid_table, - tableparser.GridTableParser) - - def simple_table_top(self, match, context, next_state): - """Top border of a simple table.""" - return self.table_top(match, context, next_state, - self.isolate_simple_table, - tableparser.SimpleTableParser) - - def table_top(self, match, context, next_state, - isolate_function, parser_class): - """Top border of a generic table.""" - nodelist, blank_finish = self.table(isolate_function, parser_class) - self.parent += nodelist - if not blank_finish: - msg = self.reporter.warning( - 'Blank line required after table.', - line=self.state_machine.abs_line_number() + 1) - self.parent += msg - return [], next_state, [] - - def table(self, isolate_function, parser_class): - """Parse a table.""" - block, messages, blank_finish = isolate_function() - if block: - try: - parser = parser_class() - tabledata = parser.parse(block) - tableline = (self.state_machine.abs_line_number() - len(block) - + 1) - table = self.build_table(tabledata, tableline) - nodelist = [table] + messages - except tableparser.TableMarkupError, detail: - nodelist = self.malformed_table( - block, ' '.join(detail.args)) + messages - else: - nodelist = messages - return nodelist, blank_finish - - def isolate_grid_table(self): - messages = [] - blank_finish = 1 - try: - block = self.state_machine.get_text_block(flush_left=1) - except statemachine.UnexpectedIndentationError, instance: - block, source, lineno = instance.args - messages.append(self.reporter.error('Unexpected indentation.', - source=source, line=lineno)) - blank_finish = 0 - block.disconnect() - # for East Asian chars: - block.pad_double_width(self.double_width_pad_char) - width = len(block[0].strip()) - for i in range(len(block)): - block[i] = block[i].strip() - if block[i][0] not in '+|': # check left edge - blank_finish = 0 - self.state_machine.previous_line(len(block) - i) - del block[i:] - break - if not self.grid_table_top_pat.match(block[-1]): # find bottom - blank_finish = 0 - # from second-last to third line of table: - for i in range(len(block) - 2, 1, -1): - if self.grid_table_top_pat.match(block[i]): - self.state_machine.previous_line(len(block) - i + 1) - del block[i+1:] - break - else: - messages.extend(self.malformed_table(block)) - return [], messages, blank_finish - for i in range(len(block)): # check right edge - if len(block[i]) != width or block[i][-1] not in '+|': - messages.extend(self.malformed_table(block)) - return [], messages, blank_finish - return block, messages, blank_finish - - def isolate_simple_table(self): - start = self.state_machine.line_offset - lines = self.state_machine.input_lines - limit = len(lines) - 1 - toplen = len(lines[start].strip()) - pattern_match = self.simple_table_border_pat.match - found = 0 - found_at = None - i = start + 1 - while i <= limit: - line = lines[i] - match = pattern_match(line) - if match: - if len(line.strip()) != toplen: - self.state_machine.next_line(i - start) - messages = self.malformed_table( - lines[start:i+1], 'Bottom/header table border does ' - 'not match top border.') - return [], messages, i == limit or not lines[i+1].strip() - found += 1 - found_at = i - if found == 2 or i == limit or not lines[i+1].strip(): - end = i - break - i += 1 - else: # reached end of input_lines - if found: - extra = ' or no blank line after table bottom' - self.state_machine.next_line(found_at - start) - block = lines[start:found_at+1] - else: - extra = '' - self.state_machine.next_line(i - start - 1) - block = lines[start:] - messages = self.malformed_table( - block, 'No bottom table border found%s.' % extra) - return [], messages, not extra - self.state_machine.next_line(end - start) - block = lines[start:end+1] - # for East Asian chars: - block.pad_double_width(self.double_width_pad_char) - return block, [], end == limit or not lines[end+1].strip() - - def malformed_table(self, block, detail=''): - block.replace(self.double_width_pad_char, '') - data = '\n'.join(block) - message = 'Malformed table.' - lineno = self.state_machine.abs_line_number() - len(block) + 1 - if detail: - message += '\n' + detail - error = self.reporter.error(message, nodes.literal_block(data, data), - line=lineno) - return [error] - - def build_table(self, tabledata, tableline, stub_columns=0): - colwidths, headrows, bodyrows = tabledata - table = nodes.table() - tgroup = nodes.tgroup(cols=len(colwidths)) - table += tgroup - for colwidth in colwidths: - colspec = nodes.colspec(colwidth=colwidth) - if stub_columns: - colspec.attributes['stub'] = 1 - stub_columns -= 1 - tgroup += colspec - if headrows: - thead = nodes.thead() - tgroup += thead - for row in headrows: - thead += self.build_table_row(row, tableline) - tbody = nodes.tbody() - tgroup += tbody - for row in bodyrows: - tbody += self.build_table_row(row, tableline) - return table - - def build_table_row(self, rowdata, tableline): - row = nodes.row() - for cell in rowdata: - if cell is None: - continue - morerows, morecols, offset, cellblock = cell - attributes = {} - if morerows: - attributes['morerows'] = morerows - if morecols: - attributes['morecols'] = morecols - entry = nodes.entry(**attributes) - row += entry - if ''.join(cellblock): - self.nested_parse(cellblock, input_offset=tableline+offset, - node=entry) - return row - - - explicit = Struct() - """Patterns and constants used for explicit markup recognition.""" - - explicit.patterns = Struct( - target=re.compile(r""" - ( - _ # anonymous target - | # OR - (?!_) # no underscore at the beginning - (?P`?) # optional open quote - (?![ `]) # first char. not space or - # backquote - (?P # reference name - .+? - ) - %(non_whitespace_escape_before)s - (?P=quote) # close quote if open quote used - ) - (?%(simplename)s)_ - | # OR - ` # open backquote - (?![ ]) # not space - (?P.+?) # hyperlink phrase - %(non_whitespace_escape_before)s - `_ # close backquote, - # reference mark - ) - $ # end of string - """ % vars(Inliner), re.VERBOSE | re.UNICODE), - substitution=re.compile(r""" - ( - (?![ ]) # first char. not space - (?P.+?) # substitution text - %(non_whitespace_escape_before)s - \| # close delimiter - ) - ([ ]+|$) # followed by whitespace - """ % vars(Inliner), re.VERBOSE),) - - def footnote(self, match): - lineno = self.state_machine.abs_line_number() - indented, indent, offset, blank_finish = \ - self.state_machine.get_first_known_indented(match.end()) - label = match.group(1) - name = normalize_name(label) - footnote = nodes.footnote('\n'.join(indented)) - footnote.line = lineno - if name[0] == '#': # auto-numbered - name = name[1:] # autonumber label - footnote['auto'] = 1 - if name: - footnote['names'].append(name) - self.document.note_autofootnote(footnote) - elif name == '': # auto-symbol - name = '' - footnote['auto'] = '' - self.document.note_symbol_footnote(footnote) - else: # manually numbered - footnote += nodes.label('', label) - footnote['names'].append(name) - self.document.note_footnote(footnote) - if name: - self.document.note_explicit_target(footnote, footnote) - else: - self.document.set_id(footnote, footnote) - if indented: - self.nested_parse(indented, input_offset=offset, node=footnote) - return [footnote], blank_finish - - def citation(self, match): - lineno = self.state_machine.abs_line_number() - indented, indent, offset, blank_finish = \ - self.state_machine.get_first_known_indented(match.end()) - label = match.group(1) - name = normalize_name(label) - citation = nodes.citation('\n'.join(indented)) - citation.line = lineno - citation += nodes.label('', label) - citation['names'].append(name) - self.document.note_citation(citation) - self.document.note_explicit_target(citation, citation) - if indented: - self.nested_parse(indented, input_offset=offset, node=citation) - return [citation], blank_finish - - def hyperlink_target(self, match): - pattern = self.explicit.patterns.target - lineno = self.state_machine.abs_line_number() - block, indent, offset, blank_finish = \ - self.state_machine.get_first_known_indented( - match.end(), until_blank=1, strip_indent=0) - blocktext = match.string[:match.end()] + '\n'.join(block) - block = [escape2null(line) for line in block] - escaped = block[0] - blockindex = 0 - while 1: - targetmatch = pattern.match(escaped) - if targetmatch: - break - blockindex += 1 - try: - escaped += block[blockindex] - except IndexError: - raise MarkupError('malformed hyperlink target.', lineno) - del block[:blockindex] - block[0] = (block[0] + ' ')[targetmatch.end()-len(escaped)-1:].strip() - target = self.make_target(block, blocktext, lineno, - targetmatch.group('name')) - return [target], blank_finish - - def make_target(self, block, block_text, lineno, target_name): - target_type, data = self.parse_target(block, block_text, lineno) - if target_type == 'refname': - target = nodes.target(block_text, '', refname=normalize_name(data)) - target.indirect_reference_name = data - self.add_target(target_name, '', target, lineno) - self.document.note_indirect_target(target) - return target - elif target_type == 'refuri': - target = nodes.target(block_text, '') - self.add_target(target_name, data, target, lineno) - return target - else: - return data - - def parse_target(self, block, block_text, lineno): - """ - Determine the type of reference of a target. - - :Return: A 2-tuple, one of: - - - 'refname' and the indirect reference name - - 'refuri' and the URI - - 'malformed' and a system_message node - """ - if block and block[-1].strip()[-1:] == '_': # possible indirect target - reference = ' '.join([line.strip() for line in block]) - refname = self.is_reference(reference) - if refname: - return 'refname', refname - reference = ''.join([''.join(line.split()) for line in block]) - return 'refuri', unescape(reference) - - def is_reference(self, reference): - match = self.explicit.patterns.reference.match( - whitespace_normalize_name(reference)) - if not match: - return None - return unescape(match.group('simple') or match.group('phrase')) - - def add_target(self, targetname, refuri, target, lineno): - target.line = lineno - if targetname: - name = normalize_name(unescape(targetname)) - target['names'].append(name) - if refuri: - uri = self.inliner.adjust_uri(refuri) - if uri: - target['refuri'] = uri - else: - raise ApplicationError('problem with URI: %r' % refuri) - self.document.note_explicit_target(target, self.parent) - else: # anonymous target - if refuri: - target['refuri'] = refuri - target['anonymous'] = 1 - self.document.note_anonymous_target(target) - - def substitution_def(self, match): - pattern = self.explicit.patterns.substitution - lineno = self.state_machine.abs_line_number() - block, indent, offset, blank_finish = \ - self.state_machine.get_first_known_indented(match.end(), - strip_indent=0) - blocktext = (match.string[:match.end()] + '\n'.join(block)) - block.disconnect() - escaped = escape2null(block[0].rstrip()) - blockindex = 0 - while 1: - subdefmatch = pattern.match(escaped) - if subdefmatch: - break - blockindex += 1 - try: - escaped = escaped + ' ' + escape2null(block[blockindex].strip()) - except IndexError: - raise MarkupError('malformed substitution definition.', - lineno) - del block[:blockindex] # strip out the substitution marker - block[0] = (block[0].strip() + ' ')[subdefmatch.end()-len(escaped)-1:-1] - if not block[0]: - del block[0] - offset += 1 - while block and not block[-1].strip(): - block.pop() - subname = subdefmatch.group('name') - substitution_node = nodes.substitution_definition(blocktext) - substitution_node.line = lineno - if not block: - msg = self.reporter.warning( - 'Substitution definition "%s" missing contents.' % subname, - nodes.literal_block(blocktext, blocktext), line=lineno) - return [msg], blank_finish - block[0] = block[0].strip() - substitution_node['names'].append( - nodes.whitespace_normalize_name(subname)) - new_abs_offset, blank_finish = self.nested_list_parse( - block, input_offset=offset, node=substitution_node, - initial_state='SubstitutionDef', blank_finish=blank_finish) - i = 0 - for node in substitution_node[:]: - if not (isinstance(node, nodes.Inline) or - isinstance(node, nodes.Text)): - self.parent += substitution_node[i] - del substitution_node[i] - else: - i += 1 - for node in substitution_node.traverse(nodes.Element): - if self.disallowed_inside_substitution_definitions(node): - pformat = nodes.literal_block('', node.pformat().rstrip()) - msg = self.reporter.error( - 'Substitution definition contains illegal element:', - pformat, nodes.literal_block(blocktext, blocktext), - line=lineno) - return [msg], blank_finish - if len(substitution_node) == 0: - msg = self.reporter.warning( - 'Substitution definition "%s" empty or invalid.' - % subname, - nodes.literal_block(blocktext, blocktext), line=lineno) - return [msg], blank_finish - self.document.note_substitution_def( - substitution_node, subname, self.parent) - return [substitution_node], blank_finish - - def disallowed_inside_substitution_definitions(self, node): - if (node['ids'] or - isinstance(node, nodes.reference) and node.get('anonymous') or - isinstance(node, nodes.footnote_reference) and node.get('auto')): - return 1 - else: - return 0 - - def directive(self, match, **option_presets): - """Returns a 2-tuple: list of nodes, and a "blank finish" boolean.""" - type_name = match.group(1) - directive_class, messages = directives.directive( - type_name, self.memo.language, self.document) - self.parent += messages - if directive_class: - return self.run_directive( - directive_class, match, type_name, option_presets) - else: - return self.unknown_directive(type_name) - - def run_directive(self, directive, match, type_name, option_presets): - """ - Parse a directive then run its directive function. - - Parameters: - - - `directive`: The class implementing the directive. Must be - a subclass of `rst.Directive`. - - - `match`: A regular expression match object which matched the first - line of the directive. - - - `type_name`: The directive name, as used in the source text. - - - `option_presets`: A dictionary of preset options, defaults for the - directive options. Currently, only an "alt" option is passed by - substitution definitions (value: the substitution name), which may - be used by an embedded image directive. - - Returns a 2-tuple: list of nodes, and a "blank finish" boolean. - """ - if isinstance(directive, (FunctionType, MethodType)): - from docutils.parsers.rst import convert_directive_function - directive = convert_directive_function(directive) - lineno = self.state_machine.abs_line_number() - initial_line_offset = self.state_machine.line_offset - indented, indent, line_offset, blank_finish \ - = self.state_machine.get_first_known_indented(match.end(), - strip_top=0) - block_text = '\n'.join(self.state_machine.input_lines[ - initial_line_offset : self.state_machine.line_offset + 1]) - try: - arguments, options, content, content_offset = ( - self.parse_directive_block(indented, line_offset, - directive, option_presets)) - except MarkupError, detail: - error = self.reporter.error( - 'Error in "%s" directive:\n%s.' % (type_name, - ' '.join(detail.args)), - nodes.literal_block(block_text, block_text), line=lineno) - return [error], blank_finish - directive_instance = directive( - type_name, arguments, options, content, lineno, - content_offset, block_text, self, self.state_machine) - try: - result = directive_instance.run() - except docutils.parsers.rst.DirectiveError, directive_error: - msg_node = self.reporter.system_message(directive_error.level, - directive_error.message) - msg_node += nodes.literal_block(block_text, block_text) - msg_node['line'] = lineno - result = [msg_node] - assert isinstance(result, list), \ - 'Directive "%s" must return a list of nodes.' % type_name - for i in range(len(result)): - assert isinstance(result[i], nodes.Node), \ - ('Directive "%s" returned non-Node object (index %s): %r' - % (type_name, i, result[i])) - return (result, - blank_finish or self.state_machine.is_next_line_blank()) - - def parse_directive_block(self, indented, line_offset, directive, - option_presets): - option_spec = directive.option_spec - has_content = directive.has_content - if indented and not indented[0].strip(): - indented.trim_start() - line_offset += 1 - while indented and not indented[-1].strip(): - indented.trim_end() - if indented and (directive.required_arguments - or directive.optional_arguments - or option_spec): - for i in range(len(indented)): - if not indented[i].strip(): - break - else: - i += 1 - arg_block = indented[:i] - content = indented[i+1:] - content_offset = line_offset + i + 1 - else: - content = indented - content_offset = line_offset - arg_block = [] - while content and not content[0].strip(): - content.trim_start() - content_offset += 1 - if option_spec: - options, arg_block = self.parse_directive_options( - option_presets, option_spec, arg_block) - if arg_block and not (directive.required_arguments - or directive.optional_arguments): - raise MarkupError('no arguments permitted; blank line ' - 'required before content block') - else: - options = {} - if directive.required_arguments or directive.optional_arguments: - arguments = self.parse_directive_arguments( - directive, arg_block) - else: - arguments = [] - if content and not has_content: - raise MarkupError('no content permitted') - return (arguments, options, content, content_offset) - - def parse_directive_options(self, option_presets, option_spec, arg_block): - options = option_presets.copy() - for i in range(len(arg_block)): - if arg_block[i][:1] == ':': - opt_block = arg_block[i:] - arg_block = arg_block[:i] - break - else: - opt_block = [] - if opt_block: - success, data = self.parse_extension_options(option_spec, - opt_block) - if success: # data is a dict of options - options.update(data) - else: # data is an error string - raise MarkupError(data) - return options, arg_block - - def parse_directive_arguments(self, directive, arg_block): - required = directive.required_arguments - optional = directive.optional_arguments - arg_text = '\n'.join(arg_block) - arguments = arg_text.split() - if len(arguments) < required: - raise MarkupError('%s argument(s) required, %s supplied' - % (required, len(arguments))) - elif len(arguments) > required + optional: - if directive.final_argument_whitespace: - arguments = arg_text.split(None, required + optional - 1) - else: - raise MarkupError( - 'maximum %s argument(s) allowed, %s supplied' - % (required + optional, len(arguments))) - return arguments - - def parse_extension_options(self, option_spec, datalines): - """ - Parse `datalines` for a field list containing extension options - matching `option_spec`. - - :Parameters: - - `option_spec`: a mapping of option name to conversion - function, which should raise an exception on bad input. - - `datalines`: a list of input strings. - - :Return: - - Success value, 1 or 0. - - An option dictionary on success, an error string on failure. - """ - node = nodes.field_list() - newline_offset, blank_finish = self.nested_list_parse( - datalines, 0, node, initial_state='ExtensionOptions', - blank_finish=1) - if newline_offset != len(datalines): # incomplete parse of block - return 0, 'invalid option block' - try: - options = utils.extract_extension_options(node, option_spec) - except KeyError, detail: - return 0, ('unknown option: "%s"' % detail.args[0]) - except (ValueError, TypeError), detail: - return 0, ('invalid option value: %s' % ' '.join(detail.args)) - except utils.ExtensionOptionError, detail: - return 0, ('invalid option data: %s' % ' '.join(detail.args)) - if blank_finish: - return 1, options - else: - return 0, 'option data incompletely parsed' - - def unknown_directive(self, type_name): - lineno = self.state_machine.abs_line_number() - indented, indent, offset, blank_finish = \ - self.state_machine.get_first_known_indented(0, strip_indent=0) - text = '\n'.join(indented) - error = self.reporter.error( - 'Unknown directive type "%s".' % type_name, - nodes.literal_block(text, text), line=lineno) - return [error], blank_finish - - def comment(self, match): - if not match.string[match.end():].strip() \ - and self.state_machine.is_next_line_blank(): # an empty comment? - return [nodes.comment()], 1 # "A tiny but practical wart." - indented, indent, offset, blank_finish = \ - self.state_machine.get_first_known_indented(match.end()) - while indented and not indented[-1].strip(): - indented.trim_end() - text = '\n'.join(indented) - return [nodes.comment(text, text)], blank_finish - - explicit.constructs = [ - (footnote, - re.compile(r""" - \.\.[ ]+ # explicit markup start - \[ - ( # footnote label: - [0-9]+ # manually numbered footnote - | # OR - \# # anonymous auto-numbered footnote - | # OR - \#%s # auto-number ed?) footnote label - | # OR - \* # auto-symbol footnote - ) - \] - ([ ]+|$) # whitespace or end of line - """ % Inliner.simplename, re.VERBOSE | re.UNICODE)), - (citation, - re.compile(r""" - \.\.[ ]+ # explicit markup start - \[(%s)\] # citation label - ([ ]+|$) # whitespace or end of line - """ % Inliner.simplename, re.VERBOSE | re.UNICODE)), - (hyperlink_target, - re.compile(r""" - \.\.[ ]+ # explicit markup start - _ # target indicator - (?![ ]|$) # first char. not space or EOL - """, re.VERBOSE)), - (substitution_def, - re.compile(r""" - \.\.[ ]+ # explicit markup start - \| # substitution indicator - (?![ ]|$) # first char. not space or EOL - """, re.VERBOSE)), - (directive, - re.compile(r""" - \.\.[ ]+ # explicit markup start - (%s) # directive name - [ ]? # optional space - :: # directive delimiter - ([ ]+|$) # whitespace or end of line - """ % Inliner.simplename, re.VERBOSE | re.UNICODE))] - - def explicit_markup(self, match, context, next_state): - """Footnotes, hyperlink targets, directives, comments.""" - nodelist, blank_finish = self.explicit_construct(match) - self.parent += nodelist - self.explicit_list(blank_finish) - return [], next_state, [] - - def explicit_construct(self, match): - """Determine which explicit construct this is, parse & return it.""" - errors = [] - for method, pattern in self.explicit.constructs: - expmatch = pattern.match(match.string) - if expmatch: - try: - return method(self, expmatch) - except MarkupError, (message, lineno): # never reached? - errors.append(self.reporter.warning(message, line=lineno)) - break - nodelist, blank_finish = self.comment(match) - return nodelist + errors, blank_finish - - def explicit_list(self, blank_finish): - """ - Create a nested state machine for a series of explicit markup - constructs (including anonymous hyperlink targets). - """ - offset = self.state_machine.line_offset + 1 # next line - newline_offset, blank_finish = self.nested_list_parse( - self.state_machine.input_lines[offset:], - input_offset=self.state_machine.abs_line_offset() + 1, - node=self.parent, initial_state='Explicit', - blank_finish=blank_finish, - match_titles=self.state_machine.match_titles) - self.goto_line(newline_offset) - if not blank_finish: - self.parent += self.unindent_warning('Explicit markup') - - def anonymous(self, match, context, next_state): - """Anonymous hyperlink targets.""" - nodelist, blank_finish = self.anonymous_target(match) - self.parent += nodelist - self.explicit_list(blank_finish) - return [], next_state, [] - - def anonymous_target(self, match): - lineno = self.state_machine.abs_line_number() - block, indent, offset, blank_finish \ - = self.state_machine.get_first_known_indented(match.end(), - until_blank=1) - blocktext = match.string[:match.end()] + '\n'.join(block) - block = [escape2null(line) for line in block] - target = self.make_target(block, blocktext, lineno, '') - return [target], blank_finish - - def line(self, match, context, next_state): - """Section title overline or transition marker.""" - if self.state_machine.match_titles: - return [match.string], 'Line', [] - elif match.string.strip() == '::': - raise statemachine.TransitionCorrection('text') - elif len(match.string.strip()) < 4: - msg = self.reporter.info( - 'Unexpected possible title overline or transition.\n' - "Treating it as ordinary text because it's so short.", - line=self.state_machine.abs_line_number()) - self.parent += msg - raise statemachine.TransitionCorrection('text') - else: - blocktext = self.state_machine.line - msg = self.reporter.severe( - 'Unexpected section title or transition.', - nodes.literal_block(blocktext, blocktext), - line=self.state_machine.abs_line_number()) - self.parent += msg - return [], next_state, [] - - def text(self, match, context, next_state): - """Titles, definition lists, paragraphs.""" - return [match.string], 'Text', [] - - -class RFC2822Body(Body): - - """ - RFC2822 headers are only valid as the first constructs in documents. As - soon as anything else appears, the `Body` state should take over. - """ - - patterns = Body.patterns.copy() # can't modify the original - patterns['rfc2822'] = r'[!-9;-~]+:( +|$)' - initial_transitions = [(name, 'Body') - for name in Body.initial_transitions] - initial_transitions.insert(-1, ('rfc2822', 'Body')) # just before 'text' - - def rfc2822(self, match, context, next_state): - """RFC2822-style field list item.""" - fieldlist = nodes.field_list(classes=['rfc2822']) - self.parent += fieldlist - field, blank_finish = self.rfc2822_field(match) - fieldlist += field - offset = self.state_machine.line_offset + 1 # next line - newline_offset, blank_finish = self.nested_list_parse( - self.state_machine.input_lines[offset:], - input_offset=self.state_machine.abs_line_offset() + 1, - node=fieldlist, initial_state='RFC2822List', - blank_finish=blank_finish) - self.goto_line(newline_offset) - if not blank_finish: - self.parent += self.unindent_warning( - 'RFC2822-style field list') - return [], next_state, [] - - def rfc2822_field(self, match): - name = match.string[:match.string.find(':')] - indented, indent, line_offset, blank_finish = \ - self.state_machine.get_first_known_indented(match.end(), - until_blank=1) - fieldnode = nodes.field() - fieldnode += nodes.field_name(name, name) - fieldbody = nodes.field_body('\n'.join(indented)) - fieldnode += fieldbody - if indented: - self.nested_parse(indented, input_offset=line_offset, - node=fieldbody) - return fieldnode, blank_finish - - -class SpecializedBody(Body): - - """ - Superclass for second and subsequent compound element members. Compound - elements are lists and list-like constructs. - - All transition methods are disabled (redefined as `invalid_input`). - Override individual methods in subclasses to re-enable. - - For example, once an initial bullet list item, say, is recognized, the - `BulletList` subclass takes over, with a "bullet_list" node as its - container. Upon encountering the initial bullet list item, `Body.bullet` - calls its ``self.nested_list_parse`` (`RSTState.nested_list_parse`), which - starts up a nested parsing session with `BulletList` as the initial state. - Only the ``bullet`` transition method is enabled in `BulletList`; as long - as only bullet list items are encountered, they are parsed and inserted - into the container. The first construct which is not a bullet list item - triggers the `invalid_input` method, which ends the nested parse and - closes the container. `BulletList` needs to recognize input that is - invalid in the context of a bullet list, which means everything other - than bullet list items, so it inherits the transition list created in - `Body`. - """ - - def invalid_input(self, match=None, context=None, next_state=None): - """Not a compound element member. Abort this state machine.""" - self.state_machine.previous_line() # back up so parent SM can reassess - raise EOFError - - indent = invalid_input - bullet = invalid_input - enumerator = invalid_input - field_marker = invalid_input - option_marker = invalid_input - doctest = invalid_input - line_block = invalid_input - grid_table_top = invalid_input - simple_table_top = invalid_input - explicit_markup = invalid_input - anonymous = invalid_input - line = invalid_input - text = invalid_input - - -class BulletList(SpecializedBody): - - """Second and subsequent bullet_list list_items.""" - - def bullet(self, match, context, next_state): - """Bullet list item.""" - if match.string[0] != self.parent['bullet']: - # different bullet: new list - self.invalid_input() - listitem, blank_finish = self.list_item(match.end()) - self.parent += listitem - self.blank_finish = blank_finish - return [], next_state, [] - - -class DefinitionList(SpecializedBody): - - """Second and subsequent definition_list_items.""" - - def text(self, match, context, next_state): - """Definition lists.""" - return [match.string], 'Definition', [] - - -class EnumeratedList(SpecializedBody): - - """Second and subsequent enumerated_list list_items.""" - - def enumerator(self, match, context, next_state): - """Enumerated list item.""" - format, sequence, text, ordinal = self.parse_enumerator( - match, self.parent['enumtype']) - if ( format != self.format - or (sequence != '#' and (sequence != self.parent['enumtype'] - or self.auto - or ordinal != (self.lastordinal + 1))) - or not self.is_enumerated_list_item(ordinal, sequence, format)): - # different enumeration: new list - self.invalid_input() - if sequence == '#': - self.auto = 1 - listitem, blank_finish = self.list_item(match.end()) - self.parent += listitem - self.blank_finish = blank_finish - self.lastordinal = ordinal - return [], next_state, [] - - -class FieldList(SpecializedBody): - - """Second and subsequent field_list fields.""" - - def field_marker(self, match, context, next_state): - """Field list field.""" - field, blank_finish = self.field(match) - self.parent += field - self.blank_finish = blank_finish - return [], next_state, [] - - -class OptionList(SpecializedBody): - - """Second and subsequent option_list option_list_items.""" - - def option_marker(self, match, context, next_state): - """Option list item.""" - try: - option_list_item, blank_finish = self.option_list_item(match) - except MarkupError, (message, lineno): - self.invalid_input() - self.parent += option_list_item - self.blank_finish = blank_finish - return [], next_state, [] - - -class RFC2822List(SpecializedBody, RFC2822Body): - - """Second and subsequent RFC2822-style field_list fields.""" - - patterns = RFC2822Body.patterns - initial_transitions = RFC2822Body.initial_transitions - - def rfc2822(self, match, context, next_state): - """RFC2822-style field list item.""" - field, blank_finish = self.rfc2822_field(match) - self.parent += field - self.blank_finish = blank_finish - return [], 'RFC2822List', [] - - blank = SpecializedBody.invalid_input - - -class ExtensionOptions(FieldList): - - """ - Parse field_list fields for extension options. - - No nested parsing is done (including inline markup parsing). - """ - - def parse_field_body(self, indented, offset, node): - """Override `Body.parse_field_body` for simpler parsing.""" - lines = [] - for line in list(indented) + ['']: - if line.strip(): - lines.append(line) - elif lines: - text = '\n'.join(lines) - node += nodes.paragraph(text, text) - lines = [] - - -class LineBlock(SpecializedBody): - - """Second and subsequent lines of a line_block.""" - - blank = SpecializedBody.invalid_input - - def line_block(self, match, context, next_state): - """New line of line block.""" - lineno = self.state_machine.abs_line_number() - line, messages, blank_finish = self.line_block_line(match, lineno) - self.parent += line - self.parent.parent += messages - self.blank_finish = blank_finish - return [], next_state, [] - - -class Explicit(SpecializedBody): - - """Second and subsequent explicit markup construct.""" - - def explicit_markup(self, match, context, next_state): - """Footnotes, hyperlink targets, directives, comments.""" - nodelist, blank_finish = self.explicit_construct(match) - self.parent += nodelist - self.blank_finish = blank_finish - return [], next_state, [] - - def anonymous(self, match, context, next_state): - """Anonymous hyperlink targets.""" - nodelist, blank_finish = self.anonymous_target(match) - self.parent += nodelist - self.blank_finish = blank_finish - return [], next_state, [] - - blank = SpecializedBody.invalid_input - - -class SubstitutionDef(Body): - - """ - Parser for the contents of a substitution_definition element. - """ - - patterns = { - 'embedded_directive': re.compile(r'(%s)::( +|$)' - % Inliner.simplename, re.UNICODE), - 'text': r''} - initial_transitions = ['embedded_directive', 'text'] - - def embedded_directive(self, match, context, next_state): - nodelist, blank_finish = self.directive(match, - alt=self.parent['names'][0]) - self.parent += nodelist - if not self.state_machine.at_eof(): - self.blank_finish = blank_finish - raise EOFError - - def text(self, match, context, next_state): - if not self.state_machine.at_eof(): - self.blank_finish = self.state_machine.is_next_line_blank() - raise EOFError - - -class Text(RSTState): - - """ - Classifier of second line of a text block. - - Could be a paragraph, a definition list item, or a title. - """ - - patterns = {'underline': Body.patterns['line'], - 'text': r''} - initial_transitions = [('underline', 'Body'), ('text', 'Body')] - - def blank(self, match, context, next_state): - """End of paragraph.""" - paragraph, literalnext = self.paragraph( - context, self.state_machine.abs_line_number() - 1) - self.parent += paragraph - if literalnext: - self.parent += self.literal_block() - return [], 'Body', [] - - def eof(self, context): - if context: - self.blank(None, context, None) - return [] - - def indent(self, match, context, next_state): - """Definition list item.""" - definitionlist = nodes.definition_list() - definitionlistitem, blank_finish = self.definition_list_item(context) - definitionlist += definitionlistitem - self.parent += definitionlist - offset = self.state_machine.line_offset + 1 # next line - newline_offset, blank_finish = self.nested_list_parse( - self.state_machine.input_lines[offset:], - input_offset=self.state_machine.abs_line_offset() + 1, - node=definitionlist, initial_state='DefinitionList', - blank_finish=blank_finish, blank_finish_state='Definition') - self.goto_line(newline_offset) - if not blank_finish: - self.parent += self.unindent_warning('Definition list') - return [], 'Body', [] - - def underline(self, match, context, next_state): - """Section title.""" - lineno = self.state_machine.abs_line_number() - title = context[0].rstrip() - underline = match.string.rstrip() - source = title + '\n' + underline - messages = [] - if column_width(title) > len(underline): - if len(underline) < 4: - if self.state_machine.match_titles: - msg = self.reporter.info( - 'Possible title underline, too short for the title.\n' - "Treating it as ordinary text because it's so short.", - line=lineno) - self.parent += msg - raise statemachine.TransitionCorrection('text') - else: - blocktext = context[0] + '\n' + self.state_machine.line - msg = self.reporter.warning( - 'Title underline too short.', - nodes.literal_block(blocktext, blocktext), line=lineno) - messages.append(msg) - if not self.state_machine.match_titles: - blocktext = context[0] + '\n' + self.state_machine.line - msg = self.reporter.severe( - 'Unexpected section title.', - nodes.literal_block(blocktext, blocktext), line=lineno) - self.parent += messages - self.parent += msg - return [], next_state, [] - style = underline[0] - context[:] = [] - self.section(title, source, style, lineno - 1, messages) - return [], next_state, [] - - def text(self, match, context, next_state): - """Paragraph.""" - startline = self.state_machine.abs_line_number() - 1 - msg = None - try: - block = self.state_machine.get_text_block(flush_left=1) - except statemachine.UnexpectedIndentationError, instance: - block, source, lineno = instance.args - msg = self.reporter.error('Unexpected indentation.', - source=source, line=lineno) - lines = context + list(block) - paragraph, literalnext = self.paragraph(lines, startline) - self.parent += paragraph - self.parent += msg - if literalnext: - try: - self.state_machine.next_line() - except EOFError: - pass - self.parent += self.literal_block() - return [], next_state, [] - - def literal_block(self): - """Return a list of nodes.""" - indented, indent, offset, blank_finish = \ - self.state_machine.get_indented() - while indented and not indented[-1].strip(): - indented.trim_end() - if not indented: - return self.quoted_literal_block() - data = '\n'.join(indented) - literal_block = nodes.literal_block(data, data) - literal_block.line = offset + 1 - nodelist = [literal_block] - if not blank_finish: - nodelist.append(self.unindent_warning('Literal block')) - return nodelist - - def quoted_literal_block(self): - abs_line_offset = self.state_machine.abs_line_offset() - offset = self.state_machine.line_offset - parent_node = nodes.Element() - new_abs_offset = self.nested_parse( - self.state_machine.input_lines[offset:], - input_offset=abs_line_offset, node=parent_node, match_titles=0, - state_machine_kwargs={'state_classes': (QuotedLiteralBlock,), - 'initial_state': 'QuotedLiteralBlock'}) - self.goto_line(new_abs_offset) - return parent_node.children - - def definition_list_item(self, termline): - indented, indent, line_offset, blank_finish = \ - self.state_machine.get_indented() - definitionlistitem = nodes.definition_list_item( - '\n'.join(termline + list(indented))) - lineno = self.state_machine.abs_line_number() - 1 - definitionlistitem.line = lineno - termlist, messages = self.term(termline, lineno) - definitionlistitem += termlist - definition = nodes.definition('', messages) - definitionlistitem += definition - if termline[0][-2:] == '::': - definition += self.reporter.info( - 'Blank line missing before literal block (after the "::")? ' - 'Interpreted as a definition list item.', line=line_offset+1) - self.nested_parse(indented, input_offset=line_offset, node=definition) - return definitionlistitem, blank_finish - - classifier_delimiter = re.compile(' +: +') - - def term(self, lines, lineno): - """Return a definition_list's term and optional classifiers.""" - assert len(lines) == 1 - text_nodes, messages = self.inline_text(lines[0], lineno) - term_node = nodes.term() - node_list = [term_node] - for i in range(len(text_nodes)): - node = text_nodes[i] - if isinstance(node, nodes.Text): - parts = self.classifier_delimiter.split(node.rawsource) - if len(parts) == 1: - node_list[-1] += node - else: - - node_list[-1] += nodes.Text(parts[0].rstrip()) - for part in parts[1:]: - classifier_node = nodes.classifier('', part) - node_list.append(classifier_node) - else: - node_list[-1] += node - return node_list, messages - - -class SpecializedText(Text): - - """ - Superclass for second and subsequent lines of Text-variants. - - All transition methods are disabled. Override individual methods in - subclasses to re-enable. - """ - - def eof(self, context): - """Incomplete construct.""" - return [] - - def invalid_input(self, match=None, context=None, next_state=None): - """Not a compound element member. Abort this state machine.""" - raise EOFError - - blank = invalid_input - indent = invalid_input - underline = invalid_input - text = invalid_input - - -class Definition(SpecializedText): - - """Second line of potential definition_list_item.""" - - def eof(self, context): - """Not a definition.""" - self.state_machine.previous_line(2) # so parent SM can reassess - return [] - - def indent(self, match, context, next_state): - """Definition list item.""" - definitionlistitem, blank_finish = self.definition_list_item(context) - self.parent += definitionlistitem - self.blank_finish = blank_finish - return [], 'DefinitionList', [] - - -class Line(SpecializedText): - - """ - Second line of over- & underlined section title or transition marker. - """ - - eofcheck = 1 # @@@ ??? - """Set to 0 while parsing sections, so that we don't catch the EOF.""" - - def eof(self, context): - """Transition marker at end of section or document.""" - marker = context[0].strip() - if self.memo.section_bubble_up_kludge: - self.memo.section_bubble_up_kludge = 0 - elif len(marker) < 4: - self.state_correction(context) - if self.eofcheck: # ignore EOFError with sections - lineno = self.state_machine.abs_line_number() - 1 - transition = nodes.transition(rawsource=context[0]) - transition.line = lineno - self.parent += transition - self.eofcheck = 1 - return [] - - def blank(self, match, context, next_state): - """Transition marker.""" - lineno = self.state_machine.abs_line_number() - 1 - marker = context[0].strip() - if len(marker) < 4: - self.state_correction(context) - transition = nodes.transition(rawsource=marker) - transition.line = lineno - self.parent += transition - return [], 'Body', [] - - def text(self, match, context, next_state): - """Potential over- & underlined title.""" - lineno = self.state_machine.abs_line_number() - 1 - overline = context[0] - title = match.string - underline = '' - try: - underline = self.state_machine.next_line() - except EOFError: - blocktext = overline + '\n' + title - if len(overline.rstrip()) < 4: - self.short_overline(context, blocktext, lineno, 2) - else: - msg = self.reporter.severe( - 'Incomplete section title.', - nodes.literal_block(blocktext, blocktext), line=lineno) - self.parent += msg - return [], 'Body', [] - source = '%s\n%s\n%s' % (overline, title, underline) - overline = overline.rstrip() - underline = underline.rstrip() - if not self.transitions['underline'][0].match(underline): - blocktext = overline + '\n' + title + '\n' + underline - if len(overline.rstrip()) < 4: - self.short_overline(context, blocktext, lineno, 2) - else: - msg = self.reporter.severe( - 'Missing matching underline for section title overline.', - nodes.literal_block(source, source), line=lineno) - self.parent += msg - return [], 'Body', [] - elif overline != underline: - blocktext = overline + '\n' + title + '\n' + underline - if len(overline.rstrip()) < 4: - self.short_overline(context, blocktext, lineno, 2) - else: - msg = self.reporter.severe( - 'Title overline & underline mismatch.', - nodes.literal_block(source, source), line=lineno) - self.parent += msg - return [], 'Body', [] - title = title.rstrip() - messages = [] - if column_width(title) > len(overline): - blocktext = overline + '\n' + title + '\n' + underline - if len(overline.rstrip()) < 4: - self.short_overline(context, blocktext, lineno, 2) - else: - msg = self.reporter.warning( - 'Title overline too short.', - nodes.literal_block(source, source), line=lineno) - messages.append(msg) - style = (overline[0], underline[0]) - self.eofcheck = 0 # @@@ not sure this is correct - self.section(title.lstrip(), source, style, lineno + 1, messages) - self.eofcheck = 1 - return [], 'Body', [] - - indent = text # indented title - - def underline(self, match, context, next_state): - overline = context[0] - blocktext = overline + '\n' + self.state_machine.line - lineno = self.state_machine.abs_line_number() - 1 - if len(overline.rstrip()) < 4: - self.short_overline(context, blocktext, lineno, 1) - msg = self.reporter.error( - 'Invalid section title or transition marker.', - nodes.literal_block(blocktext, blocktext), line=lineno) - self.parent += msg - return [], 'Body', [] - - def short_overline(self, context, blocktext, lineno, lines=1): - msg = self.reporter.info( - 'Possible incomplete section title.\nTreating the overline as ' - "ordinary text because it's so short.", line=lineno) - self.parent += msg - self.state_correction(context, lines) - - def state_correction(self, context, lines=1): - self.state_machine.previous_line(lines) - context[:] = [] - raise statemachine.StateCorrection('Body', 'text') - - -class QuotedLiteralBlock(RSTState): - - """ - Nested parse handler for quoted (unindented) literal blocks. - - Special-purpose. Not for inclusion in `state_classes`. - """ - - patterns = {'initial_quoted': r'(%(nonalphanum7bit)s)' % Body.pats, - 'text': r''} - initial_transitions = ('initial_quoted', 'text') - - def init(self, state_machine, debug=0): - RSTState.init(self, state_machine, debug) - self.messages = [] - self.initial_lineno = None - - def blank(self, match, context, next_state): - if context: - raise EOFError - else: - return context, next_state, [] - - def eof(self, context): - if context: - text = '\n'.join(context) - literal_block = nodes.literal_block(text, text) - literal_block.line = self.initial_lineno - self.parent += literal_block - else: - self.parent += self.reporter.warning( - 'Literal block expected; none found.', - line=self.state_machine.abs_line_number()) - self.state_machine.previous_line() - self.parent += self.messages - return [] - - def indent(self, match, context, next_state): - assert context, ('QuotedLiteralBlock.indent: context should not ' - 'be empty!') - self.messages.append( - self.reporter.error('Unexpected indentation.', - line=self.state_machine.abs_line_number())) - self.state_machine.previous_line() - raise EOFError - - def initial_quoted(self, match, context, next_state): - """Match arbitrary quote character on the first line only.""" - self.remove_transition('initial_quoted') - quote = match.string[0] - pattern = re.compile(re.escape(quote)) - # New transition matches consistent quotes only: - self.add_transition('quoted', - (pattern, self.quoted, self.class.name)) - self.initial_lineno = self.state_machine.abs_line_number() - return [match.string], next_state, [] - - def quoted(self, match, context, next_state): - """Match consistent quotes on subsequent lines.""" - context.append(match.string) - return context, next_state, [] - - def text(self, match, context, next_state): - if context: - self.messages.append( - self.reporter.error('Inconsistent literal block quoting.', - line=self.state_machine.abs_line_number())) - self.state_machine.previous_line() - raise EOFError - - -state_classes = (Body, BulletList, DefinitionList, EnumeratedList, FieldList, - OptionList, LineBlock, ExtensionOptions, Explicit, Text, - Definition, Line, SubstitutionDef, RFC2822Body, RFC2822List) -"""Standard set of State classes used to start `RSTStateMachine`.""" diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/tableparser.py --- a/buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/parsers/rst/tableparser.py Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,525 +0,0 @@ -# $Id: tableparser.py 4564 2006-05-21 20:44:42Z wiemann $ -# Author: David Goodger -# Copyright: This module has been placed in the public domain. - -""" -This module defines table parser classes,which parse plaintext-graphic tables -and produce a well-formed data structure suitable for building a CALS table. - -:Classes: - - `GridTableParser`: Parse fully-formed tables represented with a grid. - - `SimpleTableParser`: Parse simple tables, delimited by top & bottom - borders. - -:Exception class: `TableMarkupError` - -:Function: - `update_dict_of_lists()`: Merge two dictionaries containing list values. -""" - -docformat = 'reStructuredText' - - -import re -import sys -from docutils import DataError - - -class TableMarkupError(DataError): pass - - -class TableParser: - - """ - Abstract superclass for the common parts of the syntax-specific parsers. - """ - - head_body_separator_pat = None - """Matches the row separator between head rows and body rows.""" - - double_width_pad_char = '\x00' - """Padding character for East Asian double-width text.""" - - def parse(self, block): - """ - Analyze the text `block` and return a table data structure. - - Given a plaintext-graphic table in `block` (list of lines of text; no - whitespace padding), parse the table, construct and return the data - necessary to construct a CALS table or equivalent. - - Raise `TableMarkupError` if there is any problem with the markup. - """ - self.setup(block) - self.find_head_body_sep() - self.parse_table() - structure = self.structure_from_cells() - return structure - - def find_head_body_sep(self): - """Look for a head/body row separator line; store the line index.""" - for i in range(len(self.block)): - line = self.block[i] - if self.head_body_separator_pat.match(line): - if self.head_body_sep: - raise TableMarkupError( - 'Multiple head/body row separators in table (at line ' - 'offset %s and %s); only one allowed.' - % (self.head_body_sep, i)) - else: - self.head_body_sep = i - self.block[i] = line.replace('=', '-') - if self.head_body_sep == 0 or self.head_body_sep == (len(self.block) - - 1): - raise TableMarkupError('The head/body row separator may not be ' - 'the first or last line of the table.') - - -class GridTableParser(TableParser): - - """ - Parse a grid table using `parse()`. - - Here's an example of a grid table:: - - +------------------------+------------+----------+----------+ - | Header row, column 1 | Header 2 | Header 3 | Header 4 | - +========================+============+==========+==========+ - | body row 1, column 1 | column 2 | column 3 | column 4 | - +------------------------+------------+----------+----------+ - | body row 2 | Cells may span columns. | - +------------------------+------------+---------------------+ - | body row 3 | Cells may | - Table cells | - +------------------------+ span rows. | - contain | - | body row 4 | | - body elements. | - +------------------------+------------+---------------------+ - - Intersections use '+', row separators use '-' (except for one optional - head/body row separator, which uses '='), and column separators use '|'. - - Passing the above table to the `parse()` method will result in the - following data structure:: - - ([24, 12, 10, 10], - [[(0, 0, 1, ['Header row, column 1']), - (0, 0, 1, ['Header 2']), - (0, 0, 1, ['Header 3']), - (0, 0, 1, ['Header 4'])]], - [[(0, 0, 3, ['body row 1, column 1']), - (0, 0, 3, ['column 2']), - (0, 0, 3, ['column 3']), - (0, 0, 3, ['column 4'])], - [(0, 0, 5, ['body row 2']), - (0, 2, 5, ['Cells may span columns.']), - None, - None], - [(0, 0, 7, ['body row 3']), - (1, 0, 7, ['Cells may', 'span rows.', '']), - (1, 1, 7, ['- Table cells', '- contain', '- body elements.']), - None], - [(0, 0, 9, ['body row 4']), None, None, None]]) - - The first item is a list containing column widths (colspecs). The second - item is a list of head rows, and the third is a list of body rows. Each - row contains a list of cells. Each cell is either None (for a cell unused - because of another cell's span), or a tuple. A cell tuple contains four - items: the number of extra rows used by the cell in a vertical span - (morerows); the number of extra columns used by the cell in a horizontal - span (morecols); the line offset of the first line of the cell contents; - and the cell contents, a list of lines of text. - """ - - head_body_separator_pat = re.compile(r'\+=[=+]+=\+ $') - - def setup(self, block): - self.block = block[:] # make a copy; it may be modified - self.block.disconnect() # don't propagate changes to parent - self.bottom = len(block) - 1 - self.right = len(block[0]) - 1 - self.head_body_sep = None - self.done = [-1] * len(block[0]) - self.cells = [] - self.rowseps = {0: [0]} - self.colseps = {0: [0]} - - def parse_table(self): - """ - Start with a queue of upper-left corners, containing the upper-left - corner of the table itself. Trace out one rectangular cell, remember - it, and add its upper-right and lower-left corners to the queue of - potential upper-left corners of further cells. Process the queue in - top-to-bottom order, keeping track of how much of each text column has - been seen. - - We'll end up knowing all the row and column boundaries, cell positions - and their dimensions. - """ - corners = [(0, 0)] - while corners: - top, left = corners.pop(0) - if top == self.bottom or left == self.right \ - or top <= self.done[left]: - continue - result = self.scan_cell(top, left) - if not result: - continue - bottom, right, rowseps, colseps = result - update_dict_of_lists(self.rowseps, rowseps) - update_dict_of_lists(self.colseps, colseps) - self.mark_done(top, left, bottom, right) - cellblock = self.block.get_2D_block(top + 1, left + 1, - bottom, right) - cellblock.disconnect() # lines in cell can't sync with parent - cellblock.replace(self.double_width_pad_char, '') - self.cells.append((top, left, bottom, right, cellblock)) - corners.extend([(top, right), (bottom, left)]) - corners.sort() - if not self.check_parse_complete(): - raise TableMarkupError('Malformed table; parse incomplete.') - - def mark_done(self, top, left, bottom, right): - """For keeping track of how much of each text column has been seen.""" - before = top - 1 - after = bottom - 1 - for col in range(left, right): - assert self.done[col] == before - self.done[col] = after - - def check_parse_complete(self): - """Each text column should have been completely seen.""" - last = self.bottom - 1 - for col in range(self.right): - if self.done[col] != last: - return None - return 1 - - def scan_cell(self, top, left): - """Starting at the top-left corner, start tracing out a cell.""" - assert self.block[top][left] == '+' - result = self.scan_right(top, left) - return result - - def scan_right(self, top, left): - """ - Look for the top-right corner of the cell, and make note of all column - boundaries ('+'). - """ - colseps = {} - line = self.block[top] - for i in range(left + 1, self.right + 1): - if line[i] == '+': - colseps[i] = [top] - result = self.scan_down(top, left, i) - if result: - bottom, rowseps, newcolseps = result - update_dict_of_lists(colseps, newcolseps) - return bottom, i, rowseps, colseps - elif line[i] != '-': - return None - return None - - def scan_down(self, top, left, right): - """ - Look for the bottom-right corner of the cell, making note of all row - boundaries. - """ - rowseps = {} - for i in range(top + 1, self.bottom + 1): - if self.block[i][right] == '+': - rowseps[i] = [right] - result = self.scan_left(top, left, i, right) - if result: - newrowseps, colseps = result - update_dict_of_lists(rowseps, newrowseps) - return i, rowseps, colseps - elif self.block[i][right] != '|': - return None - return None - - def scan_left(self, top, left, bottom, right): - """ - Noting column boundaries, look for the bottom-left corner of the cell. - It must line up with the starting point. - """ - colseps = {} - line = self.block[bottom] - for i in range(right - 1, left, -1): - if line[i] == '+': - colseps[i] = [bottom] - elif line[i] != '-': - return None - if line[left] != '+': - return None - result = self.scan_up(top, left, bottom, right) - if result is not None: - rowseps = result - return rowseps, colseps - return None - - def scan_up(self, top, left, bottom, right): - """ - Noting row boundaries, see if we can return to the starting point. - """ - rowseps = {} - for i in range(bottom - 1, top, -1): - if self.block[i][left] == '+': - rowseps[i] = [left] - elif self.block[i][left] != '|': - return None - return rowseps - - def structure_from_cells(self): - """ - From the data collected by `scan_cell()`, convert to the final data - structure. - """ - rowseps = self.rowseps.keys() # list of row boundaries - rowseps.sort() - rowindex = {} - for i in range(len(rowseps)): - rowindex[rowseps[i]] = i # row boundary -> row number mapping - colseps = self.colseps.keys() # list of column boundaries - colseps.sort() - colindex = {} - for i in range(len(colseps)): - colindex[colseps[i]] = i # column boundary -> col number map - colspecs = [(colseps[i] - colseps[i - 1] - 1) - for i in range(1, len(colseps))] # list of column widths - # prepare an empty table with the correct number of rows & columns - onerow = [None for i in range(len(colseps) - 1)] - rows = [onerow[:] for i in range(len(rowseps) - 1)] - # keep track of # of cells remaining; should reduce to zero - remaining = (len(rowseps) - 1) * (len(colseps) - 1) - for top, left, bottom, right, block in self.cells: - rownum = rowindex[top] - colnum = colindex[left] - assert rows[rownum][colnum] is None, ( - 'Cell (row %s, column %s) already used.' - % (rownum + 1, colnum + 1)) - morerows = rowindex[bottom] - rownum - 1 - morecols = colindex[right] - colnum - 1 - remaining -= (morerows + 1) * (morecols + 1) - # write the cell into the table - rows[rownum][colnum] = (morerows, morecols, top + 1, block) - assert remaining == 0, 'Unused cells remaining.' - if self.head_body_sep: # separate head rows from body rows - numheadrows = rowindex[self.head_body_sep] - headrows = rows[:numheadrows] - bodyrows = rows[numheadrows:] - else: - headrows = [] - bodyrows = rows - return (colspecs, headrows, bodyrows) - - -class SimpleTableParser(TableParser): - - """ - Parse a simple table using `parse()`. - - Here's an example of a simple table:: - - ===== ===== - col 1 col 2 - ===== ===== - 1 Second column of row 1. - 2 Second column of row 2. - Second line of paragraph. - 3 - Second column of row 3. - - - Second item in bullet - list (row 3, column 2). - 4 is a span - ------------ - 5 - ===== ===== - - Top and bottom borders use '=', column span underlines use '-', column - separation is indicated with spaces. - - Passing the above table to the `parse()` method will result in the - following data structure, whose interpretation is the same as for - `GridTableParser`:: - - ([5, 25], - [[(0, 0, 1, ['col 1']), - (0, 0, 1, ['col 2'])]], - [[(0, 0, 3, ['1']), - (0, 0, 3, ['Second column of row 1.'])], - [(0, 0, 4, ['2']), - (0, 0, 4, ['Second column of row 2.', - 'Second line of paragraph.'])], - [(0, 0, 6, ['3']), - (0, 0, 6, ['- Second column of row 3.', - '', - '- Second item in bullet', - ' list (row 3, column 2).'])], - [(0, 1, 10, ['4 is a span'])], - [(0, 0, 12, ['5']), - (0, 0, 12, [''])]]) - """ - - head_body_separator_pat = re.compile('=[ =]$') - span_pat = re.compile('-[ -]$') - - def setup(self, block): - self.block = block[:] # make a copy; it will be modified - self.block.disconnect() # don't propagate changes to parent - # Convert top & bottom borders to column span underlines: - self.block[0] = self.block[0].replace('=', '-') - self.block[-1] = self.block[-1].replace('=', '-') - self.head_body_sep = None - self.columns = [] - self.border_end = None - self.table = [] - self.done = [-1] * len(block[0]) - self.rowseps = {0: [0]} - self.colseps = {0: [0]} - - def parse_table(self): - """ - First determine the column boundaries from the top border, then - process rows. Each row may consist of multiple lines; accumulate - lines until a row is complete. Call `self.parse_row` to finish the - job. - """ - # Top border must fully describe all table columns. - self.columns = self.parse_columns(self.block[0], 0) - self.border_end = self.columns[-1][1] - firststart, firstend = self.columns[0] - offset = 1 # skip top border - start = 1 - text_found = None - while offset < len(self.block): - line = self.block[offset] - if self.span_pat.match(line): - # Column span underline or border; row is complete. - self.parse_row(self.block[start:offset], start, - (line.rstrip(), offset)) - start = offset + 1 - text_found = None - elif line[firststart:firstend].strip(): - # First column not blank, therefore it's a new row. - if text_found and offset != start: - self.parse_row(self.block[start:offset], start) - start = offset - text_found = 1 - elif not text_found: - start = offset + 1 - offset += 1 - - def parse_columns(self, line, offset): - """ - Given a column span underline, return a list of (begin, end) pairs. - """ - cols = [] - end = 0 - while 1: - begin = line.find('-', end) - end = line.find(' ', begin) - if begin < 0: - break - if end < 0: - end = len(line) - cols.append((begin, end)) - if self.columns: - if cols[-1][1] != self.border_end: - raise TableMarkupError('Column span incomplete at line ' - 'offset %s.' % offset) - # Allow for an unbounded rightmost column: - cols[-1] = (cols[-1][0], self.columns[-1][1]) - return cols - - def init_row(self, colspec, offset): - i = 0 - cells = [] - for start, end in colspec: - morecols = 0 - try: - assert start == self.columns[i][0] - while end != self.columns[i][1]: - i += 1 - morecols += 1 - except (AssertionError, IndexError): - raise TableMarkupError('Column span alignment problem at ' - 'line offset %s.' % (offset + 1)) - cells.append([0, morecols, offset, []]) - i += 1 - return cells - - def parse_row(self, lines, start, spanline=None): - """ - Given the text `lines` of a row, parse it and append to `self.table`. - - The row is parsed according to the current column spec (either - `spanline` if provided or `self.columns`). For each column, extract - text from each line, and check for text in column margins. Finally, - adjust for insigificant whitespace. - """ - if not (lines or spanline): - # No new row, just blank lines. - return - if spanline: - columns = self.parse_columns(spanline) - span_offset = spanline[1] - else: - columns = self.columns[:] - span_offset = start - self.check_columns(lines, start, columns) - row = self.init_row(columns, start) - for i in range(len(columns)): - start, end = columns[i] - cellblock = lines.get_2D_block(0, start, len(lines), end) - cellblock.disconnect() # lines in cell can't sync with parent - cellblock.replace(self.double_width_pad_char, '') - row[i][3] = cellblock - self.table.append(row) - - def check_columns(self, lines, first_line, columns): - """ - Check for text in column margins and text overflow in the last column. - Raise TableMarkupError if anything but whitespace is in column margins. - Adjust the end value for the last column if there is text overflow. - """ - # "Infinite" value for a dummy last column's beginning, used to - # check for text overflow: - columns.append((sys.maxint, None)) - lastcol = len(columns) - 2 - for i in range(len(columns) - 1): - start, end = columns[i] - nextstart = columns[i+1][0] - offset = 0 - for line in lines: - if i == lastcol and line[end:].strip(): - text = line[start:].rstrip() - new_end = start + len(text) - columns[i] = (start, new_end) - main_start, main_end = self.columns[-1] - if new_end > main_end: - self.columns[-1] = (main_start, new_end) - elif line[end:nextstart].strip(): - raise TableMarkupError('Text in column margin at line ' - 'offset %s.' % (first_line + offset)) - offset += 1 - columns.pop() - - def structure_from_cells(self): - colspecs = [end - start for start, end in self.columns] - first_body_row = 0 - if self.head_body_sep: - for i in range(len(self.table)): - if self.table[i][0][2] > self.head_body_sep: - first_body_row = i - break - return (colspecs, self.table[:first_body_row], - self.table[first_body_row:]) - - -def update_dict_of_lists(master, newdata): - """ - Extend the list values of `master` with those from `newdata`. - - Both parameters must be dictionaries containing list values. - """ - for key, values in newdata.items(): - master.setdefault(key, []).extend(values) diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/readers/init.py --- a/buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/readers/init.py Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,107 +0,0 @@ -# $Id: init.py 4974 2007-03-01 18:06:52Z wiemann $ -# Authors: David Goodger ; Ueli Schlaepfer -# Copyright: This module has been placed in the public domain. - -""" -This package contains Docutils Reader modules. -""" - -docformat = 'reStructuredText' - - -from docutils import utils, parsers, Component -from docutils.transforms import universal - - -class Reader(Component): - - """ - Abstract base class for docutils Readers. - - Each reader module or package must export a subclass also called 'Reader'. - - The two steps of a Reader's responsibility are `scan()` and - `parse()`. Call `read()` to process a document. - """ - - component_type = 'reader' - config_section = 'readers' - - def get_transforms(self): - return Component.get_transforms(self) + [ - universal.Decorations, - universal.ExposeInternals, - universal.StripComments,] - - def init(self, parser=None, parser_name=None): - """ - Initialize the Reader instance. - - Several instance attributes are defined with dummy initial values. - Subclasses may use these attributes as they wish. - """ - - self.parser = parser - """A `parsers.Parser` instance shared by all doctrees. May be left - unspecified if the document source determines the parser.""" - - if parser is None and parser_name: - self.set_parser(parser_name) - - self.source = None - """`docutils.io` IO object, source of input data.""" - - self.input = None - """Raw text input; either a single string or, for more complex cases, - a collection of strings.""" - - def set_parser(self, parser_name): - """Set `self.parser` by name.""" - parser_class = parsers.get_parser_class(parser_name) - self.parser = parser_class() - - def read(self, source, parser, settings): - self.source = source - if not self.parser: - self.parser = parser - self.settings = settings - self.input = self.source.read() - self.parse() - return self.document - - def parse(self): - """Parse `self.input` into a document tree.""" - self.document = document = self.new_document() - self.parser.parse(self.input, document) - document.current_source = document.current_line = None - - def new_document(self): - """Create and return a new empty document tree (root node).""" - document = utils.new_document(self.source.source_path, self.settings) - return document - - -class ReReader(Reader): - - """ - A reader which rereads an existing document tree (e.g. a - deserializer). - - Often used in conjunction with `writers.UnfilteredWriter`. - """ - - def get_transforms(self): - # Do not add any transforms. They have already been applied - # by the reader which originally created the document. - return Component.get_transforms(self) - - -_reader_aliases = {} - -def get_reader_class(reader_name): - """Return the Reader class from the `reader_name` module.""" - reader_name = reader_name.lower() - if _reader_aliases.has_key(reader_name): - reader_name = _reader_aliases[reader_name] - module = import(reader_name, globals(), locals()) - return module.Reader diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/readers/doctree.py --- a/buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/readers/doctree.py Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,46 +0,0 @@ -# $Id: doctree.py 4564 2006-05-21 20:44:42Z wiemann $ -# Author: Martin Blais -# Copyright: This module has been placed in the public domain. - -"""Reader for existing document trees.""" - -from docutils import readers, utils, transforms - - -class Reader(readers.ReReader): - - """ - Adapt the Reader API for an existing document tree. - - The existing document tree must be passed as the ``source`` parameter to - the `docutils.core.Publisher` initializer, wrapped in a - `docutils.io.DocTreeInput` object:: - - pub = docutils.core.Publisher( - ..., source=docutils.io.DocTreeInput(document), ...) - - The original document settings are overridden; if you want to use the - settings of the original document, pass ``settings=document.settings`` to - the Publisher call above. - """ - - supported = ('doctree',) - - config_section = 'doctree reader' - config_section_dependencies = ('readers',) - - def parse(self): - """ - No parsing to do; refurbish the document tree instead. - Overrides the inherited method. - """ - self.document = self.input - # Create fresh Transformer object, to be populated from Writer - # component. - self.document.transformer = transforms.Transformer(self.document) - # Replace existing settings object with new one. - self.document.settings = self.settings - # Create fresh Reporter object because it is dependent on - # (new) settings. - self.document.reporter = utils.new_reporter( - self.document.get('source', ''), self.document.settings) diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/readers/pep.py --- a/buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/readers/pep.py Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,48 +0,0 @@ -# $Id: pep.py 4564 2006-05-21 20:44:42Z wiemann $ -# Author: David Goodger -# Copyright: This module has been placed in the public domain. - -""" -Python Enhancement Proposal (PEP) Reader. -""" - -docformat = 'reStructuredText' - - -from docutils.readers import standalone -from docutils.transforms import peps, references, misc, frontmatter -from docutils.parsers import rst - - -class Reader(standalone.Reader): - - supported = ('pep',) - """Contexts this reader supports.""" - - settings_spec = ( - 'PEP Reader Option Defaults', - 'The --pep-references and --rfc-references options (for the ' - 'reStructuredText parser) are on by default.', - ()) - - config_section = 'pep reader' - config_section_dependencies = ('readers', 'standalone reader') - - def get_transforms(self): - transforms = standalone.Reader.get_transforms(self) - # We have PEP-specific frontmatter handling. - transforms.remove(frontmatter.DocTitle) - transforms.remove(frontmatter.SectionSubTitle) - transforms.remove(frontmatter.DocInfo) - transforms.extend([peps.Headers, peps.Contents, peps.TargetNotes]) - return transforms - - settings_default_overrides = {'pep_references': 1, 'rfc_references': 1} - - inliner_class = rst.states.Inliner - - def init(self, parser=None, parser_name=None): - """`parser` should be ``None``.""" - if parser is None: - parser = rst.Parser(rfc2822=1, inliner=self.inliner_class()) - standalone.Reader.init(self, parser, '') diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/readers/python/init.py --- a/buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/readers/python/init.py Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,127 +0,0 @@ -# $Id: init.py 4813 2006-11-13 03:41:08Z wiemann $ -# Author: David Goodger -# Copyright: This module has been placed in the public domain. - -""" -This package contains the Python Source Reader modules. -""" - -docformat = 'reStructuredText' - - -import sys -import docutils.readers -from docutils.readers.python import moduleparser -from docutils import parsers -from docutils import nodes -from docutils.readers.python import pynodes -from docutils import readers - -class Reader(docutils.readers.Reader): - - config_section = 'python reader' - config_section_dependencies = ('readers',) - - default_parser = 'restructuredtext' - - def parse(self): - """Parse `self.input` into a document tree.""" - self.document = document = self.new_document() - module_section = moduleparser.parse_module(self.input, - self.source.source_path) - module_section.walk(DocformatVisitor(self.document)) - visitor = DocstringFormattingVisitor( - document=document, - default_parser=self.default_parser) - module_section.walk(visitor) - self.document.append(module_section) - - -class DocformatVisitor(nodes.SparseNodeVisitor): - - """ - This sets docformat attributes in a module. Wherever an assignment - to docformat is found, we look for the enclosing scope -- a class, - a module, or a function -- and set the docformat attribute there. - - We can't do this during the DocstringFormattingVisitor walking, - because docformat may appear below a docstring in that format - (typically below the module docstring). - """ - - def visit_attribute(self, node): - assert isinstance(node[0], pynodes.object_name) - name = node[0][0].data - if name != 'docformat': - return - value = None - for child in children: - if isinstance(child, pynodes.expression_value): - value = child[0].data - break - assert value.startswith("'") or value.startswith('"'), "docformat must be assigned a string literal (not %s); line: %s" % (value, node['lineno']) - name = name[1:-1] - looking_in = node.parent - while not isinstance(looking_in, (pynodes.module_section, - pynodes.function_section, - pynodes.class_section)): - looking_in = looking_in.parent - looking_in['docformat'] = name - - -class DocstringFormattingVisitor(nodes.SparseNodeVisitor): - - def init(self, document, default_parser): - self.document = document - self.default_parser = default_parser - self.parsers = {} - - def visit_docstring(self, node): - text = node[0].data - docformat = self.find_docformat(node) - del node[0] - node['docformat'] = docformat - parser = self.get_parser(docformat) - parser.parse(text, self.document) - for child in self.document.children: - node.append(child) - self.document.current_source = self.document.current_line = None - del self.document[:] - - def get_parser(self, parser_name): - """ - Get a parser based on its name. We reuse parsers during this - visitation, so parser instances are cached. - """ - parser_name = parsers._parser_aliases.get(parser_name, parser_name) - if not self.parsers.has_key(parser_name): - cls = parsers.get_parser_class(parser_name) - self.parsers[parser_name] = cls() - return self.parsers[parser_name] - - def find_docformat(self, node): - """ - Find the docformat closest to this node (i.e., look in the - class or module) - """ - while node: - if node.get('docformat'): - return node['docformat'] - node = node.parent - return self.default_parser - - -if name == 'main': - try: - import locale - locale.setlocale(locale.LC_ALL, '') - except: - pass - - from docutils.core import publish_cmdline, default_description - - description = ('Generates pseudo-XML from Python modules ' - '(for testing purposes). ' + default_description) - - publish_cmdline(description=description, - reader=Reader()) diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/readers/python/moduleparser.py --- a/buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/readers/python/moduleparser.py Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,758 +0,0 @@ -# $Id: moduleparser.py 4813 2006-11-13 03:41:08Z wiemann $ -# Author: David Goodger -# Copyright: This module has been placed in the public domain. - -""" -Parser for Python modules. - -The `parse_module()` function takes a module's text and file name, -runs it through the module parser (using compiler.py and tokenize.py) -and produces a parse tree of the source code, using the nodes as found -in pynodes.py. For example, given this module (x.py):: - - # comment - - '''Docstring''' - - '''Additional docstring''' - - docformat = 'reStructuredText' - - a = 1 - '''Attribute docstring''' - - class C(Super): - - '''C's docstring''' - - class_attribute = 1 - '''class_attribute's docstring''' - - def init(self, text=None): - '''init's docstring''' - - self.instance_attribute = (text 7 - + ' whaddyaknow') - '''instance_attribute's docstring''' - - - def f(x, # parameter x - y=a5, # parameter y - args): # parameter args - '''f's docstring''' - return [x + item for item in args] - - f.function_attribute = 1 - '''f.function_attribute's docstring''' - -The module parser will produce this module documentation tree:: - - - - Docstring - - Additional docstring - - - docformat - - 'reStructuredText' - - - a - - 1 - - Attribute docstring - - - C - - Super - - C's docstring - - - class_attribute - - 1 - - class_attribute's docstring - - - init - - init's docstring - - - - self - - - text - - None - - - self.instance_attribute - - (text * 7 + ' whaddyaknow') - - instance_attribute's docstring - - - f - - f's docstring - - - - x - - # parameter x - - - y - - a * 5 - - # parameter y - - - args - - # parameter args - - - f.function_attribute - - 1 - - f.function_attribute's docstring - -(Comments are not implemented yet.) - -compiler.parse() provides most of what's needed for this doctree, and -"tokenize" can be used to get the rest. We can determine the line -number from the compiler.parse() AST, and the TokenParser.rhs(lineno) -method provides the rest. - -The Docutils Python reader component will transform this module doctree into a -Python-specific Docutils doctree, and then a "stylist transform" will -further transform it into a generic doctree. Namespaces will have to be -compiled for each of the scopes, but I'm not certain at what stage of -processing. - -It's very important to keep all docstring processing out of this, so that it's -a completely generic and not tool-specific. - -:: - -> Why perform all of those transformations? Why not go from the AST to a -> generic doctree? Or, even from the AST to the final output? - -I want the docutils.readers.python.moduleparser.parse_module() function to -produce a standard documentation-oriented tree that can be used by any tool. -We can develop it together without having to compromise on the rest of our -design (i.e., HappyDoc doesn't have to be made to work like Docutils, and -vice-versa). It would be a higher-level version of what compiler.py provides. - -The Python reader component transforms this generic AST into a Python-specific -doctree (it knows about modules, classes, functions, etc.), but this is -specific to Docutils and cannot be used by HappyDoc or others. The stylist -transform does the final layout, converting Python-specific structures -("class" sections, etc.) into a generic doctree using primitives (tables, -sections, lists, etc.). This generic doctree does not know about Python -structures any more. The advantage is that this doctree can be handed off to -any of the output writers to create any output format we like. - -The latter two transforms are separate because I want to be able to have -multiple independent layout styles (multiple runtime-selectable "stylist -transforms"). Each of the existing tools (HappyDoc, pydoc, epydoc, Crystal, -etc.) has its own fixed format. I personally don't like the tables-based -format produced by these tools, and I'd like to be able to customize the -format easily. That's the goal of stylist transforms, which are independent -from the Reader component itself. One stylist transform could produce -HappyDoc-like output, another could produce output similar to module docs in -the Python library reference manual, and so on. - -It's for exactly this reason:: - ->> It's very important to keep all docstring processing out of this, so that ->> it's a completely generic and not tool-specific. - -... but it goes past docstring processing. It's also important to keep style -decisions and tool-specific data transforms out of this module parser. - - -Issues -====== - -* At what point should namespaces be computed? Should they be part of the - basic AST produced by the ASTVisitor walk, or generated by another tree - traversal? - -* At what point should a distinction be made between local variables & - instance attributes in init methods? - -* Docstrings are getting their lineno from their parents. Should the - TokenParser find the real line no's? - -* Comments: include them? How and when? Only full-line comments, or - parameter comments too? (See function "f" above for an example.) - -* Module could use more docstrings & refactoring in places. - -""" - -docformat = 'reStructuredText' - -import sys -import compiler -import compiler.ast -import tokenize -import token -from compiler.consts import OP_ASSIGN -from compiler.visitor import ASTVisitor -from types import StringType, UnicodeType, TupleType -from docutils.readers.python import pynodes -from docutils.nodes import Text - - -def parse_module(module_text, filename): - """Return a module documentation tree from `module_text`.""" - ast = compiler.parse(module_text) - token_parser = TokenParser(module_text) - visitor = ModuleVisitor(filename, token_parser) - compiler.walk(ast, visitor, walker=visitor) - return visitor.module - -class BaseVisitor(ASTVisitor): - - def init(self, token_parser): - ASTVisitor.init(self) - self.token_parser = token_parser - self.context = [] - self.documentable = None - - def default(self, node, args): - self.documentable = None - #print 'in default (%s)' % node.class.name - #ASTVisitor.default(self, node, args) - - def default_visit(self, node, args): - #print 'in default_visit (%s)' % node.class.name - ASTVisitor.default(self, node, args) - - -class DocstringVisitor(BaseVisitor): - - def visitDiscard(self, node): - if self.documentable: - self.visit(node.expr) - - def visitConst(self, node): - if self.documentable: - if type(node.value) in (StringType, UnicodeType): - self.documentable.append(make_docstring(node.value, node.lineno)) - else: - self.documentable = None - - def visitStmt(self, node): - self.default_visit(node) - - -class AssignmentVisitor(DocstringVisitor): - - def visitAssign(self, node): - visitor = AttributeVisitor(self.token_parser) - compiler.walk(node, visitor, walker=visitor) - if visitor.attributes: - self.context[-1].extend(visitor.attributes) - if len(visitor.attributes) == 1: - self.documentable = visitor.attributes[0] - else: - self.documentable = None - - -class ModuleVisitor(AssignmentVisitor): - - def init(self, filename, token_parser): - AssignmentVisitor.init(self, token_parser) - self.filename = filename - self.module = None - - def visitModule(self, node): - self.module = module = pynodes.module_section() - module['filename'] = self.filename - append_docstring(module, node.doc, node.lineno) - self.context.append(module) - self.documentable = module - self.visit(node.node) - self.context.pop() - - def visitImport(self, node): - self.context[-1] += make_import_group(names=node.names, - lineno=node.lineno) - self.documentable = None - - def visitFrom(self, node): - self.context[-1].append( - make_import_group(names=node.names, from_name=node.modname, - lineno=node.lineno)) - self.documentable = None - - def visitFunction(self, node): - visitor = FunctionVisitor(self.token_parser, - function_class=pynodes.function_section) - compiler.walk(node, visitor, walker=visitor) - self.context[-1].append(visitor.function) - - def visitClass(self, node): - visitor = ClassVisitor(self.token_parser) - compiler.walk(node, visitor, walker=visitor) - self.context[-1].append(visitor.klass) - - -class AttributeVisitor(BaseVisitor): - - def init(self, token_parser): - BaseVisitor.init(self, token_parser) - self.attributes = pynodes.class_attribute_section() - - def visitAssign(self, node): - # Don't visit the expression itself, just the attribute nodes: - for child in node.nodes: - self.dispatch(child) - expression_text = self.token_parser.rhs(node.lineno) - expression = pynodes.expression_value() - expression.append(Text(expression_text)) - for attribute in self.attributes: - attribute.append(expression) - - def visitAssName(self, node): - self.attributes.append(make_attribute(node.name, - lineno=node.lineno)) - - def visitAssTuple(self, node): - attributes = self.attributes - self.attributes = [] - self.default_visit(node) - n = pynodes.attribute_tuple() - n.extend(self.attributes) - n['lineno'] = self.attributes[0]['lineno'] - attributes.append(n) - self.attributes = attributes - #self.attributes.append(att_tuple) - - def visitAssAttr(self, node): - self.default_visit(node, node.attrname) - - def visitGetattr(self, node, suffix): - self.default_visit(node, node.attrname + '.' + suffix) - - def visitName(self, node, suffix): - self.attributes.append(make_attribute(node.name + '.' + suffix, - lineno=node.lineno)) - - -class FunctionVisitor(DocstringVisitor): - - in_function = 0 - - def init(self, token_parser, function_class): - DocstringVisitor.init(self, token_parser) - self.function_class = function_class - - def visitFunction(self, node): - if self.in_function: - self.documentable = None - # Don't bother with nested function definitions. - return - self.in_function = 1 - self.function = function = make_function_like_section( - name=node.name, - lineno=node.lineno, - doc=node.doc, - function_class=self.function_class) - self.context.append(function) - self.documentable = function - self.parse_parameter_list(node) - self.visit(node.code) - self.context.pop() - - def parse_parameter_list(self, node): - parameters = [] - special = [] - argnames = list(node.argnames) - if node.kwargs: - special.append(make_parameter(argnames[-1], excess_keyword=1)) - argnames.pop() - if node.varargs: - special.append(make_parameter(argnames[-1], - excess_positional=1)) - argnames.pop() - defaults = list(node.defaults) - defaults = [None] * (len(argnames) - len(defaults)) + defaults - function_parameters = self.token_parser.function_parameters( - node.lineno) - #print >>sys.stderr, function_parameters - for argname, default in zip(argnames, defaults): - if type(argname) is TupleType: - parameter = pynodes.parameter_tuple() - for tuplearg in argname: - parameter.append(make_parameter(tuplearg)) - argname = normalize_parameter_name(argname) - else: - parameter = make_parameter(argname) - if default: - n_default = pynodes.parameter_default() - n_default.append(Text(function_parameters[argname])) - parameter.append(n_default) - parameters.append(parameter) - if parameters or special: - special.reverse() - parameters.extend(special) - parameter_list = pynodes.parameter_list() - parameter_list.extend(parameters) - self.function.append(parameter_list) - - -class ClassVisitor(AssignmentVisitor): - - in_class = 0 - - def init(self, token_parser): - AssignmentVisitor.init(self, token_parser) - self.bases = [] - - def visitClass(self, node): - if self.in_class: - self.documentable = None - # Don't bother with nested class definitions. - return - self.in_class = 1 - #import mypdb as pdb - #pdb.set_trace() - for base in node.bases: - self.visit(base) - self.klass = klass = make_class_section(node.name, self.bases, - doc=node.doc, - lineno=node.lineno) - self.context.append(klass) - self.documentable = klass - self.visit(node.code) - self.context.pop() - - def visitGetattr(self, node, suffix=None): - if suffix: - name = node.attrname + '.' + suffix - else: - name = node.attrname - self.default_visit(node, name) - - def visitName(self, node, suffix=None): - if suffix: - name = node.name + '.' + suffix - else: - name = node.name - self.bases.append(name) - - def visitFunction(self, node): - if node.name == 'init': - visitor = InitMethodVisitor(self.token_parser, - function_class=pynodes.method_section) - compiler.walk(node, visitor, walker=visitor) - else: - visitor = FunctionVisitor(self.token_parser, - function_class=pynodes.method_section) - compiler.walk(node, visitor, walker=visitor) - self.context[-1].append(visitor.function) - - -class InitMethodVisitor(FunctionVisitor, AssignmentVisitor): pass - - -class TokenParser: - - def init(self, text): - self.text = text + '\n\n' - self.lines = self.text.splitlines(1) - self.generator = tokenize.generate_tokens(iter(self.lines).next) - self.next() - - def iter(self): - return self - - def next(self): - self.token = self.generator.next() - self.type, self.string, self.start, self.end, self.line = self.token - return self.token - - def goto_line(self, lineno): - while self.start[0] < lineno: - self.next() - return token - - def rhs(self, lineno): - """ - Return a whitespace-normalized expression string from the right-hand - side of an assignment at line `lineno`. - """ - self.goto_line(lineno) - while self.string != '=': - self.next() - self.stack = None - while self.type != token.NEWLINE and self.string != ';': - if self.string == '=' and not self.stack: - self.tokens = [] - self.stack = [] - self._type = None - self._string = None - self._backquote = 0 - else: - self.note_token() - self.next() - self.next() - text = ''.join(self.tokens) - return text.strip() - - closers = {')': '(', ']': '[', '}': '{'} - openers = {'(': 1, '[': 1, '{': 1} - del_ws_prefix = {'.': 1, '=': 1, ')': 1, ']': 1, '}': 1, ':': 1, ',': 1} - no_ws_suffix = {'.': 1, '=': 1, '(': 1, '[': 1, '{': 1} - - def note_token(self): - if self.type == tokenize.NL: - return - del_ws = self.del_ws_prefix.has_key(self.string) - append_ws = not self.no_ws_suffix.has_key(self.string) - if self.openers.has_key(self.string): - self.stack.append(self.string) - if (self._type == token.NAME - or self.closers.has_key(self._string)): - del_ws = 1 - elif self.closers.has_key(self.string): - assert self.stack[-1] == self.closers[self.string] - self.stack.pop() - elif self.string == '`': - if self._backquote: - del_ws = 1 - assert self.stack[-1] == '`' - self.stack.pop() - else: - append_ws = 0 - self.stack.append('`') - self._backquote = not self._backquote - if del_ws and self.tokens and self.tokens[-1] == ' ': - del self.tokens[-1] - self.tokens.append(self.string) - self._type = self.type - self._string = self.string - if append_ws: - self.tokens.append(' ') - - def function_parameters(self, lineno): - """ - Return a dictionary mapping parameters to defaults - (whitespace-normalized strings). - """ - self.goto_line(lineno) - while self.string != 'def': - self.next() - while self.string != '(': - self.next() - name = None - default = None - parameter_tuple = None - self.tokens = [] - parameters = {} - self.stack = [self.string] - self.next() - while 1: - if len(self.stack) == 1: - if parameter_tuple: - # Just encountered ")". - #print >>sys.stderr, 'parameter_tuple: %r' % self.tokens - name = ''.join(self.tokens).strip() - self.tokens = [] - parameter_tuple = None - if self.string in (')', ','): - if name: - if self.tokens: - default_text = ''.join(self.tokens).strip() - else: - default_text = None - parameters[name] = default_text - self.tokens = [] - name = None - default = None - if self.string == ')': - break - elif self.type == token.NAME: - if name and default: - self.note_token() - else: - assert name is None, ( - 'token=%r name=%r parameters=%r stack=%r' - % (self.token, name, parameters, self.stack)) - name = self.string - #print >>sys.stderr, 'name=%r' % name - elif self.string == '=': - assert name is not None, 'token=%r' % (self.token,) - assert default is None, 'token=%r' % (self.token,) - assert self.tokens == [], 'token=%r' % (self.token,) - default = 1 - self._type = None - self._string = None - self._backquote = 0 - elif name: - self.note_token() - elif self.string == '(': - parameter_tuple = 1 - self._type = None - self._string = None - self._backquote = 0 - self.note_token() - else: # ignore these tokens: - assert (self.string in ('*', '**', '\n') - or self.type == tokenize.COMMENT), ( - 'token=%r' % (self.token,)) - else: - self.note_token() - self.next() - return parameters - - -def make_docstring(doc, lineno): - n = pynodes.docstring() - if lineno: - # Really, only module docstrings don't have a line - # (@@: but maybe they should) - n['lineno'] = lineno - n.append(Text(doc)) - return n - -def append_docstring(node, doc, lineno): - if doc: - node.append(make_docstring(doc, lineno)) - -def make_class_section(name, bases, lineno, doc): - n = pynodes.class_section() - n['lineno'] = lineno - n.append(make_object_name(name)) - for base in bases: - b = pynodes.class_base() - b.append(make_object_name(base)) - n.append(b) - append_docstring(n, doc, lineno) - return n - -def make_object_name(name): - n = pynodes.object_name() - n.append(Text(name)) - return n - -def make_function_like_section(name, lineno, doc, function_class): - n = function_class() - n['lineno'] = lineno - n.append(make_object_name(name)) - append_docstring(n, doc, lineno) - return n - -def make_import_group(names, lineno, from_name=None): - n = pynodes.import_group() - n['lineno'] = lineno - if from_name: - n_from = pynodes.import_from() - n_from.append(Text(from_name)) - n.append(n_from) - for name, alias in names: - n_name = pynodes.import_name() - n_name.append(Text(name)) - if alias: - n_alias = pynodes.import_alias() - n_alias.append(Text(alias)) - n_name.append(n_alias) - n.append(n_name) - return n - -def make_class_attribute(name, lineno): - n = pynodes.class_attribute() - n['lineno'] = lineno - n.append(Text(name)) - return n - -def make_attribute(name, lineno): - n = pynodes.attribute() - n['lineno'] = lineno - n.append(make_object_name(name)) - return n - -def make_parameter(name, excess_keyword=0, excess_positional=0): - """ - excess_keyword and excess_positional must be either 1 or 0, and - not both of them can be 1. - """ - n = pynodes.parameter() - n.append(make_object_name(name)) - assert not excess_keyword or not excess_positional - if excess_keyword: - n['excess_keyword'] = 1 - if excess_positional: - n['excess_positional'] = 1 - return n - -def trim_docstring(text): - """ - Trim indentation and blank lines from docstring text & return it. - - See PEP 257. - """ - if not text: - return text - # Convert tabs to spaces (following the normal Python rules) - # and split into a list of lines: - lines = text.expandtabs().splitlines() - # Determine minimum indentation (first line doesn't count): - indent = sys.maxint - for line in lines[1:]: - stripped = line.lstrip() - if stripped: - indent = min(indent, len(line) - len(stripped)) - # Remove indentation (first line is special): - trimmed = [lines[0].strip()] - if indent < sys.maxint: - for line in lines[1:]: - trimmed.append(line[indent:].rstrip()) - # Strip off trailing and leading blank lines: - while trimmed and not trimmed[-1]: - trimmed.pop() - while trimmed and not trimmed[0]: - trimmed.pop(0) - # Return a single string: - return '\n'.join(trimmed) - -def normalize_parameter_name(name): - """ - Converts a tuple like ``('a', ('b', 'c'), 'd')`` into ``'(a, (b, c), d)'`` - """ - if type(name) is TupleType: - return '(%s)' % ', '.join([normalize_parameter_name(n) for n in name]) - else: - return name - -if name == 'main': - import sys - args = sys.argv[1:] - if args[0] == '-v': - filename = args[1] - module_text = open(filename).read() - ast = compiler.parse(module_text) - visitor = compiler.visitor.ExampleASTVisitor() - compiler.walk(ast, visitor, walker=visitor, verbose=1) - else: - filename = args[0] - content = open(filename).read() - print parse_module(content, filename).pformat() - diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/readers/python/pynodes.py --- a/buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/readers/python/pynodes.py Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,81 +0,0 @@ -#! /usr/bin/env python -# $Id: pynodes.py 4564 2006-05-21 20:44:42Z wiemann $ -# Author: David Goodger -# Copyright: This module has been placed in the public domain. - -from docutils import nodes -from docutils.nodes import Element, TextElement, Structural, Inline, Part, \ - Text -import types - -# This is the parent class of all the other pynode classes: -class PythonStructural(Structural): pass - -# ===================== -# Structural Elements -# ===================== - -class module_section(PythonStructural, Element): pass -class class_section(PythonStructural, Element): pass -class class_base(PythonStructural, Element): pass -class method_section(PythonStructural, Element): pass -class attribute(PythonStructural, Element): pass -class function_section(PythonStructural, Element): pass -class class_attribute_section(PythonStructural, Element): pass -class class_attribute(PythonStructural, Element): pass -class expression_value(PythonStructural, Element): pass -class attribute(PythonStructural, Element): pass - -# Structural Support Elements -# --------------------------- - -class parameter_list(PythonStructural, Element): pass -class parameter_tuple(PythonStructural, Element): pass -class parameter_default(PythonStructural, TextElement): pass -class import_group(PythonStructural, TextElement): pass -class import_from(PythonStructural, TextElement): pass -class import_name(PythonStructural, TextElement): pass -class import_alias(PythonStructural, TextElement): pass -class docstring(PythonStructural, Element): pass - -# ================= -# Inline Elements -# ================= - -# These elements cannot become references until the second -# pass. Initially, we'll use "reference" or "name". - -class object_name(PythonStructural, TextElement): pass -class parameter_list(PythonStructural, TextElement): pass -class parameter(PythonStructural, TextElement): pass -class parameter_default(PythonStructural, TextElement): pass -class class_attribute(PythonStructural, TextElement): pass -class attribute_tuple(PythonStructural, TextElement): pass - -# ================= -# Unused Elements -# ================= - -# These were part of the model, and maybe should be in the future, but -# aren't now. -#class package_section(PythonStructural, Element): pass -#class module_attribute_section(PythonStructural, Element): pass -#class instance_attribute_section(PythonStructural, Element): pass -#class module_attribute(PythonStructural, TextElement): pass -#class instance_attribute(PythonStructural, TextElement): pass -#class exception_class(PythonStructural, TextElement): pass -#class warning_class(PythonStructural, TextElement): pass - - -# Collect all the classes we've written above -def install_node_class_names(): - node_class_names = [] - for name, var in globals().items(): - if (type(var) is types.ClassType - and issubclass(var, PythonStructural) \ - and name.lower() == name): - node_class_names.append(var.tagname or name) - # Register the new node names with GenericNodeVisitor and - # SpecificNodeVisitor: - nodes._add_node_class_names(node_class_names) -install_node_class_names() diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/readers/standalone.py --- a/buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/readers/standalone.py Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,66 +0,0 @@ -# $Id: standalone.py 4802 2006-11-12 18:02:17Z goodger $ -# Author: David Goodger -# Copyright: This module has been placed in the public domain. - -""" -Standalone file Reader for the reStructuredText markup syntax. -""" - -docformat = 'reStructuredText' - - -import sys -from docutils import frontend, readers -from docutils.transforms import frontmatter, references, misc - - -class Reader(readers.Reader): - - supported = ('standalone',) - """Contexts this reader supports.""" - - document = None - """A single document tree.""" - - settings_spec = ( - 'Standalone Reader', - None, - (('Disable the promotion of a lone top-level section title to ' - 'document title (and subsequent section title to document ' - 'subtitle promotion; enabled by default).', - ['--no-doc-title'], - {'dest': 'doctitle_xform', 'action': 'store_false', 'default': 1, - 'validator': frontend.validate_boolean}), - ('Disable the bibliographic field list transform (enabled by ' - 'default).', - ['--no-doc-info'], - {'dest': 'docinfo_xform', 'action': 'store_false', 'default': 1, - 'validator': frontend.validate_boolean}), - ('Activate the promotion of lone subsection titles to ' - 'section subtitles (disabled by default).', - ['--section-subtitles'], - {'dest': 'sectsubtitle_xform', 'action': 'store_true', 'default': 0, - 'validator': frontend.validate_boolean}), - ('Deactivate the promotion of lone subsection titles.', - ['--no-section-subtitles'], - {'dest': 'sectsubtitle_xform', 'action': 'store_false'}), - )) - - config_section = 'standalone reader' - config_section_dependencies = ('readers',) - - def get_transforms(self): - return readers.Reader.get_transforms(self) + [ - references.Substitutions, - references.PropagateTargets, - frontmatter.DocTitle, - frontmatter.SectionSubTitle, - frontmatter.DocInfo, - references.AnonymousHyperlinks, - references.IndirectHyperlinks, - references.Footnotes, - references.ExternalTargets, - references.InternalTargets, - references.DanglingReferences, - misc.Transitions, - ] diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/statemachine.py --- a/buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/statemachine.py Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,1490 +0,0 @@ -# $Id: statemachine.py 4564 2006-05-21 20:44:42Z wiemann $ -# Author: David Goodger -# Copyright: This module has been placed in the public domain. - -""" -A finite state machine specialized for regular-expression-based text filters, -this module defines the following classes: - -- `StateMachine`, a state machine -- `State`, a state superclass -- `StateMachineWS`, a whitespace-sensitive version of `StateMachine` -- `StateWS`, a state superclass for use with `StateMachineWS` -- `SearchStateMachine`, uses `re.search()` instead of `re.match()` -- `SearchStateMachineWS`, uses `re.search()` instead of `re.match()` -- `ViewList`, extends standard Python lists. -- `StringList`, string-specific ViewList. - -Exception classes: - -- `StateMachineError` -- `UnknownStateError` -- `DuplicateStateError` -- `UnknownTransitionError` -- `DuplicateTransitionError` -- `TransitionPatternNotFound` -- `TransitionMethodNotFound` -- `UnexpectedIndentationError` -- `TransitionCorrection`: Raised to switch to another transition. -- `StateCorrection`: Raised to switch to another state & transition. - -Functions: - -- `string2lines()`: split a multi-line string into a list of one-line strings - - -How To Use This Module -====================== -(See the individual classes, methods, and attributes for details.) - -1. Import it: ``import statemachine`` or ``from statemachine import ...``. - You will also need to ``import re``. - -2. Derive a subclass of `State` (or `StateWS`) for each state in your state - machine:: - - class MyState(statemachine.State): - - Within the state's class definition: - - a) Include a pattern for each transition, in `State.patterns`:: - - patterns = {'atransition': r'pattern', ...} - - b) Include a list of initial transitions to be set up automatically, in - `State.initial_transitions`:: - - initial_transitions = ['atransition', ...] - - c) Define a method for each transition, with the same name as the - transition pattern:: - - def atransition(self, match, context, next_state): - # do something - result = [...] # a list - return context, next_state, result - # context, next_state may be altered - - Transition methods may raise an `EOFError` to cut processing short. - - d) You may wish to override the `State.bof()` and/or `State.eof()` implicit - transition methods, which handle the beginning- and end-of-file. - - e) In order to handle nested processing, you may wish to override the - attributes `State.nested_sm` and/or `State.nested_sm_kwargs`. - - If you are using `StateWS` as a base class, in order to handle nested - indented blocks, you may wish to: - - - override the attributes `StateWS.indent_sm`, - `StateWS.indent_sm_kwargs`, `StateWS.known_indent_sm`, and/or - `StateWS.known_indent_sm_kwargs`; - - override the `StateWS.blank()` method; and/or - - override or extend the `StateWS.indent()`, `StateWS.known_indent()`, - and/or `StateWS.firstknown_indent()` methods. - -3. Create a state machine object:: - - sm = StateMachine(state_classes=[MyState, ...], - initial_state='MyState') - -4. Obtain the input text, which needs to be converted into a tab-free list of - one-line strings. For example, to read text from a file called - 'inputfile':: - - input_string = open('inputfile').read() - input_lines = statemachine.string2lines(input_string) - -5. Run the state machine on the input text and collect the results, a list:: - - results = sm.run(input_lines) - -6. Remove any lingering circular references:: - - sm.unlink() -""" - -docformat = 'restructuredtext' - -import sys -import re -import types -import unicodedata - - -class StateMachine: - - """ - A finite state machine for text filters using regular expressions. - - The input is provided in the form of a list of one-line strings (no - newlines). States are subclasses of the `State` class. Transitions consist - of regular expression patterns and transition methods, and are defined in - each state. - - The state machine is started with the `run()` method, which returns the - results of processing in a list. - """ - - def init(self, state_classes, initial_state, debug=0): - """ - Initialize a `StateMachine` object; add state objects. - - Parameters: - - - `state_classes`: a list of `State` (sub)classes. - - `initial_state`: a string, the class name of the initial state. - - `debug`: a boolean; produce verbose output if true (nonzero). - """ - - self.input_lines = None - """`StringList` of input lines (without newlines). - Filled by `self.run()`.""" - - self.input_offset = 0 - """Offset of `self.input_lines` from the beginning of the file.""" - - self.line = None - """Current input line.""" - - self.line_offset = -1 - """Current input line offset from beginning of `self.input_lines`.""" - - self.debug = debug - """Debugging mode on/off.""" - - self.initial_state = initial_state - """The name of the initial state (key to `self.states`).""" - - self.current_state = initial_state - """The name of the current state (key to `self.states`).""" - - self.states = {} - """Mapping of {state_name: State_object}.""" - - self.add_states(state_classes) - - self.observers = [] - """List of bound methods or functions to call whenever the current - line changes. Observers are called with one argument, ``self``. - Cleared at the end of `run()`.""" - - def unlink(self): - """Remove circular references to objects no longer required.""" - for state in self.states.values(): - state.unlink() - self.states = None - - def run(self, input_lines, input_offset=0, context=None, - input_source=None): - """ - Run the state machine on `input_lines`. Return results (a list). - - Reset `self.line_offset` and `self.current_state`. Run the - beginning-of-file transition. Input one line at a time and check for a - matching transition. If a match is found, call the transition method - and possibly change the state. Store the context returned by the - transition method to be passed on to the next transition matched. - Accumulate the results returned by the transition methods in a list. - Run the end-of-file transition. Finally, return the accumulated - results. - - Parameters: - - - `input_lines`: a list of strings without newlines, or `StringList`. - - `input_offset`: the line offset of `input_lines` from the beginning - of the file. - - `context`: application-specific storage. - - `input_source`: name or path of source of `input_lines`. - """ - self.runtime_init() - if isinstance(input_lines, StringList): - self.input_lines = input_lines - else: - self.input_lines = StringList(input_lines, source=input_source) - self.input_offset = input_offset - self.line_offset = -1 - self.current_state = self.initial_state - if self.debug: - print >>sys.stderr, ( - '\nStateMachine.run: input_lines (line_offset=%s):\n| %s' - % (self.line_offset, '\n| '.join(self.input_lines))) - transitions = None - results = [] - state = self.get_state() - try: - if self.debug: - print >>sys.stderr, ('\nStateMachine.run: bof transition') - context, result = state.bof(context) - results.extend(result) - while 1: - try: - try: - self.next_line() - if self.debug: - source, offset = self.input_lines.info( - self.line_offset) - print >>sys.stderr, ( - '\nStateMachine.run: line (source=%r, ' - 'offset=%r):\n| %s' - % (source, offset, self.line)) - context, next_state, result = self.check_line( - context, state, transitions) - except EOFError: - if self.debug: - print >>sys.stderr, ( - '\nStateMachine.run: %s.eof transition' - % state.class.name) - result = state.eof(context) - results.extend(result) - break - else: - results.extend(result) - except TransitionCorrection, exception: - self.previous_line() # back up for another try - transitions = (exception.args[0],) - if self.debug: - print >>sys.stderr, ( - '\nStateMachine.run: TransitionCorrection to ' - 'state "%s", transition %s.' - % (state.class.name, transitions[0])) - continue - except StateCorrection, exception: - self.previous_line() # back up for another try - next_state = exception.args[0] - if len(exception.args) == 1: - transitions = None - else: - transitions = (exception.args[1],) - if self.debug: - print >>sys.stderr, ( - '\nStateMachine.run: StateCorrection to state ' - '"%s", transition %s.' - % (next_state, transitions[0])) - else: - transitions = None - state = self.get_state(next_state) - except: - if self.debug: - self.error() - raise - self.observers = [] - return results - - def get_state(self, next_state=None): - """ - Return current state object; set it first if `next_state` given. - - Parameter `next_state`: a string, the name of the next state. - - Exception: `UnknownStateError` raised if `next_state` unknown. - """ - if next_state: - if self.debug and next_state != self.current_state: - print >>sys.stderr, \ - ('\nStateMachine.get_state: Changing state from ' - '"%s" to "%s" (input line %s).' - % (self.current_state, next_state, - self.abs_line_number())) - self.current_state = next_state - try: - return self.states[self.current_state] - except KeyError: - raise UnknownStateError(self.current_state) - - def next_line(self, n=1): - """Load `self.line` with the `n`'th next line and return it.""" - try: - try: - self.line_offset += n - self.line = self.input_lines[self.line_offset] - except IndexError: - self.line = None - raise EOFError - return self.line - finally: - self.notify_observers() - - def is_next_line_blank(self): - """Return 1 if the next line is blank or non-existant.""" - try: - return not self.input_lines[self.line_offset + 1].strip() - except IndexError: - return 1 - - def at_eof(self): - """Return 1 if the input is at or past end-of-file.""" - return self.line_offset >= len(self.input_lines) - 1 - - def at_bof(self): - """Return 1 if the input is at or before beginning-of-file.""" - return self.line_offset <= 0 - - def previous_line(self, n=1): - """Load `self.line` with the `n`'th previous line and return it.""" - self.line_offset -= n - if self.line_offset < 0: - self.line = None - else: - self.line = self.input_lines[self.line_offset] - self.notify_observers() - return self.line - - def goto_line(self, line_offset): - """Jump to absolute line offset `line_offset`, load and return it.""" - try: - try: - self.line_offset = line_offset - self.input_offset - self.line = self.input_lines[self.line_offset] - except IndexError: - self.line = None - raise EOFError - return self.line - finally: - self.notify_observers() - - def get_source(self, line_offset): - """Return source of line at absolute line offset `line_offset`.""" - return self.input_lines.source(line_offset - self.input_offset) - - def abs_line_offset(self): - """Return line offset of current line, from beginning of file.""" - return self.line_offset + self.input_offset - - def abs_line_number(self): - """Return line number of current line (counting from 1).""" - return self.line_offset + self.input_offset + 1 - - def insert_input(self, input_lines, source): - self.input_lines.insert(self.line_offset + 1, '', - source='internal padding') - self.input_lines.insert(self.line_offset + 1, '', - source='internal padding') - self.input_lines.insert(self.line_offset + 2, - StringList(input_lines, source)) - - def get_text_block(self, flush_left=0): - """ - Return a contiguous block of text. - - If `flush_left` is true, raise `UnexpectedIndentationError` if an - indented line is encountered before the text block ends (with a blank - line). - """ - try: - block = self.input_lines.get_text_block(self.line_offset, - flush_left) - self.next_line(len(block) - 1) - return block - except UnexpectedIndentationError, error: - block, source, lineno = error - self.next_line(len(block) - 1) # advance to last line of block - raise - - def check_line(self, context, state, transitions=None): - """ - Examine one line of input for a transition match & execute its method. - - Parameters: - - - `context`: application-dependent storage. - - `state`: a `State` object, the current state. - - `transitions`: an optional ordered list of transition names to try, - instead of ``state.transition_order``. - - Return the values returned by the transition method: - - - context: possibly modified from the parameter `context`; - - next state name (`State` subclass name); - - the result output of the transition, a list. - - When there is no match, ``state.no_match()`` is called and its return - value is returned. - """ - if transitions is None: - transitions = state.transition_order - state_correction = None - if self.debug: - print >>sys.stderr, ( - '\nStateMachine.check_line: state="%s", transitions=%r.' - % (state.class.name, transitions)) - for name in transitions: - pattern, method, next_state = state.transitions[name] - match = self.match(pattern) - if match: - if self.debug: - print >>sys.stderr, ( - '\nStateMachine.check_line: Matched transition ' - '"%s" in state "%s".' - % (name, state.class.name)) - return method(match, context, next_state) - else: - if self.debug: - print >>sys.stderr, ( - '\nStateMachine.check_line: No match in state "%s".' - % state.class.name) - return state.no_match(context, transitions) - - def match(self, pattern): - """ - Return the result of a regular expression match. - - Parameter `pattern`: an `re` compiled regular expression. - """ - return pattern.match(self.line) - - def add_state(self, state_class): - """ - Initialize & add a `state_class` (`State` subclass) object. - - Exception: `DuplicateStateError` raised if `state_class` was already - added. - """ - statename = state_class.name - if self.states.has_key(statename): - raise DuplicateStateError(statename) - self.states[statename] = state_class(self, self.debug) - - def add_states(self, state_classes): - """ - Add `state_classes` (a list of `State` subclasses). - """ - for state_class in state_classes: - self.add_state(state_class) - - def runtime_init(self): - """ - Initialize `self.states`. - """ - for state in self.states.values(): - state.runtime_init() - - def error(self): - """Report error details.""" - type, value, module, line, function = _exception_data() - print >>sys.stderr, '%s: %s' % (type, value) - print >>sys.stderr, 'input line %s' % (self.abs_line_number()) - print >>sys.stderr, ('module %s, line %s, function %s' - % (module, line, function)) - - def attach_observer(self, observer): - """ - The `observer` parameter is a function or bound method which takes two - arguments, the source and offset of the current line. - """ - self.observers.append(observer) - - def detach_observer(self, observer): - self.observers.remove(observer) - - def notify_observers(self): - for observer in self.observers: - try: - info = self.input_lines.info(self.line_offset) - except IndexError: - info = (None, None) - observer(info) - - -class State: - - """ - State superclass. Contains a list of transitions, and transition methods. - - Transition methods all have the same signature. They take 3 parameters: - - - An `re` match object. ``match.string`` contains the matched input line, - ``match.start()`` gives the start index of the match, and - ``match.end()`` gives the end index. - - A context object, whose meaning is application-defined (initial value - ``None``). It can be used to store any information required by the state - machine, and the retured context is passed on to the next transition - method unchanged. - - The name of the next state, a string, taken from the transitions list; - normally it is returned unchanged, but it may be altered by the - transition method if necessary. - - Transition methods all return a 3-tuple: - - - A context object, as (potentially) modified by the transition method. - - The next state name (a return value of ``None`` means no state change). - - The processing result, a list, which is accumulated by the state - machine. - - Transition methods may raise an `EOFError` to cut processing short. - - There are two implicit transitions, and corresponding transition methods - are defined: `bof()` handles the beginning-of-file, and `eof()` handles - the end-of-file. These methods have non-standard signatures and return - values. `bof()` returns the initial context and results, and may be used - to return a header string, or do any other processing needed. `eof()` - should handle any remaining context and wrap things up; it returns the - final processing result. - - Typical applications need only subclass `State` (or a subclass), set the - `patterns` and `initial_transitions` class attributes, and provide - corresponding transition methods. The default object initialization will - take care of constructing the list of transitions. - """ - - patterns = None - """ - {Name: pattern} mapping, used by `make_transition()`. Each pattern may - be a string or a compiled `re` pattern. Override in subclasses. - """ - - initial_transitions = None - """ - A list of transitions to initialize when a `State` is instantiated. - Each entry is either a transition name string, or a (transition name, next - state name) pair. See `make_transitions()`. Override in subclasses. - """ - - nested_sm = None - """ - The `StateMachine` class for handling nested processing. - - If left as ``None``, `nested_sm` defaults to the class of the state's - controlling state machine. Override it in subclasses to avoid the default. - """ - - nested_sm_kwargs = None - """ - Keyword arguments dictionary, passed to the `nested_sm` constructor. - - Two keys must have entries in the dictionary: - - - Key 'state_classes' must be set to a list of `State` classes. - - Key 'initial_state' must be set to the name of the initial state class. - - If `nested_sm_kwargs` is left as ``None``, 'state_classes' defaults to the - class of the current state, and 'initial_state' defaults to the name of - the class of the current state. Override in subclasses to avoid the - defaults. - """ - - def init(self, state_machine, debug=0): - """ - Initialize a `State` object; make & add initial transitions. - - Parameters: - - - `statemachine`: the controlling `StateMachine` object. - - `debug`: a boolean; produce verbose output if true (nonzero). - """ - - self.transition_order = [] - """A list of transition names in search order.""" - - self.transitions = {} - """ - A mapping of transition names to 3-tuples containing - (compiled_pattern, transition_method, next_state_name). Initialized as - an instance attribute dynamically (instead of as a class attribute) - because it may make forward references to patterns and methods in this - or other classes. - """ - - self.add_initial_transitions() - - self.state_machine = state_machine - """A reference to the controlling `StateMachine` object.""" - - self.debug = debug - """Debugging mode on/off.""" - - if self.nested_sm is None: - self.nested_sm = self.state_machine.class - if self.nested_sm_kwargs is None: - self.nested_sm_kwargs = {'state_classes': [self.class], - 'initial_state': self.class.name} - - def runtime_init(self): - """ - Initialize this `State` before running the state machine; called from - `self.state_machine.run()`. - """ - pass - - def unlink(self): - """Remove circular references to objects no longer required.""" - self.state_machine = None - - def add_initial_transitions(self): - """Make and add transitions listed in `self.initial_transitions`.""" - if self.initial_transitions: - names, transitions = self.make_transitions( - self.initial_transitions) - self.add_transitions(names, transitions) - - def add_transitions(self, names, transitions): - """ - Add a list of transitions to the start of the transition list. - - Parameters: - - - `names`: a list of transition names. - - `transitions`: a mapping of names to transition tuples. - - Exceptions: `DuplicateTransitionError`, `UnknownTransitionError`. - """ - for name in names: - if self.transitions.has_key(name): - raise DuplicateTransitionError(name) - if not transitions.has_key(name): - raise UnknownTransitionError(name) - self.transition_order[:0] = names - self.transitions.update(transitions) - - def add_transition(self, name, transition): - """ - Add a transition to the start of the transition list. - - Parameter `transition`: a ready-made transition 3-tuple. - - Exception: `DuplicateTransitionError`. - """ - if self.transitions.has_key(name): - raise DuplicateTransitionError(name) - self.transition_order[:0] = [name] - self.transitions[name] = transition - - def remove_transition(self, name): - """ - Remove a transition by `name`. - - Exception: `UnknownTransitionError`. - """ - try: - del self.transitions[name] - self.transition_order.remove(name) - except: - raise UnknownTransitionError(name) - - def make_transition(self, name, next_state=None): - """ - Make & return a transition tuple based on `name`. - - This is a convenience function to simplify transition creation. - - Parameters: - - - `name`: a string, the name of the transition pattern & method. This - `State` object must have a method called '`name`', and a dictionary - `self.patterns` containing a key '`name`'. - - `next_state`: a string, the name of the next `State` object for this - transition. A value of ``None`` (or absent) implies no state change - (i.e., continue with the same state). - - Exceptions: `TransitionPatternNotFound`, `TransitionMethodNotFound`. - """ - if next_state is None: - next_state = self.class.name - try: - pattern = self.patterns[name] - if not hasattr(pattern, 'match'): - pattern = re.compile(pattern) - except KeyError: - raise TransitionPatternNotFound( - '%s.patterns[%r]' % (self.class.name, name)) - try: - method = getattr(self, name) - except AttributeError: - raise TransitionMethodNotFound( - '%s.%s' % (self.class.name, name)) - return (pattern, method, next_state) - - def make_transitions(self, name_list): - """ - Return a list of transition names and a transition mapping. - - Parameter `name_list`: a list, where each entry is either a transition - name string, or a 1- or 2-tuple (transition name, optional next state - name). - """ - stringtype = type('') - names = [] - transitions = {} - for namestate in name_list: - if type(namestate) is stringtype: - transitions[namestate] = self.make_transition(namestate) - names.append(namestate) - else: - transitions[namestate[0]] = self.make_transition(namestate) - names.append(namestate[0]) - return names, transitions - - def no_match(self, context, transitions): - """ - Called when there is no match from `StateMachine.check_line()`. - - Return the same values returned by transition methods: - - - context: unchanged; - - next state name: ``None``; - - empty result list. - - Override in subclasses to catch this event. - """ - return context, None, [] - - def bof(self, context): - """ - Handle beginning-of-file. Return unchanged `context`, empty result. - - Override in subclasses. - - Parameter `context`: application-defined storage. - """ - return context, [] - - def eof(self, context): - """ - Handle end-of-file. Return empty result. - - Override in subclasses. - - Parameter `context`: application-defined storage. - """ - return [] - - def nop(self, match, context, next_state): - """ - A "do nothing" transition method. - - Return unchanged `context` & `next_state`, empty result. Useful for - simple state changes (actionless transitions). - """ - return context, next_state, [] - - -class StateMachineWS(StateMachine): - - """ - `StateMachine` subclass specialized for whitespace recognition. - - There are three methods provided for extracting indented text blocks: - - - `get_indented()`: use when the indent is unknown. - - `get_known_indented()`: use when the indent is known for all lines. - - `get_first_known_indented()`: use when only the first line's indent is - known. - """ - - def get_indented(self, until_blank=0, strip_indent=1): - """ - Return a block of indented lines of text, and info. - - Extract an indented block where the indent is unknown for all lines. - - :Parameters: - - `until_blank`: Stop collecting at the first blank line if true - (1). - - `strip_indent`: Strip common leading indent if true (1, - default). - - :Return: - - the indented block (a list of lines of text), - - its indent, - - its first line offset from BOF, and - - whether or not it finished with a blank line. - """ - offset = self.abs_line_offset() - indented, indent, blank_finish = self.input_lines.get_indented( - self.line_offset, until_blank, strip_indent) - if indented: - self.next_line(len(indented) - 1) # advance to last indented line - while indented and not indented[0].strip(): - indented.trim_start() - offset += 1 - return indented, indent, offset, blank_finish - - def get_known_indented(self, indent, until_blank=0, strip_indent=1): - """ - Return an indented block and info. - - Extract an indented block where the indent is known for all lines. - Starting with the current line, extract the entire text block with at - least `indent` indentation (which must be whitespace, except for the - first line). - - :Parameters: - - `indent`: The number of indent columns/characters. - - `until_blank`: Stop collecting at the first blank line if true - (1). - - `strip_indent`: Strip `indent` characters of indentation if true - (1, default). - - :Return: - - the indented block, - - its first line offset from BOF, and - - whether or not it finished with a blank line. - """ - offset = self.abs_line_offset() - indented, indent, blank_finish = self.input_lines.get_indented( - self.line_offset, until_blank, strip_indent, - block_indent=indent) - self.next_line(len(indented) - 1) # advance to last indented line - while indented and not indented[0].strip(): - indented.trim_start() - offset += 1 - return indented, offset, blank_finish - - def get_first_known_indented(self, indent, until_blank=0, strip_indent=1, - strip_top=1): - """ - Return an indented block and info. - - Extract an indented block where the indent is known for the first line - and unknown for all other lines. - - :Parameters: - - `indent`: The first line's indent (# of columns/characters). - - `until_blank`: Stop collecting at the first blank line if true - (1). - - `strip_indent`: Strip `indent` characters of indentation if true - (1, default). - - `strip_top`: Strip blank lines from the beginning of the block. - - :Return: - - the indented block, - - its indent, - - its first line offset from BOF, and - - whether or not it finished with a blank line. - """ - offset = self.abs_line_offset() - indented, indent, blank_finish = self.input_lines.get_indented( - self.line_offset, until_blank, strip_indent, - first_indent=indent) - self.next_line(len(indented) - 1) # advance to last indented line - if strip_top: - while indented and not indented[0].strip(): - indented.trim_start() - offset += 1 - return indented, indent, offset, blank_finish - - -class StateWS(State): - - """ - State superclass specialized for whitespace (blank lines & indents). - - Use this class with `StateMachineWS`. The transitions 'blank' (for blank - lines) and 'indent' (for indented text blocks) are added automatically, - before any other transitions. The transition method `blank()` handles - blank lines and `indent()` handles nested indented blocks. Indented - blocks trigger a new state machine to be created by `indent()` and run. - The class of the state machine to be created is in `indent_sm`, and the - constructor keyword arguments are in the dictionary `indent_sm_kwargs`. - - The methods `known_indent()` and `firstknown_indent()` are provided for - indented blocks where the indent (all lines' and first line's only, - respectively) is known to the transition method, along with the attributes - `known_indent_sm` and `known_indent_sm_kwargs`. Neither transition method - is triggered automatically. - """ - - indent_sm = None - """ - The `StateMachine` class handling indented text blocks. - - If left as ``None``, `indent_sm` defaults to the value of - `State.nested_sm`. Override it in subclasses to avoid the default. - """ - - indent_sm_kwargs = None - """ - Keyword arguments dictionary, passed to the `indent_sm` constructor. - - If left as ``None``, `indent_sm_kwargs` defaults to the value of - `State.nested_sm_kwargs`. Override it in subclasses to avoid the default. - """ - - known_indent_sm = None - """ - The `StateMachine` class handling known-indented text blocks. - - If left as ``None``, `known_indent_sm` defaults to the value of - `indent_sm`. Override it in subclasses to avoid the default. - """ - - known_indent_sm_kwargs = None - """ - Keyword arguments dictionary, passed to the `known_indent_sm` constructor. - - If left as ``None``, `known_indent_sm_kwargs` defaults to the value of - `indent_sm_kwargs`. Override it in subclasses to avoid the default. - """ - - ws_patterns = {'blank': ' *$', - 'indent': ' +'} - """Patterns for default whitespace transitions. May be overridden in - subclasses.""" - - ws_initial_transitions = ('blank', 'indent') - """Default initial whitespace transitions, added before those listed in - `State.initial_transitions`. May be overridden in subclasses.""" - - def init(self, state_machine, debug=0): - """ - Initialize a `StateSM` object; extends `State.init()`. - - Check for indent state machine attributes, set defaults if not set. - """ - State.init(self, state_machine, debug) - if self.indent_sm is None: - self.indent_sm = self.nested_sm - if self.indent_sm_kwargs is None: - self.indent_sm_kwargs = self.nested_sm_kwargs - if self.known_indent_sm is None: - self.known_indent_sm = self.indent_sm - if self.known_indent_sm_kwargs is None: - self.known_indent_sm_kwargs = self.indent_sm_kwargs - - def add_initial_transitions(self): - """ - Add whitespace-specific transitions before those defined in subclass. - - Extends `State.add_initial_transitions()`. - """ - State.add_initial_transitions(self) - if self.patterns is None: - self.patterns = {} - self.patterns.update(self.ws_patterns) - names, transitions = self.make_transitions( - self.ws_initial_transitions) - self.add_transitions(names, transitions) - - def blank(self, match, context, next_state): - """Handle blank lines. Does nothing. Override in subclasses.""" - return self.nop(match, context, next_state) - - def indent(self, match, context, next_state): - """ - Handle an indented text block. Extend or override in subclasses. - - Recursively run the registered state machine for indented blocks - (`self.indent_sm`). - """ - indented, indent, line_offset, blank_finish = \ - self.state_machine.get_indented() - sm = self.indent_sm(debug=self.debug, self.indent_sm_kwargs) - results = sm.run(indented, input_offset=line_offset) - return context, next_state, results - - def known_indent(self, match, context, next_state): - """ - Handle a known-indent text block. Extend or override in subclasses. - - Recursively run the registered state machine for known-indent indented - blocks (`self.known_indent_sm`). The indent is the length of the - match, ``match.end()``. - """ - indented, line_offset, blank_finish = \ - self.state_machine.get_known_indented(match.end()) - sm = self.known_indent_sm(debug=self.debug, - self.known_indent_sm_kwargs) - results = sm.run(indented, input_offset=line_offset) - return context, next_state, results - - def first_known_indent(self, match, context, next_state): - """ - Handle an indented text block (first line's indent known). - - Extend or override in subclasses. - - Recursively run the registered state machine for known-indent indented - blocks (`self.known_indent_sm`). The indent is the length of the - match, ``match.end()``. - """ - indented, line_offset, blank_finish = \ - self.state_machine.get_first_known_indented(match.end()) - sm = self.known_indent_sm(debug=self.debug, - self.known_indent_sm_kwargs) - results = sm.run(indented, input_offset=line_offset) - return context, next_state, results - - -class _SearchOverride: - - """ - Mix-in class to override `StateMachine` regular expression behavior. - - Changes regular expression matching, from the default `re.match()` - (succeeds only if the pattern matches at the start of `self.line`) to - `re.search()` (succeeds if the pattern matches anywhere in `self.line`). - When subclassing a `StateMachine`, list this class first** in the - inheritance list of the class definition. - """ - - def match(self, pattern): - """ - Return the result of a regular expression search. - - Overrides `StateMachine.match()`. - - Parameter `pattern`: `re` compiled regular expression. - """ - return pattern.search(self.line) - - -class SearchStateMachine(_SearchOverride, StateMachine): - """`StateMachine` which uses `re.search()` instead of `re.match()`.""" - pass - - -class SearchStateMachineWS(_SearchOverride, StateMachineWS): - """`StateMachineWS` which uses `re.search()` instead of `re.match()`.""" - pass - - -class ViewList: - - """ - List with extended functionality: slices of ViewList objects are child - lists, linked to their parents. Changes made to a child list also affect - the parent list. A child list is effectively a "view" (in the SQL sense) - of the parent list. Changes to parent lists, however, do not affect - active child lists. If a parent list is changed, any active child lists - should be recreated. - - The start and end of the slice can be trimmed using the `trim_start()` and - `trim_end()` methods, without affecting the parent list. The link between - child and parent lists can be broken by calling `disconnect()` on the - child list. - - Also, ViewList objects keep track of the source & offset of each item. - This information is accessible via the `source()`, `offset()`, and - `info()` methods. - """ - - def init(self, initlist=None, source=None, items=None, - parent=None, parent_offset=None): - self.data = [] - """The actual list of data, flattened from various sources.""" - - self.items = [] - """A list of (source, offset) pairs, same length as `self.data`: the - source of each line and the offset of each line from the beginning of - its source.""" - - self.parent = parent - """The parent list.""" - - self.parent_offset = parent_offset - """Offset of this list from the beginning of the parent list.""" - - if isinstance(initlist, ViewList): - self.data = initlist.data[:] - self.items = initlist.items[:] - elif initlist is not None: - self.data = list(initlist) - if items: - self.items = items - else: - self.items = [(source, i) for i in range(len(initlist))] - assert len(self.data) == len(self.items), 'data mismatch' - - def str(self): - return str(self.data) - - def repr(self): - return '%s(%s, items=%s)' % (self.class.name, - self.data, self.items) - - def lt(self, other): return self.data < self.cast(other) - def le(self, other): return self.data <= self.cast(other) - def eq(self, other): return self.data == self.cast(other) - def ne(self, other): return self.data != self.cast(other) - def gt(self, other): return self.data > self.cast(other) - def ge(self, other): return self.data >= self.cast(other) - def cmp(self, other): return cmp(self.data, self.cast(other)) - - def cast(self, other): - if isinstance(other, ViewList): - return other.data - else: - return other - - def contains(self, item): return item in self.data - def len(self): return len(self.data) - - # The getitem()/setitem() methods check whether the index - # is a slice first, since native list objects start supporting - # them directly in Python 2.3 (no exception is raised when - # indexing a list with a slice object; they just work). - - def getitem(self, i): - if isinstance(i, types.SliceType): - assert i.step in (None, 1), 'cannot handle slice with stride' - return self.class(self.data[i.start:i.stop], - items=self.items[i.start:i.stop], - parent=self, parent_offset=i.start) - else: - return self.data[i] - - def setitem(self, i, item): - if isinstance(i, types.SliceType): - assert i.step in (None, 1), 'cannot handle slice with stride' - if not isinstance(item, ViewList): - raise TypeError('assigning non-ViewList to ViewList slice') - self.data[i.start:i.stop] = item.data - self.items[i.start:i.stop] = item.items - assert len(self.data) == len(self.items), 'data mismatch' - if self.parent: - self.parent[i.start + self.parent_offset - : i.stop + self.parent_offset] = item - else: - self.data[i] = item - if self.parent: - self.parent[i + self.parent_offset] = item - - def delitem(self, i): - try: - del self.data[i] - del self.items[i] - if self.parent: - del self.parent[i + self.parent_offset] - except TypeError: - assert i.step is None, 'cannot handle slice with stride' - del self.data[i.start:i.stop] - del self.items[i.start:i.stop] - if self.parent: - del self.parent[i.start + self.parent_offset - : i.stop + self.parent_offset] - - def add(self, other): - if isinstance(other, ViewList): - return self.class(self.data + other.data, - items=(self.items + other.items)) - else: - raise TypeError('adding non-ViewList to a ViewList') - - def radd(self, other): - if isinstance(other, ViewList): - return self.class(other.data + self.data, - items=(other.items + self.items)) - else: - raise TypeError('adding ViewList to a non-ViewList') - - def iadd(self, other): - if isinstance(other, ViewList): - self.data += other.data - else: - raise TypeError('argument to += must be a ViewList') - return self - - def mul(self, n): - return self.class(self.data * n, items=(self.items * n)) - - rmul = mul - - def imul(self, n): - self.data = n - self.items = n - return self - - def extend(self, other): - if not isinstance(other, ViewList): - raise TypeError('extending a ViewList with a non-ViewList') - if self.parent: - self.parent.insert(len(self.data) + self.parent_offset, other) - self.data.extend(other.data) - self.items.extend(other.items) - - def append(self, item, source=None, offset=0): - if source is None: - self.extend(item) - else: - if self.parent: - self.parent.insert(len(self.data) + self.parent_offset, item, - source, offset) - self.data.append(item) - self.items.append((source, offset)) - - def insert(self, i, item, source=None, offset=0): - if source is None: - if not isinstance(item, ViewList): - raise TypeError('inserting non-ViewList with no source given') - self.data[i:i] = item.data - self.items[i:i] = item.items - if self.parent: - index = (len(self.data) + i) % len(self.data) - self.parent.insert(index + self.parent_offset, item) - else: - self.data.insert(i, item) - self.items.insert(i, (source, offset)) - if self.parent: - index = (len(self.data) + i) % len(self.data) - self.parent.insert(index + self.parent_offset, item, - source, offset) - - def pop(self, i=-1): - if self.parent: - index = (len(self.data) + i) % len(self.data) - self.parent.pop(index + self.parent_offset) - self.items.pop(i) - return self.data.pop(i) - - def trim_start(self, n=1): - """ - Remove items from the start of the list, without touching the parent. - """ - if n > len(self.data): - raise IndexError("Size of trim too large; can't trim %s items " - "from a list of size %s." % (n, len(self.data))) - elif n < 0: - raise IndexError('Trim size must be >= 0.') - del self.data[:n] - del self.items[:n] - if self.parent: - self.parent_offset += n - - def trim_end(self, n=1): - """ - Remove items from the end of the list, without touching the parent. - """ - if n > len(self.data): - raise IndexError("Size of trim too large; can't trim %s items " - "from a list of size %s." % (n, len(self.data))) - elif n < 0: - raise IndexError('Trim size must be >= 0.') - del self.data[-n:] - del self.items[-n:] - - def remove(self, item): - index = self.index(item) - del self[index] - - def count(self, item): return self.data.count(item) - def index(self, item): return self.data.index(item) - - def reverse(self): - self.data.reverse() - self.items.reverse() - self.parent = None - - def sort(self, args): - tmp = zip(self.data, self.items) - tmp.sort(args) - self.data = [entry[0] for entry in tmp] - self.items = [entry[1] for entry in tmp] - self.parent = None - - def info(self, i): - """Return source & offset for index `i`.""" - try: - return self.items[i] - except IndexError: - if i == len(self.data): # Just past the end - return self.items[i - 1][0], None - else: - raise - - def source(self, i): - """Return source for index `i`.""" - return self.info(i)[0] - - def offset(self, i): - """Return offset for index `i`.""" - return self.info(i)[1] - - def disconnect(self): - """Break link between this list and parent list.""" - self.parent = None - - -class StringList(ViewList): - - """A `ViewList` with string-specific methods.""" - - def trim_left(self, length, start=0, end=sys.maxint): - """ - Trim `length` characters off the beginning of each item, in-place, - from index `start` to `end`. No whitespace-checking is done on the - trimmed text. Does not affect slice parent. - """ - self.data[start:end] = [line[length:] - for line in self.data[start:end]] - - def get_text_block(self, start, flush_left=0): - """ - Return a contiguous block of text. - - If `flush_left` is true, raise `UnexpectedIndentationError` if an - indented line is encountered before the text block ends (with a blank - line). - """ - end = start - last = len(self.data) - while end < last: - line = self.data[end] - if not line.strip(): - break - if flush_left and (line[0] == ' '): - source, offset = self.info(end) - raise UnexpectedIndentationError(self[start:end], source, - offset + 1) - end += 1 - return self[start:end] - - def get_indented(self, start=0, until_blank=0, strip_indent=1, - block_indent=None, first_indent=None): - """ - Extract and return a StringList of indented lines of text. - - Collect all lines with indentation, determine the minimum indentation, - remove the minimum indentation from all indented lines (unless - `strip_indent` is false), and return them. All lines up to but not - including the first unindented line will be returned. - - :Parameters: - - `start`: The index of the first line to examine. - - `until_blank`: Stop collecting at the first blank line if true. - - `strip_indent`: Strip common leading indent if true (default). - - `block_indent`: The indent of the entire block, if known. - - `first_indent`: The indent of the first line, if known. - - :Return: - - a StringList of indented lines with mininum indent removed; - - the amount of the indent; - - a boolean: did the indented block finish with a blank line or EOF? - """ - indent = block_indent # start with None if unknown - end = start - if block_indent is not None and first_indent is None: - first_indent = block_indent - if first_indent is not None: - end += 1 - last = len(self.data) - while end < last: - line = self.data[end] - if line and (line[0] != ' ' - or (block_indent is not None - and line[:block_indent].strip())): - # Line not indented or insufficiently indented. - # Block finished properly iff the last indented line blank: - blank_finish = ((end > start) - and not self.data[end - 1].strip()) - break - stripped = line.lstrip() - if not stripped: # blank line - if until_blank: - blank_finish = 1 - break - elif block_indent is None: - line_indent = len(line) - len(stripped) - if indent is None: - indent = line_indent - else: - indent = min(indent, line_indent) - end += 1 - else: - blank_finish = 1 # block ends at end of lines - block = self[start:end] - if first_indent is not None and block: - block.data[0] = block.data[0][first_indent:] - if indent and strip_indent: - block.trim_left(indent, start=(first_indent is not None)) - return block, indent or 0, blank_finish - - def get_2D_block(self, top, left, bottom, right, strip_indent=1): - block = self[top:bottom] - indent = right - for i in range(len(block.data)): - block.data[i] = line = block.data[i][left:right].rstrip() - if line: - indent = min(indent, len(line) - len(line.lstrip())) - if strip_indent and 0 < indent < right: - block.data = [line[indent:] for line in block.data] - return block - - def pad_double_width(self, pad_char): - """ - Pad all double-width characters in self by appending `pad_char` to each. - For East Asian language support. - """ - if hasattr(unicodedata, 'east_asian_width'): - east_asian_width = unicodedata.east_asian_width - else: - return # new in Python 2.4 - for i in range(len(self.data)): - line = self.data[i] - if isinstance(line, types.UnicodeType): - new = [] - for char in line: - new.append(char) - if east_asian_width(char) in 'WF': # 'W'ide & 'F'ull-width - new.append(pad_char) - self.data[i] = ''.join(new) - - def replace(self, old, new): - """Replace all occurrences of substring `old` with `new`.""" - for i in range(len(self.data)): - self.data[i] = self.data[i].replace(old, new) - - -class StateMachineError(Exception): pass -class UnknownStateError(StateMachineError): pass -class DuplicateStateError(StateMachineError): pass -class UnknownTransitionError(StateMachineError): pass -class DuplicateTransitionError(StateMachineError): pass -class TransitionPatternNotFound(StateMachineError): pass -class TransitionMethodNotFound(StateMachineError): pass -class UnexpectedIndentationError(StateMachineError): pass - - -class TransitionCorrection(Exception): - - """ - Raise from within a transition method to switch to another transition. - - Raise with one argument, the new transition name. - """ - - -class StateCorrection(Exception): - - """ - Raise from within a transition method to switch to another state. - - Raise with one or two arguments: new state name, and an optional new - transition name. - """ - - -def string2lines(astring, tab_width=8, convert_whitespace=0, - whitespace=re.compile('[\v\f]')): - """ - Return a list of one-line strings with tabs expanded, no newlines, and - trailing whitespace stripped. - - Each tab is expanded with between 1 and `tab_width` spaces, so that the - next character's index becomes a multiple of `tab_width` (8 by default). - - Parameters: - - - `astring`: a multi-line string. - - `tab_width`: the number of columns between tab stops. - - `convert_whitespace`: convert form feeds and vertical tabs to spaces? - """ - if convert_whitespace: - astring = whitespace.sub(' ', astring) - return [s.expandtabs(tab_width).rstrip() for s in astring.splitlines()] - -def _exception_data(): - """ - Return exception information: - - - the exception's class name; - - the exception object; - - the name of the file containing the offending code; - - the line number of the offending code; - - the function name of the offending code. - """ - type, value, traceback = sys.exc_info() - while traceback.tb_next: - traceback = traceback.tb_next - code = traceback.tb_frame.f_code - return (type.name, value, code.co_filename, traceback.tb_lineno, - code.co_name) diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/transforms/init.py --- a/buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/transforms/init.py Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,172 +0,0 @@ -# $Id: init.py 4975 2007-03-01 18:08:32Z wiemann $ -# Authors: David Goodger ; Ueli Schlaepfer -# Copyright: This module has been placed in the public domain. - -""" -This package contains modules for standard tree transforms available -to Docutils components. Tree transforms serve a variety of purposes: - -- To tie up certain syntax-specific "loose ends" that remain after the - initial parsing of the input plaintext. These transforms are used to - supplement a limited syntax. - -- To automate the internal linking of the document tree (hyperlink - references, footnote references, etc.). - -- To extract useful information from the document tree. These - transforms may be used to construct (for example) indexes and tables - of contents. - -Each transform is an optional step that a Docutils component may -choose to perform on the parsed document. -""" - -docformat = 'reStructuredText' - - -from docutils import languages, ApplicationError, TransformSpec - - -class TransformError(ApplicationError): pass - - -class Transform: - - """ - Docutils transform component abstract base class. - """ - - default_priority = None - """Numerical priority of this transform, 0 through 999 (override).""" - - def init(self, document, startnode=None): - """ - Initial setup for in-place document transforms. - """ - - self.document = document - """The document tree to transform.""" - - self.startnode = startnode - """Node from which to begin the transform. For many transforms which - apply to the document as a whole, `startnode` is not set (i.e. its - value is `None`).""" - - self.language = languages.get_language( - document.settings.language_code) - """Language module local to this document.""" - - def apply(self, kwargs): - """Override to apply the transform to the document tree.""" - raise NotImplementedError('subclass must override this method') - - -class Transformer(TransformSpec): - - """ - Stores transforms (`Transform` classes) and applies them to document - trees. Also keeps track of components by component type name. - """ - - def init(self, document): - self.transforms = [] - """List of transforms to apply. Each item is a 3-tuple: - ``(priority string, transform class, pending node or None)``.""" - - self.unknown_reference_resolvers = [] - """List of hook functions which assist in resolving references""" - - self.document = document - """The `nodes.document` object this Transformer is attached to.""" - - self.applied = [] - """Transforms already applied, in order.""" - - self.sorted = 0 - """Boolean: is `self.tranforms` sorted?""" - - self.components = {} - """Mapping of component type name to component object. Set by - `self.populate_from_components()`.""" - - self.serialno = 0 - """Internal serial number to keep track of the add order of - transforms.""" - - def add_transform(self, transform_class, priority=None, kwargs): - """ - Store a single transform. Use `priority` to override the default. - `kwargs` is a dictionary whose contents are passed as keyword - arguments to the `apply` method of the transform. This can be used to - pass application-specific data to the transform instance. - """ - if priority is None: - priority = transform_class.default_priority - priority_string = self.get_priority_string(priority) - self.transforms.append( - (priority_string, transform_class, None, kwargs)) - self.sorted = 0 - - def add_transforms(self, transform_list): - """Store multiple transforms, with default priorities.""" - for transform_class in transform_list: - priority_string = self.get_priority_string( - transform_class.default_priority) - self.transforms.append( - (priority_string, transform_class, None, {})) - self.sorted = 0 - - def add_pending(self, pending, priority=None): - """Store a transform with an associated `pending` node.""" - transform_class = pending.transform - if priority is None: - priority = transform_class.default_priority - priority_string = self.get_priority_string(priority) - self.transforms.append( - (priority_string, transform_class, pending, {})) - self.sorted = 0 - - def get_priority_string(self, priority): - """ - Return a string, `priority` combined with `self.serialno`. - - This ensures FIFO order on transforms with identical priority. - """ - self.serialno += 1 - return '%03d-%03d' % (priority, self.serialno) - - def populate_from_components(self, components): - """ - Store each component's default transforms, with default priorities. - Also, store components by type name in a mapping for later lookup. - """ - for component in components: - if component is None: - continue - self.add_transforms(component.get_transforms()) - self.components[component.component_type] = component - self.sorted = 0 - # Set up all of the reference resolvers for this transformer. Each - # component of this transformer is able to register its own helper - # functions to help resolve references. - unknown_reference_resolvers = [] - for i in components: - unknown_reference_resolvers.extend(i.unknown_reference_resolvers) - decorated_list = [(f.priority, f) for f in unknown_reference_resolvers] - decorated_list.sort() - self.unknown_reference_resolvers.extend([f[1] for f in decorated_list]) - - def apply_transforms(self): - """Apply all of the stored transforms, in priority order.""" - self.document.reporter.attach_observer( - self.document.note_transform_message) - while self.transforms: - if not self.sorted: - # Unsorted initially, and whenever a transform is added. - self.transforms.sort() - self.transforms.reverse() - self.sorted = 1 - priority, transform_class, pending, kwargs = self.transforms.pop() - transform = transform_class(self.document, startnode=pending) - transform.apply(**kwargs) - self.applied.append((priority, transform_class, pending, kwargs)) diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/transforms/components.py --- a/buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/transforms/components.py Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,52 +0,0 @@ -# $Id: components.py 4564 2006-05-21 20:44:42Z wiemann $ -# Author: David Goodger -# Copyright: This module has been placed in the public domain. - -""" -Docutils component-related transforms. -""" - -docformat = 'reStructuredText' - -import sys -import os -import re -import time -from docutils import nodes, utils -from docutils import ApplicationError, DataError -from docutils.transforms import Transform, TransformError - - -class Filter(Transform): - - """ - Include or exclude elements which depend on a specific Docutils component. - - For use with `nodes.pending` elements. A "pending" element's dictionary - attribute ``details`` must contain the keys "component" and "format". The - value of ``details['component']`` must match the type name of the - component the elements depend on (e.g. "writer"). The value of - ``details['format']`` is the name of a specific format or context of that - component (e.g. "html"). If the matching Docutils component supports that - format or context, the "pending" element is replaced by the contents of - ``details['nodes']`` (a list of nodes); otherwise, the "pending" element - is removed. - - For example, the reStructuredText "meta" directive creates a "pending" - element containing a "meta" element (in ``pending.details['nodes']``). - Only writers (``pending.details['component'] == 'writer'``) supporting the - "html" format (``pending.details['format'] == 'html'``) will include the - "meta" element; it will be deleted from the output of all other writers. - """ - - default_priority = 780 - - def apply(self): - pending = self.startnode - component_type = pending.details['component'] # 'reader' or 'writer' - format = pending.details['format'] - component = self.document.transformer.components[component_type] - if component.supports(format): - pending.replace_self(pending.details['nodes']) - else: - pending.parent.remove(pending) diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/transforms/frontmatter.py --- a/buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/transforms/frontmatter.py Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,512 +0,0 @@ -# $Id: frontmatter.py 4564 2006-05-21 20:44:42Z wiemann $ -# Author: David Goodger, Ueli Schlaepfer -# Copyright: This module has been placed in the public domain. - -""" -Transforms related to the front matter of a document or a section -(information found before the main text): - -- `DocTitle`: Used to transform a lone top level section's title to - the document title, promote a remaining lone top-level section's - title to the document subtitle, and determine the document's title - metadata (document['title']) based on the document title and/or the - "title" setting. - -- `SectionSubTitle`: Used to transform a lone subsection into a - subtitle. - -- `DocInfo`: Used to transform a bibliographic field list into docinfo - elements. -""" - -docformat = 'reStructuredText' - -import re -from docutils import nodes, utils -from docutils.transforms import TransformError, Transform - - -class TitlePromoter(Transform): - - """ - Abstract base class for DocTitle and SectionSubTitle transforms. - """ - - def promote_title(self, node): - """ - Transform the following tree:: - - -
- - ... - - into :: - - <node> - <title> - ... - - `node` is normally a document. - """ - # `node` must not have a title yet. - assert not (len(node) and isinstance(node[0], nodes.title)) - section, index = self.candidate_index(node) - if index is None: - return None - # Transfer the section's attributes to the node: - node.attributes.update(section.attributes) - # setup_child is called automatically for all nodes. - node[:] = (section[:1] # section title - + node[:index] # everything that was in the - # node before the section - + section[1:]) # everything that was in the section - assert isinstance(node[0], nodes.title) - return 1 - - def promote_subtitle(self, node): - """ - Transform the following node tree:: - - <node> - <title> - <section> - <title> - ... - - into :: - - <node> - <title> - <subtitle> - ... - """ - subsection, index = self.candidate_index(node) - if index is None: - return None - subtitle = nodes.subtitle() - # Transfer the subsection's attributes to the new subtitle: - # This causes trouble with list attributes! To do: Write a - # test case which catches direct access to the `attributes` - # dictionary and/or write a test case which shows problems in - # this particular case. - subtitle.attributes.update(subsection.attributes) - # We're losing the subtitle's attributes here! To do: Write a - # test case which shows this behavior. - # Transfer the contents of the subsection's title to the - # subtitle: - subtitle[:] = subsection[0][:] - node[:] = (node[:1] # title - + [subtitle] - # everything that was before the section: - + node[1:index] - # everything that was in the subsection: - + subsection[1:]) - return 1 - - def candidate_index(self, node): - """ - Find and return the promotion candidate and its index. - - Return (None, None) if no valid candidate was found. - """ - index = node.first_child_not_matching_class( - nodes.PreBibliographic) - if index is None or len(node) > (index + 1) or \ - not isinstance(node[index], nodes.section): - return None, None - else: - return node[index], index - - -class DocTitle(TitlePromoter): - - """ - In reStructuredText_, there is no way to specify a document title - and subtitle explicitly. Instead, we can supply the document title - (and possibly the subtitle as well) implicitly, and use this - two-step transform to "raise" or "promote" the title(s) (and their - corresponding section contents) to the document level. - - 1. If the document contains a single top-level section as its - first non-comment element, the top-level section's title - becomes the document's title, and the top-level section's - contents become the document's immediate contents. The lone - top-level section header must be the first non-comment element - in the document. - - For example, take this input text:: - - ================= - Top-Level Title - ================= - - A paragraph. - - Once parsed, it looks like this:: - - <document> - <section names="top-level title"> - <title> - Top-Level Title - <paragraph> - A paragraph. - - After running the DocTitle transform, we have:: - - <document names="top-level title"> - <title> - Top-Level Title - <paragraph> - A paragraph. - - 2. If step 1 successfully determines the document title, we - continue by checking for a subtitle. - - If the lone top-level section itself contains a single - second-level section as its first non-comment element, that - section's title is promoted to the document's subtitle, and - that section's contents become the document's immediate - contents. Given this input text:: - - ================= - Top-Level Title - ================= - - Second-Level Title - ~~~~~~~~~~~~~~~~~~ - - A paragraph. - - After parsing and running the Section Promotion transform, the - result is:: - - <document names="top-level title"> - <title> - Top-Level Title - <subtitle names="second-level title"> - Second-Level Title - <paragraph> - A paragraph. - - (Note that the implicit hyperlink target generated by the - "Second-Level Title" is preserved on the "subtitle" element - itself.) - - Any comment elements occurring before the document title or - subtitle are accumulated and inserted as the first body elements - after the title(s). - - This transform also sets the document's metadata title - (document['title']). - - .. _reStructuredText: http://docutils.sf.net/rst.html - """ - - default_priority = 320 - - def set_metadata(self): - """ - Set document['title'] metadata title from the following - sources, listed in order of priority: - - * Existing document['title'] attribute. - * "title" setting. - * Document title node (as promoted by promote_title). - """ - if not self.document.hasattr('title'): - if self.document.settings.title is not None: - self.document['title'] = self.document.settings.title - elif len(self.document) and isinstance(self.document[0], nodes.title): - self.document['title'] = self.document[0].astext() - - def apply(self): - if getattr(self.document.settings, 'doctitle_xform', 1): - # promote_(sub)title defined in TitlePromoter base class. - if self.promote_title(self.document): - # If a title has been promoted, also try to promote a - # subtitle. - self.promote_subtitle(self.document) - # Set document['title']. - self.set_metadata() - - -class SectionSubTitle(TitlePromoter): - - """ - This works like document subtitles, but for sections. For example, :: - - <section> - <title> - Title - <section> - <title> - Subtitle - ... - - is transformed into :: - - <section> - <title> - Title - <subtitle> - Subtitle - ... - - For details refer to the docstring of DocTitle. - """ - - default_priority = 350 - - def apply(self): - if not getattr(self.document.settings, 'sectsubtitle_xform', 1): - return - for section in self.document.traverse(nodes.section): - # On our way through the node tree, we are deleting - # sections, but we call self.promote_subtitle for those - # sections nonetheless. To do: Write a test case which - # shows the problem and discuss on Docutils-develop. - self.promote_subtitle(section) - - -class DocInfo(Transform): - - """ - This transform is specific to the reStructuredText_ markup syntax; - see "Bibliographic Fields" in the `reStructuredText Markup - Specification`_ for a high-level description. This transform - should be run after the `DocTitle` transform. - - Given a field list as the first non-comment element after the - document title and subtitle (if present), registered bibliographic - field names are transformed to the corresponding DTD elements, - becoming child elements of the "docinfo" element (except for a - dedication and/or an abstract, which become "topic" elements after - "docinfo"). - - For example, given this document fragment after parsing:: - - <document> - <title> - Document Title - <field_list> - <field> - <field_name> - Author - <field_body> - <paragraph> - A. Name - <field> - <field_name> - Status - <field_body> - <paragraph> - $RCSfile$ - ... - - After running the bibliographic field list transform, the - resulting document tree would look like this:: - - <document> - <title> - Document Title - <docinfo> - <author> - A. Name - <status> - frontmatter.py - ... - - The "Status" field contained an expanded RCS keyword, which is - normally (but optionally) cleaned up by the transform. The sole - contents of the field body must be a paragraph containing an - expanded RCS keyword of the form "$keyword: expansion text $". Any - RCS keyword can be processed in any bibliographic field. The - dollar signs and leading RCS keyword name are removed. Extra - processing is done for the following RCS keywords: - - - "RCSfile" expands to the name of the file in the RCS or CVS - repository, which is the name of the source file with a ",v" - suffix appended. The transform will remove the ",v" suffix. - - - "Date" expands to the format "YYYY/MM/DD hh:mm:ss" (in the UTC - time zone). The RCS Keywords transform will extract just the - date itself and transform it to an ISO 8601 format date, as in - "2000-12-31". - - (Since the source file for this text is itself stored under CVS, - we can't show an example of the "Date" RCS keyword because we - can't prevent any RCS keywords used in this explanation from - being expanded. Only the "RCSfile" keyword is stable; its - expansion text changes only if the file name changes.) - - .. _reStructuredText: http://docutils.sf.net/rst.html - .. _reStructuredText Markup Specification: - http://docutils.sf.net/docs/ref/rst/restructuredtext.html - """ - - default_priority = 340 - - biblio_nodes = { - 'author': nodes.author, - 'authors': nodes.authors, - 'organization': nodes.organization, - 'address': nodes.address, - 'contact': nodes.contact, - 'version': nodes.version, - 'revision': nodes.revision, - 'status': nodes.status, - 'date': nodes.date, - 'copyright': nodes.copyright, - 'dedication': nodes.topic, - 'abstract': nodes.topic} - """Canonical field name (lowcased) to node class name mapping for - bibliographic fields (field_list).""" - - def apply(self): - if not getattr(self.document.settings, 'docinfo_xform', 1): - return - document = self.document - index = document.first_child_not_matching_class( - nodes.PreBibliographic) - if index is None: - return - candidate = document[index] - if isinstance(candidate, nodes.field_list): - biblioindex = document.first_child_not_matching_class( - (nodes.Titular, nodes.Decorative)) - nodelist = self.extract_bibliographic(candidate) - del document[index] # untransformed field list (candidate) - document[biblioindex:biblioindex] = nodelist - - def extract_bibliographic(self, field_list): - docinfo = nodes.docinfo() - bibliofields = self.language.bibliographic_fields - labels = self.language.labels - topics = {'dedication': None, 'abstract': None} - for field in field_list: - try: - name = field[0][0].astext() - normedname = nodes.fully_normalize_name(name) - if not (len(field) == 2 and bibliofields.has_key(normedname) - and self.check_empty_biblio_field(field, name)): - raise TransformError - canonical = bibliofields[normedname] - biblioclass = self.biblio_nodes[canonical] - if issubclass(biblioclass, nodes.TextElement): - if not self.check_compound_biblio_field(field, name): - raise TransformError - utils.clean_rcs_keywords( - field[1][0], self.rcs_keyword_substitutions) - docinfo.append(biblioclass('', '', field[1][0])) - elif issubclass(biblioclass, nodes.authors): - self.extract_authors(field, name, docinfo) - elif issubclass(biblioclass, nodes.topic): - if topics[canonical]: - field[-1] += self.document.reporter.warning( - 'There can only be one "%s" field.' % name, - base_node=field) - raise TransformError - title = nodes.title(name, labels[canonical]) - topics[canonical] = biblioclass( - '', title, classes=[canonical], field[1].children) - else: - docinfo.append(biblioclass('', field[1].children)) - except TransformError: - if len(field[-1]) == 1 \ - and isinstance(field[-1][0], nodes.paragraph): - utils.clean_rcs_keywords( - field[-1][0], self.rcs_keyword_substitutions) - docinfo.append(field) - nodelist = [] - if len(docinfo) != 0: - nodelist.append(docinfo) - for name in ('dedication', 'abstract'): - if topics[name]: - nodelist.append(topics[name]) - return nodelist - - def check_empty_biblio_field(self, field, name): - if len(field[-1]) < 1: - field[-1] += self.document.reporter.warning( - 'Cannot extract empty bibliographic field "%s".' % name, - base_node=field) - return None - return 1 - - def check_compound_biblio_field(self, field, name): - if len(field[-1]) > 1: - field[-1] += self.document.reporter.warning( - 'Cannot extract compound bibliographic field "%s".' % name, - base_node=field) - return None - if not isinstance(field[-1][0], nodes.paragraph): - field[-1] += self.document.reporter.warning( - 'Cannot extract bibliographic field "%s" containing ' - 'anything other than a single paragraph.' % name, - base_node=field) - return None - return 1 - - rcs_keyword_substitutions = [ - (re.compile(r'\$' r'Date: (\d\d\d\d)[-/](\d\d)[-/](\d\d)[ T][\d:]+' - r'[^$] \$', re.IGNORECASE), r'\1-\2-\3'), - (re.compile(r'\$' r'RCSfile: (.+),v \$', re.IGNORECASE), r'\1'), - (re.compile(r'\$[a-zA-Z]+: (.+) \$'), r'\1'),] - - def extract_authors(self, field, name, docinfo): - try: - if len(field[1]) == 1: - if isinstance(field[1][0], nodes.paragraph): - authors = self.authors_from_one_paragraph(field) - elif isinstance(field[1][0], nodes.bullet_list): - authors = self.authors_from_bullet_list(field) - else: - raise TransformError - else: - authors = self.authors_from_paragraphs(field) - authornodes = [nodes.author('', '', author) - for author in authors if author] - if len(authornodes) >= 1: - docinfo.append(nodes.authors('', authornodes)) - else: - raise TransformError - except TransformError: - field[-1] += self.document.reporter.warning( - 'Bibliographic field "%s" incompatible with extraction: ' - 'it must contain either a single paragraph (with authors ' - 'separated by one of "%s"), multiple paragraphs (one per ' - 'author), or a bullet list with one paragraph (one author) ' - 'per item.' - % (name, ''.join(self.language.author_separators)), - base_node=field) - raise - - def authors_from_one_paragraph(self, field): - text = field[1][0].astext().strip() - if not text: - raise TransformError - for authorsep in self.language.author_separators: - authornames = text.split(authorsep) - if len(authornames) > 1: - break - authornames = [author.strip() for author in authornames] - authors = [[nodes.Text(author)] for author in authornames if author] - return authors - - def authors_from_bullet_list(self, field): - authors = [] - for item in field[1][0]: - if len(item) != 1 or not isinstance(item[0], nodes.paragraph): - raise TransformError - authors.append(item[0].children) - if not authors: - raise TransformError - return authors - - def authors_from_paragraphs(self, field): - for item in field[1]: - if not isinstance(item, nodes.paragraph): - raise TransformError - authors = [item.children for item in field[1]] - return authors diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/transforms/misc.py --- a/buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/transforms/misc.py Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,143 +0,0 @@ -# $Id: misc.py 4564 2006-05-21 20:44:42Z wiemann $ -# Author: David Goodger <goodger@python.org> -# Copyright: This module has been placed in the public domain. - -""" -Miscellaneous transforms. -""" - -docformat = 'reStructuredText' - -from docutils import nodes -from docutils.transforms import Transform, TransformError - - -class CallBack(Transform): - - """ - Inserts a callback into a document. The callback is called when the - transform is applied, which is determined by its priority. - - For use with `nodes.pending` elements. Requires a ``details['callback']`` - entry, a bound method or function which takes one parameter: the pending - node. Other data can be stored in the ``details`` attribute or in the - object hosting the callback method. - """ - - default_priority = 990 - - def apply(self): - pending = self.startnode - pending.details['callback'](pending) - pending.parent.remove(pending) - - -class ClassAttribute(Transform): - - """ - Move the "class" attribute specified in the "pending" node into the - immediately following non-comment element. - """ - - default_priority = 210 - - def apply(self): - pending = self.startnode - parent = pending.parent - child = pending - while parent: - # Check for appropriate following siblings: - for index in range(parent.index(child) + 1, len(parent)): - element = parent[index] - if (isinstance(element, nodes.Invisible) or - isinstance(element, nodes.system_message)): - continue - element['classes'] += pending.details['class'] - pending.parent.remove(pending) - return - else: - # At end of section or container; apply to sibling - child = parent - parent = parent.parent - error = self.document.reporter.error( - 'No suitable element following "%s" directive' - % pending.details['directive'], - nodes.literal_block(pending.rawsource, pending.rawsource), - line=pending.line) - pending.replace_self(error) - - -class Transitions(Transform): - - """ - Move transitions at the end of sections up the tree. Complain - on transitions after a title, at the beginning or end of the - document, and after another transition. - - For example, transform this:: - - <section> - ... - <transition> - <section> - ... - - into this:: - - <section> - ... - <transition> - <section> - ... - """ - - default_priority = 830 - - def apply(self): - for node in self.document.traverse(nodes.transition): - self.visit_transition(node) - - def visit_transition(self, node): - index = node.parent.index(node) - error = None - if (index == 0 or - isinstance(node.parent[0], nodes.title) and - (index == 1 or - isinstance(node.parent[1], nodes.subtitle) and - index == 2)): - assert (isinstance(node.parent, nodes.document) or - isinstance(node.parent, nodes.section)) - error = self.document.reporter.error( - 'Document or section may not begin with a transition.', - line=node.line) - elif isinstance(node.parent[index - 1], nodes.transition): - error = self.document.reporter.error( - 'At least one body element must separate transitions; ' - 'adjacent transitions are not allowed.', line=node.line) - if error: - # Insert before node and update index. - node.parent.insert(index, error) - index += 1 - assert index < len(node.parent) - if index != len(node.parent) - 1: - # No need to move the node. - return - # Node behind which the transition is to be moved. - sibling = node - # While sibling is the last node of its parent. - while index == len(sibling.parent) - 1: - sibling = sibling.parent - # If sibling is the whole document (i.e. it has no parent). - if sibling.parent is None: - # Transition at the end of document. Do not move the - # transition up, and place an error behind. - error = self.document.reporter.error( - 'Document may not end with a transition.', - line=node.line) - node.parent.insert(node.parent.index(node) + 1, error) - return - index = sibling.parent.index(sibling) - # Remove the original transition node. - node.parent.remove(node) - # Insert the transition after the sibling. - sibling.parent.insert(index + 1, node) diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/transforms/parts.py --- a/buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/transforms/parts.py Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,164 +0,0 @@ -# $Id: parts.py 4891 2007-01-22 08:35:57Z wiemann $ -# Authors: David Goodger <goodger@python.org>; Ueli Schlaepfer; Dmitry Jemerov -# Copyright: This module has been placed in the public domain. - -""" -Transforms related to document parts. -""" - -docformat = 'reStructuredText' - - -import re -import sys -from docutils import nodes, utils -from docutils.transforms import TransformError, Transform - - -class SectNum(Transform): - - """ - Automatically assigns numbers to the titles of document sections. - - It is possible to limit the maximum section level for which the numbers - are added. For those sections that are auto-numbered, the "autonum" - attribute is set, informing the contents table generator that a different - form of the TOC should be used. - """ - - default_priority = 710 - """Should be applied before `Contents`.""" - - def apply(self): - self.maxdepth = self.startnode.details.get('depth', sys.maxint) - self.startvalue = self.startnode.details.get('start', 1) - self.prefix = self.startnode.details.get('prefix', '') - self.suffix = self.startnode.details.get('suffix', '') - self.startnode.parent.remove(self.startnode) - if self.document.settings.sectnum_xform: - self.update_section_numbers(self.document) - - def update_section_numbers(self, node, prefix=(), depth=0): - depth += 1 - if prefix: - sectnum = 1 - else: - sectnum = self.startvalue - for child in node: - if isinstance(child, nodes.section): - numbers = prefix + (str(sectnum),) - title = child[0] - # Use for spacing: - generated = nodes.generated( - '', (self.prefix + '.'.join(numbers) + self.suffix - + u'\u00a0' * 3), - classes=['sectnum']) - title.insert(0, generated) - title['auto'] = 1 - if depth < self.maxdepth: - self.update_section_numbers(child, numbers, depth) - sectnum += 1 - - -class Contents(Transform): - - """ - This transform generates a table of contents from the entire document tree - or from a single branch. It locates "section" elements and builds them - into a nested bullet list, which is placed within a "topic" created by the - contents directive. A title is either explicitly specified, taken from - the appropriate language module, or omitted (local table of contents). - The depth may be specified. Two-way references between the table of - contents and section titles are generated (requires Writer support). - - This transform requires a startnode, which which contains generation - options and provides the location for the generated table of contents (the - startnode is replaced by the table of contents "topic"). - """ - - default_priority = 720 - - def apply(self): - details = self.startnode.details - if details.has_key('local'): - startnode = self.startnode.parent.parent - while not (isinstance(startnode, nodes.section) - or isinstance(startnode, nodes.document)): - # find the ToC root: a direct ancestor of startnode - startnode = startnode.parent - else: - startnode = self.document - self.toc_id = self.startnode.parent['ids'][0] - if details.has_key('backlinks'): - self.backlinks = details['backlinks'] - else: - self.backlinks = self.document.settings.toc_backlinks - contents = self.build_contents(startnode) - if len(contents): - self.startnode.replace_self(contents) - else: - self.startnode.parent.parent.remove(self.startnode.parent) - - def build_contents(self, node, level=0): - level += 1 - sections = [sect for sect in node if isinstance(sect, nodes.section)] - entries = [] - autonum = 0 - depth = self.startnode.details.get('depth', sys.maxint) - for section in sections: - title = section[0] - auto = title.get('auto') # May be set by SectNum. - entrytext = self.copy_and_filter(title) - reference = nodes.reference('', '', refid=section['ids'][0], - entrytext) - ref_id = self.document.set_id(reference) - entry = nodes.paragraph('', '', reference) - item = nodes.list_item('', entry) - if ( self.backlinks in ('entry', 'top') - and title.next_node(nodes.reference) is None): - if self.backlinks == 'entry': - title['refid'] = ref_id - elif self.backlinks == 'top': - title['refid'] = self.toc_id - if level < depth: - subsects = self.build_contents(section, level) - item += subsects - entries.append(item) - if entries: - contents = nodes.bullet_list('', entries) - if auto: - contents['classes'].append('auto-toc') - return contents - else: - return [] - - def copy_and_filter(self, node): - """Return a copy of a title, with references, images, etc. removed.""" - visitor = ContentsFilter(self.document) - node.walkabout(visitor) - return visitor.get_entry_text() - - -class ContentsFilter(nodes.TreeCopyVisitor): - - def get_entry_text(self): - return self.get_tree_copy().children - - def visit_citation_reference(self, node): - raise nodes.SkipNode - - def visit_footnote_reference(self, node): - raise nodes.SkipNode - - def visit_image(self, node): - if node.hasattr('alt'): - self.parent.append(nodes.Text(node['alt'])) - raise nodes.SkipNode - - def ignore_node_but_process_children(self, node): - raise nodes.SkipDeparture - - visit_interpreted = ignore_node_but_process_children - visit_problematic = ignore_node_but_process_children - visit_reference = ignore_node_but_process_children - visit_target = ignore_node_but_process_children diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/transforms/peps.py --- a/buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/transforms/peps.py Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,304 +0,0 @@ -# $Id: peps.py 4564 2006-05-21 20:44:42Z wiemann $ -# Author: David Goodger <goodger@python.org> -# Copyright: This module has been placed in the public domain. - -""" -Transforms for PEP processing. - -- `Headers`: Used to transform a PEP's initial RFC-2822 header. It remains a - field list, but some entries get processed. -- `Contents`: Auto-inserts a table of contents. -- `PEPZero`: Special processing for PEP 0. -""" - -docformat = 'reStructuredText' - -import sys -import os -import re -import time -from docutils import nodes, utils, languages -from docutils import ApplicationError, DataError -from docutils.transforms import Transform, TransformError -from docutils.transforms import parts, references, misc - - -class Headers(Transform): - - """ - Process fields in a PEP's initial RFC-2822 header. - """ - - default_priority = 360 - - pep_url = 'pep-%04d' - pep_cvs_url = ('http://svn.python.org/view/checkout' - '/peps/trunk/pep-%04d.txt') - rcs_keyword_substitutions = ( - (re.compile(r'\$' r'RCSfile: (.+),v \$$', re.IGNORECASE), r'\1'), - (re.compile(r'\$[a-zA-Z]+: (.+) \$$'), r'\1'),) - - def apply(self): - if not len(self.document): - # @@@ replace these DataErrors with proper system messages - raise DataError('Document tree is empty.') - header = self.document[0] - if not isinstance(header, nodes.field_list) or \ - 'rfc2822' not in header['classes']: - raise DataError('Document does not begin with an RFC-2822 ' - 'header; it is not a PEP.') - pep = None - for field in header: - if field[0].astext().lower() == 'pep': # should be the first field - value = field[1].astext() - try: - pep = int(value) - cvs_url = self.pep_cvs_url % pep - except ValueError: - pep = value - cvs_url = None - msg = self.document.reporter.warning( - '"PEP" header must contain an integer; "%s" is an ' - 'invalid value.' % pep, base_node=field) - msgid = self.document.set_id(msg) - prb = nodes.problematic(value, value or '(none)', - refid=msgid) - prbid = self.document.set_id(prb) - msg.add_backref(prbid) - if len(field[1]): - field[1][0][:] = [prb] - else: - field[1] += nodes.paragraph('', '', prb) - break - if pep is None: - raise DataError('Document does not contain an RFC-2822 "PEP" ' - 'header.') - if pep == 0: - # Special processing for PEP 0. - pending = nodes.pending(PEPZero) - self.document.insert(1, pending) - self.document.note_pending(pending) - if len(header) < 2 or header[1][0].astext().lower() != 'title': - raise DataError('No title!') - for field in header: - name = field[0].astext().lower() - body = field[1] - if len(body) > 1: - raise DataError('PEP header field body contains multiple ' - 'elements:\n%s' % field.pformat(level=1)) - elif len(body) == 1: - if not isinstance(body[0], nodes.paragraph): - raise DataError('PEP header field body may only contain ' - 'a single paragraph:\n%s' - % field.pformat(level=1)) - elif name == 'last-modified': - date = time.strftime( - '%d-%b-%Y', - time.localtime(os.stat(self.document['source'])[8])) - if cvs_url: - body += nodes.paragraph( - '', '', nodes.reference('', date, refuri=cvs_url)) - else: - # empty - continue - para = body[0] - if name == 'author': - for node in para: - if isinstance(node, nodes.reference): - node.replace_self(mask_email(node)) - elif name == 'discussions-to': - for node in para: - if isinstance(node, nodes.reference): - node.replace_self(mask_email(node, pep)) - elif name in ('replaces', 'replaced-by', 'requires'): - newbody = [] - space = nodes.Text(' ') - for refpep in re.split(',?\s+', body.astext()): - pepno = int(refpep) - newbody.append(nodes.reference( - refpep, refpep, - refuri=(self.document.settings.pep_base_url - + self.pep_url % pepno))) - newbody.append(space) - para[:] = newbody[:-1] # drop trailing space - elif name == 'last-modified': - utils.clean_rcs_keywords(para, self.rcs_keyword_substitutions) - if cvs_url: - date = para.astext() - para[:] = [nodes.reference('', date, refuri=cvs_url)] - elif name == 'content-type': - pep_type = para.astext() - uri = self.document.settings.pep_base_url + self.pep_url % 12 - para[:] = [nodes.reference('', pep_type, refuri=uri)] - elif name == 'version' and len(body): - utils.clean_rcs_keywords(para, self.rcs_keyword_substitutions) - - -class Contents(Transform): - - """ - Insert an empty table of contents topic and a transform placeholder into - the document after the RFC 2822 header. - """ - - default_priority = 380 - - def apply(self): - language = languages.get_language(self.document.settings.language_code) - name = language.labels['contents'] - title = nodes.title('', name) - topic = nodes.topic('', title, classes=['contents']) - name = nodes.fully_normalize_name(name) - if not self.document.has_name(name): - topic['names'].append(name) - self.document.note_implicit_target(topic) - pending = nodes.pending(parts.Contents) - topic += pending - self.document.insert(1, topic) - self.document.note_pending(pending) - - -class TargetNotes(Transform): - - """ - Locate the "References" section, insert a placeholder for an external - target footnote insertion transform at the end, and schedule the - transform to run immediately. - """ - - default_priority = 520 - - def apply(self): - doc = self.document - i = len(doc) - 1 - refsect = copyright = None - while i >= 0 and isinstance(doc[i], nodes.section): - title_words = doc[i][0].astext().lower().split() - if 'references' in title_words: - refsect = doc[i] - break - elif 'copyright' in title_words: - copyright = i - i -= 1 - if not refsect: - refsect = nodes.section() - refsect += nodes.title('', 'References') - doc.set_id(refsect) - if copyright: - # Put the new "References" section before "Copyright": - doc.insert(copyright, refsect) - else: - # Put the new "References" section at end of doc: - doc.append(refsect) - pending = nodes.pending(references.TargetNotes) - refsect.append(pending) - self.document.note_pending(pending, 0) - pending = nodes.pending(misc.CallBack, - details={'callback': self.cleanup_callback}) - refsect.append(pending) - self.document.note_pending(pending, 1) - - def cleanup_callback(self, pending): - """ - Remove an empty "References" section. - - Called after the `references.TargetNotes` transform is complete. - """ - if len(pending.parent) == 2: # <title> and <pending> - pending.parent.parent.remove(pending.parent) - - -class PEPZero(Transform): - - """ - Special processing for PEP 0. - """ - - default_priority =760 - - def apply(self): - visitor = PEPZeroSpecial(self.document) - self.document.walk(visitor) - self.startnode.parent.remove(self.startnode) - - -class PEPZeroSpecial(nodes.SparseNodeVisitor): - - """ - Perform the special processing needed by PEP 0: - - - Mask email addresses. - - - Link PEP numbers in the second column of 4-column tables to the PEPs - themselves. - """ - - pep_url = Headers.pep_url - - def unknown_visit(self, node): - pass - - def visit_reference(self, node): - node.replace_self(mask_email(node)) - - def visit_field_list(self, node): - if 'rfc2822' in node['classes']: - raise nodes.SkipNode - - def visit_tgroup(self, node): - self.pep_table = node['cols'] == 4 - self.entry = 0 - - def visit_colspec(self, node): - self.entry += 1 - if self.pep_table and self.entry == 2: - node['classes'].append('num') - - def visit_row(self, node): - self.entry = 0 - - def visit_entry(self, node): - self.entry += 1 - if self.pep_table and self.entry == 2 and len(node) == 1: - node['classes'].append('num') - p = node[0] - if isinstance(p, nodes.paragraph) and len(p) == 1: - text = p.astext() - try: - pep = int(text) - ref = (self.document.settings.pep_base_url - + self.pep_url % pep) - p[0] = nodes.reference(text, text, refuri=ref) - except ValueError: - pass - - -non_masked_addresses = ('peps@python.org', - 'python-list@python.org', - 'python-dev@python.org') - -def mask_email(ref, pepno=None): - """ - Mask the email address in `ref` and return a replacement node. - - `ref` is returned unchanged if it contains no email address. - - For email addresses such as "user@host", mask the address as "user at - host" (text) to thwart simple email address harvesters (except for those - listed in `non_masked_addresses`). If a PEP number (`pepno`) is given, - return a reference including a default email subject. - """ - if ref.hasattr('refuri') and ref['refuri'].startswith('mailto:'): - if ref['refuri'][8:] in non_masked_addresses: - replacement = ref[0] - else: - replacement_text = ref.astext().replace('@', ' at ') - replacement = nodes.raw('', replacement_text, format='html') - if pepno is None: - return replacement - else: - ref['refuri'] += '?subject=PEP%%20%s' % pepno - ref[:] = [replacement] - return ref - else: - return ref diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/transforms/references.py --- a/buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/transforms/references.py Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,896 +0,0 @@ -# $Id: references.py 5018 2007-03-12 21:39:31Z wiemann $ -# Author: David Goodger <goodger@python.org> -# Copyright: This module has been placed in the public domain. - -""" -Transforms for resolving references. -""" - -docformat = 'reStructuredText' - -import sys -import re -from docutils import nodes, utils -from docutils.transforms import TransformError, Transform - - -class PropagateTargets(Transform): - - """ - Propagate empty internal targets to the next element. - - Given the following nodes:: - - <target ids="internal1" names="internal1"> - <target anonymous="1" ids="id1"> - <target ids="internal2" names="internal2"> - <paragraph> - This is a test. - - PropagateTargets propagates the ids and names of the internal - targets preceding the paragraph to the paragraph itself:: - - <target refid="internal1"> - <target anonymous="1" refid="id1"> - <target refid="internal2"> - <paragraph ids="internal2 id1 internal1" names="internal2 internal1"> - This is a test. - """ - - default_priority = 260 - - def apply(self): - for target in self.document.traverse(nodes.target): - # Only block-level targets without reference (like ".. target:"): - if (isinstance(target.parent, nodes.TextElement) or - (target.hasattr('refid') or target.hasattr('refuri') or - target.hasattr('refname'))): - continue - assert len(target) == 0, 'error: block-level target has children' - next_node = target.next_node(ascend=1) - # Do not move names and ids into Invisibles (we'd lose the - # attributes) or different Targetables (e.g. footnotes). - if (next_node is not None and - ((not isinstance(next_node, nodes.Invisible) and - not isinstance(next_node, nodes.Targetable)) or - isinstance(next_node, nodes.target))): - next_node['ids'].extend(target['ids']) - next_node['names'].extend(target['names']) - # Set defaults for next_node.expect_referenced_by_name/id. - if not hasattr(next_node, 'expect_referenced_by_name'): - next_node.expect_referenced_by_name = {} - if not hasattr(next_node, 'expect_referenced_by_id'): - next_node.expect_referenced_by_id = {} - for id in target['ids']: - # Update IDs to node mapping. - self.document.ids[id] = next_node - # If next_node is referenced by id ``id``, this - # target shall be marked as referenced. - next_node.expect_referenced_by_id[id] = target - for name in target['names']: - next_node.expect_referenced_by_name[name] = target - # If there are any expect_referenced_by_... attributes - # in target set, copy them to next_node. - next_node.expect_referenced_by_name.update( - getattr(target, 'expect_referenced_by_name', {})) - next_node.expect_referenced_by_id.update( - getattr(target, 'expect_referenced_by_id', {})) - # Set refid to point to the first former ID of target - # which is now an ID of next_node. - target['refid'] = target['ids'][0] - # Clear ids and names; they have been moved to - # next_node. - target['ids'] = [] - target['names'] = [] - self.document.note_refid(target) - - -class AnonymousHyperlinks(Transform): - - """ - Link anonymous references to targets. Given:: - - <paragraph> - <reference anonymous="1"> - internal - <reference anonymous="1"> - external - <target anonymous="1" ids="id1"> - <target anonymous="1" ids="id2" refuri="http://external"> - - Corresponding references are linked via "refid" or resolved via "refuri":: - - <paragraph> - <reference anonymous="1" refid="id1"> - text - <reference anonymous="1" refuri="http://external"> - external - <target anonymous="1" ids="id1"> - <target anonymous="1" ids="id2" refuri="http://external"> - """ - - default_priority = 440 - - def apply(self): - anonymous_refs = [] - anonymous_targets = [] - for node in self.document.traverse(nodes.reference): - if node.get('anonymous'): - anonymous_refs.append(node) - for node in self.document.traverse(nodes.target): - if node.get('anonymous'): - anonymous_targets.append(node) - if len(anonymous_refs) \ - != len(anonymous_targets): - msg = self.document.reporter.error( - 'Anonymous hyperlink mismatch: %s references but %s ' - 'targets.\nSee "backrefs" attribute for IDs.' - % (len(anonymous_refs), len(anonymous_targets))) - msgid = self.document.set_id(msg) - for ref in anonymous_refs: - prb = nodes.problematic( - ref.rawsource, ref.rawsource, refid=msgid) - prbid = self.document.set_id(prb) - msg.add_backref(prbid) - ref.replace_self(prb) - return - for ref, target in zip(anonymous_refs, anonymous_targets): - target.referenced = 1 - while 1: - if target.hasattr('refuri'): - ref['refuri'] = target['refuri'] - ref.resolved = 1 - break - else: - if not target['ids']: - # Propagated target. - target = self.document.ids[target['refid']] - continue - ref['refid'] = target['ids'][0] - self.document.note_refid(ref) - break - - -class IndirectHyperlinks(Transform): - - """ - a) Indirect external references:: - - <paragraph> - <reference refname="indirect external"> - indirect external - <target id="id1" name="direct external" - refuri="http://indirect"> - <target id="id2" name="indirect external" - refname="direct external"> - - The "refuri" attribute is migrated back to all indirect targets - from the final direct target (i.e. a target not referring to - another indirect target):: - - <paragraph> - <reference refname="indirect external"> - indirect external - <target id="id1" name="direct external" - refuri="http://indirect"> - <target id="id2" name="indirect external" - refuri="http://indirect"> - - Once the attribute is migrated, the preexisting "refname" attribute - is dropped. - - b) Indirect internal references:: - - <target id="id1" name="final target"> - <paragraph> - <reference refname="indirect internal"> - indirect internal - <target id="id2" name="indirect internal 2" - refname="final target"> - <target id="id3" name="indirect internal" - refname="indirect internal 2"> - - Targets which indirectly refer to an internal target become one-hop - indirect (their "refid" attributes are directly set to the internal - target's "id"). References which indirectly refer to an internal - target become direct internal references:: - - <target id="id1" name="final target"> - <paragraph> - <reference refid="id1"> - indirect internal - <target id="id2" name="indirect internal 2" refid="id1"> - <target id="id3" name="indirect internal" refid="id1"> - """ - - default_priority = 460 - - def apply(self): - for target in self.document.indirect_targets: - if not target.resolved: - self.resolve_indirect_target(target) - self.resolve_indirect_references(target) - - def resolve_indirect_target(self, target): - refname = target.get('refname') - if refname is None: - reftarget_id = target['refid'] - else: - reftarget_id = self.document.nameids.get(refname) - if not reftarget_id: - # Check the unknown_reference_resolvers - for resolver_function in \ - self.document.transformer.unknown_reference_resolvers: - if resolver_function(target): - break - else: - self.nonexistent_indirect_target(target) - return - reftarget = self.document.ids[reftarget_id] - reftarget.note_referenced_by(id=reftarget_id) - if isinstance(reftarget, nodes.target) \ - and not reftarget.resolved and reftarget.hasattr('refname'): - if hasattr(target, 'multiply_indirect'): - #and target.multiply_indirect): - #del target.multiply_indirect - self.circular_indirect_reference(target) - return - target.multiply_indirect = 1 - self.resolve_indirect_target(reftarget) # multiply indirect - del target.multiply_indirect - if reftarget.hasattr('refuri'): - target['refuri'] = reftarget['refuri'] - if target.has_key('refid'): - del target['refid'] - elif reftarget.hasattr('refid'): - target['refid'] = reftarget['refid'] - self.document.note_refid(target) - else: - if reftarget['ids']: - target['refid'] = reftarget_id - self.document.note_refid(target) - else: - self.nonexistent_indirect_target(target) - return - if refname is not None: - del target['refname'] - target.resolved = 1 - - def nonexistent_indirect_target(self, target): - if self.document.nameids.has_key(target['refname']): - self.indirect_target_error(target, 'which is a duplicate, and ' - 'cannot be used as a unique reference') - else: - self.indirect_target_error(target, 'which does not exist') - - def circular_indirect_reference(self, target): - self.indirect_target_error(target, 'forming a circular reference') - - def indirect_target_error(self, target, explanation): - naming = '' - reflist = [] - if target['names']: - naming = '"%s" ' % target['names'][0] - for name in target['names']: - reflist.extend(self.document.refnames.get(name, [])) - for id in target['ids']: - reflist.extend(self.document.refids.get(id, [])) - naming += '(id="%s")' % target['ids'][0] - msg = self.document.reporter.error( - 'Indirect hyperlink target %s refers to target "%s", %s.' - % (naming, target['refname'], explanation), base_node=target) - msgid = self.document.set_id(msg) - for ref in utils.uniq(reflist): - prb = nodes.problematic( - ref.rawsource, ref.rawsource, refid=msgid) - prbid = self.document.set_id(prb) - msg.add_backref(prbid) - ref.replace_self(prb) - target.resolved = 1 - - def resolve_indirect_references(self, target): - if target.hasattr('refid'): - attname = 'refid' - call_method = self.document.note_refid - elif target.hasattr('refuri'): - attname = 'refuri' - call_method = None - else: - return - attval = target[attname] - for name in target['names']: - reflist = self.document.refnames.get(name, []) - if reflist: - target.note_referenced_by(name=name) - for ref in reflist: - if ref.resolved: - continue - del ref['refname'] - ref[attname] = attval - if call_method: - call_method(ref) - ref.resolved = 1 - if isinstance(ref, nodes.target): - self.resolve_indirect_references(ref) - for id in target['ids']: - reflist = self.document.refids.get(id, []) - if reflist: - target.note_referenced_by(id=id) - for ref in reflist: - if ref.resolved: - continue - del ref['refid'] - ref[attname] = attval - if call_method: - call_method(ref) - ref.resolved = 1 - if isinstance(ref, nodes.target): - self.resolve_indirect_references(ref) - - -class ExternalTargets(Transform): - - """ - Given:: - - <paragraph> - <reference refname="direct external"> - direct external - <target id="id1" name="direct external" refuri="http://direct"> - - The "refname" attribute is replaced by the direct "refuri" attribute:: - - <paragraph> - <reference refuri="http://direct"> - direct external - <target id="id1" name="direct external" refuri="http://direct"> - """ - - default_priority = 640 - - def apply(self): - for target in self.document.traverse(nodes.target): - if target.hasattr('refuri'): - refuri = target['refuri'] - for name in target['names']: - reflist = self.document.refnames.get(name, []) - if reflist: - target.note_referenced_by(name=name) - for ref in reflist: - if ref.resolved: - continue - del ref['refname'] - ref['refuri'] = refuri - ref.resolved = 1 - - -class InternalTargets(Transform): - - default_priority = 660 - - def apply(self): - for target in self.document.traverse(nodes.target): - if not target.hasattr('refuri') and not target.hasattr('refid'): - self.resolve_reference_ids(target) - - def resolve_reference_ids(self, target): - """ - Given:: - - <paragraph> - <reference refname="direct internal"> - direct internal - <target id="id1" name="direct internal"> - - The "refname" attribute is replaced by "refid" linking to the target's - "id":: - - <paragraph> - <reference refid="id1"> - direct internal - <target id="id1" name="direct internal"> - """ - for name in target['names']: - refid = self.document.nameids[name] - reflist = self.document.refnames.get(name, []) - if reflist: - target.note_referenced_by(name=name) - for ref in reflist: - if ref.resolved: - continue - del ref['refname'] - ref['refid'] = refid - ref.resolved = 1 - - -class Footnotes(Transform): - - """ - Assign numbers to autonumbered footnotes, and resolve links to footnotes, - citations, and their references. - - Given the following ``document`` as input:: - - <document> - <paragraph> - A labeled autonumbered footnote referece: - <footnote_reference auto="1" id="id1" refname="footnote"> - <paragraph> - An unlabeled autonumbered footnote referece: - <footnote_reference auto="1" id="id2"> - <footnote auto="1" id="id3"> - <paragraph> - Unlabeled autonumbered footnote. - <footnote auto="1" id="footnote" name="footnote"> - <paragraph> - Labeled autonumbered footnote. - - Auto-numbered footnotes have attribute ``auto="1"`` and no label. - Auto-numbered footnote_references have no reference text (they're - empty elements). When resolving the numbering, a ``label`` element - is added to the beginning of the ``footnote``, and reference text - to the ``footnote_reference``. - - The transformed result will be:: - - <document> - <paragraph> - A labeled autonumbered footnote referece: - <footnote_reference auto="1" id="id1" refid="footnote"> - 2 - <paragraph> - An unlabeled autonumbered footnote referece: - <footnote_reference auto="1" id="id2" refid="id3"> - 1 - <footnote auto="1" id="id3" backrefs="id2"> - <label> - 1 - <paragraph> - Unlabeled autonumbered footnote. - <footnote auto="1" id="footnote" name="footnote" backrefs="id1"> - <label> - 2 - <paragraph> - Labeled autonumbered footnote. - - Note that the footnotes are not in the same order as the references. - - The labels and reference text are added to the auto-numbered ``footnote`` - and ``footnote_reference`` elements. Footnote elements are backlinked to - their references via "refids" attributes. References are assigned "id" - and "refid" attributes. - - After adding labels and reference text, the "auto" attributes can be - ignored. - """ - - default_priority = 620 - - autofootnote_labels = None - """Keep track of unlabeled autonumbered footnotes.""" - - symbols = [ - # Entries 1-4 and 6 below are from section 12.51 of - # The Chicago Manual of Style, 14th edition. - '', # asterisk/star - u'\u2020', # dagger † - u'\u2021', # double dagger ‡ - u'\u00A7', # section mark § - u'\u00B6', # paragraph mark (pilcrow) ¶ - # (parallels ['||'] in CMoS) - '#', # number sign - # The entries below were chosen arbitrarily. - u'\u2660', # spade suit ♠ - u'\u2665', # heart suit ♥ - u'\u2666', # diamond suit ♦ - u'\u2663', # club suit ♣ - ] - - def apply(self): - self.autofootnote_labels = [] - startnum = self.document.autofootnote_start - self.document.autofootnote_start = self.number_footnotes(startnum) - self.number_footnote_references(startnum) - self.symbolize_footnotes() - self.resolve_footnotes_and_citations() - - def number_footnotes(self, startnum): - """ - Assign numbers to autonumbered footnotes. - - For labeled autonumbered footnotes, copy the number over to - corresponding footnote references. - """ - for footnote in self.document.autofootnotes: - while 1: - label = str(startnum) - startnum += 1 - if not self.document.nameids.has_key(label): - break - footnote.insert(0, nodes.label('', label)) - for name in footnote['names']: - for ref in self.document.footnote_refs.get(name, []): - ref += nodes.Text(label) - ref.delattr('refname') - assert len(footnote['ids']) == len(ref['ids']) == 1 - ref['refid'] = footnote['ids'][0] - footnote.add_backref(ref['ids'][0]) - self.document.note_refid(ref) - ref.resolved = 1 - if not footnote['names'] and not footnote['dupnames']: - footnote['names'].append(label) - self.document.note_explicit_target(footnote, footnote) - self.autofootnote_labels.append(label) - return startnum - - def number_footnote_references(self, startnum): - """Assign numbers to autonumbered footnote references.""" - i = 0 - for ref in self.document.autofootnote_refs: - if ref.resolved or ref.hasattr('refid'): - continue - try: - label = self.autofootnote_labels[i] - except IndexError: - msg = self.document.reporter.error( - 'Too many autonumbered footnote references: only %s ' - 'corresponding footnotes available.' - % len(self.autofootnote_labels), base_node=ref) - msgid = self.document.set_id(msg) - for ref in self.document.autofootnote_refs[i:]: - if ref.resolved or ref.hasattr('refname'): - continue - prb = nodes.problematic( - ref.rawsource, ref.rawsource, refid=msgid) - prbid = self.document.set_id(prb) - msg.add_backref(prbid) - ref.replace_self(prb) - break - ref += nodes.Text(label) - id = self.document.nameids[label] - footnote = self.document.ids[id] - ref['refid'] = id - self.document.note_refid(ref) - assert len(ref['ids']) == 1 - footnote.add_backref(ref['ids'][0]) - ref.resolved = 1 - i += 1 - - def symbolize_footnotes(self): - """Add symbols indexes to "[]"-style footnotes and references.""" - labels = [] - for footnote in self.document.symbol_footnotes: - reps, index = divmod(self.document.symbol_footnote_start, - len(self.symbols)) - labeltext = self.symbols[index] * (reps + 1) - labels.append(labeltext) - footnote.insert(0, nodes.label('', labeltext)) - self.document.symbol_footnote_start += 1 - self.document.set_id(footnote) - i = 0 - for ref in self.document.symbol_footnote_refs: - try: - ref += nodes.Text(labels[i]) - except IndexError: - msg = self.document.reporter.error( - 'Too many symbol footnote references: only %s ' - 'corresponding footnotes available.' % len(labels), - base_node=ref) - msgid = self.document.set_id(msg) - for ref in self.document.symbol_footnote_refs[i:]: - if ref.resolved or ref.hasattr('refid'): - continue - prb = nodes.problematic( - ref.rawsource, ref.rawsource, refid=msgid) - prbid = self.document.set_id(prb) - msg.add_backref(prbid) - ref.replace_self(prb) - break - footnote = self.document.symbol_footnotes[i] - assert len(footnote['ids']) == 1 - ref['refid'] = footnote['ids'][0] - self.document.note_refid(ref) - footnote.add_backref(ref['ids'][0]) - i += 1 - - def resolve_footnotes_and_citations(self): - """ - Link manually-labeled footnotes and citations to/from their - references. - """ - for footnote in self.document.footnotes: - for label in footnote['names']: - if self.document.footnote_refs.has_key(label): - reflist = self.document.footnote_refs[label] - self.resolve_references(footnote, reflist) - for citation in self.document.citations: - for label in citation['names']: - if self.document.citation_refs.has_key(label): - reflist = self.document.citation_refs[label] - self.resolve_references(citation, reflist) - - def resolve_references(self, note, reflist): - assert len(note['ids']) == 1 - id = note['ids'][0] - for ref in reflist: - if ref.resolved: - continue - ref.delattr('refname') - ref['refid'] = id - assert len(ref['ids']) == 1 - note.add_backref(ref['ids'][0]) - ref.resolved = 1 - note.resolved = 1 - - -class CircularSubstitutionDefinitionError(Exception): pass - - -class Substitutions(Transform): - - """ - Given the following ``document`` as input:: - - <document> - <paragraph> - The - <substitution_reference refname="biohazard"> - biohazard - symbol is deservedly scary-looking. - <substitution_definition name="biohazard"> - <image alt="biohazard" uri="biohazard.png"> - - The ``substitution_reference`` will simply be replaced by the - contents of the corresponding ``substitution_definition``. - - The transformed result will be:: - - <document> - <paragraph> - The - <image alt="biohazard" uri="biohazard.png"> - symbol is deservedly scary-looking. - <substitution_definition name="biohazard"> - <image alt="biohazard" uri="biohazard.png"> - """ - - default_priority = 220 - """The Substitutions transform has to be applied very early, before - `docutils.tranforms.frontmatter.DocTitle` and others.""" - - def apply(self): - defs = self.document.substitution_defs - normed = self.document.substitution_names - subreflist = self.document.traverse(nodes.substitution_reference) - nested = {} - for ref in subreflist: - refname = ref['refname'] - key = None - if defs.has_key(refname): - key = refname - else: - normed_name = refname.lower() - if normed.has_key(normed_name): - key = normed[normed_name] - if key is None: - msg = self.document.reporter.error( - 'Undefined substitution referenced: "%s".' - % refname, base_node=ref) - msgid = self.document.set_id(msg) - prb = nodes.problematic( - ref.rawsource, ref.rawsource, refid=msgid) - prbid = self.document.set_id(prb) - msg.add_backref(prbid) - ref.replace_self(prb) - else: - subdef = defs[key] - parent = ref.parent - index = parent.index(ref) - if (subdef.attributes.has_key('ltrim') - or subdef.attributes.has_key('trim')): - if index > 0 and isinstance(parent[index - 1], - nodes.Text): - parent.replace(parent[index - 1], - parent[index - 1].rstrip()) - if (subdef.attributes.has_key('rtrim') - or subdef.attributes.has_key('trim')): - if (len(parent) > index + 1 - and isinstance(parent[index + 1], nodes.Text)): - parent.replace(parent[index + 1], - parent[index + 1].lstrip()) - subdef_copy = subdef.deepcopy() - try: - # Take care of nested substitution references: - for nested_ref in subdef_copy.traverse( - nodes.substitution_reference): - nested_name = normed[nested_ref['refname'].lower()] - if nested_name in nested.setdefault(nested_name, []): - raise CircularSubstitutionDefinitionError - else: - nested[nested_name].append(key) - subreflist.append(nested_ref) - except CircularSubstitutionDefinitionError: - parent = ref.parent - if isinstance(parent, nodes.substitution_definition): - msg = self.document.reporter.error( - 'Circular substitution definition detected:', - nodes.literal_block(parent.rawsource, - parent.rawsource), - line=parent.line, base_node=parent) - parent.replace_self(msg) - else: - msg = self.document.reporter.error( - 'Circular substitution definition referenced: "%s".' - % refname, base_node=ref) - msgid = self.document.set_id(msg) - prb = nodes.problematic( - ref.rawsource, ref.rawsource, refid=msgid) - prbid = self.document.set_id(prb) - msg.add_backref(prbid) - ref.replace_self(prb) - else: - ref.replace_self(subdef_copy.children) - - -class TargetNotes(Transform): - - """ - Creates a footnote for each external target in the text, and corresponding - footnote references after each reference. - """ - - default_priority = 540 - """The TargetNotes transform has to be applied after `IndirectHyperlinks` - but before `Footnotes`.""" - - - def init(self, document, startnode): - Transform.init(self, document, startnode=startnode) - - self.classes = startnode.details.get('class', []) - - def apply(self): - notes = {} - nodelist = [] - for target in self.document.traverse(nodes.target): - # Only external targets. - if not target.hasattr('refuri'): - continue - names = target['names'] - refs = [] - for name in names: - refs.extend(self.document.refnames.get(name, [])) - if not refs: - continue - footnote = self.make_target_footnote(target['refuri'], refs, - notes) - if not notes.has_key(target['refuri']): - notes[target['refuri']] = footnote - nodelist.append(footnote) - # Take care of anonymous references. - for ref in self.document.traverse(nodes.reference): - if not ref.get('anonymous'): - continue - if ref.hasattr('refuri'): - footnote = self.make_target_footnote(ref['refuri'], [ref], - notes) - if not notes.has_key(ref['refuri']): - notes[ref['refuri']] = footnote - nodelist.append(footnote) - self.startnode.replace_self(nodelist) - - def make_target_footnote(self, refuri, refs, notes): - if notes.has_key(refuri): # duplicate? - footnote = notes[refuri] - assert len(footnote['names']) == 1 - footnote_name = footnote['names'][0] - else: # original - footnote = nodes.footnote() - footnote_id = self.document.set_id(footnote) - # Use uppercase letters and a colon; they can't be - # produced inside names by the parser. - footnote_name = 'TARGET_NOTE: ' + footnote_id - footnote['auto'] = 1 - footnote['names'] = [footnote_name] - footnote_paragraph = nodes.paragraph() - footnote_paragraph += nodes.reference('', refuri, refuri=refuri) - footnote += footnote_paragraph - self.document.note_autofootnote(footnote) - self.document.note_explicit_target(footnote, footnote) - for ref in refs: - if isinstance(ref, nodes.target): - continue - refnode = nodes.footnote_reference( - refname=footnote_name, auto=1) - refnode['classes'] += self.classes - self.document.note_autofootnote_ref(refnode) - self.document.note_footnote_ref(refnode) - index = ref.parent.index(ref) + 1 - reflist = [refnode] - if not utils.get_trim_footnote_ref_space(self.document.settings): - if self.classes: - reflist.insert(0, nodes.inline(text=' ', Classes=self.classes)) - else: - reflist.insert(0, nodes.Text(' ')) - ref.parent.insert(index, reflist) - return footnote - - -class DanglingReferences(Transform): - - """ - Check for dangling references (incl. footnote & citation) and for - unreferenced targets. - """ - - default_priority = 850 - - def apply(self): - visitor = DanglingReferencesVisitor( - self.document, - self.document.transformer.unknown_reference_resolvers) - self.document.walk(visitor) - # After resolving all references, check for unreferenced - # targets: - for target in self.document.traverse(nodes.target): - if not target.referenced: - if target.get('anonymous'): - # If we have unreferenced anonymous targets, there - # is already an error message about anonymous - # hyperlink mismatch; no need to generate another - # message. - continue - if target['names']: - naming = target['names'][0] - elif target['ids']: - naming = target['ids'][0] - else: - # Hack: Propagated targets always have their refid - # attribute set. - naming = target['refid'] - self.document.reporter.info( - 'Hyperlink target "%s" is not referenced.' - % naming, base_node=target) - - -class DanglingReferencesVisitor(nodes.SparseNodeVisitor): - - def init(self, document, unknown_reference_resolvers): - nodes.SparseNodeVisitor.init(self, document) - self.document = document - self.unknown_reference_resolvers = unknown_reference_resolvers - - def unknown_visit(self, node): - pass - - def visit_reference(self, node): - if node.resolved or not node.hasattr('refname'): - return - refname = node['refname'] - id = self.document.nameids.get(refname) - if id is None: - for resolver_function in self.unknown_reference_resolvers: - if resolver_function(node): - break - else: - if self.document.nameids.has_key(refname): - msg = self.document.reporter.error( - 'Duplicate target name, cannot be used as a unique ' - 'reference: "%s".' % (node['refname']), base_node=node) - else: - msg = self.document.reporter.error( - 'Unknown target name: "%s".' % (node['refname']), - base_node=node) - msgid = self.document.set_id(msg) - prb = nodes.problematic( - node.rawsource, node.rawsource, refid=msgid) - prbid = self.document.set_id(prb) - msg.add_backref(prbid) - node.replace_self(prb) - else: - del node['refname'] - node['refid'] = id - self.document.ids[id].note_referenced_by(id=id) - node.resolved = 1 - - visit_footnote_reference = visit_citation_reference = visit_reference diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/transforms/universal.py --- a/buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/transforms/universal.py Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,203 +0,0 @@ -# $Id: universal.py 4913 2007-02-12 04:05:20Z goodger $ -# Authors: David Goodger <goodger@python.org>; Ueli Schlaepfer -# Copyright: This module has been placed in the public domain. - -""" -Transforms needed by most or all documents: - -- `Decorations`: Generate a document's header & footer. -- `Messages`: Placement of system messages stored in - `nodes.document.transform_messages`. -- `TestMessages`: Like `Messages`, used on test runs. -- `FinalReferences`: Resolve remaining references. -""" - -docformat = 'reStructuredText' - -import re -import sys -import time -from docutils import nodes, utils -from docutils.transforms import TransformError, Transform - - -class Decorations(Transform): - - """ - Populate a document's decoration element (header, footer). - """ - - default_priority = 820 - - def apply(self): - header_nodes = self.generate_header() - if header_nodes: - decoration = self.document.get_decoration() - header = decoration.get_header() - header.extend(header_nodes) - footer_nodes = self.generate_footer() - if footer_nodes: - decoration = self.document.get_decoration() - footer = decoration.get_footer() - footer.extend(footer_nodes) - - def generate_header(self): - return None - - def generate_footer(self): - # @@@ Text is hard-coded for now. - # Should be made dynamic (language-dependent). - settings = self.document.settings - if settings.generator or settings.datestamp or settings.source_link \ - or settings.source_url: - text = [] - if settings.source_link and settings._source \ - or settings.source_url: - if settings.source_url: - source = settings.source_url - else: - source = utils.relative_path(settings._destination, - settings._source) - text.extend([ - nodes.reference('', 'View document source', - refuri=source), - nodes.Text('.\n')]) - if settings.datestamp: - datestamp = time.strftime(settings.datestamp, time.gmtime()) - text.append(nodes.Text('Generated on: ' + datestamp + '.\n')) - if settings.generator: - text.extend([ - nodes.Text('Generated by '), - nodes.reference('', 'Docutils', refuri= - 'http://docutils.sourceforge.net/'), - nodes.Text(' from '), - nodes.reference('', 'reStructuredText', refuri='http://' - 'docutils.sourceforge.net/rst.html'), - nodes.Text(' source.\n')]) - return [nodes.paragraph('', '', text)] - else: - return None - - -class ExposeInternals(Transform): - - """ - Expose internal attributes if ``expose_internals`` setting is set. - """ - - default_priority = 840 - - def not_Text(self, node): - return not isinstance(node, nodes.Text) - - def apply(self): - if self.document.settings.expose_internals: - for node in self.document.traverse(self.not_Text): - for att in self.document.settings.expose_internals: - value = getattr(node, att, None) - if value is not None: - node['internal:' + att] = value - - -class Messages(Transform): - - """ - Place any system messages generated after parsing into a dedicated section - of the document. - """ - - default_priority = 860 - - def apply(self): - unfiltered = self.document.transform_messages - threshold = self.document.reporter.report_level - messages = [] - for msg in unfiltered: - if msg['level'] >= threshold and not msg.parent: - messages.append(msg) - if messages: - section = nodes.section(classes=['system-messages']) - # @@@ get this from the language module? - section += nodes.title('', 'Docutils System Messages') - section += messages - self.document.transform_messages[:] = [] - self.document += section - - -class FilterMessages(Transform): - - """ - Remove system messages below verbosity threshold. - """ - - default_priority = 870 - - def apply(self): - for node in self.document.traverse(nodes.system_message): - if node['level'] < self.document.reporter.report_level: - node.parent.remove(node) - - -class TestMessages(Transform): - - """ - Append all post-parse system messages to the end of the document. - - Used for testing purposes. - """ - - default_priority = 880 - - def apply(self): - for msg in self.document.transform_messages: - if not msg.parent: - self.document += msg - - -class StripComments(Transform): - - """ - Remove comment elements from the document tree (only if the - ``strip_comments`` setting is enabled). - """ - - default_priority = 740 - - def apply(self): - if self.document.settings.strip_comments: - for node in self.document.traverse(nodes.comment): - node.parent.remove(node) - - -class StripClassesAndElements(Transform): - - """ - Remove from the document tree all elements with classes in - `self.document.settings.strip_elements_with_classes` and all "classes" - attribute values in `self.document.settings.strip_classes`. - """ - - default_priority = 750 - - def apply(self): - if not (self.document.settings.strip_elements_with_classes - or self.document.settings.strip_classes): - return - # prepare dicts for lookup (not sets, for Python 2.2 compatibility): - self.strip_elements = dict( - [(key, None) - for key in (self.document.settings.strip_elements_with_classes - or [])]) - self.strip_classes = dict( - [(key, None) for key in (self.document.settings.strip_classes - or [])]) - for node in self.document.traverse(self.check_classes): - node.parent.remove(node) - - def check_classes(self, node): - if isinstance(node, nodes.Element): - for class_value in node['classes'][:]: - if class_value in self.strip_classes: - node['classes'].remove(class_value) - if class_value in self.strip_elements: - return 1 diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/transforms/writer_aux.py --- a/buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/transforms/writer_aux.py Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,88 +0,0 @@ -# $Id: writer_aux.py 5174 2007-05-31 00:01:52Z wiemann $ -# Author: Lea Wiemann <LeWiemann@gmail.com> -# Copyright: This module has been placed in the public domain. - -""" -Auxiliary transforms mainly to be used by Writer components. - -This module is called "writer_aux" because otherwise there would be -conflicting imports like this one:: - - from docutils import writers - from docutils.transforms import writers -""" - -docformat = 'reStructuredText' - -from docutils import nodes, utils, languages -from docutils.transforms import Transform - - -class Compound(Transform): - - """ - Flatten all compound paragraphs. For example, transform :: - - <compound> - <paragraph> - <literal_block> - <paragraph> - - into :: - - <paragraph> - <literal_block classes="continued"> - <paragraph classes="continued"> - """ - - default_priority = 910 - - def apply(self): - for compound in self.document.traverse(nodes.compound): - first_child = 1 - for child in compound: - if first_child: - if not isinstance(child, nodes.Invisible): - first_child = 0 - else: - child['classes'].append('continued') - # Substitute children for compound. - compound.replace_self(compound[:]) - - -class Admonitions(Transform): - - """ - Transform specific admonitions, like this: - - <note> - <paragraph> - Note contents ... - - into generic admonitions, like this:: - - <admonition classes="note"> - <title> - Note - <paragraph> - Note contents ... - - The admonition title is localized. - """ - - default_priority = 920 - - def apply(self): - lcode = self.document.settings.language_code - language = languages.get_language(lcode) - for node in self.document.traverse(nodes.Admonition): - node_name = node.class.name - # Set class, so that we know what node this admonition came from. - node['classes'].append(node_name) - if not isinstance(node, nodes.admonition): - # Specific admonition. Transform into a generic admonition. - admonition = nodes.admonition(node.rawsource, node.children, - **node.attributes) - title = nodes.title('', language.labels[node_name]) - admonition.insert(0, title) - node.replace_self(admonition) diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/urischemes.py --- a/buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/urischemes.py Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,136 +0,0 @@ -# $Id: urischemes.py 4564 2006-05-21 20:44:42Z wiemann $ -# Author: David Goodger <goodger@python.org> -# Copyright: This module has been placed in the public domain. - -""" -`schemes` is a dictionary with lowercase URI addressing schemes as -keys and descriptions as values. It was compiled from the index at -http://www.iana.org/assignments/uri-schemes (revised 2005-11-28) -and an older list at http://www.w3.org/Addressing/schemes.html. -""" - -# Many values are blank and should be filled in with useful descriptions. - -schemes = { - 'about': 'provides information on Navigator', - 'acap': 'Application Configuration Access Protocol; RFC 2244', - 'addbook': "To add vCard entries to Communicator's Address Book", - 'afp': 'Apple Filing Protocol', - 'afs': 'Andrew File System global file names', - 'aim': 'AOL Instant Messenger', - 'callto': 'for NetMeeting links', - 'castanet': 'Castanet Tuner URLs for Netcaster', - 'chttp': 'cached HTTP supported by RealPlayer', - 'cid': 'content identifier; RFC 2392', - 'crid': 'TV-Anytime Content Reference Identifier; RFC 4078', - 'data': ('allows inclusion of small data items as "immediate" data; ' - 'RFC 2397'), - 'dav': 'Distributed Authoring and Versioning Protocol; RFC 2518', - 'dict': 'dictionary service protocol; RFC 2229', - 'dns': 'Domain Name System resources', - 'eid': ('External ID; non-URL data; general escape mechanism to allow ' - 'access to information for applications that are too ' - 'specialized to justify their own schemes'), - 'fax': ('a connection to a terminal that can handle telefaxes ' - '(facsimiles); RFC 2806'), - 'feed' : 'NetNewsWire feed', - 'file': 'Host-specific file names; RFC 1738', - 'finger': '', - 'freenet': '', - 'ftp': 'File Transfer Protocol; RFC 1738', - 'go': 'go; RFC 3368', - 'gopher': 'The Gopher Protocol', - 'gsm-sms': ('Global System for Mobile Communications Short Message ' - 'Service'), - 'h323': ('video (audiovisual) communication on local area networks; ' - 'RFC 3508'), - 'h324': ('video and audio communications over low bitrate connections ' - 'such as POTS modem connections'), - 'hdl': 'CNRI handle system', - 'hnews': 'an HTTP-tunneling variant of the NNTP news protocol', - 'http': 'Hypertext Transfer Protocol; RFC 2616', - 'https': 'HTTP over SSL; RFC 2818', - 'hydra': 'SubEthaEdit URI. See http://www.codingmonkeys.de/subethaedit.', - 'iioploc': 'Internet Inter-ORB Protocol Location?', - 'ilu': 'Inter-Language Unification', - 'im': 'Instant Messaging; RFC 3860', - 'imap': 'Internet Message Access Protocol; RFC 2192', - 'info': 'Information Assets with Identifiers in Public Namespaces', - 'ior': 'CORBA interoperable object reference', - 'ipp': 'Internet Printing Protocol; RFC 3510', - 'irc': 'Internet Relay Chat', - 'iris.beep': 'iris.beep; RFC 3983', - 'iseek' : 'See www.ambrosiasw.com; a little util for OS X.', - 'jar': 'Java archive', - 'javascript': ('JavaScript code; evaluates the expression after the ' - 'colon'), - 'jdbc': 'JDBC connection URI.', - 'ldap': 'Lightweight Directory Access Protocol', - 'lifn': '', - 'livescript': '', - 'lrq': '', - 'mailbox': 'Mail folder access', - 'mailserver': 'Access to data available from mail servers', - 'mailto': 'Electronic mail address; RFC 2368', - 'md5': '', - 'mid': 'message identifier; RFC 2392', - 'mocha': '', - 'modem': ('a connection to a terminal that can handle incoming data ' - 'calls; RFC 2806'), - 'mtqp': 'Message Tracking Query Protocol; RFC 3887', - 'mupdate': 'Mailbox Update (MUPDATE) Protocol; RFC 3656', - 'news': 'USENET news; RFC 1738', - 'nfs': 'Network File System protocol; RFC 2224', - 'nntp': 'USENET news using NNTP access; RFC 1738', - 'opaquelocktoken': 'RFC 2518', - 'phone': '', - 'pop': 'Post Office Protocol; RFC 2384', - 'pop3': 'Post Office Protocol v3', - 'pres': 'Presence; RFC 3859', - 'printer': '', - 'prospero': 'Prospero Directory Service; RFC 4157', - 'rdar' : ('URLs found in Darwin source ' - '(http://www.opensource.apple.com/darwinsource/).'), - 'res': '', - 'rtsp': 'real time streaming protocol; RFC 2326', - 'rvp': '', - 'rwhois': '', - 'rx': 'Remote Execution', - 'sdp': '', - 'service': 'service location; RFC 2609', - 'shttp': 'secure hypertext transfer protocol', - 'sip': 'Session Initiation Protocol; RFC 3261', - 'sips': 'secure session intitiaion protocol; RFC 3261', - 'smb': 'SAMBA filesystems.', - 'snews': 'For NNTP postings via SSL', - 'snmp': 'Simple Network Management Protocol; RFC 4088', - 'soap.beep': 'RFC 3288', - 'soap.beeps': 'RFC 3288', - 'ssh': 'Reference to interactive sessions via ssh.', - 't120': 'real time data conferencing (audiographics)', - 'tag': 'RFC 4151', - 'tcp': '', - 'tel': ('a connection to a terminal that handles normal voice ' - 'telephone calls, a voice mailbox or another voice messaging ' - 'system or a service that can be operated using DTMF tones; ' - 'RFC 2806.'), - 'telephone': 'telephone', - 'telnet': 'Reference to interactive sessions; RFC 4248', - 'tftp': 'Trivial File Transfer Protocol; RFC 3617', - 'tip': 'Transaction Internet Protocol; RFC 2371', - 'tn3270': 'Interactive 3270 emulation sessions', - 'tv': '', - 'urn': 'Uniform Resource Name; RFC 2141', - 'uuid': '', - 'vemmi': 'versatile multimedia interface; RFC 2122', - 'videotex': '', - 'view-source': 'displays HTML code that was generated with JavaScript', - 'wais': 'Wide Area Information Servers; RFC 4156', - 'whodp': '', - 'whois++': 'Distributed directory service.', - 'x-man-page': ('Opens man page in Terminal.app on OS X ' - '(see macosxhints.com)'), - 'xmlrpc.beep': 'RFC 3529', - 'xmlrpc.beeps': 'RFC 3529', - 'z39.50r': 'Z39.50 Retrieval; RFC 2056', - 'z39.50s': 'Z39.50 Session; RFC 2056',} diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/utils.py --- a/buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/utils.py Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,593 +0,0 @@ -# $Id: utils.py 5040 2007-04-03 17:41:59Z goodger $ -# Author: David Goodger <goodger@python.org> -# Copyright: This module has been placed in the public domain. - -""" -Miscellaneous utilities for the documentation utilities. -""" - -docformat = 'reStructuredText' - -import sys -import os -import os.path -import types -import warnings -import unicodedata -from types import StringType, UnicodeType -from docutils import ApplicationError, DataError -from docutils import nodes - - -class SystemMessage(ApplicationError): - - def init(self, system_message, level): - Exception.init(self, system_message.astext()) - self.level = level - - -class SystemMessagePropagation(ApplicationError): pass - - -class Reporter: - - """ - Info/warning/error reporter and ``system_message`` element generator. - - Five levels of system messages are defined, along with corresponding - methods: `debug()`, `info()`, `warning()`, `error()`, and `severe()`. - - There is typically one Reporter object per process. A Reporter object is - instantiated with thresholds for reporting (generating warnings) and - halting processing (raising exceptions), a switch to turn debug output on - or off, and an I/O stream for warnings. These are stored as instance - attributes. - - When a system message is generated, its level is compared to the stored - thresholds, and a warning or error is generated as appropriate. Debug - messages are produced iff the stored debug switch is on, independently of - other thresholds. Message output is sent to the stored warning stream if - not set to ''. - - The Reporter class also employs a modified form of the "Observer" pattern - [GoF95]_ to track system messages generated. The `attach_observer` method - should be called before parsing, with a bound method or function which - accepts system messages. The observer can be removed with - `detach_observer`, and another added in its place. - - .. [GoF95] Gamma, Helm, Johnson, Vlissides. Design Patterns: Elements of - Reusable Object-Oriented Software. Addison-Wesley, Reading, MA, USA, - 1995. - """ - - levels = 'DEBUG INFO WARNING ERROR SEVERE'.split() - """List of names for system message levels, indexed by level.""" - - # system message level constants: - (DEBUG_LEVEL, - INFO_LEVEL, - WARNING_LEVEL, - ERROR_LEVEL, - SEVERE_LEVEL) = range(5) - - def init(self, source, report_level, halt_level, stream=None, - debug=0, encoding='ascii', error_handler='replace'): - """ - :Parameters: - - `source`: The path to or description of the source data. - - `report_level`: The level at or above which warning output will - be sent to `stream`. - - `halt_level`: The level at or above which `SystemMessage` - exceptions will be raised, halting execution. - - `debug`: Show debug (level=0) system messages? - - `stream`: Where warning output is sent. Can be file-like (has a - ``.write`` method), a string (file name, opened for writing), - '' (empty string, for discarding all stream messages) or - `None` (implies `sys.stderr`; default). - - `encoding`: The encoding for stderr output. - - `error_handler`: The error handler for stderr output encoding. - """ - - self.source = source - """The path to or description of the source data.""" - - self.encoding = encoding - """The character encoding for the stderr output.""" - - self.error_handler = error_handler - """The character encoding error handler.""" - - self.debug_flag = debug - """Show debug (level=0) system messages?""" - - self.report_level = report_level - """The level at or above which warning output will be sent - to `self.stream`.""" - - self.halt_level = halt_level - """The level at or above which `SystemMessage` exceptions - will be raised, halting execution.""" - - if stream is None: - stream = sys.stderr - elif type(stream) in (StringType, UnicodeType): - # Leave stream untouched if it's ''. - if stream != '': - if type(stream) == StringType: - stream = open(stream, 'w') - elif type(stream) == UnicodeType: - stream = open(stream.encode(), 'w') - - self.stream = stream - """Where warning output is sent.""" - - self.observers = [] - """List of bound methods or functions to call with each system_message - created.""" - - self.max_level = -1 - """The highest level system message generated so far.""" - - def set_conditions(self, category, report_level, halt_level, - stream=None, debug=0): - warnings.warn('docutils.utils.Reporter.set_conditions deprecated; ' - 'set attributes via configuration settings or directly', - DeprecationWarning, stacklevel=2) - self.report_level = report_level - self.halt_level = halt_level - if stream is None: - stream = sys.stderr - self.stream = stream - self.debug_flag = debug - - def attach_observer(self, observer): - """ - The `observer` parameter is a function or bound method which takes one - argument, a `nodes.system_message` instance. - """ - self.observers.append(observer) - - def detach_observer(self, observer): - self.observers.remove(observer) - - def notify_observers(self, message): - for observer in self.observers: - observer(message) - - def system_message(self, level, message, *children, **kwargs): - """ - Return a system_message object. - - Raise an exception or generate a warning if appropriate. - """ - attributes = kwargs.copy() - if kwargs.has_key('base_node'): - source, line = get_source_line(kwargs['base_node']) - del attributes['base_node'] - if source is not None: - attributes.setdefault('source', source) - if line is not None: - attributes.setdefault('line', line) - attributes.setdefault('source', self.source) - msg = nodes.system_message(message, level=level, - type=self.levels[level], - *children, **attributes) - if self.stream and (level >= self.report_level - or self.debug_flag and level == self.DEBUG_LEVEL): - msgtext = msg.astext().encode(self.encoding, self.error_handler) - print >>self.stream, msgtext - if level >= self.halt_level: - raise SystemMessage(msg, level) - if level > self.DEBUG_LEVEL or self.debug_flag: - self.notify_observers(msg) - self.max_level = max(level, self.max_level) - return msg - - def debug(self, *args, **kwargs): - """ - Level-0, "DEBUG": an internal reporting issue. Typically, there is no - effect on the processing. Level-0 system messages are handled - separately from the others. - """ - if self.debug_flag: - return self.system_message(self.DEBUG_LEVEL, *args, **kwargs) - - def info(self, *args, **kwargs): - """ - Level-1, "INFO": a minor issue that can be ignored. Typically there is - no effect on processing, and level-1 system messages are not reported. - """ - return self.system_message(self.INFO_LEVEL, *args, **kwargs) - - def warning(self, *args, **kwargs): - """ - Level-2, "WARNING": an issue that should be addressed. If ignored, - there may be unpredictable problems with the output. - """ - return self.system_message(self.WARNING_LEVEL, *args, **kwargs) - - def error(self, *args, **kwargs): - """ - Level-3, "ERROR": an error that should be addressed. If ignored, the - output will contain errors. - """ - return self.system_message(self.ERROR_LEVEL, *args, **kwargs) - - def severe(self, *args, **kwargs): - """ - Level-4, "SEVERE": a severe error that must be addressed. If ignored, - the output will contain severe errors. Typically level-4 system - messages are turned into exceptions which halt processing. - """ - return self.system_message(self.SEVERE_LEVEL, *args, **kwargs) - - -class ExtensionOptionError(DataError): pass -class BadOptionError(ExtensionOptionError): pass -class BadOptionDataError(ExtensionOptionError): pass -class DuplicateOptionError(ExtensionOptionError): pass - - -def extract_extension_options(field_list, options_spec): - """ - Return a dictionary mapping extension option names to converted values. - - :Parameters: - - `field_list`: A flat field list without field arguments, where each - field body consists of a single paragraph only. - - `options_spec`: Dictionary mapping known option names to a - conversion function such as `int` or `float`. - - :Exceptions: - - `KeyError` for unknown option names. - - `ValueError` for invalid option values (raised by the conversion - function). - - `TypeError` for invalid option value types (raised by conversion - function). - - `DuplicateOptionError` for duplicate options. - - `BadOptionError` for invalid fields. - - `BadOptionDataError` for invalid option data (missing name, - missing data, bad quotes, etc.). - """ - option_list = extract_options(field_list) - option_dict = assemble_option_dict(option_list, options_spec) - return option_dict - -def extract_options(field_list): - """ - Return a list of option (name, value) pairs from field names & bodies. - - :Parameter: - `field_list`: A flat field list, where each field name is a single - word and each field body consists of a single paragraph only. - - :Exceptions: - - `BadOptionError` for invalid fields. - - `BadOptionDataError` for invalid option data (missing name, - missing data, bad quotes, etc.). - """ - option_list = [] - for field in field_list: - if len(field[0].astext().split()) != 1: - raise BadOptionError( - 'extension option field name may not contain multiple words') - name = str(field[0].astext().lower()) - body = field[1] - if len(body) == 0: - data = None - elif len(body) > 1 or not isinstance(body[0], nodes.paragraph) \ - or len(body[0]) != 1 or not isinstance(body[0][0], nodes.Text): - raise BadOptionDataError( - 'extension option field body may contain\n' - 'a single paragraph only (option "%s")' % name) - else: - data = body[0][0].astext() - option_list.append((name, data)) - return option_list - -def assemble_option_dict(option_list, options_spec): - """ - Return a mapping of option names to values. - - :Parameters: - - `option_list`: A list of (name, value) pairs (the output of - `extract_options()`). - - `options_spec`: Dictionary mapping known option names to a - conversion function such as `int` or `float`. - - :Exceptions: - - `KeyError` for unknown option names. - - `DuplicateOptionError` for duplicate options. - - `ValueError` for invalid option values (raised by conversion - function). - - `TypeError` for invalid option value types (raised by conversion - function). - """ - options = {} - for name, value in option_list: - convertor = options_spec[name] # raises KeyError if unknown - if convertor is None: - raise KeyError(name) # or if explicitly disabled - if options.has_key(name): - raise DuplicateOptionError('duplicate option "%s"' % name) - try: - options[name] = convertor(value) - except (ValueError, TypeError), detail: - raise detail.class('(option: "%s"; value: %r)\n%s' - % (name, value, ' '.join(detail.args))) - return options - - -class NameValueError(DataError): pass - - -def extract_name_value(line): - """ - Return a list of (name, value) from a line of the form "name=value ...". - - :Exception: - `NameValueError` for invalid input (missing name, missing data, bad - quotes, etc.). - """ - attlist = [] - while line: - equals = line.find('=') - if equals == -1: - raise NameValueError('missing "="') - attname = line[:equals].strip() - if equals == 0 or not attname: - raise NameValueError( - 'missing attribute name before "="') - line = line[equals+1:].lstrip() - if not line: - raise NameValueError( - 'missing value after "%s="' % attname) - if line[0] in '\'"': - endquote = line.find(line[0], 1) - if endquote == -1: - raise NameValueError( - 'attribute "%s" missing end quote (%s)' - % (attname, line[0])) - if len(line) > endquote + 1 and line[endquote + 1].strip(): - raise NameValueError( - 'attribute "%s" end quote (%s) not followed by ' - 'whitespace' % (attname, line[0])) - data = line[1:endquote] - line = line[endquote+1:].lstrip() - else: - space = line.find(' ') - if space == -1: - data = line - line = '' - else: - data = line[:space] - line = line[space+1:].lstrip() - attlist.append((attname.lower(), data)) - return attlist - -def new_reporter(source_path, settings): - """ - Return a new Reporter object. - - :Parameters: - `source` : string - The path to or description of the source text of the document. - `settings` : optparse.Values object - Runtime settings. - """ - reporter = Reporter( - source_path, settings.report_level, settings.halt_level, - stream=settings.warning_stream, debug=settings.debug, - encoding=settings.error_encoding, - error_handler=settings.error_encoding_error_handler) - return reporter - -def new_document(source_path, settings=None): - """ - Return a new empty document object. - - :Parameters: - `source_path` : string - The path to or description of the source text of the document. - `settings` : optparse.Values object - Runtime settings. If none provided, a default set will be used. - """ - from docutils import frontend - if settings is None: - settings = frontend.OptionParser().get_default_values() - reporter = new_reporter(source_path, settings) - document = nodes.document(settings, reporter, source=source_path) - document.note_source(source_path, -1) - return document - -def clean_rcs_keywords(paragraph, keyword_substitutions): - if len(paragraph) == 1 and isinstance(paragraph[0], nodes.Text): - textnode = paragraph[0] - for pattern, substitution in keyword_substitutions: - match = pattern.search(textnode.data) - if match: - textnode.data = pattern.sub(substitution, textnode.data) - return - -def relative_path(source, target): - """ - Build and return a path to `target`, relative to `source` (both files). - - If there is no common prefix, return the absolute path to `target`. - """ - source_parts = os.path.abspath(source or 'dummy_file').split(os.sep) - target_parts = os.path.abspath(target).split(os.sep) - # Check first 2 parts because '/dir'.split('/') == ['', 'dir']: - if source_parts[:2] != target_parts[:2]: - # Nothing in common between paths. - # Return absolute path, using '/' for URLs: - return '/'.join(target_parts) - source_parts.reverse() - target_parts.reverse() - while (source_parts and target_parts - and source_parts[-1] == target_parts[-1]): - # Remove path components in common: - source_parts.pop() - target_parts.pop() - target_parts.reverse() - parts = ['..'] * (len(source_parts) - 1) + target_parts - return '/'.join(parts) - -def get_stylesheet_reference(settings, relative_to=None): - """ - Retrieve a stylesheet reference from the settings object. - """ - if settings.stylesheet_path: - assert not settings.stylesheet, \ - 'stylesheet and stylesheet_path are mutually exclusive.' - if relative_to == None: - relative_to = settings._destination - return relative_path(relative_to, settings.stylesheet_path) - else: - return settings.stylesheet - -def get_trim_footnote_ref_space(settings): - """ - Return whether or not to trim footnote space. - - If trim_footnote_reference_space is not None, return it. - - If trim_footnote_reference_space is None, return False unless the - footnote reference style is 'superscript'. - """ - if settings.trim_footnote_reference_space is None: - return hasattr(settings, 'footnote_references') and \ - settings.footnote_references == 'superscript' - else: - return settings.trim_footnote_reference_space - -def get_source_line(node): - """ - Return the "source" and "line" attributes from the `node` given or from - its closest ancestor. - """ - while node: - if node.source or node.line: - return node.source, node.line - node = node.parent - return None, None - -def escape2null(text): - """Return a string with escape-backslashes converted to nulls.""" - parts = [] - start = 0 - while 1: - found = text.find('\\', start) - if found == -1: - parts.append(text[start:]) - return ''.join(parts) - parts.append(text[start:found]) - parts.append('\x00' + text[found+1:found+2]) - start = found + 2 # skip character after escape - -def unescape(text, restore_backslashes=0): - """ - Return a string with nulls removed or restored to backslashes. - Backslash-escaped spaces are also removed. - """ - if restore_backslashes: - return text.replace('\x00', '\\') - else: - for sep in ['\x00 ', '\x00\n', '\x00']: - text = ''.join(text.split(sep)) - return text - -east_asian_widths = {'W': 2, # Wide - 'F': 2, # Full-width (wide) - 'Na': 1, # Narrow - 'H': 1, # Half-width (narrow) - 'N': 1, # Neutral (not East Asian, treated as narrow) - 'A': 1} # Ambiguous (s/b wide in East Asian context, - # narrow otherwise, but that doesn't work) -"""Mapping of result codes from `unicodedata.east_asian_width()` to character -column widths.""" - -def east_asian_column_width(text): - if isinstance(text, types.UnicodeType): - total = 0 - for c in text: - total += east_asian_widths[unicodedata.east_asian_width(c)] - return total - else: - return len(text) - -if hasattr(unicodedata, 'east_asian_width'): - column_width = east_asian_column_width -else: - column_width = len - -def uniq(L): - r = [] - for item in L: - if not item in r: - r.append(item) - return r - - -class DependencyList: - - """ - List of dependencies, with file recording support. - - Note that the output file is not automatically closed. You have - to explicitly call the close() method. - """ - - def init(self, output_file=None, dependencies=[]): - """ - Initialize the dependency list, automatically setting the - output file to `output_file` (see `set_output()`) and adding - all supplied dependencies. - """ - self.set_output(output_file) - for i in dependencies: - self.add(i) - - def set_output(self, output_file): - """ - Set the output file and clear the list of already added - dependencies. - - `output_file` must be a string. The specified file is - immediately overwritten. - - If output_file is '-', the output will be written to stdout. - If it is None, no file output is done when calling add(). - """ - self.list = [] - if output_file == '-': - self.file = sys.stdout - elif output_file: - self.file = open(output_file, 'w') - else: - self.file = None - - def add(self, filename): - """ - If the dependency `filename` has not already been added, - append it to self.list and print it to self.file if self.file - is not None. - """ - if not filename in self.list: - self.list.append(filename) - if self.file is not None: - print >>self.file, filename - - def close(self): - """ - Close the output file. - """ - self.file.close() - self.file = None - - def repr(self): - if self.file: - output_file = self.file.name - else: - output_file = None - return '%s(%r, %s)' % (self.class.name, output_file, self.list) diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/writers/init.py --- a/buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/writers/init.py Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,133 +0,0 @@ -# $Id: init.py 4913 2007-02-12 04:05:20Z goodger $ -# Author: David Goodger <goodger@python.org> -# Copyright: This module has been placed in the public domain. - -""" -This package contains Docutils Writer modules. -""" - -docformat = 'reStructuredText' - - -import os.path -import docutils -from docutils import languages, Component -from docutils.transforms import universal - - -class Writer(Component): - - """ - Abstract base class for docutils Writers. - - Each writer module or package must export a subclass also called 'Writer'. - Each writer must support all standard node types listed in - `docutils.nodes.node_class_names`. - - The `write()` method is the main entry point. - """ - - component_type = 'writer' - config_section = 'writers' - - def get_transforms(self): - return Component.get_transforms(self) + [ - universal.Messages, - universal.FilterMessages, - universal.StripClassesAndElements,] - - document = None - """The document to write (Docutils doctree); set by `write`.""" - - output = None - """Final translated form of `document` (Unicode string for text, binary - string for other forms); set by `translate`.""" - - language = None - """Language module for the document; set by `write`.""" - - destination = None - """`docutils.io` Output object; where to write the document. - Set by `write`.""" - - def init(self): - - # Currently only used by HTML writer for output fragments: - self.parts = {} - """Mapping of document part names to fragments of `self.output`. - Values are Unicode strings; encoding is up to the client. The 'whole' - key should contain the entire document output. - """ - - def write(self, document, destination): - """ - Process a document into its final form. - - Translate `document` (a Docutils document tree) into the Writer's - native format, and write it out to its `destination` (a - `docutils.io.Output` subclass object). - - Normally not overridden or extended in subclasses. - """ - self.document = document - self.language = languages.get_language( - document.settings.language_code) - self.destination = destination - self.translate() - output = self.destination.write(self.output) - return output - - def translate(self): - """ - Do final translation of `self.document` into `self.output`. Called - from `write`. Override in subclasses. - - Usually done with a `docutils.nodes.NodeVisitor` subclass, in - combination with a call to `docutils.nodes.Node.walk()` or - `docutils.nodes.Node.walkabout()`. The ``NodeVisitor`` subclass must - support all standard elements (listed in - `docutils.nodes.node_class_names`) and possibly non-standard elements - used by the current Reader as well. - """ - raise NotImplementedError('subclass must override this method') - - def assemble_parts(self): - """Assemble the `self.parts` dictionary. Extend in subclasses.""" - self.parts['whole'] = self.output - self.parts['encoding'] = self.document.settings.output_encoding - self.parts['version'] = docutils.version - - -class UnfilteredWriter(Writer): - - """ - A writer that passes the document tree on unchanged (e.g. a - serializer.) - - Documents written by UnfilteredWriters are typically reused at a - later date using a subclass of `readers.ReReader`. - """ - - def get_transforms(self): - # Do not add any transforms. When the document is reused - # later, the then-used writer will add the appropriate - # transforms. - return Component.get_transforms(self) - - -_writer_aliases = { - 'html': 'html4css1', - 'latex': 'latex2e', - 'pprint': 'pseudoxml', - 'pformat': 'pseudoxml', - 'pdf': 'rlpdf', - 'xml': 'docutils_xml', - 's5': 's5_html'} - -def get_writer_class(writer_name): - """Return the Writer class from the `writer_name` module.""" - writer_name = writer_name.lower() - if _writer_aliases.has_key(writer_name): - writer_name = _writer_aliases[writer_name] - module = import(writer_name, globals(), locals()) - return module.Writer diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/writers/docutils_xml.py --- a/buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/writers/docutils_xml.py Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,73 +0,0 @@ -# $Id: docutils_xml.py 4564 2006-05-21 20:44:42Z wiemann $ -# Author: David Goodger <goodger@python.org> -# Copyright: This module has been placed in the public domain. - -""" -Simple internal document tree Writer, writes Docutils XML. -""" - -docformat = 'reStructuredText' - - -import docutils -from docutils import frontend, writers - - -class Writer(writers.Writer): - - supported = ('xml',) - """Formats this writer supports.""" - - settings_spec = ( - '"Docutils XML" Writer Options', - 'Warning: the --newlines and --indents options may adversely affect ' - 'whitespace; use them only for reading convenience.', - (('Generate XML with newlines before and after tags.', - ['--newlines'], - {'action': 'store_true', 'validator': frontend.validate_boolean}), - ('Generate XML with indents and newlines.', - ['--indents'], - {'action': 'store_true', 'validator': frontend.validate_boolean}), - ('Omit the XML declaration. Use with caution.', - ['--no-xml-declaration'], - {'dest': 'xml_declaration', 'default': 1, 'action': 'store_false', - 'validator': frontend.validate_boolean}), - ('Omit the DOCTYPE declaration.', - ['--no-doctype'], - {'dest': 'doctype_declaration', 'default': 1, - 'action': 'store_false', 'validator': frontend.validate_boolean}),)) - - settings_defaults = {'output_encoding_error_handler': 'xmlcharrefreplace'} - - config_section = 'docutils_xml writer' - config_section_dependencies = ('writers',) - - output = None - """Final translated form of `document`.""" - - xml_declaration = '<?xml version="1.0" encoding="%s"?>\n' - #xml_stylesheet = '<?xml-stylesheet type="text/xsl" href="%s"?>\n' - doctype = ( - '<!DOCTYPE document PUBLIC' - ' "+//IDN docutils.sourceforge.net//DTD Docutils Generic//EN//XML"' - ' "http://docutils.sourceforge.net/docs/ref/docutils.dtd">\n') - generator = '\n' - - def translate(self): - settings = self.document.settings - indent = newline = '' - if settings.newlines: - newline = '\n' - if settings.indents: - newline = '\n' - indent = ' ' - output_prefix = [] - if settings.xml_declaration: - output_prefix.append( - self.xml_declaration % settings.output_encoding) - if settings.doctype_declaration: - output_prefix.append(self.doctype) - output_prefix.append(self.generator % docutils.version) - docnode = self.document.asdom().childNodes[0] - self.output = (''.join(output_prefix) - + docnode.toprettyxml(indent, newline)) diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/writers/html4css1/init.py --- a/buildframework/helium/external/python/lib/2.5/docutils-0.5-py2.5.egg/docutils/writers/html4css1/init.py Wed Oct 28 14:39:48 2009 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,1538 +0,0 @@ -# $Id: init.py 5314 2007-07-05 12:45:43Z wiemann $ -# Author: David Goodger <goodger@python.org> -# Copyright: This module has been placed in the public domain. - -""" -Simple HyperText Markup Language document tree Writer. - -The output conforms to the XHTML version 1.0 Transitional DTD -(almost strict). The output contains a minimum of formatting -information. The cascading style sheet "html4css1.css" is required -for proper viewing with a modern graphical browser. -""" - -docformat = 'reStructuredText' - - -import sys -import os -import os.path -import time -import re -from types import ListType -try: - import Image # check for the Python Imaging Library -except ImportError: - Image = None -import docutils -from docutils import frontend, nodes, utils, writers, languages -from docutils.transforms import writer_aux - - -class Writer(writers.Writer): - - supported = ('html', 'html4css1', 'xhtml') - """Formats this writer supports.""" - - default_stylesheet = 'html4css1.css' - - default_stylesheet_path = utils.relative_path( - os.path.join(os.getcwd(), 'dummy'), - os.path.join(os.path.dirname(file), default_stylesheet)) - - default_template = 'template.txt' - - default_template_path = utils.relative_path( - os.path.join(os.getcwd(), 'dummy'), - os.path.join(os.path.dirname(file), default_template)) - - settings_spec = ( - 'HTML-Specific Options', - None, - (('Specify the template file (UTF-8 encoded). Default is "%s".' - % default_template_path, - ['--template'], - {'default': default_template_path, 'metavar': '<file>'}), - ('Specify a stylesheet URL, used verbatim. Overrides ' - '--stylesheet-path.', - ['--stylesheet'], - {'metavar': '<URL>', 'overrides': 'stylesheet_path'}), - ('Specify a stylesheet file, relative to the current working ' - 'directory. The path is adjusted relative to the output HTML ' - 'file. Overrides --stylesheet. Default: "%s"' - % default_stylesheet_path, - ['--stylesheet-path'], - {'metavar': '<file>', 'overrides': 'stylesheet', - 'default': default_stylesheet_path}), - ('Embed the stylesheet in the output HTML file. The stylesheet ' - 'file must be accessible during processing (--stylesheet-path is ' - 'recommended). This is the default.', - ['--embed-stylesheet'], - {'default': 1, 'action': 'store_true', - 'validator': frontend.validate_boolean}), - ('Link to the stylesheet in the output HTML file. Default: ' - 'embed the stylesheet, do not link to it.', - ['--link-stylesheet'], - {'dest': 'embed_stylesheet', 'action': 'store_false'}), - ('Specify the initial header level. Default is 1 for "<h1>". ' - 'Does not affect document title & subtitle (see --no-doc-title).', - ['--initial-header-level'], - {'choices': '1 2 3 4 5 6'.split(), 'default': '1', - 'metavar': '<level>'}), - ('Specify the maximum width (in characters) for one-column field ' - 'names. Longer field names will span an entire row of the table ' - 'used to render the field list. Default is 14 characters. ' - 'Use 0 for "no limit".', - ['--field-name-limit'], - {'default': 14, 'metavar': '<level>', - 'validator': frontend.validate_nonnegative_int}), - ('Specify the maximum width (in characters) for options in option ' - 'lists. Longer options will span an entire row of the table used ' - 'to render the option list. Default is 14 characters. ' - 'Use 0 for "no limit".', - ['--option-limit'], - {'default': 14, 'metavar': '<level>', - 'validator': frontend.validate_nonnegative_int}), - ('Format for footnote references: one of "superscript" or ' - '"brackets". Default is "brackets".', - ['--footnote-references'], - {'choices': ['superscript', 'brackets'], 'default': 'brackets', - 'metavar': '<format>', - 'overrides': 'trim_footnote_reference_space'}), - ('Format for block quote attributions: one of "dash" (em-dash ' - 'prefix), "parentheses"/"parens", or "none". Default is "dash".', - ['--attribution'], - {'choices': ['dash', 'parentheses', 'parens', 'none'], - 'default': 'dash', 'metavar': '<format>'}), - ('Remove extra vertical whitespace between items of "simple" bullet ' - 'lists and enumerated lists. Default: enabled.', - ['--compact-lists'], - {'default': 1, 'action': 'store_true', - 'validator': frontend.validate_boolean}), - ('Disable compact simple bullet and enumerated lists.', - ['--no-compact-lists'], - {'dest': 'compact_lists', 'action': 'store_false'}), - ('Remove extra vertical whitespace between items of simple field ' - 'lists. Default: enabled.', - ['--compact-field-lists'], - {'default': 1, 'action': 'store_true', - 'validator': frontend.validate_boolean}), - ('Disable compact simple field lists.', - ['--no-compact-field-lists'], - {'dest': 'compact_field_lists', 'action': 'store_false'}), - ('Omit the XML declaration. Use with caution.', - ['--no-xml-declaration'], - {'dest': 'xml_declaration', 'default': 1, 'action': 'store_false', - 'validator': frontend.validate_boolean}), - ('Obfuscate email addresses to confuse harvesters while still ' - 'keeping email links usable with standards-compliant browsers.', - ['--cloak-email-addresses'], - {'action': 'store_true', 'validator': frontend.validate_boolean}),)) - - settings_defaults = {'output_encoding_error_handler': 'xmlcharrefreplace'} - - relative_path_settings = ('stylesheet_path',) - - config_section = 'html4css1 writer' - config_section_dependencies = ('writers',) - - visitor_attributes = ( - 'head_prefix', 'head', 'stylesheet', 'body_prefix', - 'body_pre_docinfo', 'docinfo', 'body', 'body_suffix', - 'title', 'subtitle', 'header', 'footer', 'meta', 'fragment', - 'html_prolog', 'html_head', 'html_title', 'html_subtitle', - 'html_body') - - def get_transforms(self): - return writers.Writer.get_transforms(self) + [writer_aux.Admonitions] - - def init(self): - writers.Writer.init(self) - self.translator_class = HTMLTranslator - - def translate(self): - self.visitor = visitor = self.translator_class(self.document) - self.document.walkabout(visitor) - for attr in self.visitor_attributes: - setattr(self, attr, getattr(visitor, attr)) - self.output = self.apply_template() - - def apply_template(self): - template_file = open(self.document.settings.template) - template = unicode(template_file.read(), 'utf-8') - template_file.close() - subs = self.interpolation_dict() - return template % subs - - def interpolation_dict(self): - subs = {} - settings = self.document.settings - for attr in self.visitor_attributes: - subs[attr] = ''.join(getattr(self, attr)).rstrip('\n') - subs['encoding'] = settings.output_encoding - subs['version'] = docutils.version - return subs - - def assemble_parts(self): - writers.Writer.assemble_parts(self) - for part in self.visitor_attributes: - self.parts[part] = ''.join(getattr(self, part)) - - -class HTMLTranslator(nodes.NodeVisitor): - - """ - This HTML writer has been optimized to produce visually compact - lists (less vertical whitespace). HTML's mixed content models - allow list items to contain "<li><p>body elements</p></li>" or - "<li>just text</li>" or even "<li>text<p>and body - elements</p>combined</li>", each with different effects. It would - be best to stick with strict body elements in list items, but they - affect vertical spacing in browsers (although they really - shouldn't). - - Here is an outline of the optimization: - - - Check for and omit <p> tags in "simple" lists: list items - contain either a single paragraph, a nested simple list, or a - paragraph followed by a nested simple list. This means that - this list can be compact: - - - Item 1. - - Item 2. - - But this list cannot be compact: - - - Item 1. - - This second paragraph forces space between list items. - - - Item 2. - - - In non-list contexts, omit <p> tags on a paragraph if that - paragraph is the only child of its parent (footnotes & citations - are allowed a label first). - - - Regardless of the above, in definitions, table cells, field bodies, - option descriptions, and list items, mark the first child with - 'class="first"' and the last child with 'class="last"'. The stylesheet - sets the margins (top & bottom respectively) to 0 for these elements. - - The ``no_compact_lists`` setting (``--no-compact-lists`` command-line - option) disables list whitespace optimization. - """ - - xml_declaration = '<?xml version="1.0" encoding="%s" ?>\n' - doctype = ( - '<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"' - ' "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">\n') - head_prefix_template = ('<html xmlns="http://www.w3.org/1999/xhtml"' - ' xml:lang="%s" lang="%s">\n<head>\n') - content_type = ('<meta http-equiv="Content-Type"' - ' content="text/html; charset=%s" />\n') - generator = ('<meta name="generator" content="Docutils %s: ' - 'http://docutils.sourceforge.net/" />\n') - stylesheet_link = '<link rel="stylesheet" href="%s" type="text/css" />\n' - embedded_stylesheet = '<style type="text/css">\n\n%s\n</style>\n' - words_and_spaces = re.compile(r'\S+| +|\n') - - def init(self, document): - nodes.NodeVisitor.init(self, document) - self.settings = settings = document.settings - lcode = settings.language_code - self.language = languages.get_language(lcode) - self.meta = [self.content_type % settings.output_encoding, - self.generator % docutils.version] - self.head_prefix = [] - self.html_prolog = [] - if settings.xml_declaration: - self.head_prefix.append(self.xml_declaration - % settings.output_encoding) - # encoding not interpolated: - self.html_prolog.append(self.xml_declaration) - self.head_prefix.extend([self.doctype, - self.head_prefix_template % (lcode, lcode)]) - self.html_prolog.append(self.doctype) - self.head = self.meta[:] - stylesheet = utils.get_stylesheet_reference(settings) - self.stylesheet = [] - if stylesheet: - if settings.embed_stylesheet: - stylesheet = utils.get_stylesheet_reference( - settings, os.path.join(os.getcwd(), 'dummy')) - settings.record_dependencies.add(stylesheet) - stylesheet_text = open(stylesheet).read() - self.stylesheet = [self.embedded_stylesheet % stylesheet_text] - else: - self.stylesheet = [self.stylesheet_link - % self.encode(stylesheet)] - self.body_prefix = ['</head>\n<body>\n'] - # document title, subtitle display - self.body_pre_docinfo = [] - # author, date, etc. - self.docinfo = [] - self.body = [] - self.fragment = [] - self.body_suffix = ['</body>\n</html>\n'] - self.section_level = 0 - self.initial_header_level = int(settings.initial_header_level) - # A heterogenous stack used in conjunction with the tree traversal. - # Make sure that the pops correspond to the pushes: - self.context = [] - self.topic_classes = [] - self.colspecs = [] - self.compact_p = 1 - self.compact_simple = None - self.compact_field_list = None - self.in_docinfo = None - self.in_sidebar = None - self.title = [] - self.subtitle = [] - self.header = [] - self.footer = [] - self.html_head = [self.content_type] # charset not interpolated - self.html_title = [] - self.html_subtitle = [] - self.html_body = [] - self.in_document_title = 0 - self.in_mailto = 0 - self.author_in_authors = None - - def astext(self): - return ''.join(self.head_prefix + self.head - + self.stylesheet + self.body_prefix - + self.body_pre_docinfo + self.docinfo - + self.body + self.body_suffix) - - def encode(self, text): - """Encode special characters in `text` & return.""" - # @@@ A codec to do these and all other HTML entities would be nice. - text = text.replace("&", "&") - text = text.replace("<", "<") - text = text.replace('"', """) - text = text.replace(">", ">") - text = text.replace("@", "@") # may thwart some address harvesters - # Replace the non-breaking space character with the HTML entity: - text = text.replace(u'\u00a0', " ") - return text - - def cloak_mailto(self, uri): - """Try to hide a mailto: URL from harvesters.""" - # Encode "@" using a URL octet reference (see RFC 1738). - # Further cloaking with HTML entities will be done in the - # `attval` function. - return uri.replace('@', '%40') - - def cloak_email(self, addr): - """Try to hide the link text of a email link from harversters.""" - # Surround at-signs and periods with <span> tags. ("@" has - # already been encoded to "@" by the `encode` method.) - addr = addr.replace('@', '<span>@</span>') - addr = addr.replace('.', '<span>.</span>') - return addr - - def attval(self, text, - whitespace=re.compile('[\n\r\t\v\f]')): - """Cleanse, HTML encode, and return attribute value text.""" - encoded = self.encode(whitespace.sub(' ', text)) - if self.in_mailto and self.settings.cloak_email_addresses: - # Cloak at-signs ("%40") and periods with HTML entities. - encoded = encoded.replace('%40', '%40') - encoded = encoded.replace('.', '.') - return encoded - - def starttag(self, node, tagname, suffix='\n', empty=0, **attributes): - """ - Construct and return a start tag given a node (id & class attributes - are extracted), tag name, and optional attributes. - """ - tagname = tagname.lower() - prefix = [] - atts = {} - ids = [] - for (name, value) in attributes.items(): - atts[name.lower()] = value - classes = node.get('classes', []) - if atts.has_key('class'): - classes.append(atts['class']) - if classes: - atts['class'] = ' '.join(classes) - assert not atts.has_key('id') - ids.extend(node.get('ids', [])) - if atts.has_key('ids'): - ids.extend(atts['ids']) - del atts['ids'] - if ids: - atts['id'] = ids[0] - for id in ids[1:]: - # Add empty "span" elements for additional IDs. Note - # that we cannot use empty "a" elements because there - # may be targets inside of references, but nested "a" - # elements aren't allowed in XHTML (even if they do - # not all have a "href" attribute). - if empty: - # Empty tag. Insert target right in front of element. - prefix.append('<span id="%s"></span>' % id) - else: - # Non-empty tag. Place the auxiliary <span> tag - # inside the element, as the first child. - suffix += '<span id="%s"></span>' % id - attlist = atts.items() - attlist.sort() - parts = [tagname] - for name, value in attlist: - # value=None was used for boolean attributes without - # value, but this isn't supported by XHTML. - assert value is not None - if isinstance(value, ListType): - values = [unicode(v) for v in value] - parts.append('%s="%s"' % (name.lower(), - self.attval(' '.join(values)))) - else: - parts.append('%s="%s"' % (name.lower(), - self.attval(unicode(value)))) - if empty: - infix = ' /' - else: - infix = '' - return ''.join(prefix) + '<%s%s>' % (' '.join(parts), infix) + suffix - - def emptytag(self, node, tagname, suffix='\n', attributes): - """Construct and return an XML-compatible empty tag.""" - return self.starttag(node, tagname, suffix, empty=1, attributes) - - def set_class_on_child(self, node, class_, index=0): - """ - Set class `class_` on the visible child no. index of `node`. - Do nothing if node has fewer children than `index`. - """ - children = [n for n in node if not isinstance(n, nodes.Invisible)] - try: - child = children[index] - except IndexError: - return - child['classes'].append(class_) - - def set_first_last(self, node): - self.set_class_on_child(node, 'first', 0) - self.set_class_on_child(node, 'last', -1) - - def visit_Text(self, node): - text = node.astext() - encoded = self.encode(text) - if self.in_mailto and self.settings.cloak_email_addresses: - encoded = self.cloak_email(encoded) - self.body.append(encoded) - - def depart_Text(self, node): - pass - - def visit_abbreviation(self, node): - # @@@ implementation incomplete ("title" attribute) - self.body.append(self.starttag(node, 'abbr', '')) - - def depart_abbreviation(self, node): - self.body.append('</abbr>') - - def visit_acronym(self, node): - # @@@ implementation incomplete ("title" attribute) - self.body.append(self.starttag(node, 'acronym', '')) - - def depart_acronym(self, node): - self.body.append('</acronym>') - - def visit_address(self, node): - self.visit_docinfo_item(node, 'address', meta=None) - self.body.append(self.starttag(node, 'pre', CLASS='address')) - - def depart_address(self, node): - self.body.append('\n</pre>\n') - self.depart_docinfo_item() - - def visit_admonition(self, node): - self.body.append(self.starttag(node, 'div')) - self.set_first_last(node) - - def depart_admonition(self, node=None): - self.body.append('</div>\n') - - attribution_formats = {'dash': ('—', ''), - 'parentheses': ('(', ')'), - 'parens': ('(', ')'), - 'none': ('', '')} - - def visit_attribution(self, node): - prefix, suffix = self.attribution_formats[self.settings.attribution] - self.context.append(suffix) - self.body.append( - self.starttag(node, 'p', prefix, CLASS='attribution')) - - def depart_attribution(self, node): - self.body.append(self.context.pop() + '</p>\n') - - def visit_author(self, node): - if isinstance(node.parent, nodes.authors): - if self.author_in_authors: - self.body.append('\n<br />') - else: - self.visit_docinfo_item(node, 'author') - - def depart_author(self, node): - if isinstance(node.parent, nodes.authors): - self.author_in_authors += 1 - else: - self.depart_docinfo_item() - - def visit_authors(self, node): - self.visit_docinfo_item(node, 'authors') - self.author_in_authors = 0 # initialize counter - - def depart_authors(self, node): - self.depart_docinfo_item() - self.author_in_authors = None - - def visit_block_quote(self, node): - self.body.append(self.starttag(node, 'blockquote')) - - def depart_block_quote(self, node): - self.body.append('</blockquote>\n') - - def check_simple_list(self, node): - """Check for a simple list that can be rendered compactly.""" - visitor = SimpleListChecker(self.document) - try: - node.walk(visitor) - except nodes.NodeFound: - return None - else: - return 1 - - def is_compactable(self, node): - return ('compact' in node['classes'] - or (self.settings.compact_lists - and 'open' not in node['classes'] - and (self.compact_simple - or self.topic_classes == ['contents'] - or self.check_simple_list(node)))) - - def visit_bullet_list(self, node): - atts = {} - old_compact_simple = self.compact_simple - self.context.append((self.compact_simple, self.compact_p)) - self.compact_p = None - self.compact_simple = self.is_compactable(node) - if self.compact_simple and not old_compact_simple: - atts['class'] = 'simple' - self.body.append(self.starttag(node, 'ul', **atts)) - - def depart_bullet_list(self, node): - self.compact_simple, self.compact_p = self.context.pop() - self.body.append('</ul>\n') - - def visit_caption(self, node): - self.body.append(self.starttag(node, 'p', '', CLASS='caption')) - - def depart_caption(self, node): - self.body.append('</p>\n') - - def visit_citation(self, node): - self.body.append(self.starttag(node, 'table', - CLASS='docutils citation', - frame="void", rules="none")) - self.body.append('<colgroup><col class="label" /><col /></colgroup>\n' - '<tbody valign="top">\n' - '<tr>') - self.footnote_backrefs(node) - - def depart_citation(self, node): - self.body.append('</td></tr>\n' - '</tbody>\n</table>\n') - - def visit_citation_reference(self, node): - href = '#' + node['refid'] - self.body.append(self.starttag( - node, 'a', '[', CLASS='citation-reference', href=href)) - - def depart_citation_reference(self, node): - self.body.append(']</a>') - - def visit_classifier(self, node): - self.body.append(' <span class="classifier-delimiter">:</span> ') - self.body.append(self.starttag(node, 'span', '', CLASS='classifier')) - - def depart_classifier(self, node): - self.body.append('</span>') - - def visit_colspec(self, node): - self.colspecs.append(node) - # "stubs" list is an attribute of the tgroup element: - node.parent.stubs.append(node.attributes.get('stub')) - - def depart_colspec(self, node): - pass - - def write_colspecs(self): - width = 0 - for node in self.colspecs: - width += node['colwidth'] - for node in self.colspecs: - colwidth = int(node['colwidth'] * 100.0 / width + 0.5) - self.body.append(self.emptytag(node, 'col', - width='%i%%' % colwidth)) - self.colspecs = [] - - def visit_comment(self, node, - sub=re.compile('-(?=-)').sub): - """Escape double-dashes in comment text.""" - self.body.append('\n' % sub('- ', node.astext())) - # Content already processed: - raise nodes.SkipNode - - def visit_compound(self, node): - self.body.append(self.starttag(node, 'div', CLASS='compound')) - if len(node) > 1: - node[0]['classes'].append('compound-first') - node[-1]['classes'].append('compound-last') - for child in node[1:-1]: - child['classes'].append('compound-middle') - - def depart_compound(self, node): - self.body.append('</div>\n') - - def visit_container(self, node): - self.body.append(self.starttag(node, 'div', CLASS='container')) - - def depart_container(self, node): - self.body.append('</div>\n') - - def visit_contact(self, node): - self.visit_docinfo_item(node, 'contact', meta=None) - - def depart_contact(self, node): - self.depart_docinfo_item() - - def visit_copyright(self, node): - self.visit_docinfo_item(node, 'copyright') - - def depart_copyright(self, node): - self.depart_docinfo_item() - - def visit_date(self, node): - self.visit_docinfo_item(node, 'date') - - def depart_date(self, node): - self.depart_docinfo_item() - - def visit_decoration(self, node): - pass - - def depart_decoration(self, node): - pass - - def visit_definition(self, node): - self.body.append('</dt>\n') - self.body.append(self.starttag(node, 'dd', '')) - self.set_first_last(node) - - def depart_definition(self, node): - self.body.append('</dd>\n') - - def visit_definition_list(self, node): - self.body.append(self.starttag(node, 'dl', CLASS='docutils')) - - def depart_definition_list(self, node): - self.body.append('</dl>\n') - - def visit_definition_list_item(self, node): - pass - - def depart_definition_list_item(self, node): - pass - - def visit_description(self, node): - self.body.append(self.starttag(node, 'td', '')) - self.set_first_last(node) - - def depart_description(self, node): - self.body.append('</td>') - - def visit_docinfo(self, node): - self.context.append(len(self.body)) - self.body.append(self.starttag(node, 'table', - CLASS='docinfo', - frame="void", rules="none")) - self.body.append('<col class="docinfo-name" />\n' - '<col class="docinfo-content" />\n' - '<tbody valign="top">\n') - self.in_docinfo = 1 - - def depart_docinfo(self, node): - self.body.append('</tbody>\n</table>\n') - self.in_docinfo = None - start = self.context.pop() - self.docinfo = self.body[start:] - self.body = [] - - def visit_docinfo_item(self, node, name, meta=1): - if meta: - meta_tag = '<meta name="%s" content="%s" />\n' \ - % (name, self.attval(node.astext())) - self.add_meta(meta_tag) - self.body.append(self.starttag(node, 'tr', '')) - self.body.append('<th class="docinfo-name">%s:</th>\n<td>' - % self.language.labels[name]) - if len(node): - if isinstance(node[0], nodes.Element): - node[0]['classes'].append('first') - if isinstance(node[-1], nodes.Element): - node[-1]['classes'].append('last') - - def depart_docinfo_item(self): - self.body.append('</td></tr>\n') - - def visit_doctest_block(self, node): - self.body.append(self.starttag(node, 'pre', CLASS='doctest-block')) - - def depart_doctest_block(self, node): - self.body.append('\n</pre>\n') - - def visit_document(self, node): - self.head.append('<title>%s\n' - % self.encode(node.get('title', ''))) - - def depart_document(self, node): - self.fragment.extend(self.body) - self.body_prefix.append(self.starttag(node, 'div', CLASS='document')) - self.body_suffix.insert(0, '

\n') - # skip content-type meta tag with interpolated charset value: - self.html_head.extend(self.head[1:]) - self.html_body.extend(self.body_prefix[1:] + self.body_pre_docinfo - + self.docinfo + self.body - + self.body_suffix[:-1]) - assert not self.context, 'len(context) = %s' % len(self.context) - - def visit_emphasis(self, node): - self.body.append('') - - def depart_emphasis(self, node): - self.body.append('') - - def visit_entry(self, node): - atts = {'class': []} - if isinstance(node.parent.parent, nodes.thead): - atts['class'].append('head') - if node.parent.parent.parent.stubs[node.parent.column]: - # "stubs" list is an attribute of the tgroup element - atts['class'].append('stub') - if atts['class']: - tagname = 'th' - atts['class'] = ' '.join(atts['class']) - else: - tagname = 'td' - del atts['class'] - node.parent.column += 1 - if node.has_key('morerows'): - atts['rowspan'] = node['morerows'] + 1 - if node.has_key('morecols'): - atts['colspan'] = node['morecols'] + 1 - node.parent.column += node['morecols'] - self.body.append(self.starttag(node, tagname, '', **atts)) - self.context.append('\n' % tagname.lower()) - if len(node) == 0: # empty cell - self.body.append(' ') - self.set_first_last(node) - - def depart_entry(self, node): - self.body.append(self.context.pop()) - - def visit_enumerated_list(self, node): - """ - The 'start' attribute does not conform to HTML 4.01's strict.dtd, but - CSS1 doesn't help. CSS2 isn't widely enough supported yet to be - usable. - """ - atts = {} - if node.has_key('start'): - atts['start'] = node['start'] - if node.has_key('enumtype'): - atts['class'] = node['enumtype'] - # @@@ To do: prefix, suffix. How? Change prefix/suffix to a - # single "format" attribute? Use CSS2? - old_compact_simple = self.compact_simple - self.context.append((self.compact_simple, self.compact_p)) - self.compact_p = None - self.compact_simple = self.is_compactable(node) - if self.compact_simple and not old_compact_simple: - atts['class'] = (atts.get('class', '') + ' simple').strip() - self.body.append(self.starttag(node, 'ol', **atts)) - - def depart_enumerated_list(self, node): - self.compact_simple, self.compact_p = self.context.pop() - self.body.append('\n') - - def visit_field(self, node): - self.body.append(self.starttag(node, 'tr', '', CLASS='field')) - - def depart_field(self, node): - self.body.append('\n') - - def visit_field_body(self, node): - self.body.append(self.starttag(node, 'td', '', CLASS='field-body')) - self.set_class_on_child(node, 'first', 0) - field = node.parent - if (self.compact_field_list or - isinstance(field.parent, nodes.docinfo) or - field.parent.index(field) == len(field.parent) - 1): - # If we are in a compact list, the docinfo, or if this is - # the last field of the field list, do not add vertical - # space after last element. - self.set_class_on_child(node, 'last', -1) - - def depart_field_body(self, node): - self.body.append('\n') - - def visit_field_list(self, node): - self.context.append((self.compact_field_list, self.compact_p)) - self.compact_p = None - if 'compact' in node['classes']: - self.compact_field_list = 1 - elif (self.settings.compact_field_lists - and 'open' not in node['classes']): - self.compact_field_list = 1 - if self.compact_field_list: - for field in node: - field_body = field[-1] - assert isinstance(field_body, nodes.field_body) - children = [n for n in field_body - if not isinstance(n, nodes.Invisible)] - if not (len(children) == 0 or - len(children) == 1 and - isinstance(children[0], nodes.paragraph)): - self.compact_field_list = 0 - break - self.body.append(self.starttag(node, 'table', frame='void', - rules='none', - CLASS='docutils field-list')) - self.body.append('\n' - '\n' - '\n') - - def depart_field_list(self, node): - self.body.append('\n\n') - self.compact_field_list, self.compact_p = self.context.pop() - - def visit_field_name(self, node): - atts = {} - if self.in_docinfo: - atts['class'] = 'docinfo-name' - else: - atts['class'] = 'field-name' - if ( self.settings.field_name_limit - and len(node.astext()) > self.settings.field_name_limit): - atts['colspan'] = 2 - self.context.append('\n ') - else: - self.context.append('') - self.body.append(self.starttag(node, 'th', '', **atts)) - - def depart_field_name(self, node): - self.body.append(':') - self.body.append(self.context.pop()) - - def visit_figure(self, node): - atts = {'class': 'figure'} - if node.get('width'): - atts['style'] = 'width: %spx' % node['width'] - if node.get('align'): - atts['align'] = node['align'] - self.body.append(self.starttag(node, 'div', **atts)) - - def depart_figure(self, node): - self.body.append('\n') - - def visit_footer(self, node): - self.context.append(len(self.body)) - - def depart_footer(self, node): - start = self.context.pop() - footer = [self.starttag(node, 'div', CLASS='footer'), - '
\n'] - footer.extend(self.body[start:]) - footer.append('\n\n') - self.footer.extend(footer) - self.body_suffix[:0] = footer - del self.body[start:] - - def visit_footnote(self, node): - self.body.append(self.starttag(node, 'table', - CLASS='docutils footnote', - frame="void", rules="none")) - self.body.append('\n' - '\n' - '') - self.footnote_backrefs(node) - - def footnote_backrefs(self, node): - backlinks = [] - backrefs = node['backrefs'] - if self.settings.footnote_backlinks and backrefs: - if len(backrefs) == 1: - self.context.append('') - self.context.append('') - self.context.append('' - % backrefs[0]) - else: - i = 1 - for backref in backrefs: - backlinks.append('%s' - % (backref, i)) - i += 1 - self.context.append('(%s) ' % ', '.join(backlinks)) - self.context += ['', ''] - else: - self.context.append('') - self.context += ['', ''] - # If the node does not only consist of a label. - if len(node) > 1: - # If there are preceding backlinks, we do not set class - # 'first', because we need to retain the top-margin. - if not backlinks: - node[1]['classes'].append('first') - node[-1]['classes'].append('last') - - def depart_footnote(self, node): - self.body.append('\n' - '\n\n') - - def visit_footnote_reference(self, node): - href = '#' + node['refid'] - format = self.settings.footnote_references - if format == 'brackets': - suffix = '[' - self.context.append(']') - else: - assert format == 'superscript' - suffix = '^{'
- self.context.append('}') - self.body.append(self.starttag(node, 'a', suffix, - CLASS='footnote-reference', href=href)) - - def depart_footnote_reference(self, node): - self.body.append(self.context.pop() + '') - - def visit_generated(self, node): - pass - - def depart_generated(self, node): - pass - - def visit_header(self, node): - self.context.append(len(self.body)) - - def depart_header(self, node): - start = self.context.pop() - header = [self.starttag(node, 'div', CLASS='header')] - header.extend(self.body[start:]) - header.append('\n
\n\n') - self.body_prefix.extend(header) - self.header.extend(header) - del self.body[start:] - - def visit_image(self, node): - atts = {} - atts['src'] = node['uri'] - if node.has_key('width'): - atts['width'] = node['width'] - if node.has_key('height'): - atts['height'] = node['height'] - if node.has_key('scale'): - if Image and not (node.has_key('width') - and node.has_key('height')): - try: - im = Image.open(str(atts['src'])) - except (IOError, # Source image can't be found or opened - UnicodeError): # PIL doesn't like Unicode paths. - pass - else: - if not atts.has_key('width'): - atts['width'] = str(im.size[0]) - if not atts.has_key('height'): - atts['height'] = str(im.size[1]) - del im - for att_name in 'width', 'height': - if atts.has_key(att_name): - match = re.match(r'([0-9.]+)(\S*)$', atts[att_name]) - assert match - atts[att_name] = '%s%s' % ( - float(match.group(1)) * (float(node['scale']) / 100), - match.group(2)) - style = [] - for att_name in 'width', 'height': - if atts.has_key(att_name): - if re.match(r'^[0-9.]+$', atts[att_name]): - # Interpret unitless values as pixels. - atts[att_name] += 'px' - style.append('%s: %s;' % (att_name, atts[att_name])) - del atts[att_name] - if style: - atts['style'] = ' '.join(style) - atts['alt'] = node.get('alt', atts['src']) - if (isinstance(node.parent, nodes.TextElement) or - (isinstance(node.parent, nodes.reference) and - not isinstance(node.parent.parent, nodes.TextElement))): - # Inline context or surrounded by .... - suffix = '' - else: - suffix = '\n' - if node.has_key('align'): - if node['align'] == 'center': - # "align" attribute is set in surrounding "div" element. - self.body.append('
') - self.context.append('
\n') - suffix = '' - else: - # "align" attribute is set in "img" element. - atts['align'] = node['align'] - self.context.append('') - atts['class'] = 'align-%s' % node['align'] - else: - self.context.append('') - self.body.append(self.emptytag(node, 'img', suffix, **atts)) - - def depart_image(self, node): - self.body.append(self.context.pop()) - - def visit_inline(self, node): - self.body.append(self.starttag(node, 'span', '')) - - def depart_inline(self, node): - self.body.append('') - - def visit_label(self, node): - # Context added in footnote_backrefs. - self.body.append(self.starttag(node, 'td', '%s[' % self.context.pop(), - CLASS='label')) - - def depart_label(self, node): - # Context added in footnote_backrefs. - self.body.append(']%s%s' % (self.context.pop(), self.context.pop())) - - def visit_legend(self, node): - self.body.append(self.starttag(node, 'div', CLASS='legend')) - - def depart_legend(self, node): - self.body.append('\n') - - def visit_line(self, node): - self.body.append(self.starttag(node, 'div', suffix='', CLASS='line')) - if not len(node): - self.body.append('
') - - def depart_line(self, node): - self.body.append('\n') - - def visit_line_block(self, node): - self.body.append(self.starttag(node, 'div', CLASS='line-block')) - - def depart_line_block(self, node): - self.body.append('\n') - - def visit_list_item(self, node): - self.body.append(self.starttag(node, 'li', '')) - if len(node): - node[0]['classes'].append('first') - - def depart_list_item(self, node): - self.body.append('

' + - 'Ø<\/a>' + - '«<\/a>' + - '»<\/a>' + - '

"]||!tags.indexOf("",""]||tags.match(/^<(thead|tbody|tfoot|colg|cap)/)&&[1,"","

"]||!tags.indexOf("",""]||(!tags.indexOf("",""]||!tags.indexOf("",""]||jQuery.browser.msie&&[1,"div

","

').text(excerpt); + $.each(hlwords, function() { + rv = rv.highlightText(this, 'highlight'); + }); + return rv; +} + +/** + * Porter Stemmer + */ +var PorterStemmer = function() { + + var step2list = { + ational: 'ate', + tional: 'tion', + enci: 'ence', + anci: 'ance', + izer: 'ize', + bli: 'ble', + alli: 'al', + entli: 'ent', + eli: 'e', + ousli: 'ous', + ization: 'ize', + ation: 'ate', + ator: 'ate', + alism: 'al', + iveness: 'ive', + fulness: 'ful', + ousness: 'ous', + aliti: 'al', + iviti: 'ive', + biliti: 'ble', + logi: 'log' + }; + + var step3list = { + icate: 'ic', + ative: '', + alize: 'al', + iciti: 'ic', + ical: 'ic', + ful: '', + ness: '' + }; + + var c = "[^aeiou]"; // consonant + var v = "[aeiouy]"; // vowel + var C = c + "[^aeiouy]*"; // consonant sequence + var V = v + "[aeiou]*"; // vowel sequence + + var mgr0 = "^(" + C + ")?" + V + C; // [C]VC... is m>0 + var meq1 = "^(" + C + ")?" + V + C + "(" + V + ")?$"; // [C]VC[V] is m=1 + var mgr1 = "^(" + C + ")?" + V + C + V + C; // [C]VCVC... is m>1 + var s_v = "^(" + C + ")?" + v; // vowel in stem + + this.stemWord = function (w) { + var stem; + var suffix; + var firstch; + var origword = w; + + if (w.length < 3) + return w; + + var re; + var re2; + var re3; + var re4; + + firstch = w.substr(0,1); + if (firstch == "y") + w = firstch.toUpperCase() + w.substr(1); + + // Step 1a + re = /^(.+?)(ss|i)es$/; + re2 = /^(.+?)([^s])s$/; + + if (re.test(w)) + w = w.replace(re,"$1$2"); + else if (re2.test(w)) + w = w.replace(re2,"$1$2"); + + // Step 1b + re = /^(.+?)eed$/; + re2 = /^(.+?)(ed|ing)$/; + if (re.test(w)) { + var fp = re.exec(w); + re = new RegExp(mgr0); + if (re.test(fp[1])) { + re = /.$/; + w = w.replace(re,""); + } + } + else if (re2.test(w)) { + var fp = re2.exec(w); + stem = fp[1]; + re2 = new RegExp(s_v); + if (re2.test(stem)) { + w = stem; + re2 = /(at|bl|iz)$/; + re3 = new RegExp("([^aeiouylsz])\\1$"); + re4 = new RegExp("^" + C + v + "[^aeiouwxy]$"); + if (re2.test(w)) + w = w + "e"; + else if (re3.test(w)) { + re = /.$/; + w = w.replace(re,""); + } + else if (re4.test(w)) + w = w + "e"; + } + } + + // Step 1c + re = /^(.+?)y$/; + if (re.test(w)) { + var fp = re.exec(w); + stem = fp[1]; + re = new RegExp(s_v); + if (re.test(stem)) + w = stem + "i"; + } + + // Step 2 + re = /^(.+?)(ational|tional|enci|anci|izer|bli|alli|entli|eli|ousli|ization|ation|ator|alism|iveness|fulness|ousness|aliti|iviti|biliti|logi)$/; + if (re.test(w)) { + var fp = re.exec(w); + stem = fp[1]; + suffix = fp[2]; + re = new RegExp(mgr0); + if (re.test(stem)) + w = stem + step2list[suffix]; + } + + // Step 3 + re = /^(.+?)(icate|ative|alize|iciti|ical|ful|ness)$/; + if (re.test(w)) { + var fp = re.exec(w); + stem = fp[1]; + suffix = fp[2]; + re = new RegExp(mgr0); + if (re.test(stem)) + w = stem + step3list[suffix]; + } + + // Step 4 + re = /^(.+?)(al|ance|ence|er|ic|able|ible|ant|ement|ment|ent|ou|ism|ate|iti|ous|ive|ize)$/; + re2 = /^(.+?)(s|t)(ion)$/; + if (re.test(w)) { + var fp = re.exec(w); + stem = fp[1]; + re = new RegExp(mgr1); + if (re.test(stem)) + w = stem; + } + else if (re2.test(w)) { + var fp = re2.exec(w); + stem = fp[1] + fp[2]; + re2 = new RegExp(mgr1); + if (re2.test(stem)) + w = stem; + } + + // Step 5 + re = /^(.+?)e$/; + if (re.test(w)) { + var fp = re.exec(w); + stem = fp[1]; + re = new RegExp(mgr1); + re2 = new RegExp(meq1); + re3 = new RegExp("^" + C + v + "[^aeiouwxy]$"); + if (re.test(stem) || (re2.test(stem) && !(re3.test(stem)))) + w = stem; + } + re = /ll$/; + re2 = new RegExp(mgr1); + if (re.test(w) && re2.test(w)) { + re = /.$/; + w = w.replace(re,""); + } + + // and turn initial Y back to y + if (firstch == "y") + w = firstch.toLowerCase() + w.substr(1); + return w; + } +} + + +/** + * Search Module + */ +var Search = { + + _index : null, + _queued_query : null, + _pulse_status : -1, + + init : function() { + var params = $.getQueryParameters(); + if (params.q) { + var query = params.q[0]; + $('input[@name="q"]')[0].value = query; + this.performSearch(query); + } + }, + + /** + * Sets the index + */ + setIndex : function(index) { + var q; + this._index = index; + if ((q = this._queued_query) !== null) { + this._queued_query = null; + Search.query(q); + } + }, + + hasIndex : function() { + return this._index !== null; + }, + + deferQuery : function(query) { + this._queued_query = query; + }, + + stopPulse : function() { + this._pulse_status = 0; + }, + + startPulse : function() { + if (this._pulse_status >= 0) + return; + function pulse() { + Search._pulse_status = (Search._pulse_status + 1) % 4; + var dotString = ''; + for (var i = 0; i < Search._pulse_status; i++) + dotString += '.'; + Search.dots.text(dotString); + if (Search._pulse_status > -1) + window.setTimeout(pulse, 500); + }; + pulse(); + }, + + /** + * perform a search for something + */ + performSearch : function(query) { + // create the required interface elements + this.out = $('#search-results'); + this.title = $('

' + _('Searching') + '

').appendTo(this.out); + this.dots = $('').appendTo(this.title); + this.status = $('').appendTo(this.out); + this.output = $('

').appendTo(this.out); + + $('#search-progress').text(_('Preparing search...')); + this.startPulse(); + + // index already loaded, the browser was quick! + if (this.hasIndex()) + this.query(query); + else + this.setQuery(query); + }, + + query : function(query) { + // stem the searchterms and add them to the + // correct list + var stemmer = new PorterStemmer(); + var searchterms = []; + var excluded = []; + var hlterms = []; + var tmp = query.split(/\s+/); + var object = (tmp.length == 1) ? tmp[0].toLowerCase() : null; + for (var i = 0; i < tmp.length; i++) { + // stem the word + var word = stemmer.stemWord(tmp[i]).toLowerCase(); + // select the correct list + if (word[0] == '-') { + var toAppend = excluded; + word = word.substr(1); + } + else { + var toAppend = searchterms; + hlterms.push(tmp[i].toLowerCase()); + } + // only add if not already in the list + if (!$.contains(toAppend, word)) + toAppend.push(word); + }; + var highlightstring = '?highlight=' + $.urlencode(hlterms.join(" ")); + + console.debug('SEARCH: searching for:'); + console.info('required: ', searchterms); + console.info('excluded: ', excluded); + + // prepare search + var filenames = this._index.filenames; + var titles = this._index.titles; + var terms = this._index.terms; + var descrefs = this._index.descrefs; + var modules = this._index.modules; + var desctypes = this._index.desctypes; + var fileMap = {}; + var files = null; + var objectResults = []; + var regularResults = []; + $('#search-progress').empty(); + + // lookup as object + if (object != null) { + for (var module in modules) { + if (module.indexOf(object) > -1) { + fn = modules[module]; + descr = _('module, in ') + titles[fn]; + objectResults.push([filenames[fn], module, '#module-'+module, descr]); + } + } + for (var prefix in descrefs) { + for (var name in descrefs[prefix]) { + if (name.toLowerCase().indexOf(object) > -1) { + match = descrefs[prefix][name]; + fullname = (prefix ? prefix + '.' : '') + name; + descr = desctypes[match[1]] + _(', in ') + titles[match[0]]; + objectResults.push([filenames[match[0]], fullname, '#'+fullname, descr]); + } + } + } + } + + // sort results descending + objectResults.sort(function(a, b) { + return (a[1] > b[1]) ? -1 : ((a[1] < b[1]) ? 1 : 0); + }); + + + // perform the search on the required terms + for (var i = 0; i < searchterms.length; i++) { + var word = searchterms[i]; + // no match but word was a required one + if ((files = terms[word]) == null) + break; + if (files.length == undefined) { + files = [files]; + } + // create the mapping + for (var j = 0; j < files.length; j++) { + var file = files[j]; + if (file in fileMap) + fileMap[file].push(word); + else + fileMap[file] = [word]; + } + } + + // now check if the files don't contain excluded terms + for (var file in fileMap) { + var valid = true; + + // check if all requirements are matched + if (fileMap[file].length != searchterms.length) + continue; + + // ensure that none of the excluded terms is in the + // search result. + for (var i = 0; i < excluded.length; i++) { + if (terms[excluded[i]] == file || + $.contains(terms[excluded[i]] || [], file)) { + valid = false; + break; + } + } + + // if we have still a valid result we can add it + // to the result list + if (valid) + regularResults.push([filenames[file], titles[file], '', null]); + } + + // delete unused variables in order to not waste + // memory until list is retrieved completely + delete filenames, titles, terms; + + // now sort the regular results descending by title + regularResults.sort(function(a, b) { + var left = a[1].toLowerCase(); + var right = b[1].toLowerCase(); + return (left > right) ? -1 : ((left < right) ? 1 : 0); + }); + + // combine both + var results = regularResults.concat(objectResults); + + // print the results + var resultCount = results.length; + function displayNextItem() { + // results left, load the summary and display it + if (results.length) { + var item = results.pop(); + var listItem = $(''); + listItem.append($('

+      {{ text }}
+

+ + diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/Sphinx-0.5.1-py2.5.egg/sphinx/templates/changes/versionchanges.html --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/Sphinx-0.5.1-py2.5.egg/sphinx/templates/changes/versionchanges.html Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,33 @@ +{% macro entries changes %} +

{% for entry, docname, lineno in changes %} +

{{ entry }}

{% trans version=version|e, docstitle=docstitle|e %}Changes in Version {{ version }} — {{ docstitle }}{% endtrans %}

{% trans version=version|e %}Automatically generated list of changes in version {{ version }}{% endtrans %}

+ {% for modname, changes in libchanges %} +

+ {{ entries(changes) }} + {% endfor %} +

+ {{ entries(apichanges) }} +

+ {% for (fn, title), changes in otherchanges %} +

{{ title }} ({{ fn }})

+ {{ entries(changes) }} + {% endfor %} +

+ Welcome! This is + {% block description %}the documentation for {{ project|e }} + {{ release|e }}{% if last_updated %}, last updated {{ last_updated|e }}{% endif %}{% endblock %}. +

{{ _('Indices and tables:') }}

{{ _('Complete Table of Contents') }}
+ {{ _('lists all sections and subsections') }}

{{ _('Search Page') }}
+ {{ _('search this documentation') }}

{{ _('Global Module Index') }}
+ {{ _('quick access to all modules') }}

{{ _('General Index') }}
+ {{ _('all functions, classes, terms') }}

{% trans key=key %}Index – {{ key }}{% endtrans %}

{%- if links -%}{{ entryname|e }} + {%- for link in links[1:] %}, [{{ loop.index }}]{% endfor -%} + {%- else -%} +{{ entryname|e }} + {%- endif -%}

{{ subentryname|e }} + {%- for link in subentrylinks[1:] %}, [{{ loop.index }}]{% endfor -%} +

+{%- endif -%} +{%- endfor %} +

Index

{% for key, dummy in genindexentries -%} + {{ key }} + {% if not loop.last %}| {% endif %} + {%- endfor %}

{{ _('Full index on one page') }}

{{ _('Index pages by letter') }}:

{% for key, dummy in genindexentries -%} + {{ key }} + {% if not loop.last %}| {% endif %} + {%- endfor %}

{{ _('Full index on one page') }} + ({{ _('can be huge') }})

Index

{% for key, dummy in genindexentries -%} + {{ key }} + {% if not loop.last %}| {% endif %} + {%- endfor %}

{{ _('Full index on one page') }}

{{ key }}

{%- if links -%}{{ entryname|e }} + {%- for link in links[1:] %}, [{{ loop.index }}]{% endfor -%} + {%- else -%} +{{ entryname|e }} + {%- endif -%}

{{ subentryname|e }} + {%- for link in subentrylinks[1:] %}, [{{ loop.index }}]{% endfor -%} +

+{%- endif -%} +{%- endfor %} +

{% for key, dummy in genindexentries -%} + {{ key }} + {% if not loop.last %}| {% endif %} + {%- endfor %}

{{ _('Full index on one page') }}

+ {%- block sidebarlogo %} + {%- if logo %} +

+ +

+ {%- endif %} + {%- endblock %} + {%- block sidebartoc %} + {%- if display_toc %} +

+ {{ toc }} + {%- endif %} + {%- endblock %} + {%- block sidebarrel %} + {%- if prev %} +

+ {%- endif %} + {%- if next %} +

+ {%- endif %} + {%- endblock %} + {%- if sourcename %} +

+ + {%- endif %} + {%- if customsidebar %} + {{ rendertemplate(customsidebar) }} + {%- endif %} + {%- block sidebarsearch %} + {%- if pagename != "search" %} +

{% if builder == 'web' %}{{ _('Keyword search')}}{% else %}{{ _('Quick search') }}{% endif %}

+ + {%- if builder == 'web' %} +

+ {%- endif %} + {%- endif %} + {%- endblock %} +

+ {%- if builder != 'htmlhelp' %} +

+ {%- endif %} +

+ {% block body %} {% endblock %} +

+ {%- if builder != 'htmlhelp' %} +

+ {%- endif %} +

+{%- endblock %} + +{%- block sidebar2 %}{{ sidebar() }}{% endblock %} +

+ {%- if hasdoc('copyright') %} + {% trans path=pathto('copyright'), copyright=copyright|e %}© Copyright {{ copyright }}.{% endtrans %} + {%- else %} + {% trans copyright=copyright|e %}© Copyright {{ copyright }}.{% endtrans %} + {%- endif %} + {%- if last_updated %} + {% trans last_updated=last_updated|e %}Last updated on {{ last_updated }}.{% endtrans %} + {%- endif %} + {%- if show_sphinx %} + {% trans sphinx_version=sphinx_version|e %}Created using Sphinx {{ sphinx_version }}.{% endtrans %} + {%- endif %} +

+ {%- for module in freqentries %} + {{ module.name|e }} + {%- endfor %} +

{{ letter }}


	{{ fname }}
{% if collapse -%} + + {%- endif %}	{% if indent %} {% endif %} + {% if fname %}{% endif -%} + `{{ modname\|e }}` + {%- if fname %}{% endif %} + {%- if pform[0] %} ({{ pform\|join(', ') }}){% endif -%} +	{% if dep %}{{ _('Deprecated')}}:{% endif %} + {{ synops\|e }}

+ {{ project|e }} + {% trans docstitle=docstitle|e %}Search {{ docstitle }}{% endtrans %} + utf-8 + + {{ docstitle|e }} +{% block extra %} {# Put e.g. an element here. #} {% endblock %} +

+ {% trans %}Note: You requested an out-of-date URL from this server. We've tried to redirect you to the new location of this page, but it may not be the right one.{% endtrans %} +

+ {% trans %}From here you can search these documents. Enter your search + words into the box below and click "search". Note that the search + function will automatically search for all of the words. Pages + containing fewer words won't appear in the result list.{% endtrans %} +

+ {% if search_results %} +

{{ caption }} +
{{ context|e }}
+

+ {% endif %} +

' % node.astext()) + self.end_state() + raise nodes.SkipNode + + def visit_comment(self, node): + raise nodes.SkipNode + + def visit_meta(self, node): + # only valid for HTML + raise nodes.SkipNode + + def unknown_visit(self, node): + raise NotImplementedError('Unknown node: ' + node.__class__.__name__) diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/Sphinx-0.5.1-py2.5.egg/sphinx/util/__init__.py --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/Sphinx-0.5.1-py2.5.egg/sphinx/util/__init__.py Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,284 @@ +# -*- coding: utf-8 -*- +""" + sphinx.util + ~~~~~~~~~~~ + + Utility functions for Sphinx. + + :copyright: 2007-2008 by Georg Brandl. + :license: BSD. +""" + +import os +import re +import sys +import time +import fnmatch +import tempfile +import traceback +from os import path + + +# Generally useful regular expressions. +ws_re = re.compile(r'\s+') +caption_ref_re = re.compile(r'^([^<]+?)\s*<(.+)>$') + + +# SEP separates path elements in the canonical file names +# +# Define SEP as a manifest constant, not so much because we expect it to change +# in the future as to avoid the suspicion that a stray "/" in the code is a +# hangover from more *nix-oriented origins. +SEP = "/" + +def os_path(canonicalpath): + return canonicalpath.replace(SEP, os.path.sep) + + +def relative_uri(base, to): + """Return a relative URL from ``base`` to ``to``.""" + b2 = base.split(SEP) + t2 = to.split(SEP) + # remove common segments + for x, y in zip(b2, t2): + if x != y: + break + b2.pop(0) + t2.pop(0) + return ('..' + SEP) * (len(b2)-1) + SEP.join(t2) + + +def ensuredir(path): + """Ensure that a path exists.""" + try: + os.makedirs(path) + except OSError, err: + if not err.errno == 17: + raise + + +def walk(top, topdown=True, followlinks=False): + """ + Backport of os.walk from 2.6, where the followlinks argument was added. + """ + names = os.listdir(top) + + dirs, nondirs = [], [] + for name in names: + if path.isdir(path.join(top, name)): + dirs.append(name) + else: + nondirs.append(name) + + if topdown: + yield top, dirs, nondirs + for name in dirs: + fullpath = path.join(top, name) + if followlinks or not path.islink(fullpath): + for x in walk(fullpath, topdown, followlinks): + yield x + if not topdown: + yield top, dirs, nondirs + + +def get_matching_docs(dirname, suffix, exclude_docs=(), exclude_dirs=(), + exclude_trees=(), exclude_dirnames=()): + """ + Get all file names (without suffix) matching a suffix in a + directory, recursively. + + Exclude docs in *exclude_docs*, exclude dirs in *exclude_dirs*, + prune dirs in *exclude_trees*, prune dirnames in *exclude_dirnames*. + """ + pattern = '*' + suffix + # dirname is a normalized absolute path. + dirname = path.normpath(path.abspath(dirname)) + dirlen = len(dirname) + 1 # exclude slash + for root, dirs, files in walk(dirname, followlinks=True): + if root[dirlen:] in exclude_dirs: + continue + if root[dirlen:] in exclude_trees: + del dirs[:] + continue + dirs.sort() + files.sort() + for prunedir in exclude_dirnames: + if prunedir in dirs: + dirs.remove(prunedir) + for sfile in files: + if not fnmatch.fnmatch(sfile, pattern): + continue + qualified_name = path.join(root[dirlen:], sfile[:-len(suffix)]) + qualified_name = qualified_name.replace(os.path.sep, SEP) + if qualified_name in exclude_docs: + continue + yield qualified_name + + +def mtimes_of_files(dirnames, suffix): + for dirname in dirnames: + for root, dirs, files in os.walk(dirname): + for sfile in files: + if sfile.endswith(suffix): + try: + yield path.getmtime(path.join(root, sfile)) + except EnvironmentError: + pass + + +def shorten_result(text='', keywords=[], maxlen=240, fuzz=60): + if not text: + text = '' + text_low = text.lower() + beg = -1 + for k in keywords: + i = text_low.find(k.lower()) + if (i > -1 and i < beg) or beg == -1: + beg = i + excerpt_beg = 0 + if beg > fuzz: + for sep in ('.', ':', ';', '='): + eb = text.find(sep, beg - fuzz, beg - 1) + if eb > -1: + eb += 1 + break + else: + eb = beg - fuzz + excerpt_beg = eb + if excerpt_beg < 0: + excerpt_beg = 0 + msg = text[excerpt_beg:beg+maxlen] + if beg > fuzz: + msg = '... ' + msg + if beg < len(text)-maxlen: + msg = msg + ' ...' + return msg + + +class attrdict(dict): + def __getattr__(self, key): + return self[key] + def __setattr__(self, key, val): + self[key] = val + def __delattr__(self, key): + del self[key] + + +def fmt_ex(ex): + """Format a single line with an exception description.""" + return traceback.format_exception_only(ex.__class__, ex)[-1].strip() + + +def rpartition(s, t): + """Similar to str.rpartition from 2.5, but doesn't return the separator.""" + i = s.rfind(t) + if i != -1: + return s[:i], s[i+len(t):] + return '', s + + +def format_exception_cut_frames(x=1): + """ + Format an exception with traceback, but only the last x frames. + """ + typ, val, tb = sys.exc_info() + #res = ['Traceback (most recent call last):\n'] + res = [] + tbres = traceback.format_tb(tb) + res += tbres[-x:] + res += traceback.format_exception_only(typ, val) + return ''.join(res) + + +def save_traceback(): + """ + Save the current exception's traceback in a temporary file. + """ + exc = traceback.format_exc() + fd, path = tempfile.mkstemp('.log', 'sphinx-err-') + os.write(fd, exc) + os.close(fd) + return path + + +def _translate_pattern(pat): + """ + Translate a shell-style glob pattern to a regular expression. + + Adapted from the fnmatch module, but enhanced so that single stars don't + match slashes. + """ + i, n = 0, len(pat) + res = '' + while i < n: + c = pat[i] + i += 1 + if c == '*': + if i < n and pat[i] == '*': + # double star matches slashes too + i += 1 + res = res + '.*' + else: + # single star doesn't match slashes + res = res + '[^/]*' + elif c == '?': + # question mark doesn't match slashes too + res = res + '[^/]' + elif c == '[': + j = i + if j < n and pat[j] == '!': + j += 1 + if j < n and pat[j] == ']': + j += 1 + while j < n and pat[j] != ']': + j += 1 + if j >= n: + res = res + '\\[' + else: + stuff = pat[i:j].replace('\\', '\\\\') + i = j + 1 + if stuff[0] == '!': + # negative pattern mustn't match slashes too + stuff = '^/' + stuff[1:] + elif stuff[0] == '^': + stuff = '\\' + stuff + res = '%s[%s]' % (res, stuff) + else: + res += re.escape(c) + return res + '$' + + +_pat_cache = {} + +def patfilter(names, pat): + """ + Return the subset of the list NAMES that match PAT. + Adapted from fnmatch module. + """ + result = [] + if pat not in _pat_cache: + _pat_cache[pat] = re.compile(_translate_pattern(pat)) + match = _pat_cache[pat].match + return filter(match, names) + + +no_fn_re = re.compile(r'[^a-zA-Z0-9_-]') + +def make_filename(string): + return no_fn_re.sub('', string) + + +def nested_parse_with_titles(state, content, node): + # hack around title style bookkeeping + surrounding_title_styles = state.memo.title_styles + surrounding_section_level = state.memo.section_level + state.memo.title_styles = [] + state.memo.section_level = 0 + state.nested_parse(content, 0, node, match_titles=1) + state.memo.title_styles = surrounding_title_styles + state.memo.section_level = surrounding_section_level + + +def ustrftime(format, *args): + # strftime for unicode strings + return time.strftime(unicode(format).encode('utf-8'), *args).decode('utf-8') diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/Sphinx-0.5.1-py2.5.egg/sphinx/util/compat.py --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/Sphinx-0.5.1-py2.5.egg/sphinx/util/compat.py Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,37 @@ +# -*- coding: utf-8 -*- +""" + sphinx.util.compat + ~~~~~~~~~~~~~~~~~~ + + Stuff for docutils compatibility. + + :copyright: 2008 by Georg Brandl. + :license: BSD. +""" + +from docutils import nodes + + +# function missing in 0.5 SVN +def make_admonition(node_class, name, arguments, options, content, lineno, + content_offset, block_text, state, state_machine): + #if not content: + # error = state_machine.reporter.error( + # 'The "%s" admonition is empty; content required.' % (name), + # nodes.literal_block(block_text, block_text), line=lineno) + # return [error] + text = '\n'.join(content) + admonition_node = node_class(text) + if arguments: + title_text = arguments[0] + textnodes, messages = state.inline_text(title_text, lineno) + admonition_node += nodes.title(title_text, '', *textnodes) + admonition_node += messages + if options.has_key('class'): + classes = options['class'] + else: + classes = ['admonition-' + nodes.make_id(title_text)] + admonition_node['classes'] += classes + state.nested_parse(content, content_offset, admonition_node) + return [admonition_node] + diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/Sphinx-0.5.1-py2.5.egg/sphinx/util/console.py --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/Sphinx-0.5.1-py2.5.egg/sphinx/util/console.py Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,92 @@ +# -*- coding: utf-8 -*- +""" + sphinx.util.console + ~~~~~~~~~~~~~~~~~~~ + + Format colored console output. + + :copyright: 2007-2008 by Georg Brandl. + :license: BSD. +""" + +import os + +codes = {} + +def get_terminal_width(): + """Borrowed from the py lib.""" + try: + import os, termios, fcntl, struct + call = fcntl.ioctl(0, termios.TIOCGWINSZ, "\000"*8) + height, width = struct.unpack("hhhh", call)[:2] + terminal_width = width + except (SystemExit, KeyboardInterrupt): + raise + except: + # FALLBACK + terminal_width = int(os.environ.get('COLUMNS', 80))-1 + return terminal_width + +_tw = get_terminal_width() + +def print_and_backspace(text, func): + if not codes: + # if no coloring, don't output fancy backspaces + func(text) + else: + func(text.ljust(_tw) + _tw * "\b") + +def color_terminal(): + if 'COLORTERM' in os.environ: + return True + term = os.environ.get('TERM', 'dumb').lower() + if 'xterm' in term or 'color' in term: + return True + return False + + +def nocolor(): + codes.clear() + +def coloron(): + codes.update(_orig_codes) + +def colorize(name, text): + return codes.get(name, '') + text + codes.get('reset', '') + +def create_color_func(name): + def inner(text): + return colorize(name, text) + globals()[name] = inner + +_attrs = { + 'reset': '39;49;00m', + 'bold': '01m', + 'faint': '02m', + 'standout': '03m', + 'underline': '04m', + 'blink': '05m', +} + +for _name, _value in _attrs.items(): + codes[_name] = '\x1b[' + _value + +_colors = [ + ('black', 'darkgray'), + ('darkred', 'red'), + ('darkgreen', 'green'), + ('brown', 'yellow'), + ('darkblue', 'blue'), + ('purple', 'fuchsia'), + ('turquoise', 'teal'), + ('lightgray', 'white'), +] + +for i, (dark, light) in enumerate(_colors): + codes[dark] = '\x1b[%im' % (i+30) + codes[light] = '\x1b[%i;01m' % (i+30) + +_orig_codes = codes.copy() + +for _name in codes: + create_color_func(_name) diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/Sphinx-0.5.1-py2.5.egg/sphinx/util/jsdump.py --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/Sphinx-0.5.1-py2.5.egg/sphinx/util/jsdump.py Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,193 @@ +# -*- coding: utf-8 -*- +""" + sphinx.util.jsdump + ~~~~~~~~~~~~~~~~~~ + + This module implements a simple JavaScript serializer. + Uses the basestring encode function from simplejson. + + :copyright: 2008 by Armin Ronacher, Bob Ippolito, Georg Brandl. + :license: BSD. +""" + +import re + +_str_re = re.compile(r'"(\\\\|\\"|[^"])*"') +_int_re = re.compile(r'\d+') +_name_re = re.compile(r'[a-zA-Z]\w*') +_nameonly_re = re.compile(r'[a-zA-Z]\w*$') + +# escape \, ", control characters and everything outside ASCII +ESCAPE_ASCII = re.compile(r'([\\"]|[^\ -~])') +ESCAPE_DICT = { + '\\': '\\\\', + '"': '\\"', + '\b': '\\b', + '\f': '\\f', + '\n': '\\n', + '\r': '\\r', + '\t': '\\t', +} + +ESCAPED = re.compile(r'\\u.{4}|\\.') + + +def encode_string(s): + def replace(match): + s = match.group(0) + try: + return ESCAPE_DICT[s] + except KeyError: + n = ord(s) + if n < 0x10000: + return '\\u%04x' % (n,) + else: + # surrogate pair + n -= 0x10000 + s1 = 0xd800 | ((n >> 10) & 0x3ff) + s2 = 0xdc00 | (n & 0x3ff) + return '\\u%04x\\u%04x' % (s1, s2) + return '"' + str(ESCAPE_ASCII.sub(replace, s)) + '"' + +def decode_string(s): + return ESCAPED.sub(lambda m: eval('u"'+m.group()+'"'), s) + + +reswords = set("""\ +abstract else instanceof switch +boolean enum int synchronized +break export interface this +byte extends long throw +case false native throws +catch final new transient +char finally null true +class float package try +const for private typeof +continue function protected var +debugger goto public void +default if return volatile +delete implements short while +do import static with +double in super""".split()) + +def dumps(obj, key=False): + if key: + if not isinstance(obj, basestring): + obj = str(obj) + if _nameonly_re.match(obj) and obj not in reswords: + return obj # return it as a bare word + else: + return encode_string(obj) + if obj is None: + return 'null' + elif obj is True or obj is False: + return obj and 'true' or 'false' + elif isinstance(obj, (int, long, float)): + return str(obj) + elif isinstance(obj, dict): + return '{%s}' % ','.join('%s:%s' % ( + dumps(key, True), + dumps(value) + ) for key, value in obj.iteritems()) + elif isinstance(obj, (tuple, list, set)): + return '[%s]' % ','.join(dumps(x) for x in obj) + elif isinstance(obj, basestring): + return encode_string(obj) + raise TypeError(type(obj)) + +def dump(obj, f): + f.write(dumps(obj)) + + +def loads(x): + """Loader that can read the JS subset the indexer produces.""" + nothing = object() + i = 0 + n = len(x) + stack = [] + obj = nothing + key = False + keys = [] + while i < n: + c = x[i] + if c == '{': + obj = {} + stack.append(obj) + key = True + keys.append(nothing) + i += 1 + elif c == '[': + obj = [] + stack.append(obj) + key = False + keys.append(nothing) + i += 1 + elif c in '}]': + if key: + if keys[-1] is not nothing: + raise ValueError("unfinished dict") + # empty dict + key = False + oldobj = stack.pop() + keys.pop() + if stack: + obj = stack[-1] + if isinstance(obj, dict): + if keys[-1] is nothing: + raise ValueError("invalid key object", oldobj) + obj[keys[-1]] = oldobj + else: + obj.append(oldobj) + else: + break + i += 1 + elif c == ',': + if key: + raise ValueError("multiple keys") + if isinstance(obj, dict): + key = True + i += 1 + elif c == ':': + if not isinstance(obj, dict): + raise ValueError("colon in list") + i += 1 + if not key: + raise ValueError("multiple values") + key = False + else: + m = _str_re.match(x, i) + if m: + y = decode_string(m.group()[1:-1]) + else: + m = _int_re.match(x, i) + if m: + y = int(m.group()) + else: + m = _name_re.match(x, i) + if m: + y = m.group() + if y == 'true': + y = True + elif y == 'false': + y = False + elif y == 'null': + y = None + elif not key: + raise ValueError("bareword as value") + else: + raise ValueError("read error at pos %d" % i) + i = m.end() + if isinstance(obj, dict): + if key: + keys[-1] = y + else: + obj[keys[-1]] = y + key = False + else: + obj.append(y) + if obj is nothing: + raise ValueError("nothing loaded from string") + return obj + +def load(f): + return loads(f.read()) diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/Sphinx-0.5.1-py2.5.egg/sphinx/util/png.py --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/Sphinx-0.5.1-py2.5.egg/sphinx/util/png.py Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,58 @@ +# -*- coding: utf-8 -*- +""" + sphinx.util.png + ~~~~~~~~~~~~~~~ + + PNG image manipulation helpers. + + :copyright: 2008 by Georg Brandl. + :license: BSD. +""" + +import struct +import binascii + +LEN_IEND = 12 +LEN_DEPTH = 22 + +DEPTH_CHUNK_LEN = struct.pack('!i', 10) +DEPTH_CHUNK_START = 'tEXtDepth\x00' +IEND_CHUNK = '\x00\x00\x00\x00IEND\xAE\x42\x60\x82' + + +def read_png_depth(filename): + """ + Read the special tEXt chunk indicating the depth from a PNG file. + """ + result = None + f = open(filename, 'rb') + try: + f.seek(- (LEN_IEND + LEN_DEPTH), 2) + depthchunk = f.read(LEN_DEPTH) + if not depthchunk.startswith(DEPTH_CHUNK_LEN + DEPTH_CHUNK_START): + # either not a PNG file or not containing the depth chunk + return None + result = struct.unpack('!i', depthchunk[14:18])[0] + finally: + f.close() + return result + + +def write_png_depth(filename, depth): + """ + Write the special tEXt chunk indicating the depth to a PNG file. + The chunk is placed immediately before the special IEND chunk. + """ + data = struct.pack('!i', depth) + f = open(filename, 'r+b') + try: + # seek to the beginning of the IEND chunk + f.seek(-LEN_IEND, 2) + # overwrite it with the depth chunk + f.write(DEPTH_CHUNK_LEN + DEPTH_CHUNK_START + data) + # calculate the checksum over chunk name and data + f.write(struct.pack('!i', binascii.crc32(DEPTH_CHUNK_START + data))) + # replace the IEND chunk + f.write(IEND_CHUNK) + finally: + f.close() diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/Sphinx-0.5.1-py2.5.egg/sphinx/util/smartypants.py --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/Sphinx-0.5.1-py2.5.egg/sphinx/util/smartypants.py Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,303 @@ +r""" +This is based on SmartyPants.py by `Chad Miller`_. + +Copyright and License +===================== + +SmartyPants_ license:: + + Copyright (c) 2003 John Gruber + (http://daringfireball.net/) + All rights reserved. + + Redistribution and use in source and binary forms, with or without + modification, are permitted provided that the following conditions are + met: + + * Redistributions of source code must retain the above copyright + notice, this list of conditions and the following disclaimer. + + * Redistributions in binary form must reproduce the above copyright + notice, this list of conditions and the following disclaimer in + the documentation and/or other materials provided with the + distribution. + + * Neither the name "SmartyPants" nor the names of its contributors + may be used to endorse or promote products derived from this + software without specific prior written permission. + + This software is provided by the copyright holders and contributors "as + is" and any express or implied warranties, including, but not limited + to, the implied warranties of merchantability and fitness for a + particular purpose are disclaimed. In no event shall the copyright + owner or contributors be liable for any direct, indirect, incidental, + special, exemplary, or consequential damages (including, but not + limited to, procurement of substitute goods or services; loss of use, + data, or profits; or business interruption) however caused and on any + theory of liability, whether in contract, strict liability, or tort + (including negligence or otherwise) arising in any way out of the use + of this software, even if advised of the possibility of such damage. + + +smartypants.py license:: + + smartypants.py is a derivative work of SmartyPants. + + Redistribution and use in source and binary forms, with or without + modification, are permitted provided that the following conditions are + met: + + * Redistributions of source code must retain the above copyright + notice, this list of conditions and the following disclaimer. + + * Redistributions in binary form must reproduce the above copyright + notice, this list of conditions and the following disclaimer in + the documentation and/or other materials provided with the + distribution. + + This software is provided by the copyright holders and contributors "as + is" and any express or implied warranties, including, but not limited + to, the implied warranties of merchantability and fitness for a + particular purpose are disclaimed. In no event shall the copyright + owner or contributors be liable for any direct, indirect, incidental, + special, exemplary, or consequential damages (including, but not + limited to, procurement of substitute goods or services; loss of use, + data, or profits; or business interruption) however caused and on any + theory of liability, whether in contract, strict liability, or tort + (including negligence or otherwise) arising in any way out of the use + of this software, even if advised of the possibility of such damage. + +.. _Chad Miller: http://web.chad.org/ +""" + +import re + + +def sphinx_smarty_pants(t): + t = t.replace('"', '"') + t = educateDashesOldSchool(t) + t = educateQuotes(t) + t = t.replace('"', '"') + return t + +# Constants for quote education. + +punct_class = r"""[!"#\$\%'()*+,-.\/:;<=>?\@\[\\\]\^_`{|}~]""" +close_class = r"""[^\ \t\r\n\[\{\(\-]""" +dec_dashes = r"""–|—""" + +# Special case if the very first character is a quote +# followed by punctuation at a non-word-break. Close the quotes by brute force: +single_quote_start_re = re.compile(r"""^'(?=%s\\B)""" % (punct_class,)) +double_quote_start_re = re.compile(r"""^"(?=%s\\B)""" % (punct_class,)) + +# Special case for double sets of quotes, e.g.: +#

He said, "'Quoted' words in a larger quote."

+double_quote_sets_re = re.compile(r""""'(?=\w)""") +single_quote_sets_re = re.compile(r"""'"(?=\w)""") + +# Special case for decade abbreviations (the '80s): +decade_abbr_re = re.compile(r"""\b'(?=\d{2}s)""") + +# Get most opening double quotes: +opening_double_quotes_regex = re.compile(r""" + ( + \s | # a whitespace char, or + | # a non-breaking space entity, or + -- | # dashes, or + &[mn]dash; | # named dash entities + %s | # or decimal entities + &\#x201[34]; # or hex + ) + " # the quote + (?=\w) # followed by a word character + """ % (dec_dashes,), re.VERBOSE) + +# Double closing quotes: +closing_double_quotes_regex = re.compile(r""" + #(%s)? # character that indicates the quote should be closing + " + (?=\s) + """ % (close_class,), re.VERBOSE) + +closing_double_quotes_regex_2 = re.compile(r""" + (%s) # character that indicates the quote should be closing + " + """ % (close_class,), re.VERBOSE) + +# Get most opening single quotes: +opening_single_quotes_regex = re.compile(r""" + ( + \s | # a whitespace char, or + | # a non-breaking space entity, or + -- | # dashes, or + &[mn]dash; | # named dash entities + %s | # or decimal entities + &\#x201[34]; # or hex + ) + ' # the quote + (?=\w) # followed by a word character + """ % (dec_dashes,), re.VERBOSE) + +closing_single_quotes_regex = re.compile(r""" + (%s) + ' + (?!\s | s\b | \d) + """ % (close_class,), re.VERBOSE) + +closing_single_quotes_regex_2 = re.compile(r""" + (%s) + ' + (\s | s\b) + """ % (close_class,), re.VERBOSE) + +def educateQuotes(s): + """ + Parameter: String. + + Returns: The string, with "educated" curly quote HTML entities. + + Example input: "Isn't this fun?" + Example output: “Isn’t this fun?” + """ + + # Special case if the very first character is a quote + # followed by punctuation at a non-word-break. Close the quotes by brute force: + s = single_quote_start_re.sub("’", s) + s = double_quote_start_re.sub("”", s) + + # Special case for double sets of quotes, e.g.: + #

He said, "'Quoted' words in a larger quote."

+ s = double_quote_sets_re.sub("“‘", s) + s = single_quote_sets_re.sub("‘“", s) + + # Special case for decade abbreviations (the '80s): + s = decade_abbr_re.sub("’", s) + + s = opening_single_quotes_regex.sub(r"\1‘", s) + s = closing_single_quotes_regex.sub(r"\1’", s) + s = closing_single_quotes_regex_2.sub(r"\1’\2", s) + + # Any remaining single quotes should be opening ones: + s = s.replace("'", "‘") + + s = opening_double_quotes_regex.sub(r"\1“", s) + s = closing_double_quotes_regex.sub(r"”", s) + s = closing_double_quotes_regex_2.sub(r"\1”", s) + + # Any remaining quotes should be opening ones. + return s.replace('"', "“") + + +def educateQuotesLatex(s, dquotes=("``", "''")): + """ + Parameter: String. + + Returns: The string, with double quotes corrected to LaTeX quotes. + + Example input: "Isn't this fun?" + Example output: ``Isn't this fun?''; + """ + + # Special case if the very first character is a quote + # followed by punctuation at a non-word-break. Close the quotes by brute force: + s = single_quote_start_re.sub("\x04", s) + s = double_quote_start_re.sub("\x02", s) + + # Special case for double sets of quotes, e.g.: + #

He said, "'Quoted' words in a larger quote."

+ s = double_quote_sets_re.sub("\x01\x03", s) + s = single_quote_sets_re.sub("\x03\x01", s) + + # Special case for decade abbreviations (the '80s): + s = decade_abbr_re.sub("\x04", s) + + s = opening_single_quotes_regex.sub("\\1\x03", s) + s = closing_single_quotes_regex.sub("\\1\x04", s) + s = closing_single_quotes_regex_2.sub("\\1\x04\\2", s) + + # Any remaining single quotes should be opening ones: + s = s.replace("'", "\x03") + + s = opening_double_quotes_regex.sub("\\1\x01", s) + s = closing_double_quotes_regex.sub("\x02", s) + s = closing_double_quotes_regex_2.sub("\\1\x02", s) + + # Any remaining quotes should be opening ones. + s = s.replace('"', "\x01") + + # Finally, replace all helpers with quotes. + return s.replace("\x01", dquotes[0]).replace("\x02", dquotes[1]).\ + replace("\x03", "`").replace("\x04", "'") + + +def educateBackticks(s): + """ + Parameter: String. + Returns: The string, with ``backticks'' -style double quotes + translated into HTML curly quote entities. + Example input: ``Isn't this fun?'' + Example output: “Isn't this fun?” + """ + return s.replace("``", "“").replace("''", "”") + + +def educateSingleBackticks(s): + """ + Parameter: String. + Returns: The string, with `backticks' -style single quotes + translated into HTML curly quote entities. + + Example input: `Isn't this fun?' + Example output: ‘Isn’t this fun?’ + """ + return s.replace('`', "‘").replace("'", "’") + + +def educateDashesOldSchool(s): + """ + Parameter: String. + + Returns: The string, with each instance of "--" translated to + an en-dash HTML entity, and each "---" translated to + an em-dash HTML entity. + """ + return s.replace('---', "—").replace('--', "–") + + +def educateDashesOldSchoolInverted(s): + """ + Parameter: String. + + Returns: The string, with each instance of "--" translated to + an em-dash HTML entity, and each "---" translated to + an en-dash HTML entity. Two reasons why: First, unlike the + en- and em-dash syntax supported by + EducateDashesOldSchool(), it's compatible with existing + entries written before SmartyPants 1.1, back when "--" was + only used for em-dashes. Second, em-dashes are more + common than en-dashes, and so it sort of makes sense that + the shortcut should be shorter to type. (Thanks to Aaron + Swartz for the idea.) + """ + return s.replace('---', "–").replace('--', "—") + + + +def educateEllipses(s): + """ + Parameter: String. + Returns: The string, with each instance of "..." translated to + an ellipsis HTML entity. + + Example input: Huh...? + Example output: Huh…? + """ + return s.replace('...', "…").replace('. . .', "…") + + +__author__ = "Chad Miller " +__version__ = "1.5_1.5: Sat, 13 Aug 2005 15:50:24 -0400" +__url__ = "http://wiki.chad.org/SmartyPantsPy" +__description__ = \ + "Smart-quotes, smart-ellipses, and smart-dashes for weblog entries in pyblosxom" diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/Sphinx-0.5.1-py2.5.egg/sphinx/util/stemmer.py --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/Sphinx-0.5.1-py2.5.egg/sphinx/util/stemmer.py Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,343 @@ +# -*- coding: utf-8 -*- +""" + sphinx.util.stemmer + ~~~~~~~~~~~~~~~~~~~ + + Porter Stemming Algorithm + + This is the Porter stemming algorithm, ported to Python from the + version coded up in ANSI C by the author. It may be be regarded + as canonical, in that it follows the algorithm presented in + + Porter, 1980, An algorithm for suffix stripping, Program, Vol. 14, + no. 3, pp 130-137, + + only differing from it at the points maked --DEPARTURE-- below. + + See also http://www.tartarus.org/~martin/PorterStemmer + + The algorithm as described in the paper could be exactly replicated + by adjusting the points of DEPARTURE, but this is barely necessary, + because (a) the points of DEPARTURE are definitely improvements, and + (b) no encoding of the Porter stemmer I have seen is anything like + as exact as this version, even with the points of DEPARTURE! + + Release 1: January 2001 + + :copyright: 2001 by Vivake Gupta . + :license: Public Domain ("can be used free of charge for any purpose"). +""" + +class PorterStemmer(object): + + def __init__(self): + """The main part of the stemming algorithm starts here. + b is a buffer holding a word to be stemmed. The letters are in b[k0], + b[k0+1] ... ending at b[k]. In fact k0 = 0 in this demo program. k is + readjusted downwards as the stemming progresses. Zero termination is + not in fact used in the algorithm. + + Note that only lower case sequences are stemmed. Forcing to lower case + should be done before stem(...) is called. + """ + + self.b = "" # buffer for word to be stemmed + self.k = 0 + self.k0 = 0 + self.j = 0 # j is a general offset into the string + + def cons(self, i): + """cons(i) is TRUE <=> b[i] is a consonant.""" + if self.b[i] == 'a' or self.b[i] == 'e' or self.b[i] == 'i' \ + or self.b[i] == 'o' or self.b[i] == 'u': + return 0 + if self.b[i] == 'y': + if i == self.k0: + return 1 + else: + return (not self.cons(i - 1)) + return 1 + + def m(self): + """m() measures the number of consonant sequences between k0 and j. + if c is a consonant sequence and v a vowel sequence, and <..> + indicates arbitrary presence, + + gives 0 + vc gives 1 + vcvc gives 2 + vcvcvc gives 3 + .... + """ + n = 0 + i = self.k0 + while 1: + if i > self.j: + return n + if not self.cons(i): + break + i = i + 1 + i = i + 1 + while 1: + while 1: + if i > self.j: + return n + if self.cons(i): + break + i = i + 1 + i = i + 1 + n = n + 1 + while 1: + if i > self.j: + return n + if not self.cons(i): + break + i = i + 1 + i = i + 1 + + def vowelinstem(self): + """vowelinstem() is TRUE <=> k0,...j contains a vowel""" + for i in range(self.k0, self.j + 1): + if not self.cons(i): + return 1 + return 0 + + def doublec(self, j): + """doublec(j) is TRUE <=> j,(j-1) contain a double consonant.""" + if j < (self.k0 + 1): + return 0 + if (self.b[j] != self.b[j-1]): + return 0 + return self.cons(j) + + def cvc(self, i): + """cvc(i) is TRUE <=> i-2,i-1,i has the form consonant - vowel - consonant + and also if the second c is not w,x or y. this is used when trying to + restore an e at the end of a short e.g. + + cav(e), lov(e), hop(e), crim(e), but + snow, box, tray. + """ + if i < (self.k0 + 2) or not self.cons(i) or self.cons(i-1) or not self.cons(i-2): + return 0 + ch = self.b[i] + if ch == 'w' or ch == 'x' or ch == 'y': + return 0 + return 1 + + def ends(self, s): + """ends(s) is TRUE <=> k0,...k ends with the string s.""" + length = len(s) + if s[length - 1] != self.b[self.k]: # tiny speed-up + return 0 + if length > (self.k - self.k0 + 1): + return 0 + if self.b[self.k-length+1:self.k+1] != s: + return 0 + self.j = self.k - length + return 1 + + def setto(self, s): + """setto(s) sets (j+1),...k to the characters in the string s, readjusting k.""" + length = len(s) + self.b = self.b[:self.j+1] + s + self.b[self.j+length+1:] + self.k = self.j + length + + def r(self, s): + """r(s) is used further down.""" + if self.m() > 0: + self.setto(s) + + def step1ab(self): + """step1ab() gets rid of plurals and -ed or -ing. e.g. + + caresses -> caress + ponies -> poni + ties -> ti + caress -> caress + cats -> cat + + feed -> feed + agreed -> agree + disabled -> disable + + matting -> mat + mating -> mate + meeting -> meet + milling -> mill + messing -> mess + + meetings -> meet + """ + if self.b[self.k] == 's': + if self.ends("sses"): + self.k = self.k - 2 + elif self.ends("ies"): + self.setto("i") + elif self.b[self.k - 1] != 's': + self.k = self.k - 1 + if self.ends("eed"): + if self.m() > 0: + self.k = self.k - 1 + elif (self.ends("ed") or self.ends("ing")) and self.vowelinstem(): + self.k = self.j + if self.ends("at"): self.setto("ate") + elif self.ends("bl"): self.setto("ble") + elif self.ends("iz"): self.setto("ize") + elif self.doublec(self.k): + self.k = self.k - 1 + ch = self.b[self.k] + if ch == 'l' or ch == 's' or ch == 'z': + self.k = self.k + 1 + elif (self.m() == 1 and self.cvc(self.k)): + self.setto("e") + + def step1c(self): + """step1c() turns terminal y to i when there is another vowel in the stem.""" + if (self.ends("y") and self.vowelinstem()): + self.b = self.b[:self.k] + 'i' + self.b[self.k+1:] + + def step2(self): + """step2() maps double suffices to single ones. + so -ization ( = -ize plus -ation) maps to -ize etc. note that the + string before the suffix must give m() > 0. + """ + if self.b[self.k - 1] == 'a': + if self.ends("ational"): self.r("ate") + elif self.ends("tional"): self.r("tion") + elif self.b[self.k - 1] == 'c': + if self.ends("enci"): self.r("ence") + elif self.ends("anci"): self.r("ance") + elif self.b[self.k - 1] == 'e': + if self.ends("izer"): self.r("ize") + elif self.b[self.k - 1] == 'l': + if self.ends("bli"): self.r("ble") # --DEPARTURE-- + # To match the published algorithm, replace this phrase with + # if self.ends("abli"): self.r("able") + elif self.ends("alli"): self.r("al") + elif self.ends("entli"): self.r("ent") + elif self.ends("eli"): self.r("e") + elif self.ends("ousli"): self.r("ous") + elif self.b[self.k - 1] == 'o': + if self.ends("ization"): self.r("ize") + elif self.ends("ation"): self.r("ate") + elif self.ends("ator"): self.r("ate") + elif self.b[self.k - 1] == 's': + if self.ends("alism"): self.r("al") + elif self.ends("iveness"): self.r("ive") + elif self.ends("fulness"): self.r("ful") + elif self.ends("ousness"): self.r("ous") + elif self.b[self.k - 1] == 't': + if self.ends("aliti"): self.r("al") + elif self.ends("iviti"): self.r("ive") + elif self.ends("biliti"): self.r("ble") + elif self.b[self.k - 1] == 'g': # --DEPARTURE-- + if self.ends("logi"): self.r("log") + # To match the published algorithm, delete this phrase + + def step3(self): + """step3() dels with -ic-, -full, -ness etc. similar strategy to step2.""" + if self.b[self.k] == 'e': + if self.ends("icate"): self.r("ic") + elif self.ends("ative"): self.r("") + elif self.ends("alize"): self.r("al") + elif self.b[self.k] == 'i': + if self.ends("iciti"): self.r("ic") + elif self.b[self.k] == 'l': + if self.ends("ical"): self.r("ic") + elif self.ends("ful"): self.r("") + elif self.b[self.k] == 's': + if self.ends("ness"): self.r("") + + def step4(self): + """step4() takes off -ant, -ence etc., in context vcvc.""" + if self.b[self.k - 1] == 'a': + if self.ends("al"): pass + else: return + elif self.b[self.k - 1] == 'c': + if self.ends("ance"): pass + elif self.ends("ence"): pass + else: return + elif self.b[self.k - 1] == 'e': + if self.ends("er"): pass + else: return + elif self.b[self.k - 1] == 'i': + if self.ends("ic"): pass + else: return + elif self.b[self.k - 1] == 'l': + if self.ends("able"): pass + elif self.ends("ible"): pass + else: return + elif self.b[self.k - 1] == 'n': + if self.ends("ant"): pass + elif self.ends("ement"): pass + elif self.ends("ment"): pass + elif self.ends("ent"): pass + else: return + elif self.b[self.k - 1] == 'o': + if self.ends("ion") and (self.b[self.j] == 's' \ + or self.b[self.j] == 't'): pass + elif self.ends("ou"): pass + # takes care of -ous + else: return + elif self.b[self.k - 1] == 's': + if self.ends("ism"): pass + else: return + elif self.b[self.k - 1] == 't': + if self.ends("ate"): pass + elif self.ends("iti"): pass + else: return + elif self.b[self.k - 1] == 'u': + if self.ends("ous"): pass + else: return + elif self.b[self.k - 1] == 'v': + if self.ends("ive"): pass + else: return + elif self.b[self.k - 1] == 'z': + if self.ends("ize"): pass + else: return + else: + return + if self.m() > 1: + self.k = self.j + + def step5(self): + """step5() removes a final -e if m() > 1, and changes -ll to -l if + m() > 1. + """ + self.j = self.k + if self.b[self.k] == 'e': + a = self.m() + if a > 1 or (a == 1 and not self.cvc(self.k-1)): + self.k = self.k - 1 + if self.b[self.k] == 'l' and self.doublec(self.k) and self.m() > 1: + self.k = self.k -1 + + def stem(self, p, i, j): + """In stem(p,i,j), p is a char pointer, and the string to be stemmed + is from p[i] to p[j] inclusive. Typically i is zero and j is the + offset to the last character of a string, (p[j+1] == '\0'). The + stemmer adjusts the characters p[i] ... p[j] and returns the new + end-point of the string, k. Stemming never increases word length, so + i <= k <= j. To turn the stemmer into a module, declare 'stem' as + extern, and delete the remainder of this file. + """ + # copy the parameters into statics + self.b = p + self.k = j + self.k0 = i + if self.k <= self.k0 + 1: + return self.b # --DEPARTURE-- + + # With this line, strings of length 1 or 2 don't go through the + # stemming process, although no mention is made of this in the + # published algorithm. Remove the line to match the published + # algorithm. + + self.step1ab() + self.step1c() + self.step2() + self.step3() + self.step4() + self.step5() + return self.b[self.k0:self.k+1] diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/Sphinx-0.5.1-py2.5.egg/sphinx/util/texescape.py --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/Sphinx-0.5.1-py2.5.egg/sphinx/util/texescape.py Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,110 @@ +# -*- coding: utf-8 -*- +""" + sphinx.util.texescape + ~~~~~~~~~~~~~~~~~~~~~ + + TeX escaping helper. + + :copyright: 2008 by Georg Brandl. + :license: BSD. +""" + +tex_replacements = [ + # map TeX special chars + (u'$', ur'\$'), + (u'%', ur'\%'), + (u'&', ur'\&'), + (u'#', ur'\#'), + (u'_', ur'\_'), + (u'{', ur'\{'), + (u'}', ur'\}'), + (u'[', ur'{[}'), + (u']', ur'{]}'), + (u'`', ur'{}`'), + (u'\\',ur'\textbackslash{}'), + (u'~', ur'\textasciitilde{}'), + (u'<', ur'\textless{}'), + (u'>', ur'\textgreater{}'), + (u'^', ur'\textasciicircum{}'), + # map special Unicode characters to TeX commands + (u'¶', ur'\P{}'), + (u'§', ur'\S{}'), + (u'€', ur'\texteuro{}'), + (u'∞', ur'$\infty$'), + (u'±', ur'$\pm$'), + (u'→', ur'$\rightarrow$'), + (u'‣', ur'$\rightarrow$'), + # used to separate -- in options + (u'', ur'{}'), + # map some special Unicode characters to similar ASCII ones + (u'─', ur'-'), + (u'⎽', ur'\_'), + (u'╲', ur'\textbackslash{}'), + (u'│', ur'|'), + (u'ℯ', ur'e'), + (u'ⅈ', ur'i'), + (u'₁', ur'1'), + (u'₂', ur'2'), + # map Greek alphabet + (u'α', ur'$\alpha$'), + (u'β', ur'$\beta$'), + (u'γ', ur'$\gamma$'), + (u'δ', ur'$\delta$'), + (u'ε', ur'$\epsilon$'), + (u'ζ', ur'$\zeta$'), + (u'η', ur'$\eta$'), + (u'θ', ur'$\theta$'), + (u'ι', ur'$\iota$'), + (u'κ', ur'$\kappa$'), + (u'λ', ur'$\lambda$'), + (u'μ', ur'$\mu$'), + (u'ν', ur'$\nu$'), + (u'ξ', ur'$\xi$'), + (u'ο', ur'o'), + (u'π', ur'$\pi$'), + (u'ρ', ur'$\rho$'), + (u'σ', ur'$\sigma$'), + (u'τ', ur'$\tau$'), + (u'υ', u'\$\\upsilon\$'), + (u'φ', ur'$\phi$'), + (u'χ', ur'$\chi$'), + (u'ψ', ur'$\psi$'), + (u'ω', ur'$\omega$'), + (u'Α', ur'A'), + (u'Β', ur'B'), + (u'Γ', ur'$\Gamma$'), + (u'Δ', ur'$\Delta$'), + (u'Ε', ur'E'), + (u'Ζ', ur'Z'), + (u'Η', ur'H'), + (u'Θ', ur'$\Theta$'), + (u'Ι', ur'I'), + (u'Κ', ur'K'), + (u'Λ', ur'$\Lambda$'), + (u'Μ', ur'M'), + (u'Ν', ur'N'), + (u'Ξ', ur'$\Xi$'), + (u'Ο', ur'O'), + (u'Π', ur'$\Pi$'), + (u'Ρ', ur'P'), + (u'Σ', ur'$\Sigma$'), + (u'Τ', ur'T'), + (u'Υ', u'\$\\Upsilon\$'), + (u'Φ', ur'$\Phi$'), + (u'Χ', ur'X'), + (u'Ψ', ur'$\Psi$'), + (u'Ω', ur'$\Omega$'), + (u'Ω', ur'$\Omega$'), +] + +tex_escape_map = {} +tex_hl_escape_map = {} +_new_cmd_chars = {ord(u'\\'): u'@', ord(u'{'): u'[', ord(u'}'): u']'} + +def init(): + for a, b in tex_replacements: + tex_escape_map[ord(a)] = b + + for a, b in tex_replacements: + if a in u'[]{}\\': continue + tex_hl_escape_map[ord(a)] = b.translate(_new_cmd_chars) diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/coverage-2.85-py2.5.egg Binary file buildframework/helium/external/python/lib/common/coverage-2.85-py2.5.egg has changed diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/EGG-INFO/PKG-INFO --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/EGG-INFO/PKG-INFO Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,38 @@ +Metadata-Version: 1.0 +Name: docutils +Version: 0.5 +Summary: Docutils -- Python Documentation Utilities +Home-page: http://docutils.sourceforge.net/ +Author: David Goodger +Author-email: goodger@python.org +License: public domain, Python, BSD, GPL (see COPYING.txt) +Description: Docutils is a modular system for processing documentation + into useful formats, such as HTML, XML, and LaTeX. For + input Docutils supports reStructuredText, an easy-to-read, + what-you-see-is-what-you-get plaintext markup syntax. +Platform: OS-independent +Classifier: Development Status :: 3 - Alpha +Classifier: Environment :: Console +Classifier: Intended Audience :: End Users/Desktop +Classifier: Intended Audience :: Other Audience +Classifier: Intended Audience :: Developers +Classifier: Intended Audience :: System Administrators +Classifier: License :: Public Domain +Classifier: License :: OSI Approved :: Python Software Foundation License +Classifier: License :: OSI Approved :: BSD License +Classifier: License :: OSI Approved :: GNU General Public License (GPL) +Classifier: Operating System :: OS Independent +Classifier: Programming Language :: Python +Classifier: Topic :: Documentation +Classifier: Topic :: Software Development :: Documentation +Classifier: Topic :: Text Processing +Classifier: Natural Language :: English +Classifier: Natural Language :: Afrikaans +Classifier: Natural Language :: Esperanto +Classifier: Natural Language :: French +Classifier: Natural Language :: German +Classifier: Natural Language :: Italian +Classifier: Natural Language :: Russian +Classifier: Natural Language :: Slovak +Classifier: Natural Language :: Spanish +Classifier: Natural Language :: Swedish diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/EGG-INFO/SOURCES.txt --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/EGG-INFO/SOURCES.txt Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,482 @@ +BUGS.txt +COPYING.txt +FAQ.txt +HISTORY.txt +MANIFEST.in +README.txt +RELEASE-NOTES.txt +THANKS.txt +install.py +setup.py +docs/index.txt +docs/api/cmdline-tool.txt +docs/api/publisher.txt +docs/api/runtime-settings.txt +docs/dev/distributing.txt +docs/dev/enthought-plan.txt +docs/dev/enthought-rfp.txt +docs/dev/hacking.txt +docs/dev/policies.txt +docs/dev/pysource.dtd +docs/dev/pysource.txt +docs/dev/release.txt +docs/dev/repository.txt +docs/dev/semantics.txt +docs/dev/testing.txt +docs/dev/todo.txt +docs/dev/website.txt +docs/dev/rst/alternatives.txt +docs/dev/rst/problems.txt +docs/howto/html-stylesheets.txt +docs/howto/i18n.txt +docs/howto/rst-directives.txt +docs/howto/rst-roles.txt +docs/howto/security.txt +docs/peps/pep-0256.txt +docs/peps/pep-0257.txt +docs/peps/pep-0258.txt +docs/peps/pep-0287.txt +docs/ref/doctree.txt +docs/ref/docutils.dtd +docs/ref/soextblx.dtd +docs/ref/transforms.txt +docs/ref/rst/definitions.txt +docs/ref/rst/directives.txt +docs/ref/rst/introduction.txt +docs/ref/rst/restructuredtext.txt +docs/ref/rst/roles.txt +docs/user/Makefile.docutils-update +docs/user/config.txt +docs/user/emacs.txt +docs/user/latex.txt +docs/user/links.txt +docs/user/mailing-lists.txt +docs/user/slide-shows.txt +docs/user/tools.txt +docs/user/images/big-black.png +docs/user/images/big-white.png +docs/user/images/default.png +docs/user/images/happy_monkey.png +docs/user/images/medium-black.png +docs/user/images/medium-white.png +docs/user/images/rsp-all.png +docs/user/images/rsp-breaks.png +docs/user/images/rsp-covers.png +docs/user/images/rsp-cuts.png +docs/user/images/rsp-empty.png +docs/user/images/rsp-objects.png +docs/user/images/rsp.svg +docs/user/images/s5-files.png +docs/user/images/s5-files.svg +docs/user/images/small-black.png +docs/user/images/small-white.png +docs/user/rst/cheatsheet.txt +docs/user/rst/demo.txt +docs/user/rst/quickref.html +docs/user/rst/quickstart.txt +docs/user/rst/images/ball1.gif +docs/user/rst/images/biohazard.png +docs/user/rst/images/title.png +docutils/__init__.py +docutils/core.py +docutils/docutils.conf +docutils/examples.py +docutils/frontend.py +docutils/io.py +docutils/nodes.py +docutils/statemachine.py +docutils/urischemes.py +docutils/utils.py +docutils/languages/__init__.py +docutils/languages/af.py +docutils/languages/ca.py +docutils/languages/cs.py +docutils/languages/de.py +docutils/languages/en.py +docutils/languages/eo.py +docutils/languages/es.py +docutils/languages/fi.py +docutils/languages/fr.py +docutils/languages/he.py +docutils/languages/it.py +docutils/languages/ja.py +docutils/languages/nl.py +docutils/languages/pt_br.py +docutils/languages/ru.py +docutils/languages/sk.py +docutils/languages/sv.py +docutils/languages/zh_cn.py +docutils/languages/zh_tw.py +docutils/parsers/__init__.py +docutils/parsers/null.py +docutils/parsers/rst/__init__.py +docutils/parsers/rst/roles.py +docutils/parsers/rst/states.py +docutils/parsers/rst/tableparser.py +docutils/parsers/rst/directives/__init__.py +docutils/parsers/rst/directives/admonitions.py +docutils/parsers/rst/directives/body.py +docutils/parsers/rst/directives/html.py +docutils/parsers/rst/directives/images.py +docutils/parsers/rst/directives/misc.py +docutils/parsers/rst/directives/parts.py +docutils/parsers/rst/directives/references.py +docutils/parsers/rst/directives/tables.py +docutils/parsers/rst/include/README.txt +docutils/parsers/rst/include/isoamsa.txt +docutils/parsers/rst/include/isoamsb.txt +docutils/parsers/rst/include/isoamsc.txt +docutils/parsers/rst/include/isoamsn.txt +docutils/parsers/rst/include/isoamso.txt +docutils/parsers/rst/include/isoamsr.txt +docutils/parsers/rst/include/isobox.txt +docutils/parsers/rst/include/isocyr1.txt +docutils/parsers/rst/include/isocyr2.txt +docutils/parsers/rst/include/isodia.txt +docutils/parsers/rst/include/isogrk1.txt +docutils/parsers/rst/include/isogrk2.txt +docutils/parsers/rst/include/isogrk3.txt +docutils/parsers/rst/include/isogrk4-wide.txt +docutils/parsers/rst/include/isogrk4.txt +docutils/parsers/rst/include/isolat1.txt +docutils/parsers/rst/include/isolat2.txt +docutils/parsers/rst/include/isomfrk-wide.txt +docutils/parsers/rst/include/isomfrk.txt +docutils/parsers/rst/include/isomopf-wide.txt +docutils/parsers/rst/include/isomopf.txt +docutils/parsers/rst/include/isomscr-wide.txt +docutils/parsers/rst/include/isomscr.txt +docutils/parsers/rst/include/isonum.txt +docutils/parsers/rst/include/isopub.txt +docutils/parsers/rst/include/isotech.txt +docutils/parsers/rst/include/mmlalias.txt +docutils/parsers/rst/include/mmlextra-wide.txt +docutils/parsers/rst/include/mmlextra.txt +docutils/parsers/rst/include/s5defs.txt +docutils/parsers/rst/include/xhtml1-lat1.txt +docutils/parsers/rst/include/xhtml1-special.txt +docutils/parsers/rst/include/xhtml1-symbol.txt +docutils/parsers/rst/languages/__init__.py +docutils/parsers/rst/languages/af.py +docutils/parsers/rst/languages/ca.py +docutils/parsers/rst/languages/cs.py +docutils/parsers/rst/languages/de.py +docutils/parsers/rst/languages/en.py +docutils/parsers/rst/languages/eo.py +docutils/parsers/rst/languages/es.py +docutils/parsers/rst/languages/fi.py +docutils/parsers/rst/languages/fr.py +docutils/parsers/rst/languages/he.py +docutils/parsers/rst/languages/it.py +docutils/parsers/rst/languages/ja.py +docutils/parsers/rst/languages/nl.py +docutils/parsers/rst/languages/pt_br.py +docutils/parsers/rst/languages/ru.py +docutils/parsers/rst/languages/sk.py +docutils/parsers/rst/languages/sv.py +docutils/parsers/rst/languages/zh_cn.py +docutils/parsers/rst/languages/zh_tw.py +docutils/readers/__init__.py +docutils/readers/doctree.py +docutils/readers/pep.py +docutils/readers/standalone.py +docutils/readers/python/__init__.py +docutils/readers/python/moduleparser.py +docutils/readers/python/pynodes.py +docutils/transforms/__init__.py +docutils/transforms/components.py +docutils/transforms/frontmatter.py +docutils/transforms/misc.py +docutils/transforms/parts.py +docutils/transforms/peps.py +docutils/transforms/references.py +docutils/transforms/universal.py +docutils/transforms/writer_aux.py +docutils/writers/__init__.py +docutils/writers/docutils_xml.py +docutils/writers/null.py +docutils/writers/pseudoxml.py +docutils/writers/html4css1/__init__.py +docutils/writers/html4css1/html4css1.css +docutils/writers/html4css1/template.txt +docutils/writers/latex2e/__init__.py +docutils/writers/latex2e/latex2e.tex +docutils/writers/newlatex2e/__init__.py +docutils/writers/newlatex2e/base.tex +docutils/writers/newlatex2e/notes.txt +docutils/writers/newlatex2e/tests.txt +docutils/writers/newlatex2e/unicode_map.py +docutils/writers/pep_html/__init__.py +docutils/writers/pep_html/pep.css +docutils/writers/pep_html/template.txt +docutils/writers/s5_html/__init__.py +docutils/writers/s5_html/themes/README.txt +docutils/writers/s5_html/themes/big-black/__base__ +docutils/writers/s5_html/themes/big-black/framing.css +docutils/writers/s5_html/themes/big-black/pretty.css +docutils/writers/s5_html/themes/big-white/framing.css +docutils/writers/s5_html/themes/big-white/pretty.css +docutils/writers/s5_html/themes/default/blank.gif +docutils/writers/s5_html/themes/default/framing.css +docutils/writers/s5_html/themes/default/iepngfix.htc +docutils/writers/s5_html/themes/default/opera.css +docutils/writers/s5_html/themes/default/outline.css +docutils/writers/s5_html/themes/default/pretty.css +docutils/writers/s5_html/themes/default/print.css +docutils/writers/s5_html/themes/default/s5-core.css +docutils/writers/s5_html/themes/default/slides.css +docutils/writers/s5_html/themes/default/slides.js +docutils/writers/s5_html/themes/medium-black/__base__ +docutils/writers/s5_html/themes/medium-black/pretty.css +docutils/writers/s5_html/themes/medium-white/framing.css +docutils/writers/s5_html/themes/medium-white/pretty.css +docutils/writers/s5_html/themes/small-black/__base__ +docutils/writers/s5_html/themes/small-black/pretty.css +docutils/writers/s5_html/themes/small-white/framing.css +docutils/writers/s5_html/themes/small-white/pretty.css +extras/optparse.py +extras/roman.py +extras/textwrap.py +extras/docutils.egg-info/PKG-INFO +extras/docutils.egg-info/SOURCES.txt +extras/docutils.egg-info/dependency_links.txt +extras/docutils.egg-info/top_level.txt +licenses/docutils.conf +licenses/gpl.txt +licenses/python-2-1-1.txt +licenses/python-2-2.txt +licenses/python-2-3.txt +test/DocutilsTestSupport.py +test/alltests.py +test/coverage.sh +test/docutils.conf +test/docutils_difflib.py +test/package_unittest.py +test/test_dependencies.py +test/test_functional.py +test/test_io.py +test/test_language.py +test/test_nodes.py +test/test_pickle.py +test/test_publisher.py +test/test_settings.py +test/test_statemachine.py +test/test_traversals.py +test/test_utils.py +test/test_viewlist.py +test/data/config_1.txt +test/data/config_2.txt +test/data/config_error_handler.txt +test/data/config_list.txt +test/data/config_list_2.txt +test/data/config_old.txt +test/data/csv_data.txt +test/data/csv_dep.txt +test/data/dependencies.txt +test/data/full-template.txt +test/data/include.txt +test/data/raw.txt +test/data/stylesheet.txt +test/functional/README.txt +test/functional/expected/compact_lists.html +test/functional/expected/dangerous.html +test/functional/expected/field_name_limit.html +test/functional/expected/latex_docinfo.tex +test/functional/expected/misc_rst_html4css1.html +test/functional/expected/pep_html.html +test/functional/expected/standalone_rst_html4css1.html +test/functional/expected/standalone_rst_latex.tex +test/functional/expected/standalone_rst_pseudoxml.txt +test/functional/expected/standalone_rst_s5_html_1.html +test/functional/expected/standalone_rst_s5_html_2.html +test/functional/expected/ui/default/blank.gif +test/functional/expected/ui/default/framing.css +test/functional/expected/ui/default/iepngfix.htc +test/functional/expected/ui/default/opera.css +test/functional/expected/ui/default/outline.css +test/functional/expected/ui/default/pretty.css +test/functional/expected/ui/default/print.css +test/functional/expected/ui/default/s5-core.css +test/functional/expected/ui/default/slides.css +test/functional/expected/ui/default/slides.js +test/functional/expected/ui/small-black/blank.gif +test/functional/expected/ui/small-black/framing.css +test/functional/expected/ui/small-black/iepngfix.htc +test/functional/expected/ui/small-black/opera.css +test/functional/expected/ui/small-black/outline.css +test/functional/expected/ui/small-black/pretty.css +test/functional/expected/ui/small-black/print.css +test/functional/expected/ui/small-black/s5-core.css +test/functional/expected/ui/small-black/slides.css +test/functional/expected/ui/small-black/slides.js +test/functional/input/compact_lists.txt +test/functional/input/dangerous.txt +test/functional/input/field_list.txt +test/functional/input/latex_docinfo.txt +test/functional/input/pep_html.txt +test/functional/input/simple.txt +test/functional/input/standalone_rst_html4css1.txt +test/functional/input/standalone_rst_latex.txt +test/functional/input/standalone_rst_newlatex.txt +test/functional/input/standalone_rst_pseudoxml.txt +test/functional/input/standalone_rst_s5_html.txt +test/functional/input/data/custom_roles.txt +test/functional/input/data/errors.txt +test/functional/input/data/header_footer.txt +test/functional/input/data/latex.txt +test/functional/input/data/latex2e.txt +test/functional/input/data/list_table.txt +test/functional/input/data/nonalphanumeric.txt +test/functional/input/data/standard.txt +test/functional/input/data/table_colspan.txt +test/functional/input/data/table_complex.txt +test/functional/input/data/table_rowspan.txt +test/functional/input/data/unicode.txt +test/functional/output/README.txt +test/functional/tests/_default.py +test/functional/tests/_standalone_rst_defaults.py +test/functional/tests/compact_lists.py +test/functional/tests/dangerous.py +test/functional/tests/field_name_limit.py +test/functional/tests/latex_docinfo.py +test/functional/tests/misc_rst_html4css1.py +test/functional/tests/pep_html.py +test/functional/tests/standalone_rst_html4css1.py +test/functional/tests/standalone_rst_latex.py +test/functional/tests/standalone_rst_pseudoxml.py +test/functional/tests/standalone_rst_s5_html_1.py +test/functional/tests/standalone_rst_s5_html_2.py +test/test_parsers/__init__.py +test/test_parsers/test_rst/__init__.py +test/test_parsers/test_rst/test_SimpleTableParser.py +test/test_parsers/test_rst/test_TableParser.py +test/test_parsers/test_rst/test_block_quotes.py +test/test_parsers/test_rst/test_bullet_lists.py +test/test_parsers/test_rst/test_citations.py +test/test_parsers/test_rst/test_comments.py +test/test_parsers/test_rst/test_definition_lists.py +test/test_parsers/test_rst/test_doctest_blocks.py +test/test_parsers/test_rst/test_east_asian_text.py +test/test_parsers/test_rst/test_enumerated_lists.py +test/test_parsers/test_rst/test_field_lists.py +test/test_parsers/test_rst/test_footnotes.py +test/test_parsers/test_rst/test_functions.py +test/test_parsers/test_rst/test_inline_markup.py +test/test_parsers/test_rst/test_interpreted.py +test/test_parsers/test_rst/test_line_blocks.py +test/test_parsers/test_rst/test_literal_blocks.py +test/test_parsers/test_rst/test_option_lists.py +test/test_parsers/test_rst/test_outdenting.py +test/test_parsers/test_rst/test_paragraphs.py +test/test_parsers/test_rst/test_section_headers.py +test/test_parsers/test_rst/test_substitutions.py +test/test_parsers/test_rst/test_tables.py +test/test_parsers/test_rst/test_targets.py +test/test_parsers/test_rst/test_transitions.py +test/test_parsers/test_rst/includes/include9.txt +test/test_parsers/test_rst/test_directives/__init__.py +test/test_parsers/test_rst/test_directives/empty.txt +test/test_parsers/test_rst/test_directives/include 11.txt +test/test_parsers/test_rst/test_directives/include1.txt +test/test_parsers/test_rst/test_directives/include10.txt +test/test_parsers/test_rst/test_directives/include12.txt +test/test_parsers/test_rst/test_directives/include13.txt +test/test_parsers/test_rst/test_directives/include2.txt +test/test_parsers/test_rst/test_directives/include3.txt +test/test_parsers/test_rst/test_directives/include8.txt +test/test_parsers/test_rst/test_directives/raw1.txt +test/test_parsers/test_rst/test_directives/test_admonitions.py +test/test_parsers/test_rst/test_directives/test_block_quotes.py +test/test_parsers/test_rst/test_directives/test_class.py +test/test_parsers/test_rst/test_directives/test_compound.py +test/test_parsers/test_rst/test_directives/test_container.py +test/test_parsers/test_rst/test_directives/test_contents.py +test/test_parsers/test_rst/test_directives/test_date.py +test/test_parsers/test_rst/test_directives/test_decorations.py +test/test_parsers/test_rst/test_directives/test_default_role.py +test/test_parsers/test_rst/test_directives/test_figures.py +test/test_parsers/test_rst/test_directives/test_images.py +test/test_parsers/test_rst/test_directives/test_include.py +test/test_parsers/test_rst/test_directives/test_line_blocks.py +test/test_parsers/test_rst/test_directives/test_meta.py +test/test_parsers/test_rst/test_directives/test_parsed_literals.py +test/test_parsers/test_rst/test_directives/test_raw.py +test/test_parsers/test_rst/test_directives/test_replace.py +test/test_parsers/test_rst/test_directives/test_role.py +test/test_parsers/test_rst/test_directives/test_rubrics.py +test/test_parsers/test_rst/test_directives/test_sectnum.py +test/test_parsers/test_rst/test_directives/test_sidebars.py +test/test_parsers/test_rst/test_directives/test_tables.py +test/test_parsers/test_rst/test_directives/test_target_notes.py +test/test_parsers/test_rst/test_directives/test_test_directives.py +test/test_parsers/test_rst/test_directives/test_title.py +test/test_parsers/test_rst/test_directives/test_topics.py +test/test_parsers/test_rst/test_directives/test_unicode.py +test/test_parsers/test_rst/test_directives/test_unknown.py +test/test_parsers/test_rst/test_directives/utf-16.csv +test/test_parsers/test_rst/test_directives/includes/include4.txt +test/test_parsers/test_rst/test_directives/includes/include5.txt +test/test_parsers/test_rst/test_directives/includes/more/include6.txt +test/test_parsers/test_rst/test_directives/includes/sibling/include7.txt +test/test_readers/__init__.py +test/test_readers/test_pep/__init__.py +test/test_readers/test_pep/test_inline_markup.py +test/test_readers/test_pep/test_rfc2822.py +test/test_readers/test_python/__init__.py +test/test_readers/test_python/showast +test/test_readers/test_python/showdoc +test/test_readers/test_python/showparse +test/test_readers/test_python/showtok +test/test_readers/test_python/test_functions.py +test/test_readers/test_python/test_parser.py +test/test_readers/test_python/test_token_parser.py +test/test_transforms/__init__.py +test/test_transforms/test___init__.py +test/test_transforms/test_class.py +test/test_transforms/test_contents.py +test/test_transforms/test_docinfo.py +test/test_transforms/test_doctitle.py +test/test_transforms/test_expose_internals.py +test/test_transforms/test_filter.py +test/test_transforms/test_footnotes.py +test/test_transforms/test_hyperlinks.py +test/test_transforms/test_messages.py +test/test_transforms/test_peps.py +test/test_transforms/test_sectnum.py +test/test_transforms/test_strip_comments.py +test/test_transforms/test_substitutions.py +test/test_transforms/test_target_notes.py +test/test_transforms/test_transitions.py +test/test_transforms/test_writer_aux.py +test/test_writers/__init__.py +test/test_writers/test_docutils_xml.py +test/test_writers/test_html4css1_misc.py +test/test_writers/test_html4css1_parts.py +test/test_writers/test_html4css1_template.py +test/test_writers/test_latex2e.py +test/test_writers/test_null.py +test/test_writers/test_pseudoxml.py +test/test_writers/test_s5.py +tools/buildhtml.py +tools/docutils.conf +tools/quicktest.py +tools/rst2html.py +tools/rst2latex.py +tools/rst2newlatex.py +tools/rst2pseudoxml.py +tools/rst2s5.py +tools/rst2xml.py +tools/rstpep2html.py +tools/dev/README.txt +tools/dev/create_unimap.py +tools/dev/profile_docutils.py +tools/dev/unicode2rstsubs.py +tools/editors/README.txt +tools/editors/emacs/README.txt +tools/editors/emacs/docutils.conf +tools/editors/emacs/rst.el +tools/editors/emacs/tests/Makefile +tools/editors/emacs/tests/README.txt +tools/editors/emacs/tests/tests-adjust-section.el +tools/editors/emacs/tests/tests-basic.el +tools/editors/emacs/tests/tests-runner.el diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/EGG-INFO/dependency_links.txt --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/EGG-INFO/dependency_links.txt Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,1 @@ + diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/EGG-INFO/not-zip-safe --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/EGG-INFO/not-zip-safe Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,1 @@ + diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/EGG-INFO/scripts/rst2html.py --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/EGG-INFO/scripts/rst2html.py Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,23 @@ +#!C:\Python25\python.exe + +# $Id: rst2html.py 4564 2006-05-21 20:44:42Z wiemann $ +# Author: David Goodger +# Copyright: This module has been placed in the public domain. + +""" +A minimal front end to the Docutils Publisher, producing HTML. +""" + +try: + import locale + locale.setlocale(locale.LC_ALL, '') +except: + pass + +from docutils.core import publish_cmdline, default_description + + +description = ('Generates (X)HTML documents from standalone reStructuredText ' + 'sources. ' + default_description) + +publish_cmdline(writer_name='html', description=description) diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/EGG-INFO/scripts/rst2latex.py --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/EGG-INFO/scripts/rst2latex.py Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,23 @@ +#!C:\Python25\python.exe + +# $Id: rst2latex.py 4564 2006-05-21 20:44:42Z wiemann $ +# Author: David Goodger +# Copyright: This module has been placed in the public domain. + +""" +A minimal front end to the Docutils Publisher, producing LaTeX. +""" + +try: + import locale + locale.setlocale(locale.LC_ALL, '') +except: + pass + +from docutils.core import publish_cmdline, default_description + + +description = ('Generates LaTeX documents from standalone reStructuredText ' + 'sources. ' + default_description) + +publish_cmdline(writer_name='latex', description=description) diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/EGG-INFO/scripts/rst2newlatex.py --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/EGG-INFO/scripts/rst2newlatex.py Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,25 @@ +#!C:\Python25\python.exe + +# $Id: rst2newlatex.py 4564 2006-05-21 20:44:42Z wiemann $ +# Author: David Goodger +# Copyright: This module has been placed in the public domain. + +""" +A minimal front end to the Docutils Publisher, producing LaTeX using +the new LaTeX writer. +""" + +try: + import locale + locale.setlocale(locale.LC_ALL, '') +except: + pass + +from docutils.core import publish_cmdline, default_description + + +description = ('Generates LaTeX documents from standalone reStructuredText ' + 'sources. This writer is EXPERIMENTAL and should not be used ' + 'in a production environment. ' + default_description) + +publish_cmdline(writer_name='newlatex2e', description=description) diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/EGG-INFO/scripts/rst2pseudoxml.py --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/EGG-INFO/scripts/rst2pseudoxml.py Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,23 @@ +#!C:\Python25\python.exe + +# $Id: rst2pseudoxml.py 4564 2006-05-21 20:44:42Z wiemann $ +# Author: David Goodger +# Copyright: This module has been placed in the public domain. + +""" +A minimal front end to the Docutils Publisher, producing pseudo-XML. +""" + +try: + import locale + locale.setlocale(locale.LC_ALL, '') +except: + pass + +from docutils.core import publish_cmdline, default_description + + +description = ('Generates pseudo-XML from standalone reStructuredText ' + 'sources (for testing purposes). ' + default_description) + +publish_cmdline(description=description) diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/EGG-INFO/scripts/rst2s5.py --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/EGG-INFO/scripts/rst2s5.py Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,24 @@ +#!C:\Python25\python.exe + +# $Id: rst2s5.py 4564 2006-05-21 20:44:42Z wiemann $ +# Author: Chris Liechti +# Copyright: This module has been placed in the public domain. + +""" +A minimal front end to the Docutils Publisher, producing HTML slides using +the S5 template system. +""" + +try: + import locale + locale.setlocale(locale.LC_ALL, '') +except: + pass + +from docutils.core import publish_cmdline, default_description + + +description = ('Generates S5 (X)HTML slideshow documents from standalone ' + 'reStructuredText sources. ' + default_description) + +publish_cmdline(writer_name='s5', description=description) diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/EGG-INFO/scripts/rst2xml.py --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/EGG-INFO/scripts/rst2xml.py Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,23 @@ +#!C:\Python25\python.exe + +# $Id: rst2xml.py 4564 2006-05-21 20:44:42Z wiemann $ +# Author: David Goodger +# Copyright: This module has been placed in the public domain. + +""" +A minimal front end to the Docutils Publisher, producing Docutils XML. +""" + +try: + import locale + locale.setlocale(locale.LC_ALL, '') +except: + pass + +from docutils.core import publish_cmdline, default_description + + +description = ('Generates Docutils-native XML from standalone ' + 'reStructuredText sources. ' + default_description) + +publish_cmdline(writer_name='xml', description=description) diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/EGG-INFO/scripts/rstpep2html.py --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/EGG-INFO/scripts/rstpep2html.py Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,25 @@ +#!C:\Python25\python.exe + +# $Id: rstpep2html.py 4564 2006-05-21 20:44:42Z wiemann $ +# Author: David Goodger +# Copyright: This module has been placed in the public domain. + +""" +A minimal front end to the Docutils Publisher, producing HTML from PEP +(Python Enhancement Proposal) documents. +""" + +try: + import locale + locale.setlocale(locale.LC_ALL, '') +except: + pass + +from docutils.core import publish_cmdline, default_description + + +description = ('Generates (X)HTML from reStructuredText-format PEP files. ' + + default_description) + +publish_cmdline(reader_name='pep', writer_name='pep_html', + description=description) diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/EGG-INFO/top_level.txt --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/EGG-INFO/top_level.txt Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,2 @@ +docutils +roman diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/__init__.py --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/__init__.py Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,204 @@ +# $Id: __init__.py 4801 2006-11-12 18:02:08Z goodger $ +# Author: David Goodger +# Copyright: This module has been placed in the public domain. + +""" +This is the Docutils (Python Documentation Utilities) package. + +Package Structure +================= + +Modules: + +- __init__.py: Contains component base classes, exception classes, and + Docutils version information. + +- core.py: Contains the ``Publisher`` class and ``publish_*()`` convenience + functions. + +- frontend.py: Runtime settings (command-line interface, configuration files) + processing, for Docutils front-ends. + +- io.py: Provides a uniform API for low-level input and output. + +- nodes.py: Docutils document tree (doctree) node class library. + +- statemachine.py: A finite state machine specialized for + regular-expression-based text filters. + +- urischemes.py: Contains a complete mapping of known URI addressing + scheme names to descriptions. + +- utils.py: Contains the ``Reporter`` system warning class and miscellaneous + utilities. + +Subpackages: + +- languages: Language-specific mappings of terms. + +- parsers: Syntax-specific input parser modules or packages. + +- readers: Context-specific input handlers which understand the data + source and manage a parser. + +- transforms: Modules used by readers and writers to modify DPS + doctrees. + +- writers: Format-specific output translators. +""" + +__docformat__ = 'reStructuredText' + +__version__ = '0.5' +"""``major.minor.micro`` version number. The micro number is bumped for API +changes, for new functionality, and for interim project releases. The minor +number is bumped whenever there is a significant project release. The major +number will be bumped when the project is feature-complete, and perhaps if +there is a major change in the design.""" + +__version_details__ = 'snapshot 2007-11-01, r5461' +"""Extra version details (e.g. 'snapshot 2005-05-29, r3410', 'repository', +'release'), modified automatically & manually.""" + +class ApplicationError(StandardError): pass +class DataError(ApplicationError): pass + + +class SettingsSpec: + + """ + Runtime setting specification base class. + + SettingsSpec subclass objects used by `docutils.frontend.OptionParser`. + """ + + settings_spec = () + """Runtime settings specification. Override in subclasses. + + Defines runtime settings and associated command-line options, as used by + `docutils.frontend.OptionParser`. This is a tuple of: + + - Option group title (string or `None` which implies no group, just a list + of single options). + + - Description (string or `None`). + + - A sequence of option tuples. Each consists of: + + - Help text (string) + + - List of option strings (e.g. ``['-Q', '--quux']``). + + - Dictionary of keyword arguments sent to the OptionParser/OptionGroup + ``add_option`` method. + + Runtime setting names are derived implicitly from long option names + ('--a-setting' becomes ``settings.a_setting``) or explicitly from the + 'dest' keyword argument. + + Most settings will also have a 'validator' keyword & function. The + validator function validates setting values (from configuration files + and command-line option arguments) and converts them to appropriate + types. For example, the ``docutils.frontend.validate_boolean`` + function, **required by all boolean settings**, converts true values + ('1', 'on', 'yes', and 'true') to 1 and false values ('0', 'off', + 'no', 'false', and '') to 0. Validators need only be set once per + setting. See the `docutils.frontend.validate_*` functions. + + See the optparse docs for more details. + + - More triples of group title, description, options, as many times as + needed. Thus, `settings_spec` tuples can be simply concatenated. + """ + + settings_defaults = None + """A dictionary of defaults for settings not in `settings_spec` (internal + settings, intended to be inaccessible by command-line and config file). + Override in subclasses.""" + + settings_default_overrides = None + """A dictionary of auxiliary defaults, to override defaults for settings + defined in other components. Override in subclasses.""" + + relative_path_settings = () + """Settings containing filesystem paths. Override in subclasses. + Settings listed here are to be interpreted relative to the current working + directory.""" + + config_section = None + """The name of the config file section specific to this component + (lowercase, no brackets). Override in subclasses.""" + + config_section_dependencies = None + """A list of names of config file sections that are to be applied before + `config_section`, in order (from general to specific). In other words, + the settings in `config_section` are to be overlaid on top of the settings + from these sections. The "general" section is assumed implicitly. + Override in subclasses.""" + + +class TransformSpec: + + """ + Runtime transform specification base class. + + TransformSpec subclass objects used by `docutils.transforms.Transformer`. + """ + + def get_transforms(self): + """Transforms required by this class. Override in subclasses.""" + if self.default_transforms != (): + import warnings + warnings.warn('default_transforms attribute deprecated.\n' + 'Use get_transforms() method instead.', + DeprecationWarning) + return list(self.default_transforms) + return [] + + # Deprecated; for compatibility. + default_transforms = () + + unknown_reference_resolvers = () + """List of functions to try to resolve unknown references. Unknown + references have a 'refname' attribute which doesn't correspond to any + target in the document. Called when the transforms in + `docutils.tranforms.references` are unable to find a correct target. The + list should contain functions which will try to resolve unknown + references, with the following signature:: + + def reference_resolver(node): + '''Returns boolean: true if resolved, false if not.''' + + If the function is able to resolve the reference, it should also remove + the 'refname' attribute and mark the node as resolved:: + + del node['refname'] + node.resolved = 1 + + Each function must have a "priority" attribute which will affect the order + the unknown_reference_resolvers are run:: + + reference_resolver.priority = 100 + + Override in subclasses.""" + + +class Component(SettingsSpec, TransformSpec): + + """Base class for Docutils components.""" + + component_type = None + """Name of the component type ('reader', 'parser', 'writer'). Override in + subclasses.""" + + supported = () + """Names for this component. Override in subclasses.""" + + def supports(self, format): + """ + Is `format` supported by this component? + + To be used by transforms to ask the dependent component if it supports + a certain input context or output format. + """ + return format in self.supported diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/core.py --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/core.py Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,613 @@ +# $Id: core.py 5033 2007-03-21 19:51:22Z wiemann $ +# Author: David Goodger +# Copyright: This module has been placed in the public domain. + +""" +Calling the ``publish_*`` convenience functions (or instantiating a +`Publisher` object) with component names will result in default +behavior. For custom behavior (setting component options), create +custom component objects first, and pass *them* to +``publish_*``/`Publisher`. See `The Docutils Publisher`_. + +.. _The Docutils Publisher: http://docutils.sf.net/docs/api/publisher.html +""" + +__docformat__ = 'reStructuredText' + +import sys +import pprint +from types import StringType +from docutils import __version__, __version_details__, SettingsSpec +from docutils import frontend, io, utils, readers, writers +from docutils.frontend import OptionParser +from docutils.transforms import Transformer +import docutils.readers.doctree + + +class Publisher: + + """ + A facade encapsulating the high-level logic of a Docutils system. + """ + + def __init__(self, reader=None, parser=None, writer=None, + source=None, source_class=io.FileInput, + destination=None, destination_class=io.FileOutput, + settings=None): + """ + Initial setup. If any of `reader`, `parser`, or `writer` are not + specified, the corresponding ``set_...`` method should be called with + a component name (`set_reader` sets the parser as well). + """ + + self.document = None + """The document tree (`docutils.nodes` objects).""" + + self.reader = reader + """A `docutils.readers.Reader` instance.""" + + self.parser = parser + """A `docutils.parsers.Parser` instance.""" + + self.writer = writer + """A `docutils.writers.Writer` instance.""" + + for component in 'reader', 'parser', 'writer': + assert not isinstance(getattr(self, component), StringType), \ + ('passed string as "%s" parameter; use "%s_name" instead' + % (getattr(self, component), component, component)) + + self.source = source + """The source of input data, a `docutils.io.Input` instance.""" + + self.source_class = source_class + """The class for dynamically created source objects.""" + + self.destination = destination + """The destination for docutils output, a `docutils.io.Output` + instance.""" + + self.destination_class = destination_class + """The class for dynamically created destination objects.""" + + self.settings = settings + """An object containing Docutils settings as instance attributes. + Set by `self.process_command_line()` or `self.get_settings()`.""" + + def set_reader(self, reader_name, parser, parser_name): + """Set `self.reader` by name.""" + reader_class = readers.get_reader_class(reader_name) + self.reader = reader_class(parser, parser_name) + self.parser = self.reader.parser + + def set_writer(self, writer_name): + """Set `self.writer` by name.""" + writer_class = writers.get_writer_class(writer_name) + self.writer = writer_class() + + def set_components(self, reader_name, parser_name, writer_name): + if self.reader is None: + self.set_reader(reader_name, self.parser, parser_name) + if self.parser is None: + if self.reader.parser is None: + self.reader.set_parser(parser_name) + self.parser = self.reader.parser + if self.writer is None: + self.set_writer(writer_name) + + def setup_option_parser(self, usage=None, description=None, + settings_spec=None, config_section=None, + **defaults): + if config_section: + if not settings_spec: + settings_spec = SettingsSpec() + settings_spec.config_section = config_section + parts = config_section.split() + if len(parts) > 1 and parts[-1] == 'application': + settings_spec.config_section_dependencies = ['applications'] + #@@@ Add self.source & self.destination to components in future? + option_parser = OptionParser( + components=(self.parser, self.reader, self.writer, settings_spec), + defaults=defaults, read_config_files=1, + usage=usage, description=description) + return option_parser + + def get_settings(self, usage=None, description=None, + settings_spec=None, config_section=None, **defaults): + """ + Set and return default settings (overrides in `defaults` dict). + + Set components first (`self.set_reader` & `self.set_writer`). + Explicitly setting `self.settings` disables command line option + processing from `self.publish()`. + """ + option_parser = self.setup_option_parser( + usage, description, settings_spec, config_section, **defaults) + self.settings = option_parser.get_default_values() + return self.settings + + def process_programmatic_settings(self, settings_spec, + settings_overrides, + config_section): + if self.settings is None: + defaults = (settings_overrides or {}).copy() + # Propagate exceptions by default when used programmatically: + defaults.setdefault('traceback', 1) + self.get_settings(settings_spec=settings_spec, + config_section=config_section, + **defaults) + + def process_command_line(self, argv=None, usage=None, description=None, + settings_spec=None, config_section=None, + **defaults): + """ + Pass an empty list to `argv` to avoid reading `sys.argv` (the + default). + + Set components first (`self.set_reader` & `self.set_writer`). + """ + option_parser = self.setup_option_parser( + usage, description, settings_spec, config_section, **defaults) + if argv is None: + argv = sys.argv[1:] + self.settings = option_parser.parse_args(argv) + + def set_io(self, source_path=None, destination_path=None): + if self.source is None: + self.set_source(source_path=source_path) + if self.destination is None: + self.set_destination(destination_path=destination_path) + + def set_source(self, source=None, source_path=None): + if source_path is None: + source_path = self.settings._source + else: + self.settings._source = source_path + self.source = self.source_class( + source=source, source_path=source_path, + encoding=self.settings.input_encoding) + + def set_destination(self, destination=None, destination_path=None): + if destination_path is None: + destination_path = self.settings._destination + else: + self.settings._destination = destination_path + self.destination = self.destination_class( + destination=destination, destination_path=destination_path, + encoding=self.settings.output_encoding, + error_handler=self.settings.output_encoding_error_handler) + + def apply_transforms(self): + self.document.transformer.populate_from_components( + (self.source, self.reader, self.reader.parser, self.writer, + self.destination)) + self.document.transformer.apply_transforms() + + def publish(self, argv=None, usage=None, description=None, + settings_spec=None, settings_overrides=None, + config_section=None, enable_exit_status=None): + """ + Process command line options and arguments (if `self.settings` not + already set), run `self.reader` and then `self.writer`. Return + `self.writer`'s output. + """ + exit = None + try: + if self.settings is None: + self.process_command_line( + argv, usage, description, settings_spec, config_section, + **(settings_overrides or {})) + self.set_io() + self.document = self.reader.read(self.source, self.parser, + self.settings) + self.apply_transforms() + output = self.writer.write(self.document, self.destination) + self.writer.assemble_parts() + except SystemExit, error: + exit = 1 + exit_status = error.code + except Exception, error: + if not self.settings: # exception too early to report nicely + raise + if self.settings.traceback: # Propagate exceptions? + self.debugging_dumps() + raise + self.report_Exception(error) + exit = 1 + exit_status = 1 + self.debugging_dumps() + if (enable_exit_status and self.document + and (self.document.reporter.max_level + >= self.settings.exit_status_level)): + sys.exit(self.document.reporter.max_level + 10) + elif exit: + sys.exit(exit_status) + return output + + def debugging_dumps(self): + if not self.document: + return + if self.settings.dump_settings: + print >>sys.stderr, '\n::: Runtime settings:' + print >>sys.stderr, pprint.pformat(self.settings.__dict__) + if self.settings.dump_internals: + print >>sys.stderr, '\n::: Document internals:' + print >>sys.stderr, pprint.pformat(self.document.__dict__) + if self.settings.dump_transforms: + print >>sys.stderr, '\n::: Transforms applied:' + print >>sys.stderr, (' (priority, transform class, ' + 'pending node details, keyword args)') + print >>sys.stderr, pprint.pformat( + [(priority, '%s.%s' % (xclass.__module__, xclass.__name__), + pending and pending.details, kwargs) + for priority, xclass, pending, kwargs + in self.document.transformer.applied]) + if self.settings.dump_pseudo_xml: + print >>sys.stderr, '\n::: Pseudo-XML:' + print >>sys.stderr, self.document.pformat().encode( + 'raw_unicode_escape') + + def report_Exception(self, error): + if isinstance(error, utils.SystemMessage): + self.report_SystemMessage(error) + elif isinstance(error, UnicodeError): + self.report_UnicodeError(error) + else: + print >>sys.stderr, '%s: %s' % (error.__class__.__name__, error) + print >>sys.stderr, ("""\ +Exiting due to error. Use "--traceback" to diagnose. +Please report errors to . +Include "--traceback" output, Docutils version (%s [%s]), +Python version (%s), your OS type & version, and the +command line used.""" % (__version__, __version_details__, + sys.version.split()[0])) + + def report_SystemMessage(self, error): + print >>sys.stderr, ('Exiting due to level-%s (%s) system message.' + % (error.level, + utils.Reporter.levels[error.level])) + + def report_UnicodeError(self, error): + sys.stderr.write( + '%s: %s\n' + '\n' + 'The specified output encoding (%s) cannot\n' + 'handle all of the output.\n' + 'Try setting "--output-encoding-error-handler" to\n' + '\n' + '* "xmlcharrefreplace" (for HTML & XML output);\n' + % (error.__class__.__name__, error, + self.settings.output_encoding)) + try: + data = error.object[error.start:error.end] + sys.stderr.write( + ' the output will contain "%s" and should be usable.\n' + '* "backslashreplace" (for other output formats, Python 2.3+);\n' + ' look for "%s" in the output.\n' + % (data.encode('ascii', 'xmlcharrefreplace'), + data.encode('ascii', 'backslashreplace'))) + except AttributeError: + sys.stderr.write(' the output should be usable as-is.\n') + sys.stderr.write( + '* "replace"; look for "?" in the output.\n' + '\n' + '"--output-encoding-error-handler" is currently set to "%s".\n' + '\n' + 'Exiting due to error. Use "--traceback" to diagnose.\n' + 'If the advice above doesn\'t eliminate the error,\n' + 'please report it to .\n' + 'Include "--traceback" output, Docutils version (%s),\n' + 'Python version (%s), your OS type & version, and the\n' + 'command line used.\n' + % (self.settings.output_encoding_error_handler, + __version__, sys.version.split()[0])) + +default_usage = '%prog [options] [ []]' +default_description = ('Reads from (default is stdin) and writes to ' + ' (default is stdout). See ' + ' for ' + 'the full reference.') + +def publish_cmdline(reader=None, reader_name='standalone', + parser=None, parser_name='restructuredtext', + writer=None, writer_name='pseudoxml', + settings=None, settings_spec=None, + settings_overrides=None, config_section=None, + enable_exit_status=1, argv=None, + usage=default_usage, description=default_description): + """ + Set up & run a `Publisher` for command-line-based file I/O (input and + output file paths taken automatically from the command line). Return the + encoded string output also. + + Parameters: see `publish_programmatically` for the remainder. + + - `argv`: Command-line argument list to use instead of ``sys.argv[1:]``. + - `usage`: Usage string, output if there's a problem parsing the command + line. + - `description`: Program description, output for the "--help" option + (along with command-line option descriptions). + """ + pub = Publisher(reader, parser, writer, settings=settings) + pub.set_components(reader_name, parser_name, writer_name) + output = pub.publish( + argv, usage, description, settings_spec, settings_overrides, + config_section=config_section, enable_exit_status=enable_exit_status) + return output + +def publish_file(source=None, source_path=None, + destination=None, destination_path=None, + reader=None, reader_name='standalone', + parser=None, parser_name='restructuredtext', + writer=None, writer_name='pseudoxml', + settings=None, settings_spec=None, settings_overrides=None, + config_section=None, enable_exit_status=None): + """ + Set up & run a `Publisher` for programmatic use with file-like I/O. + Return the encoded string output also. + + Parameters: see `publish_programmatically`. + """ + output, pub = publish_programmatically( + source_class=io.FileInput, source=source, source_path=source_path, + destination_class=io.FileOutput, + destination=destination, destination_path=destination_path, + reader=reader, reader_name=reader_name, + parser=parser, parser_name=parser_name, + writer=writer, writer_name=writer_name, + settings=settings, settings_spec=settings_spec, + settings_overrides=settings_overrides, + config_section=config_section, + enable_exit_status=enable_exit_status) + return output + +def publish_string(source, source_path=None, destination_path=None, + reader=None, reader_name='standalone', + parser=None, parser_name='restructuredtext', + writer=None, writer_name='pseudoxml', + settings=None, settings_spec=None, + settings_overrides=None, config_section=None, + enable_exit_status=None): + """ + Set up & run a `Publisher` for programmatic use with string I/O. Return + the encoded string or Unicode string output. + + For encoded string output, be sure to set the 'output_encoding' setting to + the desired encoding. Set it to 'unicode' for unencoded Unicode string + output. Here's one way:: + + publish_string(..., settings_overrides={'output_encoding': 'unicode'}) + + Similarly for Unicode string input (`source`):: + + publish_string(..., settings_overrides={'input_encoding': 'unicode'}) + + Parameters: see `publish_programmatically`. + """ + output, pub = publish_programmatically( + source_class=io.StringInput, source=source, source_path=source_path, + destination_class=io.StringOutput, + destination=None, destination_path=destination_path, + reader=reader, reader_name=reader_name, + parser=parser, parser_name=parser_name, + writer=writer, writer_name=writer_name, + settings=settings, settings_spec=settings_spec, + settings_overrides=settings_overrides, + config_section=config_section, + enable_exit_status=enable_exit_status) + return output + +def publish_parts(source, source_path=None, source_class=io.StringInput, + destination_path=None, + reader=None, reader_name='standalone', + parser=None, parser_name='restructuredtext', + writer=None, writer_name='pseudoxml', + settings=None, settings_spec=None, + settings_overrides=None, config_section=None, + enable_exit_status=None): + """ + Set up & run a `Publisher`, and return a dictionary of document parts. + Dictionary keys are the names of parts, and values are Unicode strings; + encoding is up to the client. For programmatic use with string I/O. + + For encoded string input, be sure to set the 'input_encoding' setting to + the desired encoding. Set it to 'unicode' for unencoded Unicode string + input. Here's how:: + + publish_parts(..., settings_overrides={'input_encoding': 'unicode'}) + + Parameters: see `publish_programmatically`. + """ + output, pub = publish_programmatically( + source=source, source_path=source_path, source_class=source_class, + destination_class=io.StringOutput, + destination=None, destination_path=destination_path, + reader=reader, reader_name=reader_name, + parser=parser, parser_name=parser_name, + writer=writer, writer_name=writer_name, + settings=settings, settings_spec=settings_spec, + settings_overrides=settings_overrides, + config_section=config_section, + enable_exit_status=enable_exit_status) + return pub.writer.parts + +def publish_doctree(source, source_path=None, + source_class=io.StringInput, + reader=None, reader_name='standalone', + parser=None, parser_name='restructuredtext', + settings=None, settings_spec=None, + settings_overrides=None, config_section=None, + enable_exit_status=None): + """ + Set up & run a `Publisher` for programmatic use with string I/O. + Return the document tree. + + For encoded string input, be sure to set the 'input_encoding' setting to + the desired encoding. Set it to 'unicode' for unencoded Unicode string + input. Here's one way:: + + publish_doctree(..., settings_overrides={'input_encoding': 'unicode'}) + + Parameters: see `publish_programmatically`. + """ + pub = Publisher(reader=reader, parser=parser, writer=None, + settings=settings, + source_class=source_class, + destination_class=io.NullOutput) + pub.set_components(reader_name, parser_name, 'null') + pub.process_programmatic_settings( + settings_spec, settings_overrides, config_section) + pub.set_source(source, source_path) + pub.set_destination(None, None) + output = pub.publish(enable_exit_status=enable_exit_status) + return pub.document + +def publish_from_doctree(document, destination_path=None, + writer=None, writer_name='pseudoxml', + settings=None, settings_spec=None, + settings_overrides=None, config_section=None, + enable_exit_status=None): + """ + Set up & run a `Publisher` to render from an existing document + tree data structure, for programmatic use with string I/O. Return + the encoded string output. + + Note that document.settings is overridden; if you want to use the settings + of the original `document`, pass settings=document.settings. + + Also, new document.transformer and document.reporter objects are + generated. + + For encoded string output, be sure to set the 'output_encoding' setting to + the desired encoding. Set it to 'unicode' for unencoded Unicode string + output. Here's one way:: + + publish_from_doctree( + ..., settings_overrides={'output_encoding': 'unicode'}) + + Parameters: `document` is a `docutils.nodes.document` object, an existing + document tree. + + Other parameters: see `publish_programmatically`. + """ + reader = docutils.readers.doctree.Reader(parser_name='null') + pub = Publisher(reader, None, writer, + source=io.DocTreeInput(document), + destination_class=io.StringOutput, settings=settings) + if not writer and writer_name: + pub.set_writer(writer_name) + pub.process_programmatic_settings( + settings_spec, settings_overrides, config_section) + pub.set_destination(None, destination_path) + return pub.publish(enable_exit_status=enable_exit_status) + +def publish_programmatically(source_class, source, source_path, + destination_class, destination, destination_path, + reader, reader_name, + parser, parser_name, + writer, writer_name, + settings, settings_spec, + settings_overrides, config_section, + enable_exit_status): + """ + Set up & run a `Publisher` for custom programmatic use. Return the + encoded string output and the Publisher object. + + Applications should not need to call this function directly. If it does + seem to be necessary to call this function directly, please write to the + Docutils-develop mailing list + . + + Parameters: + + * `source_class` **required**: The class for dynamically created source + objects. Typically `io.FileInput` or `io.StringInput`. + + * `source`: Type depends on `source_class`: + + - If `source_class` is `io.FileInput`: Either a file-like object + (must have 'read' and 'close' methods), or ``None`` + (`source_path` is opened). If neither `source` nor + `source_path` are supplied, `sys.stdin` is used. + + - If `source_class` is `io.StringInput` **required**: The input + string, either an encoded 8-bit string (set the + 'input_encoding' setting to the correct encoding) or a Unicode + string (set the 'input_encoding' setting to 'unicode'). + + * `source_path`: Type depends on `source_class`: + + - `io.FileInput`: Path to the input file, opened if no `source` + supplied. + + - `io.StringInput`: Optional. Path to the file or object that produced + `source`. Only used for diagnostic output. + + * `destination_class` **required**: The class for dynamically created + destination objects. Typically `io.FileOutput` or `io.StringOutput`. + + * `destination`: Type depends on `destination_class`: + + - `io.FileOutput`: Either a file-like object (must have 'write' and + 'close' methods), or ``None`` (`destination_path` is opened). If + neither `destination` nor `destination_path` are supplied, + `sys.stdout` is used. + + - `io.StringOutput`: Not used; pass ``None``. + + * `destination_path`: Type depends on `destination_class`: + + - `io.FileOutput`: Path to the output file. Opened if no `destination` + supplied. + + - `io.StringOutput`: Path to the file or object which will receive the + output; optional. Used for determining relative paths (stylesheets, + source links, etc.). + + * `reader`: A `docutils.readers.Reader` object. + + * `reader_name`: Name or alias of the Reader class to be instantiated if + no `reader` supplied. + + * `parser`: A `docutils.parsers.Parser` object. + + * `parser_name`: Name or alias of the Parser class to be instantiated if + no `parser` supplied. + + * `writer`: A `docutils.writers.Writer` object. + + * `writer_name`: Name or alias of the Writer class to be instantiated if + no `writer` supplied. + + * `settings`: A runtime settings (`docutils.frontend.Values`) object, for + dotted-attribute access to runtime settings. It's the end result of the + `SettingsSpec`, config file, and option processing. If `settings` is + passed, it's assumed to be complete and no further setting/config/option + processing is done. + + * `settings_spec`: A `docutils.SettingsSpec` subclass or object. Provides + extra application-specific settings definitions independently of + components. In other words, the application becomes a component, and + its settings data is processed along with that of the other components. + Used only if no `settings` specified. + + * `settings_overrides`: A dictionary containing application-specific + settings defaults that override the defaults of other components. + Used only if no `settings` specified. + + * `config_section`: A string, the name of the configuration file section + for this application. Overrides the ``config_section`` attribute + defined by `settings_spec`. Used only if no `settings` specified. + + * `enable_exit_status`: Boolean; enable exit status at end of processing? + """ + pub = Publisher(reader, parser, writer, settings=settings, + source_class=source_class, + destination_class=destination_class) + pub.set_components(reader_name, parser_name, writer_name) + pub.process_programmatic_settings( + settings_spec, settings_overrides, config_section) + pub.set_source(source, source_path) + pub.set_destination(destination, destination_path) + output = pub.publish(enable_exit_status=enable_exit_status) + return output, pub diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/examples.py --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/examples.py Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,96 @@ +# $Id: examples.py 4800 2006-11-12 18:02:01Z goodger $ +# Author: David Goodger +# Copyright: This module has been placed in the public domain. + +""" +This module contains practical examples of Docutils client code. + +Importing this module from client code is not recommended; its contents are +subject to change in future Docutils releases. Instead, it is recommended +that you copy and paste the parts you need into your own code, modifying as +necessary. +""" + +from docutils import core, io + + +def html_parts(input_string, source_path=None, destination_path=None, + input_encoding='unicode', doctitle=1, initial_header_level=1): + """ + Given an input string, returns a dictionary of HTML document parts. + + Dictionary keys are the names of parts, and values are Unicode strings; + encoding is up to the client. + + Parameters: + + - `input_string`: A multi-line text string; required. + - `source_path`: Path to the source file or object. Optional, but useful + for diagnostic output (system messages). + - `destination_path`: Path to the file or object which will receive the + output; optional. Used for determining relative paths (stylesheets, + source links, etc.). + - `input_encoding`: The encoding of `input_string`. If it is an encoded + 8-bit string, provide the correct encoding. If it is a Unicode string, + use "unicode", the default. + - `doctitle`: Disable the promotion of a lone top-level section title to + document title (and subsequent section title to document subtitle + promotion); enabled by default. + - `initial_header_level`: The initial level for header elements (e.g. 1 + for "

"). + """ + overrides = {'input_encoding': input_encoding, + 'doctitle_xform': doctitle, + 'initial_header_level': initial_header_level} + parts = core.publish_parts( + source=input_string, source_path=source_path, + destination_path=destination_path, + writer_name='html', settings_overrides=overrides) + return parts + +def html_body(input_string, source_path=None, destination_path=None, + input_encoding='unicode', output_encoding='unicode', + doctitle=1, initial_header_level=1): + """ + Given an input string, returns an HTML fragment as a string. + + The return value is the contents of the element. + + Parameters (see `html_parts()` for the remainder): + + - `output_encoding`: The desired encoding of the output. If a Unicode + string is desired, use the default value of "unicode" . + """ + parts = html_parts( + input_string=input_string, source_path=source_path, + destination_path=destination_path, + input_encoding=input_encoding, doctitle=doctitle, + initial_header_level=initial_header_level) + fragment = parts['html_body'] + if output_encoding != 'unicode': + fragment = fragment.encode(output_encoding) + return fragment + +def internals(input_string, source_path=None, destination_path=None, + input_encoding='unicode', settings_overrides=None): + """ + Return the document tree and publisher, for exploring Docutils internals. + + Parameters: see `html_parts()`. + """ + if settings_overrides: + overrides = settings_overrides.copy() + else: + overrides = {} + overrides['input_encoding'] = input_encoding + output, pub = core.publish_programmatically( + source_class=io.StringInput, source=input_string, + source_path=source_path, + destination_class=io.NullOutput, destination=None, + destination_path=destination_path, + reader=None, reader_name='standalone', + parser=None, parser_name='restructuredtext', + writer=None, writer_name='null', + settings=None, settings_spec=None, settings_overrides=overrides, + config_section=None, enable_exit_status=None) + return pub.writer.document, pub diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/frontend.py --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/frontend.py Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,756 @@ +# $Id: frontend.py 4913 2007-02-12 04:05:20Z goodger $ +# Author: David Goodger +# Copyright: This module has been placed in the public domain. + +""" +Command-line and common processing for Docutils front-end tools. + +Exports the following classes: + +* `OptionParser`: Standard Docutils command-line processing. +* `Option`: Customized version of `optparse.Option`; validation support. +* `Values`: Runtime settings; objects are simple structs + (``object.attribute``). Supports cumulative list settings (attributes). +* `ConfigParser`: Standard Docutils config file processing. + +Also exports the following functions: + +* Option callbacks: `store_multiple`, `read_config_file`. +* Setting validators: `validate_encoding`, + `validate_encoding_error_handler`, + `validate_encoding_and_error_handler`, `validate_boolean`, + `validate_threshold`, `validate_colon_separated_string_list`, + `validate_dependency_file`. +* `make_paths_absolute`. +""" + +docformat = 'reStructuredText' + +import os +import os.path +import sys +import types +import warnings +import ConfigParser as CP +import codecs +import docutils +import docutils.utils +import docutils.nodes +try: + import optparse + from optparse import SUPPRESS_HELP +except ImportError: + import optik as optparse + from optik import SUPPRESS_HELP + + +def store_multiple(option, opt, value, parser, *args, **kwargs): + """ + Store multiple values in `parser.values`. (Option callback.) + + Store `None` for each attribute named in `args`, and store the value for + each key (attribute name) in `kwargs`. + """ + for attribute in args: + setattr(parser.values, attribute, None) + for key, value in kwargs.items(): + setattr(parser.values, key, value) + +def read_config_file(option, opt, value, parser): + """ + Read a configuration file during option processing. (Option callback.) + """ + try: + new_settings = parser.get_config_file_settings(value) + except ValueError, error: + parser.error(error) + parser.values.update(new_settings, parser) + +def validate_encoding(setting, value, option_parser, + config_parser=None, config_section=None): + try: + codecs.lookup(value) + except LookupError: + raise (LookupError('setting "%s": unknown encoding: "%s"' + % (setting, value)), + None, sys.exc_info()[2]) + return value + +def validate_encoding_error_handler(setting, value, option_parser, + config_parser=None, config_section=None): + try: + codecs.lookup_error(value) + except AttributeError: # prior to Python 2.3 + if value not in ('strict', 'ignore', 'replace', 'xmlcharrefreplace'): + raise (LookupError( + 'unknown encoding error handler: "%s" (choices: ' + '"strict", "ignore", "replace", or "xmlcharrefreplace")' % value), + None, sys.exc_info()[2]) + except LookupError: + raise (LookupError( + 'unknown encoding error handler: "%s" (choices: ' + '"strict", "ignore", "replace", "backslashreplace", ' + '"xmlcharrefreplace", and possibly others; see documentation for ' + 'the Python ``codecs`` module)' % value), + None, sys.exc_info()[2]) + return value + +def validate_encoding_and_error_handler( + setting, value, option_parser, config_parser=None, config_section=None): + """ + Side-effect: if an error handler is included in the value, it is inserted + into the appropriate place as if it was a separate setting/option. + """ + if ':' in value: + encoding, handler = value.split(':') + validate_encoding_error_handler( + setting + '_error_handler', handler, option_parser, + config_parser, config_section) + if config_parser: + config_parser.set(config_section, setting + '_error_handler', + handler) + else: + setattr(option_parser.values, setting + '_error_handler', handler) + else: + encoding = value + validate_encoding(setting, encoding, option_parser, + config_parser, config_section) + return encoding + +def validate_boolean(setting, value, option_parser, + config_parser=None, config_section=None): + if isinstance(value, types.UnicodeType): + try: + return option_parser.booleans[value.strip().lower()] + except KeyError: + raise (LookupError('unknown boolean value: "%s"' % value), + None, sys.exc_info()[2]) + return value + +def validate_nonnegative_int(setting, value, option_parser, + config_parser=None, config_section=None): + value = int(value) + if value < 0: + raise ValueError('negative value; must be positive or zero') + return value + +def validate_threshold(setting, value, option_parser, + config_parser=None, config_section=None): + try: + return int(value) + except ValueError: + try: + return option_parser.thresholds[value.lower()] + except (KeyError, AttributeError): + raise (LookupError('unknown threshold: %r.' % value), + None, sys.exc_info[2]) + +def validate_colon_separated_string_list( + setting, value, option_parser, config_parser=None, config_section=None): + if isinstance(value, types.UnicodeType): + value = value.split(':') + else: + last = value.pop() + value.extend(last.split(':')) + return value + +def validate_url_trailing_slash( + setting, value, option_parser, config_parser=None, config_section=None): + if not value: + return './' + elif value.endswith('/'): + return value + else: + return value + '/' + +def validate_dependency_file(setting, value, option_parser, + config_parser=None, config_section=None): + try: + return docutils.utils.DependencyList(value) + except IOError: + return docutils.utils.DependencyList(None) + +def validate_strip_class(setting, value, option_parser, + config_parser=None, config_section=None): + if config_parser: # validate all values + class_values = value + else: # just validate the latest value + class_values = [value[-1]] + for class_value in class_values: + normalized = docutils.nodes.make_id(class_value) + if class_value != normalized: + raise ValueError('invalid class value %r (perhaps %r?)' + % (class_value, normalized)) + return value + +def make_paths_absolute(pathdict, keys, base_path=None): + """ + Interpret filesystem path settings relative to the `base_path` given. + + Paths are values in `pathdict` whose keys are in `keys`. Get `keys` from + `OptionParser.relative_path_settings`. + """ + if base_path is None: + base_path = os.getcwd() + for key in keys: + if pathdict.has_key(key): + value = pathdict[key] + if isinstance(value, types.ListType): + value = [make_one_path_absolute(base_path, path) + for path in value] + elif value: + value = make_one_path_absolute(base_path, value) + pathdict[key] = value + +def make_one_path_absolute(base_path, path): + return os.path.abspath(os.path.join(base_path, path)) + + +class Values(optparse.Values): + + """ + Updates list attributes by extension rather than by replacement. + Works in conjunction with the `OptionParser.lists` instance attribute. + """ + + def init(self, *args, **kwargs): + optparse.Values.init(self, *args, **kwargs) + if (not hasattr(self, 'record_dependencies') + or self.record_dependencies is None): + # Set up dependency list, in case it is needed. + self.record_dependencies = docutils.utils.DependencyList() + + def update(self, other_dict, option_parser): + if isinstance(other_dict, Values): + other_dict = other_dict.dict + other_dict = other_dict.copy() + for setting in option_parser.lists.keys(): + if (hasattr(self, setting) and other_dict.has_key(setting)): + value = getattr(self, setting) + if value: + value += other_dict[setting] + del other_dict[setting] + self._update_loose(other_dict) + + def copy(self): + """Return a shallow copy of `self`.""" + return self.class(defaults=self.dict) + + +class Option(optparse.Option): + + ATTRS = optparse.Option.ATTRS + ['validator', 'overrides'] + + def process(self, opt, value, values, parser): + """ + Call the validator function on applicable settings and + evaluate the 'overrides' option. + Extends `optparse.Option.process`. + """ + result = optparse.Option.process(self, opt, value, values, parser) + setting = self.dest + if setting: + if self.validator: + value = getattr(values, setting) + try: + new_value = self.validator(setting, value, parser) + except Exception, error: + raise (optparse.OptionValueError( + 'Error in option "%s":\n %s: %s' + % (opt, error.class.name, error)), + None, sys.exc_info()[2]) + setattr(values, setting, new_value) + if self.overrides: + setattr(values, self.overrides, None) + return result + + +class OptionParser(optparse.OptionParser, docutils.SettingsSpec): + + """ + Parser for command-line and library use. The `settings_spec` + specification here and in other Docutils components are merged to build + the set of command-line options and runtime settings for this process. + + Common settings (defined below) and component-specific settings must not + conflict. Short options are reserved for common settings, and components + are restrict to using long options. + """ + + standard_config_files = [ + '/etc/docutils.conf', # system-wide + './docutils.conf', # project-specific + '~/.docutils'] # user-specific + """Docutils configuration files, using ConfigParser syntax. Filenames + will be tilde-expanded later. Later files override earlier ones.""" + + threshold_choices = 'info 1 warning 2 error 3 severe 4 none 5'.split() + """Possible inputs for for --report and --halt threshold values.""" + + thresholds = {'info': 1, 'warning': 2, 'error': 3, 'severe': 4, 'none': 5} + """Lookup table for --report and --halt threshold values.""" + + booleans={'1': 1, 'on': 1, 'yes': 1, 'true': 1, + '0': 0, 'off': 0, 'no': 0, 'false': 0, '': 0} + """Lookup table for boolean configuration file settings.""" + + if hasattr(codecs, 'backslashreplace_errors'): + default_error_encoding_error_handler = 'backslashreplace' + else: + default_error_encoding_error_handler = 'replace' + + settings_spec = ( + 'General Docutils Options', + None, + (('Specify the document title as metadata.', + ['--title'], {}), + ('Include a "Generated by Docutils" credit and link.', + ['--generator', '-g'], {'action': 'store_true', + 'validator': validate_boolean}), + ('Do not include a generator credit.', + ['--no-generator'], {'action': 'store_false', 'dest': 'generator'}), + ('Include the date at the end of the document (UTC).', + ['--date', '-d'], {'action': 'store_const', 'const': '%Y-%m-%d', + 'dest': 'datestamp'}), + ('Include the time & date (UTC).', + ['--time', '-t'], {'action': 'store_const', + 'const': '%Y-%m-%d %H:%M UTC', + 'dest': 'datestamp'}), + ('Do not include a datestamp of any kind.', + ['--no-datestamp'], {'action': 'store_const', 'const': None, + 'dest': 'datestamp'}), + ('Include a "View document source" link.', + ['--source-link', '-s'], {'action': 'store_true', + 'validator': validate_boolean}), + ('Use for a source link; implies --source-link.', + ['--source-url'], {'metavar': ''}), + ('Do not include a "View document source" link.', + ['--no-source-link'], + {'action': 'callback', 'callback': store_multiple, + 'callback_args': ('source_link', 'source_url')}), + ('Link from section headers to TOC entries. (default)', + ['--toc-entry-backlinks'], + {'dest': 'toc_backlinks', 'action': 'store_const', 'const': 'entry', + 'default': 'entry'}), + ('Link from section headers to the top of the TOC.', + ['--toc-top-backlinks'], + {'dest': 'toc_backlinks', 'action': 'store_const', 'const': 'top'}), + ('Disable backlinks to the table of contents.', + ['--no-toc-backlinks'], + {'dest': 'toc_backlinks', 'action': 'store_false'}), + ('Link from footnotes/citations to references. (default)', + ['--footnote-backlinks'], + {'action': 'store_true', 'default': 1, + 'validator': validate_boolean}), + ('Disable backlinks from footnotes and citations.', + ['--no-footnote-backlinks'], + {'dest': 'footnote_backlinks', 'action': 'store_false'}), + ('Enable section numbering. (default)', + ['--section-numbering'], + {'action': 'store_true', 'dest': 'sectnum_xform', + 'default': 1, 'validator': validate_boolean}), + ('Disable section numbering.', + ['--no-section-numbering'], + {'action': 'store_false', 'dest': 'sectnum_xform'}), + ('Remove comment elements from the document tree.', + ['--strip-comments'], + {'action': 'store_true', 'validator': validate_boolean}), + ('Leave comment elements in the document tree. (default)', + ['--leave-comments'], + {'action': 'store_false', 'dest': 'strip_comments'}), + ('Remove all elements with classes="" from the document tree. ' + '(Multiple-use option.)', + ['--strip-elements-with-class'], + {'action': 'append', 'dest': 'strip_elements_with_classes', + 'metavar': '', 'validator': validate_strip_class}), + ('Remove all classes="" attributes from elements in the ' + 'document tree. (Multiple-use option.)', + ['--strip-class'], + {'action': 'append', 'dest': 'strip_classes', + 'metavar': '', 'validator': validate_strip_class}), + ('Report system messages at or higher than : "info" or "1", ' + '"warning"/"2" (default), "error"/"3", "severe"/"4", "none"/"5"', + ['--report', '-r'], {'choices': threshold_choices, 'default': 2, + 'dest': 'report_level', 'metavar': '', + 'validator': validate_threshold}), + ('Report all system messages. (Same as "--report=1".)', + ['--verbose', '-v'], {'action': 'store_const', 'const': 1, + 'dest': 'report_level'}), + ('Report no system messages. (Same as "--report=5".)', + ['--quiet', '-q'], {'action': 'store_const', 'const': 5, + 'dest': 'report_level'}), + ('Halt execution at system messages at or above . ' + 'Levels as in --report. Default: 4 (severe).', + ['--halt'], {'choices': threshold_choices, 'dest': 'halt_level', + 'default': 4, 'metavar': '', + 'validator': validate_threshold}), + ('Halt at the slightest problem. Same as "--halt=info".', + ['--strict'], {'action': 'store_const', 'const': 'info', + 'dest': 'halt_level'}), + ('Enable a non-zero exit status for non-halting system messages at ' + 'or above . Default: 5 (disabled).', + ['--exit-status'], {'choices': threshold_choices, + 'dest': 'exit_status_level', + 'default': 5, 'metavar': '', + 'validator': validate_threshold}), + ('Enable debug-level system messages and diagnostics.', + ['--debug'], {'action': 'store_true', 'validator': validate_boolean}), + ('Disable debug output. (default)', + ['--no-debug'], {'action': 'store_false', 'dest': 'debug'}), + ('Send the output of system messages to .', + ['--warnings'], {'dest': 'warning_stream', 'metavar': ''}), + ('Enable Python tracebacks when Docutils is halted.', + ['--traceback'], {'action': 'store_true', 'default': None, + 'validator': validate_boolean}), + ('Disable Python tracebacks. (default)', + ['--no-traceback'], {'dest': 'traceback', 'action': 'store_false'}), + ('Specify the encoding and optionally the ' + 'error handler of input text. Default: :strict.', + ['--input-encoding', '-i'], + {'metavar': '', + 'validator': validate_encoding_and_error_handler}), + ('Specify the error handler for undecodable characters. ' + 'Choices: "strict" (default), "ignore", and "replace".', + ['--input-encoding-error-handler'], + {'default': 'strict', 'validator': validate_encoding_error_handler}), + ('Specify the text encoding and optionally the error handler for ' + 'output. Default: UTF-8:strict.', + ['--output-encoding', '-o'], + {'metavar': '', 'default': 'utf-8', + 'validator': validate_encoding_and_error_handler}), + ('Specify error handler for unencodable output characters; ' + '"strict" (default), "ignore", "replace", ' + '"xmlcharrefreplace", "backslashreplace" (Python 2.3+).', + ['--output-encoding-error-handler'], + {'default': 'strict', 'validator': validate_encoding_error_handler}), + ('Specify text encoding and error handler for error output. ' + 'Default: ASCII:%s.' + % default_error_encoding_error_handler, + ['--error-encoding', '-e'], + {'metavar': '', 'default': 'ascii', + 'validator': validate_encoding_and_error_handler}), + ('Specify the error handler for unencodable characters in ' + 'error output. Default: %s.' + % default_error_encoding_error_handler, + ['--error-encoding-error-handler'], + {'default': default_error_encoding_error_handler, + 'validator': validate_encoding_error_handler}), + ('Specify the language (as 2-letter code). Default: en.', + ['--language', '-l'], {'dest': 'language_code', 'default': 'en', + 'metavar': ''}), + ('Write output file dependencies to .', + ['--record-dependencies'], + {'metavar': '', 'validator': validate_dependency_file, + 'default': None}), # default set in Values class + ('Read configuration settings from , if it exists.', + ['--config'], {'metavar': '', 'type': 'string', + 'action': 'callback', 'callback': read_config_file}), + ("Show this program's version number and exit.", + ['--version', '-V'], {'action': 'version'}), + ('Show this help message and exit.', + ['--help', '-h'], {'action': 'help'}), + # Typically not useful for non-programmatical use: + (SUPPRESS_HELP, ['--id-prefix'], {'default': ''}), + (SUPPRESS_HELP, ['--auto-id-prefix'], {'default': 'id'}), + # Hidden options, for development use only: + (SUPPRESS_HELP, ['--dump-settings'], {'action': 'store_true'}), + (SUPPRESS_HELP, ['--dump-internals'], {'action': 'store_true'}), + (SUPPRESS_HELP, ['--dump-transforms'], {'action': 'store_true'}), + (SUPPRESS_HELP, ['--dump-pseudo-xml'], {'action': 'store_true'}), + (SUPPRESS_HELP, ['--expose-internal-attribute'], + {'action': 'append', 'dest': 'expose_internals', + 'validator': validate_colon_separated_string_list}), + (SUPPRESS_HELP, ['--strict-visitor'], {'action': 'store_true'}), + )) + """Runtime settings and command-line options common to all Docutils front + ends. Setting specs specific to individual Docutils components are also + used (see `populate_from_components()`).""" + + settings_defaults = {'_disable_config': None, + '_source': None, + '_destination': None, + '_config_files': None} + """Defaults for settings that don't have command-line option equivalents.""" + + relative_path_settings = ('warning_stream',) + + config_section = 'general' + + version_template = ('%%prog (Docutils %s [%s])' + % (docutils.version, docutils.__version_details)) + """Default version message.""" + + def init__(self, components=(), defaults=None, read_config_files=None, + *args, **kwargs): + """ + `components` is a list of Docutils components each containing a + ``.settings_spec`` attribute. `defaults` is a mapping of setting + default overrides. + """ + + self.lists = {} + """Set of list-type settings.""" + + self.config_files = [] + """List of paths of applied configuration files.""" + + optparse.OptionParser.init( + self, option_class=Option, add_help_option=None, + formatter=optparse.TitledHelpFormatter(width=78), + *args, **kwargs) + if not self.version: + self.version = self.version_template + # Make an instance copy (it will be modified): + self.relative_path_settings = list(self.relative_path_settings) + self.components = (self,) + tuple(components) + self.populate_from_components(self.components) + self.set_defaults_from_dict(defaults or {}) + if read_config_files and not self.defaults['_disable_config']: + try: + config_settings = self.get_standard_config_settings() + except ValueError, error: + self.error(error) + self.set_defaults_from_dict(config_settings.dict) + + def populate_from_components(self, components): + """ + For each component, first populate from the `SettingsSpec.settings_spec` + structure, then from the `SettingsSpec.settings_defaults` dictionary. + After all components have been processed, check for and populate from + each component's `SettingsSpec.settings_default_overrides` dictionary. + """ + for component in components: + if component is None: + continue + settings_spec = component.settings_spec + self.relative_path_settings.extend( + component.relative_path_settings) + for i in range(0, len(settings_spec), 3): + title, description, option_spec = settings_spec[i:i+3] + if title: + group = optparse.OptionGroup(self, title, description) + self.add_option_group(group) + else: + group = self # single options + for (help_text, option_strings, kwargs) in option_spec: + option = group.add_option(help=help_text, *option_strings, + **kwargs) + if kwargs.get('action') == 'append': + self.lists[option.dest] = 1 + if component.settings_defaults: + self.defaults.update(component.settings_defaults) + for component in components: + if component and component.settings_default_overrides: + self.defaults.update(component.settings_default_overrides) + + def get_standard_config_files(self): + """Return list of config files, from environment or standard.""" + try: + config_files = os.environ['DOCUTILSCONFIG'].split(os.pathsep) + except KeyError: + config_files = self.standard_config_files + + # If 'HOME' is not set, expandvars() requires the 'pwd' module which is + # not available under certain environments, for example, within + # mod_python. The publisher ends up in here, and we need to publish + # from within mod_python. Therefore we need to avoid expanding when we + # are in those environments. + expand = os.path.expanduser + if 'HOME' not in os.environ: + try: + import pwd + except ImportError: + expand = lambda x: x + return [expand(f) for f in config_files if f.strip()] + + def get_standard_config_settings(self): + settings = Values() + for filename in self.get_standard_config_files(): + settings.update(self.get_config_file_settings(filename), self) + return settings + + def get_config_file_settings(self, config_file): + """Returns a dictionary containing appropriate config file settings.""" + parser = ConfigParser() + parser.read(config_file, self) + self.config_files.extend(parser._files) + base_path = os.path.dirname(config_file) + applied = {} + settings = Values() + for component in self.components: + if not component: + continue + for section in (tuple(component.config_section_dependencies or ()) + + (component.config_section,)): + if applied.has_key(section): + continue + applied[section] = 1 + settings.update(parser.get_section(section), self) + make_paths_absolute( + settings.dict, self.relative_path_settings, base_path) + return settings.dict + + def check_values(self, values, args): + """Store positional arguments as runtime settings.""" + values._source, values._destination = self.check_args(args) + make_paths_absolute(values.dict, self.relative_path_settings, + os.getcwd()) + values._config_files = self.config_files + return values + + def check_args(self, args): + source = destination = None + if args: + source = args.pop(0) + if source == '-': # means stdin + source = None + if args: + destination = args.pop(0) + if destination == '-': # means stdout + destination = None + if args: + self.error('Maximum 2 arguments allowed.') + if source and source == destination: + self.error('Do not specify the same file for both source and ' + 'destination. It will clobber the source file.') + return source, destination + + def set_defaults_from_dict(self, defaults): + self.defaults.update(defaults) + + def get_default_values(self): + """Needed to get custom `Values` instances.""" + defaults = Values(self.defaults) + defaults._config_files = self.config_files + return defaults + + def get_option_by_dest(self, dest): + """ + Get an option by its dest. + + If you're supplying a dest which is shared by several options, + it is undefined which option of those is returned. + + A KeyError is raised if there is no option with the supplied + dest. + """ + for group in self.option_groups + [self]: + for option in group.option_list: + if option.dest == dest: + return option + raise KeyError('No option with dest == %r.' % dest) + + +class ConfigParser(CP.ConfigParser): + + old_settings = { + 'pep_stylesheet': ('pep_html writer', 'stylesheet'), + 'pep_stylesheet_path': ('pep_html writer', 'stylesheet_path'), + 'pep_template': ('pep_html writer', 'template')} + """{old setting: (new section, new setting)} mapping, used by + `handle_old_config`, to convert settings from the old [options] section.""" + + old_warning = """ +The "[option]" section is deprecated. Support for old-format configuration +files may be removed in a future Docutils release. Please revise your +configuration files. See , +section "Old-Format Configuration Files". +""" + + not_utf8_error = """\ +Unable to read configuration file "%s": content not encoded as UTF-8. +Skipping "%s" configuration file. +""" + + def init(self, *args, **kwargs): + CP.ConfigParser.init(self, *args, **kwargs) + + self._files = [] + """List of paths of configuration files read.""" + + def read(self, filenames, option_parser): + if type(filenames) in (types.StringType, types.UnicodeType): + filenames = [filenames] + for filename in filenames: + try: + # Config files must be UTF-8-encoded: + fp = codecs.open(filename, 'r', 'utf-8') + except IOError: + continue + try: + CP.ConfigParser.readfp(self, fp, filename) + except UnicodeDecodeError: + sys.stderr.write(self.not_utf8_error % (filename, filename)) + fp.close() + continue + fp.close() + self._files.append(filename) + if self.has_section('options'): + self.handle_old_config(filename) + self.validate_settings(filename, option_parser) + + def handle_old_config(self, filename): + warnings.warn_explicit(self.old_warning, ConfigDeprecationWarning, + filename, 0) + options = self.get_section('options') + if not self.has_section('general'): + self.add_section('general') + for key, value in options.items(): + if self.old_settings.has_key(key): + section, setting = self.old_settings[key] + if not self.has_section(section): + self.add_section(section) + else: + section = 'general' + setting = key + if not self.has_option(section, setting): + self.set(section, setting, value) + self.remove_section('options') + + def validate_settings(self, filename, option_parser): + """ + Call the validator function and implement overrides on all applicable + settings. + """ + for section in self.sections(): + for setting in self.options(section): + try: + option = option_parser.get_option_by_dest(setting) + except KeyError: + continue + if option.validator: + value = self.get(section, setting, raw=1) + try: + new_value = option.validator( + setting, value, option_parser, + config_parser=self, config_section=section) + except Exception, error: + raise (ValueError( + 'Error in config file "%s", section "[%s]":\n' + ' %s: %s\n %s = %s' + % (filename, section, error.class.name, + error, setting, value)), None, sys.exc_info()[2]) + self.set(section, setting, new_value) + if option.overrides: + self.set(section, option.overrides, None) + + def optionxform(self, optionstr): + """ + Transform '-' to '_' so the cmdline form of option names can be used. + """ + return optionstr.lower().replace('-', '_') + + def get_section(self, section): + """ + Return a given section as a dictionary (empty if the section + doesn't exist). + """ + section_dict = {} + if self.has_section(section): + for option in self.options(section): + section_dict[option] = self.get(section, option, raw=1) + return section_dict + + +class ConfigDeprecationWarning(DeprecationWarning): + """Warning for deprecated configuration file features.""" diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/io.py --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/io.py Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,412 @@ +# $Id: io.py 4750 2006-09-16 21:32:29Z wiemann $ +# Author: David Goodger +# Copyright: This module has been placed in the public domain. + +""" +I/O classes provide a uniform API for low-level input and output. Subclasses +will exist for a variety of input/output mechanisms. +""" + +docformat = 'reStructuredText' + +import sys +try: + import locale +except: + pass +import re +from types import UnicodeType +from docutils import TransformSpec + + +class Input(TransformSpec): + + """ + Abstract base class for input wrappers. + """ + + component_type = 'input' + + default_source_path = None + + def init(self, source=None, source_path=None, encoding=None, + error_handler='strict'): + self.encoding = encoding + """Text encoding for the input source.""" + + self.error_handler = error_handler + """Text decoding error handler.""" + + self.source = source + """The source of input data.""" + + self.source_path = source_path + """A text reference to the source.""" + + if not source_path: + self.source_path = self.default_source_path + + self.successful_encoding = None + """The encoding that successfully decoded the source data.""" + + def repr(self): + return '%s: source=%r, source_path=%r' % (self.class, self.source, + self.source_path) + + def read(self): + raise NotImplementedError + + def decode(self, data): + """ + Decode a string, `data`, heuristically. + Raise UnicodeError if unsuccessful. + + The client application should call ``locale.setlocale`` at the + beginning of processing:: + + locale.setlocale(locale.LC_ALL, '') + """ + if self.encoding and self.encoding.lower() == 'unicode': + assert isinstance(data, UnicodeType), ( + 'input encoding is "unicode" ' + 'but input is not a unicode object') + if isinstance(data, UnicodeType): + # Accept unicode even if self.encoding != 'unicode'. + return data + if self.encoding: + # We believe the user/application when the encoding is + # explicitly given. + encodings = [self.encoding] + else: + data_encoding = self.determine_encoding_from_data(data) + if data_encoding: + # If the data declares its encoding (explicitly or via a BOM), + # we believe it. + encodings = [data_encoding] + else: + # Apply heuristics only if no encoding is explicitly given and + # no BOM found. Start with UTF-8, because that only matches + # data that IS UTF-8: + encodings = ['utf-8'] + try: + # for Python 2.2 compatibility + encodings.append(locale.nl_langinfo(locale.CODESET)) + except: + pass + try: + encodings.append(locale.getlocale()[1]) + except: + pass + try: + encodings.append(locale.getdefaultlocale()[1]) + except: + pass + # fallback encoding: + encodings.append('latin-1') + error = None + error_details = '' + for enc in encodings: + if not enc: + continue + try: + decoded = unicode(data, enc, self.error_handler) + self.successful_encoding = enc + # Return decoded, removing BOMs. + return decoded.replace(u'\ufeff', u'') + except (UnicodeError, LookupError), error: + pass + if error is not None: + error_details = '\n(%s: %s)' % (error.class.name, error) + raise UnicodeError( + 'Unable to decode input data. Tried the following encodings: ' + '%s.%s' + % (', '.join([repr(enc) for enc in encodings if enc]), + error_details)) + + coding_slug = re.compile("coding[:=]\s([-\w.]+)") + """Encoding declaration pattern.""" + + byte_order_marks = (('\xef\xbb\xbf', 'utf-8'), + ('\xfe\xff', 'utf-16-be'), + ('\xff\xfe', 'utf-16-le'),) + """Sequence of (start_bytes, encoding) tuples to for encoding detection. + The first bytes of input data are checked against the start_bytes strings. + A match indicates the given encoding.""" + + def determine_encoding_from_data(self, data): + """ + Try to determine the encoding of `data` by looking in* `data`. + Check for a byte order mark (BOM) or an encoding declaration. + """ + # check for a byte order mark: + for start_bytes, encoding in self.byte_order_marks: + if data.startswith(start_bytes): + return encoding + # check for an encoding declaration pattern in first 2 lines of file: + for line in data.splitlines()[:2]: + match = self.coding_slug.search(line) + if match: + return match.group(1) + return None + + +class Output(TransformSpec): + + """ + Abstract base class for output wrappers. + """ + + component_type = 'output' + + default_destination_path = None + + def init(self, destination=None, destination_path=None, + encoding=None, error_handler='strict'): + self.encoding = encoding + """Text encoding for the output destination.""" + + self.error_handler = error_handler or 'strict' + """Text encoding error handler.""" + + self.destination = destination + """The destination for output data.""" + + self.destination_path = destination_path + """A text reference to the destination.""" + + if not destination_path: + self.destination_path = self.default_destination_path + + def repr(self): + return ('%s: destination=%r, destination_path=%r' + % (self.class, self.destination, self.destination_path)) + + def write(self, data): + """`data` is a Unicode string, to be encoded by `self.encode`.""" + raise NotImplementedError + + def encode(self, data): + if self.encoding and self.encoding.lower() == 'unicode': + assert isinstance(data, UnicodeType), ( + 'the encoding given is "unicode" but the output is not ' + 'a Unicode string') + return data + if not isinstance(data, UnicodeType): + # Non-unicode (e.g. binary) output. + return data + else: + try: + return data.encode(self.encoding, self.error_handler) + except (LookupError, ValueError): + # LookupError is raised if there are unencodable chars + # in data and the error_handler isn't found. In old + # Python versions, ValueError is raised. + if self.error_handler == 'xmlcharrefreplace': + # We are using xmlcharrefreplace with a Python + # version that doesn't support it (2.1, 2.2, or + # IronPython 1.0) so we emulate its behavior. + return ''.join([self.xmlcharref_encode(char) + for char in data]) + else: + raise + + def xmlcharref_encode(self, char): + """Emulate Python 2.3's 'xmlcharrefreplace' encoding error handler.""" + try: + return char.encode(self.encoding, 'strict') + except UnicodeError: + return '&#%i;' % ord(char) + + +class FileInput(Input): + + """ + Input for single, simple file-like objects. + """ + + def init(self, source=None, source_path=None, + encoding=None, error_handler='strict', + autoclose=1, handle_io_errors=1): + """ + :Parameters: + - `source`: either a file-like object (which is read directly), or + `None` (which implies `sys.stdin` if no `source_path` given). + - `source_path`: a path to a file, which is opened and then read. + - `encoding`: the expected text encoding of the input file. + - `error_handler`: the encoding error handler to use. + - `autoclose`: close automatically after read (boolean); always + false if `sys.stdin` is the source. + - `handle_io_errors`: summarize I/O errors here, and exit? + """ + Input.init(self, source, source_path, encoding, error_handler) + self.autoclose = autoclose + self.handle_io_errors = handle_io_errors + if source is None: + if source_path: + try: + self.source = open(source_path) + except IOError, error: + if not handle_io_errors: + raise + print >>sys.stderr, '%s: %s' % (error.class.name, + error) + print >>sys.stderr, ( + 'Unable to open source file for reading (%r). Exiting.' + % source_path) + sys.exit(1) + else: + self.source = sys.stdin + self.autoclose = None + if not source_path: + try: + self.source_path = self.source.name + except AttributeError: + pass + + def read(self): + """ + Read and decode a single file and return the data (Unicode string). + """ + try: + data = self.source.read() + finally: + if self.autoclose: + self.close() + return self.decode(data) + + def close(self): + self.source.close() + + +class FileOutput(Output): + + """ + Output for single, simple file-like objects. + """ + + def init(self, destination=None, destination_path=None, + encoding=None, error_handler='strict', autoclose=1, + handle_io_errors=1): + """ + :Parameters: + - `destination`: either a file-like object (which is written + directly) or `None` (which implies `sys.stdout` if no + `destination_path` given). + - `destination_path`: a path to a file, which is opened and then + written. + - `autoclose`: close automatically after write (boolean); always + false if `sys.stdout` is the destination. + """ + Output.init(self, destination, destination_path, + encoding, error_handler) + self.opened = 1 + self.autoclose = autoclose + self.handle_io_errors = handle_io_errors + if destination is None: + if destination_path: + self.opened = None + else: + self.destination = sys.stdout + self.autoclose = None + if not destination_path: + try: + self.destination_path = self.destination.name + except AttributeError: + pass + + def open(self): + try: + self.destination = open(self.destination_path, 'w') + except IOError, error: + if not self.handle_io_errors: + raise + print >>sys.stderr, '%s: %s' % (error.class.name, + error) + print >>sys.stderr, ('Unable to open destination file for writing ' + '(%r). Exiting.' % self.destination_path) + sys.exit(1) + self.opened = 1 + + def write(self, data): + """Encode `data`, write it to a single file, and return it.""" + output = self.encode(data) + if not self.opened: + self.open() + try: + self.destination.write(output) + finally: + if self.autoclose: + self.close() + return output + + def close(self): + self.destination.close() + self.opened = None + + +class StringInput(Input): + + """ + Direct string input. + """ + + default_source_path = '' + + def read(self): + """Decode and return the source string.""" + return self.decode(self.source) + + +class StringOutput(Output): + + """ + Direct string output. + """ + + default_destination_path = '' + + def write(self, data): + """Encode `data`, store it in `self.destination`, and return it.""" + self.destination = self.encode(data) + return self.destination + + +class NullInput(Input): + + """ + Degenerate input: read nothing. + """ + + default_source_path = 'null input' + + def read(self): + """Return a null string.""" + return u'' + + +class NullOutput(Output): + + """ + Degenerate output: write nothing. + """ + + default_destination_path = 'null output' + + def write(self, data): + """Do nothing ([don't even] send data to the bit bucket).""" + pass + + +class DocTreeInput(Input): + + """ + Adapter for document tree input. + + The document tree must be passed in the ``source`` parameter. + """ + + default_source_path = 'doctree input' + + def read(self): + """Return the document tree.""" + return self.source diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/languages/init.py --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/languages/init.py Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,21 @@ +# $Id: init.py 4564 2006-05-21 20:44:42Z wiemann $ +# Author: David Goodger +# Copyright: This module has been placed in the public domain. + +# Internationalization details are documented in +# . + +""" +This package contains modules for language-dependent features of Docutils. +""" + +docformat = 'reStructuredText' + +_languages = {} + +def get_language(language_code): + if _languages.has_key(language_code): + return _languages[language_code] + module = import(language_code, globals(), locals()) + _languages[language_code] = module + return module diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/languages/af.py --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/languages/af.py Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,58 @@ +# $Id: af.py 4564 2006-05-21 20:44:42Z wiemann $ +# Author: Jannie Hofmeyr +# Copyright: This module has been placed in the public domain. + +# New language mappings are welcome. Before doing a new translation, please +# read . Two files must be +# translated for each language: one in docutils/languages, the other in +# docutils/parsers/rst/languages. + +""" +Afrikaans-language mappings for language-dependent features of Docutils. +""" + +docformat = 'reStructuredText' + +labels = { + 'author': 'Auteur', + 'authors': 'Auteurs', + 'organization': 'Organisasie', + 'address': 'Adres', + 'contact': 'Kontak', + 'version': 'Weergawe', + 'revision': 'Revisie', + 'status': 'Status', + 'date': 'Datum', + 'copyright': 'Kopiereg', + 'dedication': 'Opdrag', + 'abstract': 'Opsomming', + 'attention': 'Aandag!', + 'caution': 'Wees versigtig!', + 'danger': '!GEVAAR!', + 'error': 'Fout', + 'hint': 'Wenk', + 'important': 'Belangrik', + 'note': 'Nota', + 'tip': 'Tip', # hint and tip both have the same translation: wenk + 'warning': 'Waarskuwing', + 'contents': 'Inhoud'} +"""Mapping of node class name to label text.""" + +bibliographic_fields = { + 'auteur': 'author', + 'auteurs': 'authors', + 'organisasie': 'organization', + 'adres': 'address', + 'kontak': 'contact', + 'weergawe': 'version', + 'revisie': 'revision', + 'status': 'status', + 'datum': 'date', + 'kopiereg': 'copyright', + 'opdrag': 'dedication', + 'opsomming': 'abstract'} +"""Afrikaans (lowcased) to canonical name mapping for bibliographic fields.""" + +author_separators = [';', ','] +"""List of separator strings for the 'Authors' bibliographic field. Tried in +order.""" diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/languages/ca.py --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/languages/ca.py Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,60 @@ +# $Id: ca.py 4564 2006-05-21 20:44:42Z wiemann $ +# Author: Ivan Vilata i Balaguer +# Copyright: This module has been placed in the public domain. + +# New language mappings are welcome. Before doing a new translation, please +# read . Two files must be +# translated for each language: one in docutils/languages, the other in +# docutils/parsers/rst/languages. + +""" +Catalan-language mappings for language-dependent features of Docutils. +""" + +docformat = 'reStructuredText' + +labels = { + # fixed: language-dependent + 'author': u'Autor', + 'authors': u'Autors', + 'organization': u'Organitzaci\u00F3', + 'address': u'Adre\u00E7a', + 'contact': u'Contacte', + 'version': u'Versi\u00F3', + 'revision': u'Revisi\u00F3', + 'status': u'Estat', + 'date': u'Data', + 'copyright': u'Copyright', + 'dedication': u'Dedicat\u00F2ria', + 'abstract': u'Resum', + 'attention': u'Atenci\u00F3!', + 'caution': u'Compte!', + 'danger': u'PERILL!', + 'error': u'Error', + 'hint': u'Suggeriment', + 'important': u'Important', + 'note': u'Nota', + 'tip': u'Consell', + 'warning': u'Av\u00EDs', + 'contents': u'Contingut'} +"""Mapping of node class name to label text.""" + +bibliographic_fields = { + # language-dependent: fixed + u'autor': 'author', + u'autors': 'authors', + u'organitzaci\u00F3': 'organization', + u'adre\u00E7a': 'address', + u'contacte': 'contact', + u'versi\u00F3': 'version', + u'revisi\u00F3': 'revision', + u'estat': 'status', + u'data': 'date', + u'copyright': 'copyright', + u'dedicat\u00F2ria': 'dedication', + u'resum': 'abstract'} +"""Catalan (lowcased) to canonical name mapping for bibliographic fields.""" + +author_separators = [';', ','] +"""List of separator strings for the 'Authors' bibliographic field. Tried in +order.""" diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/languages/cs.py --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/languages/cs.py Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,60 @@ +# $Id: cs.py 4564 2006-05-21 20:44:42Z wiemann $ +# Author: Marek Blaha +# Copyright: This module has been placed in the public domain. + +# New language mappings are welcome. Before doing a new translation, please +# read . Two files must be +# translated for each language: one in docutils/languages, the other in +# docutils/parsers/rst/languages. + +""" +Czech-language mappings for language-dependent features of Docutils. +""" + +docformat = 'reStructuredText' + +labels = { + # fixed: language-dependent + 'author': u'Autor', + 'authors': u'Auto\u0159i', + 'organization': u'Organizace', + 'address': u'Adresa', + 'contact': u'Kontakt', + 'version': u'Verze', + 'revision': u'Revize', + 'status': u'Stav', + 'date': u'Datum', + 'copyright': u'Copyright', + 'dedication': u'V\u011Bnov\u00E1n\u00ED', + 'abstract': u'Abstrakt', + 'attention': u'Pozor!', + 'caution': u'Opatrn\u011B!', + 'danger': u'!NEBEZPE\u010C\u00CD!', + 'error': u'Chyba', + 'hint': u'Rada', + 'important': u'D\u016Fle\u017Eit\u00E9', + 'note': u'Pozn\u00E1mka', + 'tip': u'Tip', + 'warning': u'Varov\u00E1n\u00ED', + 'contents': u'Obsah'} +"""Mapping of node class name to label text.""" + +bibliographic_fields = { + # language-dependent: fixed + u'autor': 'author', + u'auto\u0159i': 'authors', + u'organizace': 'organization', + u'adresa': 'address', + u'kontakt': 'contact', + u'verze': 'version', + u'revize': 'revision', + u'stav': 'status', + u'datum': 'date', + u'copyright': 'copyright', + u'v\u011Bnov\u00E1n\u00ED': 'dedication', + u'abstrakt': 'abstract'} +"""Czech (lowcased) to canonical name mapping for bibliographic fields.""" + +author_separators = [';', ','] +"""List of separator strings for the 'Authors' bibliographic field. Tried in +order.""" diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/languages/de.py --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/languages/de.py Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,58 @@ +# $Id: de.py 4564 2006-05-21 20:44:42Z wiemann $ +# Author: Gunnar Schwant +# Copyright: This module has been placed in the public domain. + +# New language mappings are welcome. Before doing a new translation, please +# read . Two files must be +# translated for each language: one in docutils/languages, the other in +# docutils/parsers/rst/languages. + +""" +German language mappings for language-dependent features of Docutils. +""" + +docformat = 'reStructuredText' + +labels = { + 'author': 'Autor', + 'authors': 'Autoren', + 'organization': 'Organisation', + 'address': 'Adresse', + 'contact': 'Kontakt', + 'version': 'Version', + 'revision': 'Revision', + 'status': 'Status', + 'date': 'Datum', + 'dedication': 'Widmung', + 'copyright': 'Copyright', + 'abstract': 'Zusammenfassung', + 'attention': 'Achtung!', + 'caution': 'Vorsicht!', + 'danger': '!GEFAHR!', + 'error': 'Fehler', + 'hint': 'Hinweis', + 'important': 'Wichtig', + 'note': 'Bemerkung', + 'tip': 'Tipp', + 'warning': 'Warnung', + 'contents': 'Inhalt'} +"""Mapping of node class name to label text.""" + +bibliographic_fields = { + 'autor': 'author', + 'autoren': 'authors', + 'organisation': 'organization', + 'adresse': 'address', + 'kontakt': 'contact', + 'version': 'version', + 'revision': 'revision', + 'status': 'status', + 'datum': 'date', + 'copyright': 'copyright', + 'widmung': 'dedication', + 'zusammenfassung': 'abstract'} +"""German (lowcased) to canonical name mapping for bibliographic fields.""" + +author_separators = [';', ','] +"""List of separator strings for the 'Authors' bibliographic field. Tried in +order.""" diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/languages/en.py --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/languages/en.py Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,60 @@ +# $Id: en.py 4564 2006-05-21 20:44:42Z wiemann $ +# Author: David Goodger +# Copyright: This module has been placed in the public domain. + +# New language mappings are welcome. Before doing a new translation, please +# read . Two files must be +# translated for each language: one in docutils/languages, the other in +# docutils/parsers/rst/languages. + +""" +English-language mappings for language-dependent features of Docutils. +""" + +docformat = 'reStructuredText' + +labels = { + # fixed: language-dependent + 'author': 'Author', + 'authors': 'Authors', + 'organization': 'Organization', + 'address': 'Address', + 'contact': 'Contact', + 'version': 'Version', + 'revision': 'Revision', + 'status': 'Status', + 'date': 'Date', + 'copyright': 'Copyright', + 'dedication': 'Dedication', + 'abstract': 'Abstract', + 'attention': 'Attention!', + 'caution': 'Caution!', + 'danger': '!DANGER!', + 'error': 'Error', + 'hint': 'Hint', + 'important': 'Important', + 'note': 'Note', + 'tip': 'Tip', + 'warning': 'Warning', + 'contents': 'Contents'} +"""Mapping of node class name to label text.""" + +bibliographic_fields = { + # language-dependent: fixed + 'author': 'author', + 'authors': 'authors', + 'organization': 'organization', + 'address': 'address', + 'contact': 'contact', + 'version': 'version', + 'revision': 'revision', + 'status': 'status', + 'date': 'date', + 'copyright': 'copyright', + 'dedication': 'dedication', + 'abstract': 'abstract'} +"""English (lowcased) to canonical name mapping for bibliographic fields.""" + +author_separators = [';', ','] +"""List of separator strings for the 'Authors' bibliographic field. Tried in +order.""" diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/languages/eo.py --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/languages/eo.py Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,61 @@ +# $Id: eo.py 4564 2006-05-21 20:44:42Z wiemann $ +# Author: Marcelo Huerta San Martin +# Copyright: This module has been placed in the public domain. + +# New language mappings are welcome. Before doing a new translation, please +# read . Two files must be +# translated for each language: one in docutils/languages, the other in +# docutils/parsers/rst/languages. + +""" +Esperanto-language mappings for language-dependent features of Docutils. +""" + +docformat = 'reStructuredText' + +labels = { + # fixed: language-dependent + 'author': u'A\u016dtoro', + 'authors': u'A\u016dtoroj', + 'organization': u'Organizo', + 'address': u'Adreso', + 'contact': u'Kontakto', + 'version': u'Versio', + 'revision': u'Revido', + 'status': u'Stato', + 'date': u'Dato', + # 'copyright': u'Kopirajto', + 'copyright': u'A\u016dtorrajto', + 'dedication': u'Dedi\u0109o', + 'abstract': u'Resumo', + 'attention': u'Atentu!', + 'caution': u'Zorgu!', + 'danger': u'DAN\u011cERO!', + 'error': u'Eraro', + 'hint': u'Spuro', + 'important': u'Grava', + 'note': u'Noto', + 'tip': u'Helpeto', + 'warning': u'Averto', + 'contents': u'Enhavo'} +"""Mapping of node class name to label text.""" + +bibliographic_fields = { + # language-dependent: fixed + 'a\u016dtoro': 'author', + 'a\u016dtoroj': 'authors', + 'organizo': 'organization', + 'adreso': 'address', + 'kontakto': 'contact', + 'versio': 'version', + 'revido': 'revision', + 'stato': 'status', + 'dato': 'date', + 'a\u016dtorrajto': 'copyright', + 'dedi\u0109o': 'dedication', + 'resumo': 'abstract'} +"""Esperanto (lowcased) to canonical name mapping for bibliographic fields.""" + +author_separators = [';', ','] +"""List of separator strings for the 'Authors' bibliographic field. Tried in +order.""" diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/languages/es.py --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/languages/es.py Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,59 @@ +# -- coding: utf-8 -- +# $Id: es.py 4572 2006-05-25 20:48:37Z richieadler $ +# Author: Marcelo Huerta San Martín +# Copyright: This module has been placed in the public domain. + +# New language mappings are welcome. Before doing a new translation, please +# read . Two files must be +# translated for each language: one in docutils/languages, the other in +# docutils/parsers/rst/languages. + +""" +Spanish-language mappings for language-dependent features of Docutils. +""" + +docformat = 'reStructuredText' + +labels = { + 'author': u'Autor', + 'authors': u'Autores', + 'organization': u'Organizaci\u00f3n', + 'address': u'Direcci\u00f3n', + 'contact': u'Contacto', + 'version': u'Versi\u00f3n', + 'revision': u'Revisi\u00f3n', + 'status': u'Estado', + 'date': u'Fecha', + 'copyright': u'Copyright', + 'dedication': u'Dedicatoria', + 'abstract': u'Resumen', + 'attention': u'\u00a1Atenci\u00f3n!', + 'caution': u'\u00a1Precauci\u00f3n!', + 'danger': u'\u00a1PELIGRO!', + 'error': u'Error', + 'hint': u'Sugerencia', + 'important': u'Importante', + 'note': u'Nota', + 'tip': u'Consejo', + 'warning': u'Advertencia', + 'contents': u'Contenido'} +"""Mapping of node class name to label text.""" + +bibliographic_fields = { + u'autor': 'author', + u'autores': 'authors', + u'organizaci\u00f3n': 'organization', + u'direcci\u00f3n': 'address', + u'contacto': 'contact', + u'versi\u00f3n': 'version', + u'revisi\u00f3n': 'revision', + u'estado': 'status', + u'fecha': 'date', + u'copyright': 'copyright', + u'dedicatoria': 'dedication', + u'resumen': 'abstract'} +"""Spanish (lowcased) to canonical name mapping for bibliographic fields.""" + +author_separators = [';', ','] +"""List of separator strings for the 'Authors' bibliographic field. Tried in +order.""" diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/languages/fi.py --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/languages/fi.py Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,60 @@ +# $Id: fi.py 4564 2006-05-21 20:44:42Z wiemann $ +# Author: Asko Soukka +# Copyright: This module has been placed in the public domain. + +# New language mappings are welcome. Before doing a new translation, please +# read . Two files must be +# translated for each language: one in docutils/languages, the other in +# docutils/parsers/rst/languages. + +""" +Finnish-language mappings for language-dependent features of Docutils. +""" + +docformat = 'reStructuredText' + +labels = { + # fixed: language-dependent + u'author': u'Tekij\u00e4', + u'authors': u'Tekij\u00e4t', + u'organization': u'Yhteis\u00f6', + u'address': u'Osoite', + u'contact': u'Yhteystiedot', + u'version': u'Versio', + u'revision': u'Vedos', + u'status': u'Tila', + u'date': u'P\u00e4iv\u00e4ys', + u'copyright': u'Tekij\u00e4noikeudet', + u'dedication': u'Omistuskirjoitus', + u'abstract': u'Tiivistelm\u00e4', + u'attention': u'Huomio!', + u'caution': u'Varo!', + u'danger': u'!VAARA!', + u'error': u'Virhe', + u'hint': u'Vihje', + u'important': u'T\u00e4rke\u00e4\u00e4', + u'note': u'Huomautus', + u'tip': u'Neuvo', + u'warning': u'Varoitus', + u'contents': u'Sis\u00e4llys'} +"""Mapping of node class name to label text.""" + +bibliographic_fields = { + # language-dependent: fixed + u'tekij\u00e4': u'author', + u'tekij\u00e4t': u'authors', + u'yhteis\u00f6': u'organization', + u'osoite': u'address', + u'yhteystiedot': u'contact', + u'versio': u'version', + u'vedos': u'revision', + u'tila': u'status', + u'p\u00e4iv\u00e4ys': u'date', + u'tekij\u00e4noikeudet': u'copyright', + u'omistuskirjoitus': u'dedication', + u'tiivistelm\u00e4': u'abstract'} +"""Finnish (lowcased) to canonical name mapping for bibliographic fields.""" + +author_separators = [';', ','] +"""List of separator strings for the 'Authors' bibliographic field. Tried in +order.""" diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/languages/fr.py --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/languages/fr.py Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,58 @@ +# $Id: fr.py 4564 2006-05-21 20:44:42Z wiemann $ +# Author: Stefane Fermigier +# Copyright: This module has been placed in the public domain. + +# New language mappings are welcome. Before doing a new translation, please +# read . Two files must be +# translated for each language: one in docutils/languages, the other in +# docutils/parsers/rst/languages. + +""" +French-language mappings for language-dependent features of Docutils. +""" + +docformat = 'reStructuredText' + +labels = { + u'author': u'Auteur', + u'authors': u'Auteurs', + u'organization': u'Organisation', + u'address': u'Adresse', + u'contact': u'Contact', + u'version': u'Version', + u'revision': u'R\u00e9vision', + u'status': u'Statut', + u'date': u'Date', + u'copyright': u'Copyright', + u'dedication': u'D\u00e9dicace', + u'abstract': u'R\u00e9sum\u00e9', + u'attention': u'Attention!', + u'caution': u'Avertissement!', + u'danger': u'!DANGER!', + u'error': u'Erreur', + u'hint': u'Indication', + u'important': u'Important', + u'note': u'Note', + u'tip': u'Astuce', + u'warning': u'Avis', + u'contents': u'Sommaire'} +"""Mapping of node class name to label text.""" + +bibliographic_fields = { + u'auteur': u'author', + u'auteurs': u'authors', + u'organisation': u'organization', + u'adresse': u'address', + u'contact': u'contact', + u'version': u'version', + u'r\u00e9vision': u'revision', + u'statut': u'status', + u'date': u'date', + u'copyright': u'copyright', + u'd\u00e9dicace': u'dedication', + u'r\u00e9sum\u00e9': u'abstract'} +"""French (lowcased) to canonical name mapping for bibliographic fields.""" + +author_separators = [';', ','] +"""List of separator strings for the 'Authors' bibliographic field. Tried in +order.""" diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/languages/he.py --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/languages/he.py Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,60 @@ +# Author: Meir Kriheli +# Id: $Id: he.py 4837 2006-12-26 09:59:41Z sfcben $ +# Copyright: This module has been placed in the public domain. + +# New language mappings are welcome. Before doing a new translation, please +# read . Two files must be +# translated for each language: one in docutils/languages, the other in +# docutils/parsers/rst/languages. + +""" +Hebrew-language mappings for language-dependent features of Docutils. +""" + +docformat = 'reStructuredText' + +labels = { + # fixed: language-dependent + 'author': u'\u05de\u05d7\u05d1\u05e8', + 'authors': u'\u05de\u05d7\u05d1\u05e8\u05d9', + 'organization': u'\u05d0\u05e8\u05d2\u05d5\u05df', + 'address': u'\u05db\u05ea\u05d5\u05d1\u05ea', + 'contact': u'\u05d0\u05d9\u05e9 \u05e7\u05e9\u05e8', + 'version': u'\u05d2\u05e8\u05e1\u05d4', + 'revision': u'\u05de\u05d4\u05d3\u05d5\u05e8\u05d4', + 'status': u'\u05e1\u05d8\u05d8\u05d5\u05e1', + 'date': u'\u05ea\u05d0\u05e8\u05d9\u05da', + 'copyright': u'\u05d6\u05db\u05d5\u05d9\u05d5\u05ea \u05e9\u05de\u05d5\u05e8\u05d5\u05ea', + 'dedication': u'\u05d4\u05e7\u05d3\u05e9\u05d4', + 'abstract': u'\u05ea\u05e7\u05e6\u05d9\u05e8', + 'attention': u'\u05ea\u05e9\u05d5\u05de\u05ea \u05dc\u05d1', + 'caution': u'\u05d6\u05d4\u05d9\u05e8\u05d5\u05ea', + 'danger': u'\u05e1\u05db\u05e0\u05d4', + 'error': u'\u05e9\u05d2\u05d9\u05d0\u05d4' , + 'hint': u'\u05e8\u05de\u05d6', + 'important': u'\u05d7\u05e9\u05d5\u05d1', + 'note': u'\u05d4\u05e2\u05e8\u05d4', + 'tip': u'\u05d8\u05d9\u05e4', + 'warning': u'\u05d0\u05d6\u05d4\u05e8\u05d4', + 'contents': u'\u05ea\u05d5\u05db\u05df'} +"""Mapping of node class name to label text.""" + +bibliographic_fields = { + # language-dependent: fixed + u'\u05de\u05d7\u05d1\u05e8': 'author', + u'\u05de\u05d7\u05d1\u05e8\u05d9': 'authors', + u'\u05d0\u05e8\u05d2\u05d5\u05df': 'organization', + u'\u05db\u05ea\u05d5\u05d1\u05ea': 'address', + u'\u05d0\u05d9\u05e9 \u05e7\u05e9\u05e8': 'contact', + u'\u05d2\u05e8\u05e1\u05d4': 'version', + u'\u05de\u05d4\u05d3\u05d5\u05e8\u05d4': 'revision', + u'\u05e1\u05d8\u05d8\u05d5\u05e1': 'status', + u'\u05ea\u05d0\u05e8\u05d9\u05da': 'date', + u'\u05d6\u05db\u05d5\u05d9\u05d5\u05ea \u05e9\u05de\u05d5\u05e8\u05d5\u05ea': 'copyright', + u'\u05d4\u05e7\u05d3\u05e9\u05d4': 'dedication', + u'\u05ea\u05e7\u05e6\u05d9\u05e8': 'abstract'} +"""Hebrew to canonical name mapping for bibliographic fields.""" + +author_separators = [';', ','] +"""List of separator strings for the 'Authors' bibliographic field. Tried in +order.""" diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/languages/it.py --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/languages/it.py Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,58 @@ +# $Id: it.py 4564 2006-05-21 20:44:42Z wiemann $ +# Author: Nicola Larosa +# Copyright: This module has been placed in the public domain. + +# New language mappings are welcome. Before doing a new translation, please +# read . Two files must be +# translated for each language: one in docutils/languages, the other in +# docutils/parsers/rst/languages. + +""" +Italian-language mappings for language-dependent features of Docutils. +""" + +docformat = 'reStructuredText' + +labels = { + 'author': 'Autore', + 'authors': 'Autori', + 'organization': 'Organizzazione', + 'address': 'Indirizzo', + 'contact': 'Contatti', + 'version': 'Versione', + 'revision': 'Revisione', + 'status': 'Status', + 'date': 'Data', + 'copyright': 'Copyright', + 'dedication': 'Dedica', + 'abstract': 'Riassunto', + 'attention': 'Attenzione!', + 'caution': 'Cautela!', + 'danger': '!PERICOLO!', + 'error': 'Errore', + 'hint': 'Suggerimento', + 'important': 'Importante', + 'note': 'Nota', + 'tip': 'Consiglio', + 'warning': 'Avvertenza', + 'contents': 'Indice'} +"""Mapping of node class name to label text.""" + +bibliographic_fields = { + 'autore': 'author', + 'autori': 'authors', + 'organizzazione': 'organization', + 'indirizzo': 'address', + 'contatto': 'contact', + 'versione': 'version', + 'revisione': 'revision', + 'status': 'status', + 'data': 'date', + 'copyright': 'copyright', + 'dedica': 'dedication', + 'riassunto': 'abstract'} +"""Italian (lowcased) to canonical name mapping for bibliographic fields.""" + +author_separators = [';', ','] +"""List of separator strings for the 'Authors' bibliographic field. Tried in +order.""" diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/languages/ja.py --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/languages/ja.py Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,61 @@ +# -- coding: utf-8 -- +# $Id: ja.py 4564 2006-05-21 20:44:42Z wiemann $ +# Author: Hisashi Morita +# Copyright: This module has been placed in the public domain. + +# New language mappings are welcome. Before doing a new translation, please +# read . Two files must be +# translated for each language: one in docutils/languages, the other in +# docutils/parsers/rst/languages. + +""" +Japanese-language mappings for language-dependent features of Docutils. +""" + +docformat = 'reStructuredText' + +labels = { + # fixed: language-dependent + 'author': u'著者', + 'authors': u'著者', + 'organization': u'組織', + 'address': u'住所', + 'contact': u'連絡先', + 'version': u'バージョン', + 'revision': u'リビジョン', + 'status': u'ステータス', + 'date': u'日付', + 'copyright': u'著作権', + 'dedication': u'献辞', + 'abstract': u'概要', + 'attention': u'注目!', + 'caution': u'注意!', + 'danger': u'!危険!', + 'error': u'エラー', + 'hint': u'ヒント', + 'important': u'重要', + 'note': u'備考', + 'tip': u'通報', + 'warning': u'警告', + 'contents': u'目次'} +"""Mapping of node class name to label text.""" + +bibliographic_fields = { + # language-dependent: fixed + u'著者': 'author', + u' n/a': 'authors', + u'組織': 'organization', + u'住所': 'address', + u'連絡先': 'contact', + u'バージョン': 'version', + u'リビジョン': 'revision', + u'ステータス': 'status', + u'日付': 'date', + u'著作権': 'copyright', + u'献辞': 'dedication', + u'概要': 'abstract'} +"""Japanese (lowcased) to canonical name mapping for bibliographic fields.""" + +author_separators = [';', ','] +"""List of separator strings for the 'Authors' bibliographic field. Tried in +order.""" diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/languages/nl.py --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/languages/nl.py Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,60 @@ +# $Id: nl.py 4564 2006-05-21 20:44:42Z wiemann $ +# Author: Martijn Pieters +# Copyright: This module has been placed in the public domain. + +# New language mappings are welcome. Before doing a new translation, please +# read . Two files must be +# translated for each language: one in docutils/languages, the other in +# docutils/parsers/rst/languages. + +""" +Dutch-language mappings for language-dependent features of Docutils. +""" + +docformat = 'reStructuredText' + +labels = { + # fixed: language-dependent + 'author': 'Auteur', + 'authors': 'Auteurs', + 'organization': 'Organisatie', + 'address': 'Adres', + 'contact': 'Contact', + 'version': 'Versie', + 'revision': 'Revisie', + 'status': 'Status', + 'date': 'Datum', + 'copyright': 'Copyright', + 'dedication': 'Toewijding', + 'abstract': 'Samenvatting', + 'attention': 'Attentie!', + 'caution': 'Let op!', + 'danger': '!GEVAAR!', + 'error': 'Fout', + 'hint': 'Hint', + 'important': 'Belangrijk', + 'note': 'Opmerking', + 'tip': 'Tip', + 'warning': 'Waarschuwing', + 'contents': 'Inhoud'} +"""Mapping of node class name to label text.""" + +bibliographic_fields = { + # language-dependent: fixed + 'auteur': 'author', + 'auteurs': 'authors', + 'organisatie': 'organization', + 'adres': 'address', + 'contact': 'contact', + 'versie': 'version', + 'revisie': 'revision', + 'status': 'status', + 'datum': 'date', + 'copyright': 'copyright', + 'toewijding': 'dedication', + 'samenvatting': 'abstract'} +"""Dutch (lowcased) to canonical name mapping for bibliographic fields.""" + +author_separators = [';', ','] +"""List of separator strings for the 'Authors' bibliographic field. Tried in +order.""" diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/languages/pt_br.py --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/languages/pt_br.py Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,60 @@ +# $Id: pt_br.py 4564 2006-05-21 20:44:42Z wiemann $ +# Author: David Goodger +# Copyright: This module has been placed in the public domain. + +# New language mappings are welcome. Before doing a new translation, please +# read . Two files must be +# translated for each language: one in docutils/languages, the other in +# docutils/parsers/rst/languages. + +""" +Brazilian Portuguese-language mappings for language-dependent features of Docutils. +""" + +docformat = 'reStructuredText' + +labels = { + # fixed: language-dependent + 'author': u'Autor', + 'authors': u'Autores', + 'organization': u'Organiza\u00E7\u00E3o', + 'address': u'Endere\u00E7o', + 'contact': u'Contato', + 'version': u'Vers\u00E3o', + 'revision': u'Revis\u00E3o', + 'status': u'Estado', + 'date': u'Data', + 'copyright': u'Copyright', + 'dedication': u'Dedicat\u00F3ria', + 'abstract': u'Resumo', + 'attention': u'Atten\u00E7\u00E3o!', + 'caution': u'Cuidado!', + 'danger': u'PERIGO!', + 'error': u'Erro', + 'hint': u'Sugest\u00E3o', + 'important': u'Importante', + 'note': u'Nota', + 'tip': u'Dica', + 'warning': u'Aviso', + 'contents': u'Sum\u00E1rio'} +"""Mapping of node class name to label text.""" + +bibliographic_fields = { + # language-dependent: fixed + u'autor': 'author', + u'autores': 'authors', + u'organiza\u00E7\u00E3o': 'organization', + u'endere\u00E7o': 'address', + u'contato': 'contact', + u'vers\u00E3o': 'version', + u'revis\u00E3o': 'revision', + u'estado': 'status', + u'data': 'date', + u'copyright': 'copyright', + u'dedicat\u00F3ria': 'dedication', + u'resumo': 'abstract'} +"""Brazilian Portuguese (lowcased) to canonical name mapping for bibliographic fields.""" + +author_separators = [';', ','] +"""List of separator strings for the 'Authors' bibliographic field. Tried in +order.""" diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/languages/ru.py --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/languages/ru.py Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,66 @@ +# $Id: ru.py 4564 2006-05-21 20:44:42Z wiemann $ +# Author: Roman Suzi +# Copyright: This module has been placed in the public domain. + +# New language mappings are welcome. Before doing a new translation, please +# read . Two files must be +# translated for each language: one in docutils/languages, the other in +# docutils/parsers/rst/languages. + +""" +Russian-language mappings for language-dependent features of Docutils. +""" + +docformat = 'reStructuredText' + +labels = { + u'abstract': u'\u0410\u043d\u043d\u043e\u0442\u0430\u0446\u0438\u044f', + u'address': u'\u0410\u0434\u0440\u0435\u0441', + u'attention': u'\u0412\u043d\u0438\u043c\u0430\u043d\u0438\u0435!', + u'author': u'\u0410\u0432\u0442\u043e\u0440', + u'authors': u'\u0410\u0432\u0442\u043e\u0440\u044b', + u'caution': u'\u041e\u0441\u0442\u043e\u0440\u043e\u0436\u043d\u043e!', + u'contact': u'\u041a\u043e\u043d\u0442\u0430\u043a\u0442', + u'contents': + u'\u0421\u043e\u0434\u0435\u0440\u0436\u0430\u043d\u0438\u0435', + u'copyright': u'\u041f\u0440\u0430\u0432\u0430 ' + u'\u043a\u043e\u043f\u0438\u0440\u043e\u0432\u0430\u043d\u0438\u044f', + u'danger': u'\u041e\u041f\u0410\u0421\u041d\u041e!', + u'date': u'\u0414\u0430\u0442\u0430', + u'dedication': + u'\u041f\u043e\u0441\u0432\u044f\u0449\u0435\u043d\u0438\u0435', + u'error': u'\u041e\u0448\u0438\u0431\u043a\u0430', + u'hint': u'\u0421\u043e\u0432\u0435\u0442', + u'important': u'\u0412\u0430\u0436\u043d\u043e', + u'note': u'\u041f\u0440\u0438\u043c\u0435\u0447\u0430\u043d\u0438\u0435', + u'organization': + u'\u041e\u0440\u0433\u0430\u043d\u0438\u0437\u0430\u0446\u0438\u044f', + u'revision': u'\u0420\u0435\u0434\u0430\u043a\u0446\u0438\u044f', + u'status': u'\u0421\u0442\u0430\u0442\u0443\u0441', + u'tip': u'\u041f\u043e\u0434\u0441\u043a\u0430\u0437\u043a\u0430', + u'version': u'\u0412\u0435\u0440\u0441\u0438\u044f', + u'warning': u'\u041f\u0440\u0435\u0434\u0443\u043f\u0440\u0435\u0436' + u'\u0434\u0435\u043d\u0438\u0435'} +"""Mapping of node class name to label text.""" + +bibliographic_fields = { + u'\u0430\u043d\u043d\u043e\u0442\u0430\u0446\u0438\u044f': u'abstract', + u'\u0430\u0434\u0440\u0435\u0441': u'address', + u'\u0430\u0432\u0442\u043e\u0440': u'author', + u'\u0430\u0432\u0442\u043e\u0440\u044b': u'authors', + u'\u043a\u043e\u043d\u0442\u0430\u043a\u0442': u'contact', + u'\u043f\u0440\u0430\u0432\u0430 \u043a\u043e\u043f\u0438\u0440\u043e' + u'\u0432\u0430\u043d\u0438\u044f': u'copyright', + u'\u0434\u0430\u0442\u0430': u'date', + u'\u043f\u043e\u0441\u0432\u044f\u0449\u0435\u043d\u0438\u0435': + u'dedication', + u'\u043e\u0440\u0433\u0430\u043d\u0438\u0437\u0430\u0446\u0438\u044f': + u'organization', + u'\u0440\u0435\u0434\u0430\u043a\u0446\u0438\u044f': u'revision', + u'\u0441\u0442\u0430\u0442\u0443\u0441': u'status', + u'\u0432\u0435\u0440\u0441\u0438\u044f': u'version'} +"""Russian (lowcased) to canonical name mapping for bibliographic fields.""" + +author_separators = [';', ','] +"""List of separator strings for the 'Authors' bibliographic field. Tried in +order.""" diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/languages/sk.py --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/languages/sk.py Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,58 @@ +# $Id: sk.py 4564 2006-05-21 20:44:42Z wiemann $ +# Author: Miroslav Vasko +# Copyright: This module has been placed in the public domain. + +# New language mappings are welcome. Before doing a new translation, please +# read . Two files must be +# translated for each language: one in docutils/languages, the other in +# docutils/parsers/rst/languages. + +""" +Slovak-language mappings for language-dependent features of Docutils. +""" + +docformat = 'reStructuredText' + +labels = { + 'author': u'Autor', + 'authors': u'Autori', + 'organization': u'Organiz\u00E1cia', + 'address': u'Adresa', + 'contact': u'Kontakt', + 'version': u'Verzia', + 'revision': u'Rev\u00EDzia', + 'status': u'Stav', + 'date': u'D\u00E1tum', + 'copyright': u'Copyright', + 'dedication': u'Venovanie', + 'abstract': u'Abstraktne', + 'attention': u'Pozor!', + 'caution': u'Opatrne!', + 'danger': u'!NEBEZPE\u010cENSTVO!', + 'error': u'Chyba', + 'hint': u'Rada', + 'important': u'D\u00F4le\u017Eit\u00E9', + 'note': u'Pozn\u00E1mka', + 'tip': u'Tip', + 'warning': u'Varovanie', + 'contents': u'Obsah'} +"""Mapping of node class name to label text.""" + +bibliographic_fields = { + u'autor': 'author', + u'autori': 'authors', + u'organiz\u00E1cia': 'organization', + u'adresa': 'address', + u'kontakt': 'contact', + u'verzia': 'version', + u'rev\u00EDzia': 'revision', + u'stav': 'status', + u'd\u00E1tum': 'date', + u'copyright': 'copyright', + u'venovanie': 'dedication', + u'abstraktne': 'abstract'} +"""Slovak (lowcased) to canonical name mapping for bibliographic fields.""" + +author_separators = [';', ','] +"""List of separator strings for the 'Authors' bibliographic field. Tried in +order.""" diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/languages/sv.py --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/languages/sv.py Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,59 @@ +# $Id: sv.py 4564 2006-05-21 20:44:42Z wiemann $ +# Author: Adam Chodorowski +# Copyright: This module has been placed in the public domain. + +# New language mappings are welcome. Before doing a new translation, please +# read . Two files must be +# translated for each language: one in docutils/languages, the other in +# docutils/parsers/rst/languages. + +""" +Swedish language mappings for language-dependent features of Docutils. +""" + +docformat = 'reStructuredText' + +labels = { + 'author': u'F\u00f6rfattare', + 'authors': u'F\u00f6rfattare', + 'organization': u'Organisation', + 'address': u'Adress', + 'contact': u'Kontakt', + 'version': u'Version', + 'revision': u'Revision', + 'status': u'Status', + 'date': u'Datum', + 'copyright': u'Copyright', + 'dedication': u'Dedikation', + 'abstract': u'Sammanfattning', + 'attention': u'Observera!', + 'caution': u'Varning!', + 'danger': u'FARA!', + 'error': u'Fel', + 'hint': u'V\u00e4gledning', + 'important': u'Viktigt', + 'note': u'Notera', + 'tip': u'Tips', + 'warning': u'Varning', + 'contents': u'Inneh\u00e5ll' } +"""Mapping of node class name to label text.""" + +bibliographic_fields = { + # 'Author' and 'Authors' identical in Swedish; assume the plural: + u'f\u00f6rfattare': 'authors', + u' n/a': 'author', + u'organisation': 'organization', + u'adress': 'address', + u'kontakt': 'contact', + u'version': 'version', + u'revision': 'revision', + u'status': 'status', + u'datum': 'date', + u'copyright': 'copyright', + u'dedikation': 'dedication', + u'sammanfattning': 'abstract' } +"""Swedish (lowcased) to canonical name mapping for bibliographic fields.""" + +author_separators = [';', ','] +"""List of separator strings for the 'Authors' bibliographic field. Tried in +order.""" diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/languages/zh_cn.py --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/languages/zh_cn.py Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,67 @@ +# -- coding: utf-8 -- +# $Id: zh_cn.py 4564 2006-05-21 20:44:42Z wiemann $ +# Author: Pan Junyong +# Copyright: This module has been placed in the public domain. + +# New language mappings are welcome. Before doing a new translation, please +# read . Two files must be +# translated for each language: one in docutils/languages, the other in +# docutils/parsers/rst/languages. + +""" +Simplified Chinese language mappings for language-dependent features +of Docutils. +""" + +docformat = 'reStructuredText' + +labels = { + # fixed: language-dependent + 'author': u'作者', + 'authors': u'作者群', + 'organization': u'组织', + 'address': u'地址', + 'contact': u'联系', + 'version': u'版本', + 'revision': u'修订', + 'status': u'状态', + 'date': u'日期', + 'copyright': u'版权', + 'dedication': u'献辞', + 'abstract': u'摘要', + 'attention': u'注意', + 'caution': u'小心', + 'danger': u'危险', + 'error': u'错误', + 'hint': u'提示', + 'important': u'重要', + 'note': u'注解', + 'tip': u'技巧', + 'warning': u'警告', + 'contents': u'目录', +} +"""Mapping of node class name to label text.""" + +bibliographic_fields = { + # language-dependent: fixed + u'作者': 'author', + u'作者群': 'authors', + u'组织': 'organization', + u'地址': 'address', + u'联系': 'contact', + u'版本': 'version', + u'修订': 'revision', + u'状态': 'status', + u'时间': 'date', + u'版权': 'copyright', + u'献辞': 'dedication', + u'摘要': 'abstract'} +"""Simplified Chinese to canonical name mapping for bibliographic fields.""" + +author_separators = [';', ',', + u'\uff1b', # '；' + u'\uff0c', # '，' + u'\u3001', # '、' + ] +"""List of separator strings for the 'Authors' bibliographic field. Tried in +order.""" diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/languages/zh_tw.py --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/languages/zh_tw.py Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,66 @@ +# -- coding: utf-8 -- +# $Id: zh_tw.py 4564 2006-05-21 20:44:42Z wiemann $ +# Author: Joe YS Jaw +# Copyright: This module has been placed in the public domain. + +# New language mappings are welcome. Before doing a new translation, please +# read . Two files must be +# translated for each language: one in docutils/languages, the other in +# docutils/parsers/rst/languages. + +""" +Traditional Chinese language mappings for language-dependent features of Docutils. +""" + +docformat = 'reStructuredText' + +labels = { + # fixed: language-dependent + 'author': u'\u4f5c\u8005', # '作者' <-- Chinese word + 'authors': u'\u4f5c\u8005\u7fa4', # '作者群', + 'organization': u'\u7d44\u7e54', # '組織', + 'address': u'\u5730\u5740', # '地址', + 'contact': u'\u9023\u7d61', # '連絡', + 'version': u'\u7248\u672c', # '版本', + 'revision': u'\u4fee\u8a02', # '修訂', + 'status': u'\u72c0\u614b', # '狀態', + 'date': u'\u65e5\u671f', # '日期', + 'copyright': u'\u7248\u6b0a', # '版權', + 'dedication': u'\u984c\u737b', # '題獻', + 'abstract': u'\u6458\u8981', # '摘要', + 'attention': u'\u6ce8\u610f\uff01', # '注意！', + 'caution': u'\u5c0f\u5fc3\uff01', # '小心！', + 'danger': u'\uff01\u5371\u96aa\uff01', # '！危險！', + 'error': u'\u932f\u8aa4', # '錯誤', + 'hint': u'\u63d0\u793a', # '提示', + 'important': u'\u91cd\u8981', # '注意！', + 'note': u'\u8a3b\u91cb', # '註釋', + 'tip': u'\u79d8\u8a23', # '秘訣', + 'warning': u'\u8b66\u544a', # '警告', + 'contents': u'\u76ee\u9304' # '目錄' +} +"""Mapping of node class name to label text.""" + +bibliographic_fields = { + # language-dependent: fixed + 'author (translation required)': 'author', + 'authors (translation required)': 'authors', + 'organization (translation required)': 'organization', + 'address (translation required)': 'address', + 'contact (translation required)': 'contact', + 'version (translation required)': 'version', + 'revision (translation required)': 'revision', + 'status (translation required)': 'status', + 'date (translation required)': 'date', + 'copyright (translation required)': 'copyright', + 'dedication (translation required)': 'dedication', + 'abstract (translation required)': 'abstract'} +"""Traditional Chinese to canonical name mapping for bibliographic fields.""" + +author_separators = [';', ',', + u'\uff1b', # '；' + u'\uff0c', # '，' + u'\u3001', # '、' + ] +"""List of separator strings for the 'Authors' bibliographic field. Tried in +order.""" diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/nodes.py --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/nodes.py Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,1801 @@ +# $Id: nodes.py 5033 2007-03-21 19:51:22Z wiemann $ +# Author: David Goodger +# Copyright: This module has been placed in the public domain. + +""" +Docutils document tree element class library. + +Classes in CamelCase are abstract base classes or auxiliary classes. The one +exception is `Text`, for a text (PCDATA) node; uppercase is used to +differentiate from element classes. Classes in lower_case_with_underscores +are element classes, matching the XML element generic identifiers in the DTD_. + +The position of each node (the level at which it can occur) is significant and +is represented by abstract base classes (`Root`, `Structural`, `Body`, +`Inline`, etc.). Certain transformations will be easier because we can use +``isinstance(node, base_class)`` to determine the position of the node in the +hierarchy. + +.. _DTD: http://docutils.sourceforge.net/docs/ref/docutils.dtd +""" + +docformat = 'reStructuredText' + +import sys +import os +import re +import warnings +from types import IntType, SliceType, StringType, UnicodeType, \ + TupleType, ListType, ClassType, TypeType +from UserString import UserString + + +# ============================== +# Functional Node Base Classes +# ============================== + +class Node: + + """Abstract base class of nodes in a document tree.""" + + parent = None + """Back-reference to the Node immediately containing this Node.""" + + document = None + """The `document` node at the root of the tree containing this Node.""" + + source = None + """Path or description of the input source which generated this Node.""" + + line = None + """The line number (1-based) of the beginning of this Node in `source`.""" + + def nonzero(self): + """ + Node instances are always true, even if they're empty. A node is more + than a simple container. Its boolean "truth" does not depend on + having one or more subnodes in the doctree. + + Use `len()` to check node length. Use `None` to represent a boolean + false value. + """ + return 1 + + def str(self): + return self.unicode().encode('raw_unicode_escape') + + def unicode(self): + # Override in subclass. + raise NotImplementedError + + def asdom(self, dom=None): + """Return a DOM fragment representation of this Node.""" + if dom is None: + import xml.dom.minidom as dom + domroot = dom.Document() + return self._dom_node(domroot) + + def pformat(self, indent=' ', level=0): + """ + Return an indented pseudo-XML representation, for test purposes. + + Override in subclasses. + """ + raise NotImplementedError + + def copy(self): + """Return a copy of self.""" + raise NotImplementedError + + def deepcopy(self): + """Return a deep copy of self (also copying children).""" + raise NotImplementedError + + def setup_child(self, child): + child.parent = self + if self.document: + child.document = self.document + if child.source is None: + child.source = self.document.current_source + if child.line is None: + child.line = self.document.current_line + + def walk(self, visitor): + """ + Traverse a tree of `Node` objects, calling the + `dispatch_visit()` method of `visitor` when entering each + node. (The `walkabout()` method is similar, except it also + calls the `dispatch_departure()` method before exiting each + node.) + + This tree traversal supports limited in-place tree + modifications. Replacing one node with one or more nodes is + OK, as is removing an element. However, if the node removed + or replaced occurs after the current node, the old node will + still be traversed, and any new nodes will not. + + Within ``visit`` methods (and ``depart`` methods for + `walkabout()`), `TreePruningException` subclasses may be raised + (`SkipChildren`, `SkipSiblings`, `SkipNode`, `SkipDeparture`). + + Parameter `visitor`: A `NodeVisitor` object, containing a + ``visit`` implementation for each `Node` subclass encountered. + + Return true if we should stop the traversal. + """ + stop = 0 + visitor.document.reporter.debug( + 'docutils.nodes.Node.walk calling dispatch_visit for %s' + % self.class.name) + try: + try: + visitor.dispatch_visit(self) + except (SkipChildren, SkipNode): + return stop + except SkipDeparture: # not applicable; ignore + pass + children = self.children + try: + for child in children[:]: + if child.walk(visitor): + stop = 1 + break + except SkipSiblings: + pass + except StopTraversal: + stop = 1 + return stop + + def walkabout(self, visitor): + """ + Perform a tree traversal similarly to `Node.walk()` (which + see), except also call the `dispatch_departure()` method + before exiting each node. + + Parameter `visitor`: A `NodeVisitor` object, containing a + ``visit`` and ``depart`` implementation for each `Node` + subclass encountered. + + Return true if we should stop the traversal. + """ + call_depart = 1 + stop = 0 + visitor.document.reporter.debug( + 'docutils.nodes.Node.walkabout calling dispatch_visit for %s' + % self.class.name) + try: + try: + visitor.dispatch_visit(self) + except SkipNode: + return stop + except SkipDeparture: + call_depart = 0 + children = self.children + try: + for child in children[:]: + if child.walkabout(visitor): + stop = 1 + break + except SkipSiblings: + pass + except SkipChildren: + pass + except StopTraversal: + stop = 1 + if call_depart: + visitor.document.reporter.debug( + 'docutils.nodes.Node.walkabout calling dispatch_departure ' + 'for %s' % self.class.name) + visitor.dispatch_departure(self) + return stop + + def traverse(self, condition=None, + include_self=1, descend=1, siblings=0, ascend=0): + """ + Return an iterable containing + + * self (if include_self is true) + * all descendants in tree traversal order (if descend is true) + * all siblings (if siblings is true) and their descendants (if + also descend is true) + * the siblings of the parent (if ascend is true) and their + descendants (if also descend is true), and so on + + If `condition` is not None, the iterable contains only nodes + for which ``condition(node)`` is true. If `condition` is a + node class ``cls``, it is equivalent to a function consisting + of ``return isinstance(node, cls)``. + + If ascend is true, assume siblings to be true as well. + + For example, given the following tree:: + + + <--- emphasis.traverse() and + <--- strong.traverse() are called. + Foo + Bar + + Baz + + Then list(emphasis.traverse()) equals :: + + [, , <#text: Foo>, <#text: Bar>] + + and list(strong.traverse(ascend=1)) equals :: + + [, <#text: Foo>, <#text: Bar>, , <#text: Baz>] + """ + r = [] + if ascend: + siblings=1 + # Check if `condition` is a class (check for TypeType for Python + # implementations that use only new-style classes, like PyPy). + if isinstance(condition, (ClassType, TypeType)): + node_class = condition + def condition(node, node_class=node_class): + return isinstance(node, node_class) + if include_self and (condition is None or condition(self)): + r.append(self) + if descend and len(self.children): + for child in self: + r.extend(child.traverse( + include_self=1, descend=1, siblings=0, ascend=0, + condition=condition)) + if siblings or ascend: + node = self + while node.parent: + index = node.parent.index(node) + for sibling in node.parent[index+1:]: + r.extend(sibling.traverse(include_self=1, descend=descend, + siblings=0, ascend=0, + condition=condition)) + if not ascend: + break + else: + node = node.parent + return r + + def next_node(self, condition=None, + include_self=0, descend=1, siblings=0, ascend=0): + """ + Return the first node in the iterable returned by traverse(), + or None if the iterable is empty. + + Parameter list is the same as of traverse. Note that + include_self defaults to 0, though. + """ + iterable = self.traverse(condition=condition, + include_self=include_self, descend=descend, + siblings=siblings, ascend=ascend) + try: + return iterable[0] + except IndexError: + return None + +class Text(Node, UserString): + + """ + Instances are terminal nodes (leaves) containing text only; no child + nodes or attributes. Initialize by passing a string to the constructor. + Access the text itself with the `astext` method. + """ + + tagname = '#text' + + children = () + """Text nodes have no children, and cannot have children.""" + + def init(self, data, rawsource=''): + UserString.init(self, data) + + self.rawsource = rawsource + """The raw text from which this element was constructed.""" + + def repr(self): + data = repr(self.data) + if len(data) > 70: + data = repr(self.data[:64] + ' ...') + return '<%s: %s>' % (self.tagname, data) + + def len(self): + return len(self.data) + + def shortrepr(self): + data = repr(self.data) + if len(data) > 20: + data = repr(self.data[:16] + ' ...') + return '<%s: %s>' % (self.tagname, data) + + def _dom_node(self, domroot): + return domroot.createTextNode(self.data) + + def astext(self): + return self.data + + def unicode(self): + return self.data + + def copy(self): + return self.class(self.data) + + def deepcopy(self): + return self.copy() + + def pformat(self, indent=' ', level=0): + result = [] + indent = indent * level + for line in self.data.splitlines(): + result.append(indent + line + '\n') + return ''.join(result) + + +class Element(Node): + + """ + `Element` is the superclass to all specific elements. + + Elements contain attributes and child nodes. Elements emulate + dictionaries for attributes, indexing by attribute name (a string). To + set the attribute 'att' to 'value', do:: + + element['att'] = 'value' + + There are two special attributes: 'ids' and 'names'. Both are + lists of unique identifiers, and names serve as human interfaces + to IDs. Names are case- and whitespace-normalized (see the + fully_normalize_name() function), and IDs conform to the regular + expression ``[a-z](-?[a-z0-9]+)`` (see the make_id() function). + + Elements also emulate lists for child nodes (element nodes and/or text + nodes), indexing by integer. To get the first child node, use:: + + element[0] + + Elements may be constructed using the ``+=`` operator. To add one new + child node to element, do:: + + element += node + + This is equivalent to ``element.append(node)``. + + To add a list of multiple child nodes at once, use the same ``+=`` + operator:: + + element += [node1, node2] + + This is equivalent to ``element.extend([node1, node2])``. + """ + + list_attributes = ('ids', 'classes', 'names', 'dupnames', 'backrefs') + """List attributes, automatically initialized to empty lists for + all nodes.""" + + tagname = None + """The element generic identifier. If None, it is set as an instance + attribute to the name of the class.""" + + child_text_separator = '\n\n' + """Separator for child nodes, used by `astext()` method.""" + + def init(self, rawsource='', children, **attributes): + self.rawsource = rawsource + """The raw text from which this element was constructed.""" + + self.children = [] + """List of child nodes (elements and/or `Text`).""" + + self.extend(children) # maintain parent info + + self.attributes = {} + """Dictionary of attribute {name: value}.""" + + # Initialize list attributes. + for att in self.list_attributes: + self.attributes[att] = [] + + for att, value in attributes.items(): + att = att.lower() + if att in self.list_attributes: + # mutable list; make a copy for this node + self.attributes[att] = value[:] + else: + self.attributes[att] = value + + if self.tagname is None: + self.tagname = self.class.name + + def _dom_node(self, domroot): + element = domroot.createElement(self.tagname) + for attribute, value in self.attlist(): + if isinstance(value, ListType): + value = ' '.join([serial_escape('%s' % v) for v in value]) + element.setAttribute(attribute, '%s' % value) + for child in self.children: + element.appendChild(child._dom_node(domroot)) + return element + + def repr(self): + data = '' + for c in self.children: + data += c.shortrepr() + if len(data) > 60: + data = data[:56] + ' ...' + break + if self['names']: + return '<%s "%s": %s>' % (self.class.name, + '; '.join(self['names']), data) + else: + return '<%s: %s>' % (self.class.name, data) + + def shortrepr(self): + if self['names']: + return '<%s "%s"...>' % (self.class.name, + '; '.join(self['names'])) + else: + return '<%s...>' % self.tagname + + def unicode(self): + if self.children: + return u'%s%s%s' % (self.starttag(), + ''.join([unicode(c) for c in self.children]), + self.endtag()) + else: + return self.emptytag() + + def starttag(self): + parts = [self.tagname] + for name, value in self.attlist(): + if value is None: # boolean attribute + parts.append(name) + elif isinstance(value, ListType): + values = [serial_escape('%s' % v) for v in value] + parts.append('%s="%s"' % (name, ' '.join(values))) + else: + parts.append('%s="%s"' % (name, value)) + return '<%s>' % ' '.join(parts) + + def endtag(self): + return '' % self.tagname + + def emptytag(self): + return u'<%s/>' % ' '.join([self.tagname] + + ['%s="%s"' % (n, v) + for n, v in self.attlist()]) + + def len(self): + return len(self.children) + + def getitem(self, key): + if isinstance(key, UnicodeType) or isinstance(key, StringType): + return self.attributes[key] + elif isinstance(key, IntType): + return self.children[key] + elif isinstance(key, SliceType): + assert key.step in (None, 1), 'cannot handle slice with stride' + return self.children[key.start:key.stop] + else: + raise TypeError, ('element index must be an integer, a slice, or ' + 'an attribute name string') + + def setitem(self, key, item): + if isinstance(key, UnicodeType) or isinstance(key, StringType): + self.attributes[str(key)] = item + elif isinstance(key, IntType): + self.setup_child(item) + self.children[key] = item + elif isinstance(key, SliceType): + assert key.step in (None, 1), 'cannot handle slice with stride' + for node in item: + self.setup_child(node) + self.children[key.start:key.stop] = item + else: + raise TypeError, ('element index must be an integer, a slice, or ' + 'an attribute name string') + + def delitem(self, key): + if isinstance(key, UnicodeType) or isinstance(key, StringType): + del self.attributes[key] + elif isinstance(key, IntType): + del self.children[key] + elif isinstance(key, SliceType): + assert key.step in (None, 1), 'cannot handle slice with stride' + del self.children[key.start:key.stop] + else: + raise TypeError, ('element index must be an integer, a simple ' + 'slice, or an attribute name string') + + def add(self, other): + return self.children + other + + def radd(self, other): + return other + self.children + + def iadd(self, other): + """Append a node or a list of nodes to `self.children`.""" + if isinstance(other, Node): + self.append(other) + elif other is not None: + self.extend(other) + return self + + def astext(self): + return self.child_text_separator.join( + [child.astext() for child in self.children]) + + def non_default_attributes(self): + atts = {} + for key, value in self.attributes.items(): + if self.is_not_default(key): + atts[key] = value + return atts + + def attlist(self): + attlist = self.non_default_attributes().items() + attlist.sort() + return attlist + + def get(self, key, failobj=None): + return self.attributes.get(key, failobj) + + def hasattr(self, attr): + return self.attributes.has_key(attr) + + def delattr(self, attr): + if self.attributes.has_key(attr): + del self.attributes[attr] + + def setdefault(self, key, failobj=None): + return self.attributes.setdefault(key, failobj) + + has_key = hasattr + + def append(self, item): + self.setup_child(item) + self.children.append(item) + + def extend(self, item): + for node in item: + self.append(node) + + def insert(self, index, item): + if isinstance(item, Node): + self.setup_child(item) + self.children.insert(index, item) + elif item is not None: + self[index:index] = item + + def pop(self, i=-1): + return self.children.pop(i) + + def remove(self, item): + self.children.remove(item) + + def index(self, item): + return self.children.index(item) + + def is_not_default(self, key): + if self[key] == [] and key in self.list_attributes: + return 0 + else: + return 1 + + def update_basic_atts(self, dict): + """ + Update basic attributes ('ids', 'names', 'classes', + 'dupnames', but not 'source') from node or dictionary `dict`. + """ + if isinstance(dict, Node): + dict = dict.attributes + for att in ('ids', 'classes', 'names', 'dupnames'): + for value in dict.get(att, []): + if not value in self[att]: + self[att].append(value) + + def clear(self): + self.children = [] + + def replace(self, old, new): + """Replace one child `Node` with another child or children.""" + index = self.index(old) + if isinstance(new, Node): + self.setup_child(new) + self[index] = new + elif new is not None: + self[index:index+1] = new + + def replace_self(self, new): + """ + Replace `self` node with `new`, where `new` is a node or a + list of nodes. + """ + update = new + if not isinstance(new, Node): + # `new` is a list; update first child. + try: + update = new[0] + except IndexError: + update = None + if isinstance(update, Element): + update.update_basic_atts(self) + else: + # `update` is a Text node or `new` is an empty list. + # Assert that we aren't losing any attributes. + for att in ('ids', 'names', 'classes', 'dupnames'): + assert not self[att], \ + 'Losing "%s" attribute: %s' % (att, self[att]) + self.parent.replace(self, new) + + def first_child_matching_class(self, childclass, start=0, end=sys.maxint): + """ + Return the index of the first child whose class exactly matches. + + Parameters: + + - `childclass`: A `Node` subclass to search for, or a tuple of `Node` + classes. If a tuple, any of the classes may match. + - `start`: Initial index to check. + - `end`: Initial index to not check. + """ + if not isinstance(childclass, TupleType): + childclass = (childclass,) + for index in range(start, min(len(self), end)): + for c in childclass: + if isinstance(self[index], c): + return index + return None + + def first_child_not_matching_class(self, childclass, start=0, + end=sys.maxint): + """ + Return the index of the first child whose class does not match. + + Parameters: + + - `childclass`: A `Node` subclass to skip, or a tuple of `Node` + classes. If a tuple, none of the classes may match. + - `start`: Initial index to check. + - `end`: Initial index to not check. + """ + if not isinstance(childclass, TupleType): + childclass = (childclass,) + for index in range(start, min(len(self), end)): + for c in childclass: + if isinstance(self.children[index], c): + break + else: + return index + return None + + def pformat(self, indent=' ', level=0): + return ''.join(['%s%s\n' % (indent * level, self.starttag())] + + [child.pformat(indent, level+1) + for child in self.children]) + + def copy(self): + return self.class(**self.attributes) + + def deepcopy(self): + copy = self.copy() + copy.extend([child.deepcopy() for child in self.children]) + return copy + + def set_class(self, name): + """Add a new class to the "classes" attribute.""" + warnings.warn('docutils.nodes.Element.set_class deprecated; ' + "append to Element['classes'] list attribute directly", + DeprecationWarning, stacklevel=2) + assert ' ' not in name + self['classes'].append(name.lower()) + + def note_referenced_by(self, name=None, id=None): + """Note that this Element has been referenced by its name + `name` or id `id`.""" + self.referenced = 1 + # Element.expect_referenced_by_* dictionaries map names or ids + # to nodes whose ``referenced`` attribute is set to true as + # soon as this node is referenced by the given name or id. + # Needed for target propagation. + by_name = getattr(self, 'expect_referenced_by_name', {}).get(name) + by_id = getattr(self, 'expect_referenced_by_id', {}).get(id) + if by_name: + assert name is not None + by_name.referenced = 1 + if by_id: + assert id is not None + by_id.referenced = 1 + + +class TextElement(Element): + + """ + An element which directly contains text. + + Its children are all `Text` or `Inline` subclass nodes. You can + check whether an element's context is inline simply by checking whether + its immediate parent is a `TextElement` instance (including subclasses). + This is handy for nodes like `image` that can appear both inline and as + standalone body elements. + + If passing children to `init()`, make sure to set `text` to + ``''`` or some other suitable value. + """ + + child_text_separator = '' + """Separator for child nodes, used by `astext()` method.""" + + def init(self, rawsource='', text='', *children, **attributes): + if text != '': + textnode = Text(text) + Element.init(self, rawsource, textnode, *children, + **attributes) + else: + Element.init(self, rawsource, *children, **attributes) + + +class FixedTextElement(TextElement): + + """An element which directly contains preformatted text.""" + + def init(self, rawsource='', text='', *children, **attributes): + TextElement.init(self, rawsource, text, *children, **attributes) + self.attributes['xml:space'] = 'preserve' + + +# ======== +# Mixins +# ======== + +class Resolvable: + + resolved = 0 + + +class BackLinkable: + + def add_backref(self, refid): + self['backrefs'].append(refid) + + +# ==================== +# Element Categories +# ==================== + +class Root: pass + +class Titular: pass + +class PreBibliographic: + """Category of Node which may occur before Bibliographic Nodes.""" + +class Bibliographic: pass + +class Decorative(PreBibliographic): pass + +class Structural: pass + +class Body: pass + +class General(Body): pass + +class Sequential(Body): + """List-like elements.""" + +class Admonition(Body): pass + +class Special(Body): + """Special internal body elements.""" + +class Invisible(PreBibliographic): + """Internal elements that don't appear in output.""" + +class Part: pass + +class Inline: pass + +class Referential(Resolvable): pass + + +class Targetable(Resolvable): + + referenced = 0 + + indirect_reference_name = None + """Holds the whitespace_normalized_name (contains mixed case) of a target. + Required for MoinMoin/reST compatibility.""" + + +class Labeled: + """Contains a `label` as its first element.""" + + +# ============== +# Root Element +# ============== + +class document(Root, Structural, Element): + + """ + The document root element. + + Do not instantiate this class directly; use + `docutils.utils.new_document()` instead. + """ + + def init(self, settings, reporter, *args, **kwargs): + Element.init(self, args, kwargs) + + self.current_source = None + """Path to or description of the input source being processed.""" + + self.current_line = None + """Line number (1-based) of `current_source`.""" + + self.settings = settings + """Runtime settings data record.""" + + self.reporter = reporter + """System message generator.""" + + self.indirect_targets = [] + """List of indirect target nodes.""" + + self.substitution_defs = {} + """Mapping of substitution names to substitution_definition nodes.""" + + self.substitution_names = {} + """Mapping of case-normalized substitution names to case-sensitive + names.""" + + self.refnames = {} + """Mapping of names to lists of referencing nodes.""" + + self.refids = {} + """Mapping of ids to lists of referencing nodes.""" + + self.nameids = {} + """Mapping of names to unique id's.""" + + self.nametypes = {} + """Mapping of names to hyperlink type (boolean: True => explicit, + False => implicit.""" + + self.ids = {} + """Mapping of ids to nodes.""" + + self.footnote_refs = {} + """Mapping of footnote labels to lists of footnote_reference nodes.""" + + self.citation_refs = {} + """Mapping of citation labels to lists of citation_reference nodes.""" + + self.autofootnotes = [] + """List of auto-numbered footnote nodes.""" + + self.autofootnote_refs = [] + """List of auto-numbered footnote_reference nodes.""" + + self.symbol_footnotes = [] + """List of symbol footnote nodes.""" + + self.symbol_footnote_refs = [] + """List of symbol footnote_reference nodes.""" + + self.footnotes = [] + """List of manually-numbered footnote nodes.""" + + self.citations = [] + """List of citation nodes.""" + + self.autofootnote_start = 1 + """Initial auto-numbered footnote number.""" + + self.symbol_footnote_start = 0 + """Initial symbol footnote symbol index.""" + + self.id_start = 1 + """Initial ID number.""" + + self.parse_messages = [] + """System messages generated while parsing.""" + + self.transform_messages = [] + """System messages generated while applying transforms.""" + + import docutils.transforms + self.transformer = docutils.transforms.Transformer(self) + """Storage for transforms to be applied to this document.""" + + self.decoration = None + """Document's `decoration` node.""" + + self.document = self + + def getstate(self): + """ + Return dict with unpicklable references removed. + """ + state = self.dict.copy() + state['reporter'] = None + state['transformer'] = None + return state + + def asdom(self, dom=None): + """Return a DOM representation of this document.""" + if dom is None: + import xml.dom.minidom as dom + domroot = dom.Document() + domroot.appendChild(self._dom_node(domroot)) + return domroot + + def set_id(self, node, msgnode=None): + for id in node['ids']: + if self.ids.has_key(id) and self.ids[id] is not node: + msg = self.reporter.severe('Duplicate ID: "%s".' % id) + if msgnode != None: + msgnode += msg + if not node['ids']: + for name in node['names']: + id = self.settings.id_prefix + make_id(name) + if id and not self.ids.has_key(id): + break + else: + id = '' + while not id or self.ids.has_key(id): + id = (self.settings.id_prefix + + self.settings.auto_id_prefix + str(self.id_start)) + self.id_start += 1 + node['ids'].append(id) + self.ids[id] = node + return id + + def set_name_id_map(self, node, id, msgnode=None, explicit=None): + """ + `self.nameids` maps names to IDs, while `self.nametypes` maps names to + booleans representing hyperlink type (True==explicit, + False==implicit). This method updates the mappings. + + The following state transition table shows how `self.nameids` ("ids") + and `self.nametypes` ("types") change with new input (a call to this + method), and what actions are performed ("implicit"-type system + messages are INFO/1, and "explicit"-type system messages are ERROR/3): + + ==== ===== ======== ======== ======= ==== ===== ===== + Old State Input Action New State Notes + ----------- -------- ----------------- ----------- ----- + ids types new type sys.msg. dupname ids types + ==== ===== ======== ======== ======= ==== ===== ===== + - - explicit - - new True + - - implicit - - new False + None False explicit - - new True + old False explicit implicit old new True + None True explicit explicit new None True + old True explicit explicit new,old None True [#]_ + None False implicit implicit new None False + old False implicit implicit new,old None False + None True implicit implicit new None True + old True implicit implicit new old True + ==== ===== ======== ======== ======= ==== ===== ===== + + .. [#] Do not clear the name-to-id map or invalidate the old target if + both old and new targets are external and refer to identical URIs. + The new target is invalidated regardless. + """ + for name in node['names']: + if self.nameids.has_key(name): + self.set_duplicate_name_id(node, id, name, msgnode, explicit) + else: + self.nameids[name] = id + self.nametypes[name] = explicit + + def set_duplicate_name_id(self, node, id, name, msgnode, explicit): + old_id = self.nameids[name] + old_explicit = self.nametypes[name] + self.nametypes[name] = old_explicit or explicit + if explicit: + if old_explicit: + level = 2 + if old_id is not None: + old_node = self.ids[old_id] + if node.has_key('refuri'): + refuri = node['refuri'] + if old_node['names'] \ + and old_node.has_key('refuri') \ + and old_node['refuri'] == refuri: + level = 1 # just inform if refuri's identical + if level > 1: + dupname(old_node, name) + self.nameids[name] = None + msg = self.reporter.system_message( + level, 'Duplicate explicit target name: "%s".' % name, + backrefs=[id], base_node=node) + if msgnode != None: + msgnode += msg + dupname(node, name) + else: + self.nameids[name] = id + if old_id is not None: + old_node = self.ids[old_id] + dupname(old_node, name) + else: + if old_id is not None and not old_explicit: + self.nameids[name] = None + old_node = self.ids[old_id] + dupname(old_node, name) + dupname(node, name) + if not explicit or (not old_explicit and old_id is not None): + msg = self.reporter.info( + 'Duplicate implicit target name: "%s".' % name, + backrefs=[id], base_node=node) + if msgnode != None: + msgnode += msg + + def has_name(self, name): + return self.nameids.has_key(name) + + # "note" here is an imperative verb: "take note of". + def note_implicit_target(self, target, msgnode=None): + id = self.set_id(target, msgnode) + self.set_name_id_map(target, id, msgnode, explicit=None) + + def note_explicit_target(self, target, msgnode=None): + id = self.set_id(target, msgnode) + self.set_name_id_map(target, id, msgnode, explicit=1) + + def note_refname(self, node): + self.refnames.setdefault(node['refname'], []).append(node) + + def note_refid(self, node): + self.refids.setdefault(node['refid'], []).append(node) + + def note_indirect_target(self, target): + self.indirect_targets.append(target) + if target['names']: + self.note_refname(target) + + def note_anonymous_target(self, target): + self.set_id(target) + + def note_autofootnote(self, footnote): + self.set_id(footnote) + self.autofootnotes.append(footnote) + + def note_autofootnote_ref(self, ref): + self.set_id(ref) + self.autofootnote_refs.append(ref) + + def note_symbol_footnote(self, footnote): + self.set_id(footnote) + self.symbol_footnotes.append(footnote) + + def note_symbol_footnote_ref(self, ref): + self.set_id(ref) + self.symbol_footnote_refs.append(ref) + + def note_footnote(self, footnote): + self.set_id(footnote) + self.footnotes.append(footnote) + + def note_footnote_ref(self, ref): + self.set_id(ref) + self.footnote_refs.setdefault(ref['refname'], []).append(ref) + self.note_refname(ref) + + def note_citation(self, citation): + self.citations.append(citation) + + def note_citation_ref(self, ref): + self.set_id(ref) + self.citation_refs.setdefault(ref['refname'], []).append(ref) + self.note_refname(ref) + + def note_substitution_def(self, subdef, def_name, msgnode=None): + name = whitespace_normalize_name(def_name) + if self.substitution_defs.has_key(name): + msg = self.reporter.error( + 'Duplicate substitution definition name: "%s".' % name, + base_node=subdef) + if msgnode != None: + msgnode += msg + oldnode = self.substitution_defs[name] + dupname(oldnode, name) + # keep only the last definition: + self.substitution_defs[name] = subdef + # case-insensitive mapping: + self.substitution_names[fully_normalize_name(name)] = name + + def note_substitution_ref(self, subref, refname): + subref['refname'] = whitespace_normalize_name(refname) + + def note_pending(self, pending, priority=None): + self.transformer.add_pending(pending, priority) + + def note_parse_message(self, message): + self.parse_messages.append(message) + + def note_transform_message(self, message): + self.transform_messages.append(message) + + def note_source(self, source, offset): + self.current_source = source + if offset is None: + self.current_line = offset + else: + self.current_line = offset + 1 + + def copy(self): + return self.class(self.settings, self.reporter, + self.attributes) + + def get_decoration(self): + if not self.decoration: + self.decoration = decoration() + index = self.first_child_not_matching_class(Titular) + if index is None: + self.append(self.decoration) + else: + self.insert(index, self.decoration) + return self.decoration + + +# ================ +# Title Elements +# ================ + +class title(Titular, PreBibliographic, TextElement): pass +class subtitle(Titular, PreBibliographic, TextElement): pass +class rubric(Titular, TextElement): pass + + +# ======================== +# Bibliographic Elements +# ======================== + +class docinfo(Bibliographic, Element): pass +class author(Bibliographic, TextElement): pass +class authors(Bibliographic, Element): pass +class organization(Bibliographic, TextElement): pass +class address(Bibliographic, FixedTextElement): pass +class contact(Bibliographic, TextElement): pass +class version(Bibliographic, TextElement): pass +class revision(Bibliographic, TextElement): pass +class status(Bibliographic, TextElement): pass +class date(Bibliographic, TextElement): pass +class copyright(Bibliographic, TextElement): pass + + +# ===================== +# Decorative Elements +# ===================== + +class decoration(Decorative, Element): + + def get_header(self): + if not len(self.children) or not isinstance(self.children[0], header): + self.insert(0, header()) + return self.children[0] + + def get_footer(self): + if not len(self.children) or not isinstance(self.children[-1], footer): + self.append(footer()) + return self.children[-1] + + +class header(Decorative, Element): pass +class footer(Decorative, Element): pass + + +# ===================== +# Structural Elements +# ===================== + +class section(Structural, Element): pass + + +class topic(Structural, Element): + + """ + Topics are terminal, "leaf" mini-sections, like block quotes with titles, + or textual figures. A topic is just like a section, except that it has no + subsections, and it doesn't have to conform to section placement rules. + + Topics are allowed wherever body elements (list, table, etc.) are allowed, + but only at the top level of a section or document. Topics cannot nest + inside topics, sidebars, or body elements; you can't have a topic inside a + table, list, block quote, etc. + """ + + +class sidebar(Structural, Element): + + """ + Sidebars are like miniature, parallel documents that occur inside other + documents, providing related or reference material. A sidebar is + typically offset by a border and "floats" to the side of the page; the + document's main text may flow around it. Sidebars can also be likened to + super-footnotes; their content is outside of the flow of the document's + main text. + + Sidebars are allowed wherever body elements (list, table, etc.) are + allowed, but only at the top level of a section or document. Sidebars + cannot nest inside sidebars, topics, or body elements; you can't have a + sidebar inside a table, list, block quote, etc. + """ + + +class transition(Structural, Element): pass + + +# =============== +# Body Elements +# =============== + +class paragraph(General, TextElement): pass +class compound(General, Element): pass +class container(General, Element): pass +class bullet_list(Sequential, Element): pass +class enumerated_list(Sequential, Element): pass +class list_item(Part, Element): pass +class definition_list(Sequential, Element): pass +class definition_list_item(Part, Element): pass +class term(Part, TextElement): pass +class classifier(Part, TextElement): pass +class definition(Part, Element): pass +class field_list(Sequential, Element): pass +class field(Part, Element): pass +class field_name(Part, TextElement): pass +class field_body(Part, Element): pass + + +class option(Part, Element): + + child_text_separator = '' + + +class option_argument(Part, TextElement): + + def astext(self): + return self.get('delimiter', ' ') + TextElement.astext(self) + + +class option_group(Part, Element): + + child_text_separator = ', ' + + +class option_list(Sequential, Element): pass + + +class option_list_item(Part, Element): + + child_text_separator = ' ' + + +class option_string(Part, TextElement): pass +class description(Part, Element): pass +class literal_block(General, FixedTextElement): pass +class doctest_block(General, FixedTextElement): pass +class line_block(General, Element): pass + + +class line(Part, TextElement): + + indent = None + + +class block_quote(General, Element): pass +class attribution(Part, TextElement): pass +class attention(Admonition, Element): pass +class caution(Admonition, Element): pass +class danger(Admonition, Element): pass +class error(Admonition, Element): pass +class important(Admonition, Element): pass +class note(Admonition, Element): pass +class tip(Admonition, Element): pass +class hint(Admonition, Element): pass +class warning(Admonition, Element): pass +class admonition(Admonition, Element): pass +class comment(Special, Invisible, FixedTextElement): pass +class substitution_definition(Special, Invisible, TextElement): pass +class target(Special, Invisible, Inline, TextElement, Targetable): pass +class footnote(General, BackLinkable, Element, Labeled, Targetable): pass +class citation(General, BackLinkable, Element, Labeled, Targetable): pass +class label(Part, TextElement): pass +class figure(General, Element): pass +class caption(Part, TextElement): pass +class legend(Part, Element): pass +class table(General, Element): pass +class tgroup(Part, Element): pass +class colspec(Part, Element): pass +class thead(Part, Element): pass +class tbody(Part, Element): pass +class row(Part, Element): pass +class entry(Part, Element): pass + + +class system_message(Special, BackLinkable, PreBibliographic, Element): + + """ + System message element. + + Do not instantiate this class directly; use + ``document.reporter.info/warning/error/severe()`` instead. + """ + + def init(self, message=None, children, **attributes): + if message: + p = paragraph('', message) + children = (p,) + children + try: + Element.init(self, '', *children, **attributes) + except: + print 'system_message: children=%r' % (children,) + raise + + def astext(self): + line = self.get('line', '') + return u'%s:%s: (%s/%s) %s' % (self['source'], line, self['type'], + self['level'], Element.astext(self)) + + +class pending(Special, Invisible, Element): + + """ + The "pending" element is used to encapsulate a pending operation: the + operation (transform), the point at which to apply it, and any data it + requires. Only the pending operation's location within the document is + stored in the public document tree (by the "pending" object itself); the + operation and its data are stored in the "pending" object's internal + instance attributes. + + For example, say you want a table of contents in your reStructuredText + document. The easiest way to specify where to put it is from within the + document, with a directive:: + + .. contents:: + + But the "contents" directive can't do its work until the entire document + has been parsed and possibly transformed to some extent. So the directive + code leaves a placeholder behind that will trigger the second phase of its + processing, something like this:: + + + internal attributes + + Use `document.note_pending()` so that the + `docutils.transforms.Transformer` stage of processing can run all pending + transforms. + """ + + def init(self, transform, details=None, + rawsource='', *children, **attributes): + Element.init(self, rawsource, *children, **attributes) + + self.transform = transform + """The `docutils.transforms.Transform` class implementing the pending + operation.""" + + self.details = details or {} + """Detail data (dictionary) required by the pending operation.""" + + def pformat(self, indent=' ', level=0): + internals = [ + '.. internal attributes:', + ' .transform: %s.%s' % (self.transform.module, + self.transform.name), + ' .details:'] + details = self.details.items() + details.sort() + for key, value in details: + if isinstance(value, Node): + internals.append('%7s%s:' % ('', key)) + internals.extend(['%9s%s' % ('', line) + for line in value.pformat().splitlines()]) + elif value and isinstance(value, ListType) \ + and isinstance(value[0], Node): + internals.append('%7s%s:' % ('', key)) + for v in value: + internals.extend(['%9s%s' % ('', line) + for line in v.pformat().splitlines()]) + else: + internals.append('%7s%s: %r' % ('', key, value)) + return (Element.pformat(self, indent, level) + + ''.join([(' %s%s\n' % (indent * level, line)) + for line in internals])) + + def copy(self): + return self.class(self.transform, self.details, self.rawsource, + **self.attributes) + + +class raw(Special, Inline, PreBibliographic, FixedTextElement): + + """ + Raw data that is to be passed untouched to the Writer. + """ + + pass + + +# ================= +# Inline Elements +# ================= + +class emphasis(Inline, TextElement): pass +class strong(Inline, TextElement): pass +class literal(Inline, TextElement): pass +class reference(General, Inline, Referential, TextElement): pass +class footnote_reference(Inline, Referential, TextElement): pass +class citation_reference(Inline, Referential, TextElement): pass +class substitution_reference(Inline, TextElement): pass +class title_reference(Inline, TextElement): pass +class abbreviation(Inline, TextElement): pass +class acronym(Inline, TextElement): pass +class superscript(Inline, TextElement): pass +class subscript(Inline, TextElement): pass + + +class image(General, Inline, Element): + + def astext(self): + return self.get('alt', '') + + +class inline(Inline, TextElement): pass +class problematic(Inline, TextElement): pass +class generated(Inline, TextElement): pass + + +# ======================================== +# Auxiliary Classes, Functions, and Data +# ======================================== + +node_class_names = """ + Text + abbreviation acronym address admonition attention attribution author + authors + block_quote bullet_list + caption caution citation citation_reference classifier colspec comment + compound contact container copyright + danger date decoration definition definition_list definition_list_item + description docinfo doctest_block document + emphasis entry enumerated_list error + field field_body field_list field_name figure footer + footnote footnote_reference + generated + header hint + image important inline + label legend line line_block list_item literal literal_block + note + option option_argument option_group option_list option_list_item + option_string organization + paragraph pending problematic + raw reference revision row rubric + section sidebar status strong subscript substitution_definition + substitution_reference subtitle superscript system_message + table target tbody term tgroup thead tip title title_reference topic + transition + version + warning""".split() +"""A list of names of all concrete Node subclasses.""" + + +class NodeVisitor: + + """ + "Visitor" pattern [GoF95]_ abstract superclass implementation for + document tree traversals. + + Each node class has corresponding methods, doing nothing by + default; override individual methods for specific and useful + behaviour. The `dispatch_visit()` method is called by + `Node.walk()` upon entering a node. `Node.walkabout()` also calls + the `dispatch_departure()` method before exiting a node. + + The dispatch methods call "``visit_`` + node class name" or + "``depart_`` + node class name", resp. + + This is a base class for visitors whose ``visit_...`` & ``depart_...`` + methods should be implemented for all node types encountered (such as + for `docutils.writers.Writer` subclasses). Unimplemented methods will + raise exceptions. + + For sparse traversals, where only certain node types are of interest, + subclass `SparseNodeVisitor` instead. When (mostly or entirely) uniform + processing is desired, subclass `GenericNodeVisitor`. + + .. [GoF95] Gamma, Helm, Johnson, Vlissides. Design Patterns: Elements of + Reusable Object-Oriented Software. Addison-Wesley, Reading, MA, USA, + 1995. + """ + + optional = () + """ + Tuple containing node class names (as strings). + + No exception will be raised if writers do not implement visit + or departure functions for these node classes. + + Used to ensure transitional compatibility with existing 3rd-party writers. + """ + + def init(self, document): + self.document = document + + def dispatch_visit(self, node): + """ + Call self."``visit_`` + node class name" with `node` as + parameter. If the ``visit_...`` method does not exist, call + self.unknown_visit. + """ + node_name = node.class.name + method = getattr(self, 'visit_' + node_name, self.unknown_visit) + self.document.reporter.debug( + 'docutils.nodes.NodeVisitor.dispatch_visit calling %s for %s' + % (method.name, node_name)) + return method(node) + + def dispatch_departure(self, node): + """ + Call self."``depart_`` + node class name" with `node` as + parameter. If the ``depart_...`` method does not exist, call + self.unknown_departure. + """ + node_name = node.class.name + method = getattr(self, 'depart_' + node_name, self.unknown_departure) + self.document.reporter.debug( + 'docutils.nodes.NodeVisitor.dispatch_departure calling %s for %s' + % (method.name, node_name)) + return method(node) + + def unknown_visit(self, node): + """ + Called when entering unknown `Node` types. + + Raise an exception unless overridden. + """ + if (node.document.settings.strict_visitor + or node.class.name not in self.optional): + raise NotImplementedError( + '%s visiting unknown node type: %s' + % (self.class, node.class.name)) + + def unknown_departure(self, node): + """ + Called before exiting unknown `Node` types. + + Raise exception unless overridden. + """ + if (node.document.settings.strict_visitor + or node.class.name not in self.optional): + raise NotImplementedError( + '%s departing unknown node type: %s' + % (self.class, node.class.name)) + + +class SparseNodeVisitor(NodeVisitor): + + """ + Base class for sparse traversals, where only certain node types are of + interest. When ``visit_...`` & ``depart_...`` methods should be + implemented for all node types (such as for `docutils.writers.Writer` + subclasses), subclass `NodeVisitor` instead. + """ + + +class GenericNodeVisitor(NodeVisitor): + + """ + Generic "Visitor" abstract superclass, for simple traversals. + + Unless overridden, each ``visit_...`` method calls `default_visit()`, and + each ``depart_...`` method (when using `Node.walkabout()`) calls + `default_departure()`. `default_visit()` (and `default_departure()`) must + be overridden in subclasses. + + Define fully generic visitors by overriding `default_visit()` (and + `default_departure()`) only. Define semi-generic visitors by overriding + individual ``visit_...()`` (and ``depart_...()``) methods also. + + `NodeVisitor.unknown_visit()` (`NodeVisitor.unknown_departure()`) should + be overridden for default behavior. + """ + + def default_visit(self, node): + """Override for generic, uniform traversals.""" + raise NotImplementedError + + def default_departure(self, node): + """Override for generic, uniform traversals.""" + raise NotImplementedError + +def _call_default_visit(self, node): + self.default_visit(node) + +def _call_default_departure(self, node): + self.default_departure(node) + +def _nop(self, node): + pass + +def _add_node_class_names(names): + """Save typing with dynamic assignments:""" + for _name in names: + setattr(GenericNodeVisitor, "visit_" + _name, _call_default_visit) + setattr(GenericNodeVisitor, "depart_" + _name, _call_default_departure) + setattr(SparseNodeVisitor, 'visit_' + _name, _nop) + setattr(SparseNodeVisitor, 'depart_' + _name, _nop) + +_add_node_class_names(node_class_names) + + +class TreeCopyVisitor(GenericNodeVisitor): + + """ + Make a complete copy of a tree or branch, including element attributes. + """ + + def init(self, document): + GenericNodeVisitor.init(self, document) + self.parent_stack = [] + self.parent = [] + + def get_tree_copy(self): + return self.parent[0] + + def default_visit(self, node): + """Copy the current node, and make it the new acting parent.""" + newnode = node.copy() + self.parent.append(newnode) + self.parent_stack.append(self.parent) + self.parent = newnode + + def default_departure(self, node): + """Restore the previous acting parent.""" + self.parent = self.parent_stack.pop() + + +class TreePruningException(Exception): + + """ + Base class for `NodeVisitor`-related tree pruning exceptions. + + Raise subclasses from within ``visit_...`` or ``depart_...`` methods + called from `Node.walk()` and `Node.walkabout()` tree traversals to prune + the tree traversed. + """ + + pass + + +class SkipChildren(TreePruningException): + + """ + Do not visit any children of the current node. The current node's + siblings and ``depart_...`` method are not affected. + """ + + pass + + +class SkipSiblings(TreePruningException): + + """ + Do not visit any more siblings (to the right) of the current node. The + current node's children and its ``depart_...`` method are not affected. + """ + + pass + + +class SkipNode(TreePruningException): + + """ + Do not visit the current node's children, and do not call the current + node's ``depart_...`` method. + """ + + pass + + +class SkipDeparture(TreePruningException): + + """ + Do not call the current node's ``depart_...`` method. The current node's + children and siblings are not affected. + """ + + pass + + +class NodeFound(TreePruningException): + + """ + Raise to indicate that the target of a search has been found. This + exception must be caught by the client; it is not caught by the traversal + code. + """ + + pass + + +class StopTraversal(TreePruningException): + + """ + Stop the traversal alltogether. The current node's ``depart_...`` method + is not affected. The parent nodes ``depart_...`` methods are also called + as usual. No other nodes are visited. This is an alternative to + NodeFound that does not cause exception handling to trickle up to the + caller. + """ + + pass + + +def make_id(string): + """ + Convert `string` into an identifier and return it. + + Docutils identifiers will conform to the regular expression + ``[a-z](-?[a-z0-9]+)``. For CSS compatibility, identifiers (the "class" + and "id" attributes) should have no underscores, colons, or periods. + Hyphens may be used. + + - The `HTML 4.01 spec`_ defines identifiers based on SGML tokens: + + ID and NAME tokens must begin with a letter ([A-Za-z]) and may be + followed by any number of letters, digits ([0-9]), hyphens ("-"), + underscores ("_"), colons (":"), and periods ("."). + + - However the `CSS1 spec`_ defines identifiers based on the "name" token, + a tighter interpretation ("flex" tokenizer notation; "latin1" and + "escape" 8-bit characters have been replaced with entities):: + + unicode \\[0-9a-f]{1,4} + latin1 [¡-ÿ] + escape {unicode}|\\[ -~¡-ÿ] + nmchar [-a-z0-9]|{latin1}|{escape} + name {nmchar}+ + + The CSS1 "nmchar" rule does not include underscores ("_"), colons (":"), + or periods ("."), therefore "class" and "id" attributes should not contain + these characters. They should be replaced with hyphens ("-"). Combined + with HTML's requirements (the first character must be a letter; no + "unicode", "latin1", or "escape" characters), this results in the + ``[a-z](-?[a-z0-9]+)`` pattern. + + .. _HTML 4.01 spec: http://www.w3.org/TR/html401 + .. _CSS1 spec: http://www.w3.org/TR/REC-CSS1 + """ + id = _non_id_chars.sub('-', ' '.join(string.lower().split())) + id = _non_id_at_ends.sub('', id) + return str(id) + +_non_id_chars = re.compile('[^a-z0-9]+') +_non_id_at_ends = re.compile('^[-0-9]+|-+$') + +def dupname(node, name): + node['dupnames'].append(name) + node['names'].remove(name) + # Assume that this method is referenced, even though it isn't; we + # don't want to throw unnecessary system_messages. + node.referenced = 1 + +def fully_normalize_name(name): + """Return a case- and whitespace-normalized name.""" + return ' '.join(name.lower().split()) + +def whitespace_normalize_name(name): + """Return a whitespace-normalized name.""" + return ' '.join(name.split()) + +def serial_escape(value): + """Escape string values that are elements of a list, for serialization.""" + return value.replace('\\', r'\\').replace(' ', r'\ ') + +# +# +# Local Variables: +# indent-tabs-mode: nil +# sentence-end-double-space: t +# fill-column: 78 +# End: diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/init.py --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/init.py Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,47 @@ +# $Id: init.py 4564 2006-05-21 20:44:42Z wiemann $ +# Author: David Goodger +# Copyright: This module has been placed in the public domain. + +""" +This package contains Docutils parser modules. +""" + +docformat = 'reStructuredText' + +from docutils import Component + + +class Parser(Component): + + component_type = 'parser' + config_section = 'parsers' + + def parse(self, inputstring, document): + """Override to parse `inputstring` into document tree `document`.""" + raise NotImplementedError('subclass must override this method') + + def setup_parse(self, inputstring, document): + """Initial parse setup. Call at start of `self.parse()`.""" + self.inputstring = inputstring + self.document = document + document.reporter.attach_observer(document.note_parse_message) + + def finish_parse(self): + """Finalize parse details. Call at end of `self.parse()`.""" + self.document.reporter.detach_observer( + self.document.note_parse_message) + + +_parser_aliases = { + 'restructuredtext': 'rst', + 'rest': 'rst', + 'restx': 'rst', + 'rtxt': 'rst',} + +def get_parser_class(parser_name): + """Return the Parser class from the `parser_name` module.""" + parser_name = parser_name.lower() + if _parser_aliases.has_key(parser_name): + parser_name = _parser_aliases[parser_name] + module = import(parser_name, globals(), locals()) + return module.Parser diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/null.py --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/null.py Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,20 @@ +# $Id: null.py 4564 2006-05-21 20:44:42Z wiemann $ +# Author: Martin Blais +# Copyright: This module has been placed in the public domain. + +"""A do-nothing parser.""" + +from docutils import parsers + + +class Parser(parsers.Parser): + + """A do-nothing parser.""" + + supported = ('null',) + + config_section = 'null parser' + config_section_dependencies = ('parsers',) + + def parse(self, inputstring, document): + pass diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/init.py --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/init.py Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,367 @@ +# $Id: init.py 4802 2006-11-12 18:02:17Z goodger $ +# Author: David Goodger +# Copyright: This module has been placed in the public domain. + +""" +This is ``docutils.parsers.rst`` package. It exports a single class, `Parser`, +the reStructuredText parser. + + +Usage +===== + +1. Create a parser:: + + parser = docutils.parsers.rst.Parser() + + Several optional arguments may be passed to modify the parser's behavior. + Please see `Customizing the Parser`_ below for details. + +2. Gather input (a multi-line string), by reading a file or the standard + input:: + + input = sys.stdin.read() + +3. Create a new empty `docutils.nodes.document` tree:: + + document = docutils.utils.new_document(source, settings) + + See `docutils.utils.new_document()` for parameter details. + +4. Run the parser, populating the document tree:: + + parser.parse(input, document) + + +Parser Overview +=============== + +The reStructuredText parser is implemented as a state machine, examining its +input one line at a time. To understand how the parser works, please first +become familiar with the `docutils.statemachine` module, then see the +`states` module. + + +Customizing the Parser +---------------------- + +Anything that isn't already customizable is that way simply because that type +of customizability hasn't been implemented yet. Patches welcome! + +When instantiating an object of the `Parser` class, two parameters may be +passed: ``rfc2822`` and ``inliner``. Pass ``rfc2822=1`` to enable an initial +RFC-2822 style header block, parsed as a "field_list" element (with "class" +attribute set to "rfc2822"). Currently this is the only body-level element +which is customizable without subclassing. (Tip: subclass `Parser` and change +its "state_classes" and "initial_state" attributes to refer to new classes. +Contact the author if you need more details.) + +The ``inliner`` parameter takes an instance of `states.Inliner` or a subclass. +It handles inline markup recognition. A common extension is the addition of +further implicit hyperlinks, like "RFC 2822". This can be done by subclassing +`states.Inliner`, adding a new method for the implicit markup, and adding a +``(pattern, method)`` pair to the "implicit_dispatch" attribute of the +subclass. See `states.Inliner.implicit_inline()` for details. Explicit +inline markup can be customized in a `states.Inliner` subclass via the +``patterns.initial`` and ``dispatch`` attributes (and new methods as +appropriate). +""" + +docformat = 'reStructuredText' + + +import docutils.parsers +import docutils.statemachine +from docutils.parsers.rst import states +from docutils import frontend, nodes + + +class Parser(docutils.parsers.Parser): + + """The reStructuredText parser.""" + + supported = ('restructuredtext', 'rst', 'rest', 'restx', 'rtxt', 'rstx') + """Aliases this parser supports.""" + + settings_spec = ( + 'reStructuredText Parser Options', + None, + (('Recognize and link to standalone PEP references (like "PEP 258").', + ['--pep-references'], + {'action': 'store_true', 'validator': frontend.validate_boolean}), + ('Base URL for PEP references ' + '(default "http://www.python.org/dev/peps/").', + ['--pep-base-url'], + {'metavar': '', 'default': 'http://www.python.org/dev/peps/', + 'validator': frontend.validate_url_trailing_slash}), + ('Template for PEP file part of URL. (default "pep-%04d")', + ['--pep-file-url-template'], + {'metavar': '', 'default': 'pep-%04d'}), + ('Recognize and link to standalone RFC references (like "RFC 822").', + ['--rfc-references'], + {'action': 'store_true', 'validator': frontend.validate_boolean}), + ('Base URL for RFC references (default "http://www.faqs.org/rfcs/").', + ['--rfc-base-url'], + {'metavar': '', 'default': 'http://www.faqs.org/rfcs/', + 'validator': frontend.validate_url_trailing_slash}), + ('Set number of spaces for tab expansion (default 8).', + ['--tab-width'], + {'metavar': '', 'type': 'int', 'default': 8, + 'validator': frontend.validate_nonnegative_int}), + ('Remove spaces before footnote references.', + ['--trim-footnote-reference-space'], + {'action': 'store_true', 'validator': frontend.validate_boolean}), + ('Leave spaces before footnote references.', + ['--leave-footnote-reference-space'], + {'action': 'store_false', 'dest': 'trim_footnote_reference_space'}), + ('Disable directives that insert the contents of external file ' + '("include" & "raw"); replaced with a "warning" system message.', + ['--no-file-insertion'], + {'action': 'store_false', 'default': 1, + 'dest': 'file_insertion_enabled', + 'validator': frontend.validate_boolean}), + ('Enable directives that insert the contents of external file ' + '("include" & "raw"). Enabled by default.', + ['--file-insertion-enabled'], + {'action': 'store_true'}), + ('Disable the "raw" directives; replaced with a "warning" ' + 'system message.', + ['--no-raw'], + {'action': 'store_false', 'default': 1, 'dest': 'raw_enabled', + 'validator': frontend.validate_boolean}), + ('Enable the "raw" directive. Enabled by default.', + ['--raw-enabled'], + {'action': 'store_true'}),)) + + config_section = 'restructuredtext parser' + config_section_dependencies = ('parsers',) + + def init(self, rfc2822=None, inliner=None): + if rfc2822: + self.initial_state = 'RFC2822Body' + else: + self.initial_state = 'Body' + self.state_classes = states.state_classes + self.inliner = inliner + + def parse(self, inputstring, document): + """Parse `inputstring` and populate `document`, a document tree.""" + self.setup_parse(inputstring, document) + self.statemachine = states.RSTStateMachine( + state_classes=self.state_classes, + initial_state=self.initial_state, + debug=document.reporter.debug_flag) + inputlines = docutils.statemachine.string2lines( + inputstring, tab_width=document.settings.tab_width, + convert_whitespace=1) + self.statemachine.run(inputlines, document, inliner=self.inliner) + self.finish_parse() + + +class DirectiveError(Exception): + + """ + Store a message and a system message level. + + To be thrown from inside directive code. + + Do not instantiate directly -- use `Directive.directive_error()` + instead! + """ + + def init(self, level, message): + """ + Initialize with message `message`. `level` is a system message level. + """ + Exception.init(self) + self.level = level + self.message = message + + +class Directive: + + """ + Base class for reStructuredText directives. + + The following attributes may be set by subclasses. They are + interpreted by the directive parser (which runs the directive + class): + + - `required_arguments`: The number of required arguments (default: + 0). + + - `optional_arguments`: The number of optional arguments (default: + 0). + + - `final_argument_whitespace`: A boolean, indicating if the final + argument may contain whitespace (default: False). + + - `option_spec`: A dictionary, mapping known option names to + conversion functions such as `int` or `float` (default: {}, no + options). Several conversion functions are defined in the + directives/init.py module. + + Option conversion functions take a single parameter, the option + argument (a string or ``None``), validate it and/or convert it + to the appropriate form. Conversion functions may raise + `ValueError` and `TypeError` exceptions. + + - `has_content`: A boolean; True if content is allowed. Client + code must handle the case where content is required but not + supplied (an empty content list will be supplied). + + Arguments are normally single whitespace-separated words. The + final argument may contain whitespace and/or newlines if + `final_argument_whitespace` is True. + + If the form of the arguments is more complex, specify only one + argument (either required or optional) and set + `final_argument_whitespace` to True; the client code must do any + context-sensitive parsing. + + When a directive implementation is being run, the directive class + is instantiated, and the `run()` method is executed. During + instantiation, the following instance variables are set: + + - ``name`` is the directive type or name (string). + + - ``arguments`` is the list of positional arguments (strings). + + - ``options`` is a dictionary mapping option names (strings) to + values (type depends on option conversion functions; see + `option_spec` above). + + - ``content`` is a list of strings, the directive content line by line. + + - ``lineno`` is the line number of the first line of the directive. + + - ``content_offset`` is the line offset of the first line of the content from + the beginning of the current input. Used when initiating a nested parse. + + - ``block_text`` is a string containing the entire directive. + + - ``state`` is the state which called the directive function. + + - ``state_machine`` is the state machine which controls the state which called + the directive function. + + Directive functions return a list of nodes which will be inserted + into the document tree at the point where the directive was + encountered. This can be an empty list if there is nothing to + insert. + + For ordinary directives, the list must contain body elements or + structural elements. Some directives are intended specifically + for substitution definitions, and must return a list of `Text` + nodes and/or inline elements (suitable for inline insertion, in + place of the substitution reference). Such directives must verify + substitution definition context, typically using code like this:: + + if not isinstance(state, states.SubstitutionDef): + error = state_machine.reporter.error( + 'Invalid context: the "%s" directive can only be used ' + 'within a substitution definition.' % (name), + nodes.literal_block(block_text, block_text), line=lineno) + return [error] + """ + + # There is a "Creating reStructuredText Directives" how-to at + # . If you + # update this docstring, please update the how-to as well. + + required_arguments = 0 + """Number of required directive arguments.""" + + optional_arguments = 0 + """Number of optional arguments after the required arguments.""" + + final_argument_whitespace = False + """May the final argument contain whitespace?""" + + option_spec = None + """Mapping of option names to validator functions.""" + + has_content = False + """May the directive have content?""" + + def init(self, name, arguments, options, content, lineno, + content_offset, block_text, state, state_machine): + self.name = name + self.arguments = arguments + self.options = options + self.content = content + self.lineno = lineno + self.content_offset = content_offset + self.block_text = block_text + self.state = state + self.state_machine = state_machine + + def run(self): + raise NotImplementedError('Must override run() is subclass.') + + # Directive errors: + + def directive_error(self, level, message): + """ + Return a DirectiveError suitable for being thrown as an exception. + + Call "raise self.directive_error(level, message)" from within + a directive implementation to return one single system message + at level `level`, which automatically gets the directive block + and the line number added. + + You'd often use self.error(message) instead, which will + generate an ERROR-level directive error. + """ + return DirectiveError(level, message) + + def debug(self, message): + return self.directive_error(0, message) + + def info(self, message): + return self.directive_error(1, message) + + def warning(self, message): + return self.directive_error(2, message) + + def error(self, message): + return self.directive_error(3, message) + + def severe(self, message): + return self.directive_error(4, message) + + # Convenience methods: + + def assert_has_content(self): + """ + Throw an ERROR-level DirectiveError if the directive doesn't + have contents. + """ + if not self.content: + raise self.error('Content block expected for the "%s" directive; ' + 'none found.' % self.name) + + +def convert_directive_function(directive_fn): + """ + Define & return a directive class generated from `directive_fn`. + + `directive_fn` uses the old-style, functional interface. + """ + + class FunctionalDirective(Directive): + + option_spec = getattr(directive_fn, 'options', None) + has_content = getattr(directive_fn, 'content', False) + _argument_spec = getattr(directive_fn, 'arguments', (0, 0, False)) + required_arguments, optional_arguments, final_argument_whitespace \ + = _argument_spec + + def run(self): + return directive_fn( + self.name, self.arguments, self.options, self.content, + self.lineno, self.content_offset, self.block_text, + self.state, self.state_machine) + + # Return new-style directive. + return FunctionalDirective diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/directives/init.py --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/directives/init.py Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,367 @@ +# $Id: init.py 4667 2006-07-12 21:40:56Z wiemann $ +# Author: David Goodger +# Copyright: This module has been placed in the public domain. + +""" +This package contains directive implementation modules. +""" + +docformat = 'reStructuredText' + +import re +import codecs +from docutils import nodes +from docutils.parsers.rst.languages import en as _fallback_language_module + + +_directive_registry = { + 'attention': ('admonitions', 'Attention'), + 'caution': ('admonitions', 'Caution'), + 'danger': ('admonitions', 'Danger'), + 'error': ('admonitions', 'Error'), + 'important': ('admonitions', 'Important'), + 'note': ('admonitions', 'Note'), + 'tip': ('admonitions', 'Tip'), + 'hint': ('admonitions', 'Hint'), + 'warning': ('admonitions', 'Warning'), + 'admonition': ('admonitions', 'Admonition'), + 'sidebar': ('body', 'Sidebar'), + 'topic': ('body', 'Topic'), + 'line-block': ('body', 'LineBlock'), + 'parsed-literal': ('body', 'ParsedLiteral'), + 'rubric': ('body', 'Rubric'), + 'epigraph': ('body', 'Epigraph'), + 'highlights': ('body', 'Highlights'), + 'pull-quote': ('body', 'PullQuote'), + 'compound': ('body', 'Compound'), + 'container': ('body', 'Container'), + #'questions': ('body', 'question_list'), + 'table': ('tables', 'RSTTable'), + 'csv-table': ('tables', 'CSVTable'), + 'list-table': ('tables', 'ListTable'), + 'image': ('images', 'Image'), + 'figure': ('images', 'Figure'), + 'contents': ('parts', 'Contents'), + 'sectnum': ('parts', 'Sectnum'), + 'header': ('parts', 'Header'), + 'footer': ('parts', 'Footer'), + #'footnotes': ('parts', 'footnotes'), + #'citations': ('parts', 'citations'), + 'target-notes': ('references', 'TargetNotes'), + 'meta': ('html', 'Meta'), + #'imagemap': ('html', 'imagemap'), + 'raw': ('misc', 'Raw'), + 'include': ('misc', 'Include'), + 'replace': ('misc', 'Replace'), + 'unicode': ('misc', 'Unicode'), + 'class': ('misc', 'Class'), + 'role': ('misc', 'Role'), + 'default-role': ('misc', 'DefaultRole'), + 'title': ('misc', 'Title'), + 'date': ('misc', 'Date'), + 'restructuredtext-test-directive': ('misc', 'TestDirective'),} +"""Mapping of directive name to (module name, class name). The +directive name is canonical & must be lowercase. Language-dependent +names are defined in the ``language`` subpackage.""" + +_directives = {} +"""Cache of imported directives.""" + +def directive(directive_name, language_module, document): + """ + Locate and return a directive function from its language-dependent name. + If not found in the current language, check English. Return None if the + named directive cannot be found. + """ + normname = directive_name.lower() + messages = [] + msg_text = [] + if _directives.has_key(normname): + return _directives[normname], messages + canonicalname = None + try: + canonicalname = language_module.directives[normname] + except AttributeError, error: + msg_text.append('Problem retrieving directive entry from language ' + 'module %r: %s.' % (language_module, error)) + except KeyError: + msg_text.append('No directive entry for "%s" in module "%s".' + % (directive_name, language_module.name)) + if not canonicalname: + try: + canonicalname = _fallback_language_module.directives[normname] + msg_text.append('Using English fallback for directive "%s".' + % directive_name) + except KeyError: + msg_text.append('Trying "%s" as canonical directive name.' + % directive_name) + # The canonical name should be an English name, but just in case: + canonicalname = normname + if msg_text: + message = document.reporter.info( + '\n'.join(msg_text), line=document.current_line) + messages.append(message) + try: + modulename, classname = _directive_registry[canonicalname] + except KeyError: + # Error handling done by caller. + return None, messages + try: + module = import(modulename, globals(), locals()) + except ImportError, detail: + messages.append(document.reporter.error( + 'Error importing directive module "%s" (directive "%s"):\n%s' + % (modulename, directive_name, detail), + line=document.current_line)) + return None, messages + try: + directive = getattr(module, classname) + _directives[normname] = directive + except AttributeError: + messages.append(document.reporter.error( + 'No directive class "%s" in module "%s" (directive "%s").' + % (classname, modulename, directive_name), + line=document.current_line)) + return None, messages + return directive, messages + +def register_directive(name, directive): + """ + Register a nonstandard application-defined directive function. + Language lookups are not needed for such functions. + """ + _directives[name] = directive + +def flag(argument): + """ + Check for a valid flag option (no argument) and return ``None``. + (Directive option conversion function.) + + Raise ``ValueError`` if an argument is found. + """ + if argument and argument.strip(): + raise ValueError('no argument is allowed; "%s" supplied' % argument) + else: + return None + +def unchanged_required(argument): + """ + Return the argument text, unchanged. + (Directive option conversion function.) + + Raise ``ValueError`` if no argument is found. + """ + if argument is None: + raise ValueError('argument required but none supplied') + else: + return argument # unchanged! + +def unchanged(argument): + """ + Return the argument text, unchanged. + (Directive option conversion function.) + + No argument implies empty string (""). + """ + if argument is None: + return u'' + else: + return argument # unchanged! + +def path(argument): + """ + Return the path argument unwrapped (with newlines removed). + (Directive option conversion function.) + + Raise ``ValueError`` if no argument is found. + """ + if argument is None: + raise ValueError('argument required but none supplied') + else: + path = ''.join([s.strip() for s in argument.splitlines()]) + return path + +def uri(argument): + """ + Return the URI argument with whitespace removed. + (Directive option conversion function.) + + Raise ``ValueError`` if no argument is found. + """ + if argument is None: + raise ValueError('argument required but none supplied') + else: + uri = ''.join(argument.split()) + return uri + +def nonnegative_int(argument): + """ + Check for a nonnegative integer argument; raise ``ValueError`` if not. + (Directive option conversion function.) + """ + value = int(argument) + if value < 0: + raise ValueError('negative value; must be positive or zero') + return value + +length_units = ['em', 'ex', 'px', 'in', 'cm', 'mm', 'pt', 'pc'] + +def get_measure(argument, units): + """ + Check for a positive argument of one of the units and return a + normalized string of the form "" (without space in + between). + + To be called from directive option conversion functions. + """ + match = re.match(r'^([0-9.]+) (%s)$' % '|'.join(units), argument) + try: + assert match is not None + float(match.group(1)) + except (AssertionError, ValueError): + raise ValueError( + 'not a positive measure of one of the following units:\n%s' + % ' '.join(['"%s"' % i for i in units])) + return match.group(1) + match.group(2) + +def length_or_unitless(argument): + return get_measure(argument, length_units + ['']) + +def length_or_percentage_or_unitless(argument): + return get_measure(argument, length_units + ['%', '']) + +def class_option(argument): + """ + Convert the argument into a list of ID-compatible strings and return it. + (Directive option conversion function.) + + Raise ``ValueError`` if no argument is found. + """ + if argument is None: + raise ValueError('argument required but none supplied') + names = argument.split() + class_names = [] + for name in names: + class_name = nodes.make_id(name) + if not class_name: + raise ValueError('cannot make "%s" into a class name' % name) + class_names.append(class_name) + return class_names + +unicode_pattern = re.compile( + r'(?:0x|x|\\x|U\+?|\\u)([0-9a-f]+)$|&#x([0-9a-f]+);$', re.IGNORECASE) + +def unicode_code(code): + r""" + Convert a Unicode character code to a Unicode character. + (Directive option conversion function.) + + Codes may be decimal numbers, hexadecimal numbers (prefixed by ``0x``, + ``x``, ``\x``, ``U+``, ``u``, or ``\u``; e.g. ``U+262E``), or XML-style + numeric character entities (e.g. ``☮``). Other text remains as-is. + + Raise ValueError for illegal Unicode code values. + """ + try: + if code.isdigit(): # decimal number + return unichr(int(code)) + else: + match = unicode_pattern.match(code) + if match: # hex number + value = match.group(1) or match.group(2) + return unichr(int(value, 16)) + else: # other text + return code + except OverflowError, detail: + raise ValueError('code too large (%s)' % detail) + +def single_char_or_unicode(argument): + """ + A single character is returned as-is. Unicode characters codes are + converted as in `unicode_code`. (Directive option conversion function.) + """ + char = unicode_code(argument) + if len(char) > 1: + raise ValueError('%r invalid; must be a single character or ' + 'a Unicode code' % char) + return char + +def single_char_or_whitespace_or_unicode(argument): + """ + As with `single_char_or_unicode`, but "tab" and "space" are also supported. + (Directive option conversion function.) + """ + if argument == 'tab': + char = '\t' + elif argument == 'space': + char = ' ' + else: + char = single_char_or_unicode(argument) + return char + +def positive_int(argument): + """ + Converts the argument into an integer. Raises ValueError for negative, + zero, or non-integer values. (Directive option conversion function.) + """ + value = int(argument) + if value < 1: + raise ValueError('negative or zero value; must be positive') + return value + +def positive_int_list(argument): + """ + Converts a space- or comma-separated list of values into a Python list + of integers. + (Directive option conversion function.) + + Raises ValueError for non-positive-integer values. + """ + if ',' in argument: + entries = argument.split(',') + else: + entries = argument.split() + return [positive_int(entry) for entry in entries] + +def encoding(argument): + """ + Verfies the encoding argument by lookup. + (Directive option conversion function.) + + Raises ValueError for unknown encodings. + """ + try: + codecs.lookup(argument) + except LookupError: + raise ValueError('unknown encoding: "%s"' % argument) + return argument + +def choice(argument, values): + """ + Directive option utility function, supplied to enable options whose + argument must be a member of a finite set of possible values (must be + lower case). A custom conversion function must be written to use it. For + example:: + + from docutils.parsers.rst import directives + + def yesno(argument): + return directives.choice(argument, ('yes', 'no')) + + Raise ``ValueError`` if no argument is found or if the argument's value is + not valid (not an entry in the supplied list). + """ + try: + value = argument.lower().strip() + except AttributeError: + raise ValueError('must supply an argument; choose from %s' + % format_values(values)) + if value in values: + return value + else: + raise ValueError('"%s" unknown; choose from %s' + % (argument, format_values(values))) + +def format_values(values): + return '%s, or "%s"' % (', '.join(['"%s"' % s for s in values[:-1]]), + values[-1]) diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/directives/admonitions.py --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/directives/admonitions.py Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,97 @@ +# $Id: admonitions.py 4667 2006-07-12 21:40:56Z wiemann $ +# Author: David Goodger +# Copyright: This module has been placed in the public domain. + +""" +Admonition directives. +""" + +docformat = 'reStructuredText' + + +from docutils.parsers.rst import Directive +from docutils.parsers.rst import states, directives +from docutils import nodes + + +class BaseAdmonition(Directive): + + required_arguments = 0 + optional_arguments = 0 + final_argument_whitespace = True + option_spec = {} + has_content = True + + node_class = None + """Subclasses must set this to the appropriate admonition node class.""" + + def run(self): + self.assert_has_content() + text = '\n'.join(self.content) + admonition_node = self.node_class(text) + if self.arguments: + title_text = self.arguments[0] + textnodes, messages = self.state.inline_text(title_text, + self.lineno) + admonition_node += nodes.title(title_text, '', textnodes) + admonition_node += messages + if self.options.has_key('class'): + classes = self.options['class'] + else: + classes = ['admonition-' + nodes.make_id(title_text)] + admonition_node['classes'] += classes + self.state.nested_parse(self.content, self.content_offset, + admonition_node) + return [admonition_node] + + +class Admonition(BaseAdmonition): + + required_arguments = 1 + option_spec = {'class': directives.class_option} + node_class = nodes.admonition + + +class Attention(BaseAdmonition): + + node_class = nodes.attention + + +class Caution(BaseAdmonition): + + node_class = nodes.caution + + +class Danger(BaseAdmonition): + + node_class = nodes.danger + + +class Error(BaseAdmonition): + + node_class = nodes.error + + +class Hint(BaseAdmonition): + + node_class = nodes.hint + + +class Important(BaseAdmonition): + + node_class = nodes.important + + +class Note(BaseAdmonition): + + node_class = nodes.note + + +class Tip(BaseAdmonition): + + node_class = nodes.tip + + +class Warning(BaseAdmonition): + + node_class = nodes.warning diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/directives/body.py --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/directives/body.py Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,192 @@ +# $Id: body.py 4667 2006-07-12 21:40:56Z wiemann $ +# Author: David Goodger +# Copyright: This module has been placed in the public domain. + +""" +Directives for additional body elements. + +See `docutils.parsers.rst.directives` for API details. +""" + +docformat = 'reStructuredText' + + +import sys +from docutils import nodes +from docutils.parsers.rst import Directive +from docutils.parsers.rst import directives +from docutils.parsers.rst.roles import set_classes + + +class BasePseudoSection(Directive): + + required_arguments = 1 + optional_arguments = 0 + final_argument_whitespace = True + option_spec = {'class': directives.class_option} + has_content = True + + node_class = None + """Node class to be used (must be set in subclasses).""" + + def run(self): + if not (self.state_machine.match_titles + or isinstance(self.state_machine.node, nodes.sidebar)): + raise self.error('The "%s" directive may not be used within ' + 'topics or body elements.' % self.name) + self.assert_has_content() + title_text = self.arguments[0] + textnodes, messages = self.state.inline_text(title_text, self.lineno) + titles = [nodes.title(title_text, '', textnodes)] + # Sidebar uses this code. + if self.options.has_key('subtitle'): + textnodes, more_messages = self.state.inline_text( + self.options['subtitle'], self.lineno) + titles.append(nodes.subtitle(self.options['subtitle'], '', + textnodes)) + messages.extend(more_messages) + text = '\n'.join(self.content) + node = self.node_class(text, (titles + messages)) + node['classes'] += self.options.get('class', []) + if text: + self.state.nested_parse(self.content, self.content_offset, node) + return [node] + + +class Topic(BasePseudoSection): + + node_class = nodes.topic + + +class Sidebar(BasePseudoSection): + + node_class = nodes.sidebar + + option_spec = BasePseudoSection.option_spec.copy() + option_spec['subtitle'] = directives.unchanged_required + + def run(self): + if isinstance(self.state_machine.node, nodes.sidebar): + raise self.error('The "%s" directive may not be used within a ' + 'sidebar element.' % self.name) + return BasePseudoSection.run(self) + + +class LineBlock(Directive): + + option_spec = {'class': directives.class_option} + has_content = True + + def run(self): + self.assert_has_content() + block = nodes.line_block(classes=self.options.get('class', [])) + node_list = [block] + for line_text in self.content: + text_nodes, messages = self.state.inline_text( + line_text.strip(), self.lineno + self.content_offset) + line = nodes.line(line_text, '', text_nodes) + if line_text.strip(): + line.indent = len(line_text) - len(line_text.lstrip()) + block += line + node_list.extend(messages) + self.content_offset += 1 + self.state.nest_line_block_lines(block) + return node_list + + +class ParsedLiteral(Directive): + + option_spec = {'class': directives.class_option} + has_content = True + + def run(self): + set_classes(self.options) + self.assert_has_content() + text = '\n'.join(self.content) + text_nodes, messages = self.state.inline_text(text, self.lineno) + node = nodes.literal_block(text, '', *text_nodes, **self.options) + node.line = self.content_offset + 1 + return [node] + messages + + +class Rubric(Directive): + + required_arguments = 1 + optional_arguments = 0 + final_argument_whitespace = True + option_spec = {'class': directives.class_option} + + def run(self): + set_classes(self.options) + rubric_text = self.arguments[0] + textnodes, messages = self.state.inline_text(rubric_text, self.lineno) + rubric = nodes.rubric(rubric_text, '', textnodes, self.options) + return [rubric] + messages + + +class BlockQuote(Directive): + + has_content = True + classes = [] + + def run(self): + self.assert_has_content() + elements = self.state.block_quote(self.content, self.content_offset) + for element in elements: + if isinstance(element, nodes.block_quote): + element['classes'] += self.classes + return elements + + +class Epigraph(BlockQuote): + + classes = ['epigraph'] + + +class Highlights(BlockQuote): + + classes = ['highlights'] + + +class PullQuote(BlockQuote): + + classes = ['pull-quote'] + + +class Compound(Directive): + + option_spec = {'class': directives.class_option} + has_content = True + + def run(self): + self.assert_has_content() + text = '\n'.join(self.content) + node = nodes.compound(text) + node['classes'] += self.options.get('class', []) + self.state.nested_parse(self.content, self.content_offset, node) + return [node] + + +class Container(Directive): + + required_arguments = 0 + optional_arguments = 1 + final_argument_whitespace = True + has_content = True + + def run(self): + self.assert_has_content() + text = '\n'.join(self.content) + try: + if self.arguments: + classes = directives.class_option(self.arguments[0]) + else: + classes = [] + except ValueError: + raise self.error( + 'Invalid class attribute value for "%s" directive: "%s".' + % (self.name, self.arguments[0])) + node = nodes.container(text) + node['classes'].extend(classes) + self.state.nested_parse(self.content, self.content_offset, node) + return [node] diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/directives/html.py --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/directives/html.py Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,88 @@ +# $Id: html.py 4667 2006-07-12 21:40:56Z wiemann $ +# Author: David Goodger +# Copyright: This module has been placed in the public domain. + +""" +Directives for typically HTML-specific constructs. +""" + +docformat = 'reStructuredText' + +import sys +from docutils import nodes, utils +from docutils.parsers.rst import Directive +from docutils.parsers.rst import states +from docutils.transforms import components + + +class MetaBody(states.SpecializedBody): + + class meta(nodes.Special, nodes.PreBibliographic, nodes.Element): + """HTML-specific "meta" element.""" + pass + + def field_marker(self, match, context, next_state): + """Meta element.""" + node, blank_finish = self.parsemeta(match) + self.parent += node + return [], next_state, [] + + def parsemeta(self, match): + name = self.parse_field_marker(match) + indented, indent, line_offset, blank_finish = \ + self.state_machine.get_first_known_indented(match.end()) + node = self.meta() + pending = nodes.pending(components.Filter, + {'component': 'writer', + 'format': 'html', + 'nodes': [node]}) + node['content'] = ' '.join(indented) + if not indented: + line = self.state_machine.line + msg = self.reporter.info( + 'No content for meta tag "%s".' % name, + nodes.literal_block(line, line), + line=self.state_machine.abs_line_number()) + return msg, blank_finish + tokens = name.split() + try: + attname, val = utils.extract_name_value(tokens[0])[0] + node[attname.lower()] = val + except utils.NameValueError: + node['name'] = tokens[0] + for token in tokens[1:]: + try: + attname, val = utils.extract_name_value(token)[0] + node[attname.lower()] = val + except utils.NameValueError, detail: + line = self.state_machine.line + msg = self.reporter.error( + 'Error parsing meta tag attribute "%s": %s.' + % (token, detail), nodes.literal_block(line, line), + line=self.state_machine.abs_line_number()) + return msg, blank_finish + self.document.note_pending(pending) + return pending, blank_finish + + +class Meta(Directive): + + has_content = True + + SMkwargs = {'state_classes': (MetaBody,)} + + def run(self): + self.assert_has_content() + node = nodes.Element() + new_line_offset, blank_finish = self.state.nested_list_parse( + self.content, self.content_offset, node, + initial_state='MetaBody', blank_finish=1, + state_machine_kwargs=self.SMkwargs) + if (new_line_offset - self.content_offset) != len(self.content): + # incomplete parse of block? + error = self.state_machine.reporter.error( + 'Invalid meta directive.', + nodes.literal_block(self.block_text, self.block_text), + line=self.lineno) + node += error + return node.children diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/directives/images.py --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/directives/images.py Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,160 @@ +# $Id: images.py 4667 2006-07-12 21:40:56Z wiemann $ +# Author: David Goodger +# Copyright: This module has been placed in the public domain. + +""" +Directives for figures and simple images. +""" + +docformat = 'reStructuredText' + + +import sys +from docutils import nodes, utils +from docutils.parsers.rst import Directive +from docutils.parsers.rst import directives, states +from docutils.nodes import fully_normalize_name, whitespace_normalize_name +from docutils.parsers.rst.roles import set_classes + +try: + import Image as PIL # PIL +except ImportError: + PIL = None + + +class Image(Directive): + + align_h_values = ('left', 'center', 'right') + align_v_values = ('top', 'middle', 'bottom') + align_values = align_v_values + align_h_values + + def align(argument): + # This is not callable as self.align. We cannot make it a + # staticmethod because we're saving an unbound method in + # option_spec below. + return directives.choice(argument, Image.align_values) + + required_arguments = 1 + optional_arguments = 0 + final_argument_whitespace = True + option_spec = {'alt': directives.unchanged, + 'height': directives.length_or_unitless, + 'width': directives.length_or_percentage_or_unitless, + 'scale': directives.nonnegative_int, + 'align': align, + 'target': directives.unchanged_required, + 'class': directives.class_option} + + def run(self): + if self.options.has_key('align'): + if isinstance(self.state, states.SubstitutionDef): + # Check for align_v_values. + if self.options['align'] not in self.align_v_values: + raise self.error( + 'Error in "%s" directive: "%s" is not a valid value ' + 'for the "align" option within a substitution ' + 'definition. Valid values for "align" are: "%s".' + % (self.name, self.options['align'], + '", "'.join(self.align_v_values))) + elif self.options['align'] not in self.align_h_values: + raise self.error( + 'Error in "%s" directive: "%s" is not a valid value for ' + 'the "align" option. Valid values for "align" are: "%s".' + % (self.name, self.options['align'], + '", "'.join(self.align_h_values))) + messages = [] + reference = directives.uri(self.arguments[0]) + self.options['uri'] = reference + reference_node = None + if self.options.has_key('target'): + block = states.escape2null( + self.options['target']).splitlines() + block = [line for line in block] + target_type, data = self.state.parse_target( + block, self.block_text, self.lineno) + if target_type == 'refuri': + reference_node = nodes.reference(refuri=data) + elif target_type == 'refname': + reference_node = nodes.reference( + refname=fully_normalize_name(data), + name=whitespace_normalize_name(data)) + reference_node.indirect_reference_name = data + self.state.document.note_refname(reference_node) + else: # malformed target + messages.append(data) # data is a system message + del self.options['target'] + set_classes(self.options) + image_node = nodes.image(self.block_text, self.options) + if reference_node: + reference_node += image_node + return messages + [reference_node] + else: + return messages + [image_node] + + +class Figure(Image): + + def align(argument): + return directives.choice(argument, Figure.align_h_values) + + def figwidth_value(argument): + if argument.lower() == 'image': + return 'image' + else: + return directives.nonnegative_int(argument) + + option_spec = Image.option_spec.copy() + option_spec['figwidth'] = figwidth_value + option_spec['figclass'] = directives.class_option + option_spec['align'] = align + has_content = True + + def run(self): + figwidth = self.options.get('figwidth') + if figwidth: + del self.options['figwidth'] + figclasses = self.options.get('figclass') + if figclasses: + del self.options['figclass'] + align = self.options.get('align') + if align: + del self.options['align'] + (image_node,) = Image.run(self) + if isinstance(image_node, nodes.system_message): + return [image_node] + figure_node = nodes.figure('', image_node) + if figwidth == 'image': + if PIL and self.state.document.settings.file_insertion_enabled: + # PIL doesn't like Unicode paths: + try: + i = PIL.open(str(image_node['uri'])) + except (IOError, UnicodeError): + pass + else: + self.state.document.settings.record_dependencies.add( + image_node['uri']) + figure_node['width'] = i.size[0] + elif figwidth is not None: + figure_node['width'] = figwidth + if figclasses: + figure_node['classes'] += figclasses + if align: + figure_node['align'] = align + if self.content: + node = nodes.Element() # anonymous container for parsing + self.state.nested_parse(self.content, self.content_offset, node) + first_node = node[0] + if isinstance(first_node, nodes.paragraph): + caption = nodes.caption(first_node.rawsource, '', + first_node.children) + figure_node += caption + elif not (isinstance(first_node, nodes.comment) + and len(first_node) == 0): + error = self.state_machine.reporter.error( + 'Figure caption must be a paragraph or empty comment.', + nodes.literal_block(self.block_text, self.block_text), + line=self.lineno) + return [figure_node, error] + if len(node) > 1: + figure_node += nodes.legend('', node[1:]) + return [figure_node] diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/directives/misc.py --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/directives/misc.py Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,462 @@ +# $Id: misc.py 5015 2007-03-12 20:25:40Z wiemann $ +# Authors: David Goodger ; Dethe Elza +# Copyright: This module has been placed in the public domain. + +"""Miscellaneous directives.""" + +docformat = 'reStructuredText' + +import sys +import os.path +import re +import time +from docutils import io, nodes, statemachine, utils +from docutils.parsers.rst import Directive, convert_directive_function +from docutils.parsers.rst import directives, roles, states +from docutils.transforms import misc + + +class Include(Directive): + + """ + Include content read from a separate source file. + + Content may be parsed by the parser, or included as a literal + block. The encoding of the included file can be specified. Only + a part of the given file argument may be included by specifying + text to match before and/or after the text to be used. + """ + + required_arguments = 1 + optional_arguments = 0 + final_argument_whitespace = True + option_spec = {'literal': directives.flag, + 'encoding': directives.encoding, + 'start-after': directives.unchanged_required, + 'end-before': directives.unchanged_required} + + standard_include_path = os.path.join(os.path.dirname(states.file), + 'include') + + def run(self): + """Include a reST file as part of the content of this reST file.""" + if not self.state.document.settings.file_insertion_enabled: + raise self.warning('"%s" directive disabled.' % self.name) + source = self.state_machine.input_lines.source( + self.lineno - self.state_machine.input_offset - 1) + source_dir = os.path.dirname(os.path.abspath(source)) + path = directives.path(self.arguments[0]) + if path.startswith('<') and path.endswith('>'): + path = os.path.join(self.standard_include_path, path[1:-1]) + path = os.path.normpath(os.path.join(source_dir, path)) + path = utils.relative_path(None, path) + encoding = self.options.get( + 'encoding', self.state.document.settings.input_encoding) + try: + self.state.document.settings.record_dependencies.add(path) + include_file = io.FileInput( + source_path=path, encoding=encoding, + error_handler=(self.state.document.settings.\ + input_encoding_error_handler), + handle_io_errors=None) + except IOError, error: + raise self.severe('Problems with "%s" directive path:\n%s: %s.' + % (self.name, error.class.name, error)) + try: + include_text = include_file.read() + except UnicodeError, error: + raise self.severe( + 'Problem with "%s" directive:\n%s: %s' + % (self.name, error.class.name, error)) + # start-after/end-before: no restrictions on newlines in match-text, + # and no restrictions on matching inside lines vs. line boundaries + after_text = self.options.get('start-after', None) + if after_text: + # skip content in include_text before and incl.* a matching text + after_index = include_text.find(after_text) + if after_index < 0: + raise self.severe('Problem with "start-after" option of "%s" ' + 'directive:\nText not found.' % self.name) + include_text = include_text[after_index + len(after_text):] + before_text = self.options.get('end-before', None) + if before_text: + # skip content in include_text after and incl. a matching text + before_index = include_text.find(before_text) + if before_index < 0: + raise self.severe('Problem with "end-before" option of "%s" ' + 'directive:\nText not found.' % self.name) + include_text = include_text[:before_index] + if self.options.has_key('literal'): + literal_block = nodes.literal_block(include_text, include_text, + source=path) + literal_block.line = 1 + return [literal_block] + else: + include_lines = statemachine.string2lines(include_text, + convert_whitespace=1) + self.state_machine.insert_input(include_lines, path) + return [] + + +class Raw(Directive): + + """ + Pass through content unchanged + + Content is included in output based on type argument + + Content may be included inline (content section of directive) or + imported from a file or url. + """ + + required_arguments = 1 + optional_arguments = 0 + final_argument_whitespace = True + option_spec = {'file': directives.path, + 'url': directives.uri, + 'encoding': directives.encoding} + has_content = True + + def run(self): + if (not self.state.document.settings.raw_enabled + or (not self.state.document.settings.file_insertion_enabled + and (self.options.has_key('file') + or self.options.has_key('url')))): + raise self.warning('"%s" directive disabled.' % self.name) + attributes = {'format': ' '.join(self.arguments[0].lower().split())} + encoding = self.options.get( + 'encoding', self.state.document.settings.input_encoding) + if self.content: + if self.options.has_key('file') or self.options.has_key('url'): + raise self.error( + '"%s" directive may not both specify an external file ' + 'and have content.' % self.name) + text = '\n'.join(self.content) + elif self.options.has_key('file'): + if self.options.has_key('url'): + raise self.error( + 'The "file" and "url" options may not be simultaneously ' + 'specified for the "%s" directive.' % self.name) + source_dir = os.path.dirname( + os.path.abspath(self.state.document.current_source)) + path = os.path.normpath(os.path.join(source_dir, + self.options['file'])) + path = utils.relative_path(None, path) + try: + self.state.document.settings.record_dependencies.add(path) + raw_file = io.FileInput( + source_path=path, encoding=encoding, + error_handler=(self.state.document.settings.\ + input_encoding_error_handler), + handle_io_errors=None) + except IOError, error: + raise self.severe('Problems with "%s" directive path:\n%s.' + % (self.name, error)) + try: + text = raw_file.read() + except UnicodeError, error: + raise self.severe( + 'Problem with "%s" directive:\n%s: %s' + % (self.name, error.class.name, error)) + attributes['source'] = path + elif self.options.has_key('url'): + source = self.options['url'] + # Do not import urllib2 at the top of the module because + # it may fail due to broken SSL dependencies, and it takes + # about 0.15 seconds to load. + import urllib2 + try: + raw_text = urllib2.urlopen(source).read() + except (urllib2.URLError, IOError, OSError), error: + raise self.severe( + 'Problems with "%s" directive URL "%s":\n%s.' + % (self.name, self.options['url'], error)) + raw_file = io.StringInput( + source=raw_text, source_path=source, encoding=encoding, + error_handler=(self.state.document.settings.\ + input_encoding_error_handler)) + try: + text = raw_file.read() + except UnicodeError, error: + raise self.severe( + 'Problem with "%s" directive:\n%s: %s' + % (self.name, error.class.name, error)) + attributes['source'] = source + else: + # This will always fail because there is no content. + self.assert_has_content() + raw_node = nodes.raw('', text, **attributes) + return [raw_node] + + +class Replace(Directive): + + has_content = True + + def run(self): + if not isinstance(self.state, states.SubstitutionDef): + raise self.error( + 'Invalid context: the "%s" directive can only be used within ' + 'a substitution definition.' % self.name) + self.assert_has_content() + text = '\n'.join(self.content) + element = nodes.Element(text) + self.state.nested_parse(self.content, self.content_offset, + element) + if ( len(element) != 1 + or not isinstance(element[0], nodes.paragraph)): + messages = [] + for node in element: + if isinstance(node, nodes.system_message): + node['backrefs'] = [] + messages.append(node) + error = self.state_machine.reporter.error( + 'Error in "%s" directive: may contain a single paragraph ' + 'only.' % (self.name), line=self.lineno) + messages.append(error) + return messages + else: + return element[0].children + + +class Unicode(Directive): + + r""" + Convert Unicode character codes (numbers) to characters. Codes may be + decimal numbers, hexadecimal numbers (prefixed by ``0x``, ``x``, ``\x``, + ``U+``, ``u``, or ``\u``; e.g. ``U+262E``), or XML-style numeric character + entities (e.g. ``☮``). Text following ".." is a comment and is + ignored. Spaces are ignored, and any other text remains as-is. + """ + + required_arguments = 1 + optional_arguments = 0 + final_argument_whitespace = True + option_spec = {'trim': directives.flag, + 'ltrim': directives.flag, + 'rtrim': directives.flag} + + comment_pattern = re.compile(r'( |\n|^)\.\. ') + + def run(self): + if not isinstance(self.state, states.SubstitutionDef): + raise self.error( + 'Invalid context: the "%s" directive can only be used within ' + 'a substitution definition.' % self.name) + substitution_definition = self.state_machine.node + if self.options.has_key('trim'): + substitution_definition.attributes['ltrim'] = 1 + substitution_definition.attributes['rtrim'] = 1 + if self.options.has_key('ltrim'): + substitution_definition.attributes['ltrim'] = 1 + if self.options.has_key('rtrim'): + substitution_definition.attributes['rtrim'] = 1 + codes = self.comment_pattern.split(self.arguments[0])[0].split() + element = nodes.Element() + for code in codes: + try: + decoded = directives.unicode_code(code) + except ValueError, err: + raise self.error( + 'Invalid character code: %s\n%s: %s' + % (code, err.class.name, err)) + element += nodes.Text(decoded) + return element.children + + +class Class(Directive): + + """ + Set a "class" attribute on the directive content or the next element. + When applied to the next element, a "pending" element is inserted, and a + transform does the work later. + """ + + required_arguments = 1 + optional_arguments = 0 + final_argument_whitespace = True + has_content = True + + def run(self): + try: + class_value = directives.class_option(self.arguments[0]) + except ValueError: + raise self.error( + 'Invalid class attribute value for "%s" directive: "%s".' + % (self.name, self.arguments[0])) + node_list = [] + if self.content: + container = nodes.Element() + self.state.nested_parse(self.content, self.content_offset, + container) + for node in container: + node['classes'].extend(class_value) + node_list.extend(container.children) + else: + pending = nodes.pending( + misc.ClassAttribute, + {'class': class_value, 'directive': self.name}, + self.block_text) + self.state_machine.document.note_pending(pending) + node_list.append(pending) + return node_list + + +class Role(Directive): + + has_content = True + + argument_pattern = re.compile(r'(%s)\s($\s(%s)\s$\s)?$' + % ((states.Inliner.simplename,) * 2)) + + def run(self): + """Dynamically create and register a custom interpreted text role.""" + if self.content_offset > self.lineno or not self.content: + raise self.error('"%s" directive requires arguments on the first ' + 'line.' % self.name) + args = self.content[0] + match = self.argument_pattern.match(args) + if not match: + raise self.error('"%s" directive arguments not valid role names: ' + '"%s".' % (self.name, args)) + new_role_name = match.group(1) + base_role_name = match.group(3) + messages = [] + if base_role_name: + base_role, messages = roles.role( + base_role_name, self.state_machine.language, self.lineno, + self.state.reporter) + if base_role is None: + error = self.state.reporter.error( + 'Unknown interpreted text role "%s".' % base_role_name, + nodes.literal_block(self.block_text, self.block_text), + line=self.lineno) + return messages + [error] + else: + base_role = roles.generic_custom_role + assert not hasattr(base_role, 'arguments'), ( + 'Supplemental directive arguments for "%s" directive not ' + 'supported (specified by "%r" role).' % (self.name, base_role)) + try: + converted_role = convert_directive_function(base_role) + (arguments, options, content, content_offset) = ( + self.state.parse_directive_block( + self.content[1:], self.content_offset, converted_role, + option_presets={})) + except states.MarkupError, detail: + error = self.state_machine.reporter.error( + 'Error in "%s" directive:\n%s.' % (self.name, detail), + nodes.literal_block(self.block_text, self.block_text), + line=self.lineno) + return messages + [error] + if not options.has_key('class'): + try: + options['class'] = directives.class_option(new_role_name) + except ValueError, detail: + error = self.state_machine.reporter.error( + 'Invalid argument for "%s" directive:\n%s.' + % (self.name, detail), nodes.literal_block( + self.block_text, self.block_text), line=self.lineno) + return messages + [error] + role = roles.CustomRole(new_role_name, base_role, options, content) + roles.register_local_role(new_role_name, role) + return messages + + +class DefaultRole(Directive): + + """Set the default interpreted text role.""" + + required_arguments = 0 + optional_arguments = 1 + final_argument_whitespace = False + + def run(self): + if not self.arguments: + if roles._roles.has_key(''): + # restore the "default" default role + del roles._roles[''] + return [] + role_name = self.arguments[0] + role, messages = roles.role(role_name, self.state_machine.language, + self.lineno, self.state.reporter) + if role is None: + error = self.state.reporter.error( + 'Unknown interpreted text role "%s".' % role_name, + nodes.literal_block(self.block_text, self.block_text), + line=self.lineno) + return messages + [error] + roles._roles[''] = role + # @@@ should this be local to the document, not the parser? + return messages + + +class Title(Directive): + + required_arguments = 1 + optional_arguments = 0 + final_argument_whitespace = True + + def run(self): + self.state_machine.document['title'] = self.arguments[0] + return [] + + +class Date(Directive): + + has_content = True + + def run(self): + if not isinstance(self.state, states.SubstitutionDef): + raise self.error( + 'Invalid context: the "%s" directive can only be used within ' + 'a substitution definition.' % self.name) + format = '\n'.join(self.content) or '%Y-%m-%d' + text = time.strftime(format) + return [nodes.Text(text)] + + +class TestDirective(Directive): + + """This directive is useful only for testing purposes.""" + + required_arguments = 0 + optional_arguments = 1 + final_argument_whitespace = True + option_spec = {'option': directives.unchanged_required} + has_content = True + + def run(self): + if self.content: + text = '\n'.join(self.content) + info = self.state_machine.reporter.info( + 'Directive processed. Type="%s", arguments=%r, options=%r, ' + 'content:' % (self.name, self.arguments, self.options), + nodes.literal_block(text, text), line=self.lineno) + else: + info = self.state_machine.reporter.info( + 'Directive processed. Type="%s", arguments=%r, options=%r, ' + 'content: None' % (self.name, self.arguments, self.options), + line=self.lineno) + return [info] + +# Old-style, functional definition: +# +# def directive_test_function(name, arguments, options, content, lineno, +# content_offset, block_text, state, state_machine): +# """This directive is useful only for testing purposes.""" +# if content: +# text = '\n'.join(content) +# info = state_machine.reporter.info( +# 'Directive processed. Type="%s", arguments=%r, options=%r, ' +# 'content:' % (name, arguments, options), +# nodes.literal_block(text, text), line=lineno) +# else: +# info = state_machine.reporter.info( +# 'Directive processed. Type="%s", arguments=%r, options=%r, ' +# 'content: None' % (name, arguments, options), line=lineno) +# return [info] +# +# directive_test_function.arguments = (0, 1, 1) +# directive_test_function.options = {'option': directives.unchanged_required} +# directive_test_function.content = 1 diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/directives/parts.py --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/directives/parts.py Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,123 @@ +# $Id: parts.py 4667 2006-07-12 21:40:56Z wiemann $ +# Authors: David Goodger ; Dmitry Jemerov +# Copyright: This module has been placed in the public domain. + +""" +Directives for document parts. +""" + +docformat = 'reStructuredText' + +from docutils import nodes, languages +from docutils.transforms import parts +from docutils.parsers.rst import Directive +from docutils.parsers.rst import directives + + +class Contents(Directive): + + """ + Table of contents. + + The table of contents is generated in two passes: initial parse and + transform. During the initial parse, a 'pending' element is generated + which acts as a placeholder, storing the TOC title and any options + internally. At a later stage in the processing, the 'pending' element is + replaced by a 'topic' element, a title and the table of contents proper. + """ + + backlinks_values = ('top', 'entry', 'none') + + def backlinks(arg): + value = directives.choice(arg, Contents.backlinks_values) + if value == 'none': + return None + else: + return value + + required_arguments = 0 + optional_arguments = 1 + final_argument_whitespace = True + option_spec = {'depth': directives.nonnegative_int, + 'local': directives.flag, + 'backlinks': backlinks, + 'class': directives.class_option} + + def run(self): + if not (self.state_machine.match_titles + or isinstance(self.state_machine.node, nodes.sidebar)): + raise self.error('The "%s" directive may not be used within ' + 'topics or body elements.' % self.name) + document = self.state_machine.document + language = languages.get_language(document.settings.language_code) + if self.arguments: + title_text = self.arguments[0] + text_nodes, messages = self.state.inline_text(title_text, + self.lineno) + title = nodes.title(title_text, '', text_nodes) + else: + messages = [] + if self.options.has_key('local'): + title = None + else: + title = nodes.title('', language.labels['contents']) + topic = nodes.topic(classes=['contents']) + topic['classes'] += self.options.get('class', []) + if self.options.has_key('local'): + topic['classes'].append('local') + if title: + name = title.astext() + topic += title + else: + name = language.labels['contents'] + name = nodes.fully_normalize_name(name) + if not document.has_name(name): + topic['names'].append(name) + document.note_implicit_target(topic) + pending = nodes.pending(parts.Contents, rawsource=self.block_text) + pending.details.update(self.options) + document.note_pending(pending) + topic += pending + return [topic] + messages + + +class Sectnum(Directive): + + """Automatic section numbering.""" + + option_spec = {'depth': int, + 'start': int, + 'prefix': directives.unchanged_required, + 'suffix': directives.unchanged_required} + + def run(self): + pending = nodes.pending(parts.SectNum) + pending.details.update(self.options) + self.state_machine.document.note_pending(pending) + return [pending] + + +class Header(Directive): + + """Contents of document header.""" + + has_content = True + + def run(self): + self.assert_has_content() + header = self.state_machine.document.get_decoration().get_header() + self.state.nested_parse(self.content, self.content_offset, header) + return [] + + +class Footer(Directive): + + """Contents of document footer.""" + + has_content = True + + def run(self): + self.assert_has_content() + footer = self.state_machine.document.get_decoration().get_footer() + self.state.nested_parse(self.content, self.content_offset, footer) + return [] diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/directives/references.py --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/directives/references.py Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,28 @@ +# $Id: references.py 4667 2006-07-12 21:40:56Z wiemann $ +# Authors: David Goodger ; Dmitry Jemerov +# Copyright: This module has been placed in the public domain. + +""" +Directives for references and targets. +""" + +docformat = 'reStructuredText' + +from docutils import nodes +from docutils.transforms import references +from docutils.parsers.rst import Directive +from docutils.parsers.rst import directives + + +class TargetNotes(Directive): + + """Target footnote generation.""" + + option_spec = {'class': directives.class_option} + + def run(self): + pending = nodes.pending(references.TargetNotes) + pending.details.update(self.options) + self.state_machine.document.note_pending(pending) + nodelist = [pending] + return nodelist diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/directives/tables.py --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/directives/tables.py Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,444 @@ +# $Id: tables.py 4667 2006-07-12 21:40:56Z wiemann $ +# Authors: David Goodger ; David Priest +# Copyright: This module has been placed in the public domain. + +""" +Directives for table elements. +""" + +docformat = 'reStructuredText' + + +import sys +import os.path +from docutils import io, nodes, statemachine, utils +from docutils.utils import SystemMessagePropagation +from docutils.parsers.rst import Directive +from docutils.parsers.rst import directives + +try: + import csv # new in Python 2.3 +except ImportError: + csv = None + + +class Table(Directive): + + """ + Generic table base class. + """ + + required_arguments = 0 + optional_arguments = 1 + final_argument_whitespace = True + option_spec = {'class': directives.class_option} + has_content = True + + def make_title(self): + if self.arguments: + title_text = self.arguments[0] + text_nodes, messages = self.state.inline_text(title_text, + self.lineno) + title = nodes.title(title_text, '', text_nodes) + else: + title = None + messages = [] + return title, messages + + def process_header_option(self): + source = self.state_machine.get_source(self.lineno - 1) + table_head = [] + max_header_cols = 0 + if self.options.has_key('header'): # separate table header in option + rows, max_header_cols = self.parse_csv_data_into_rows( + self.options['header'].split('\n'), self.HeaderDialect(), + source) + table_head.extend(rows) + return table_head, max_header_cols + + def check_table_dimensions(self, rows, header_rows, stub_columns): + if len(rows) < header_rows: + error = self.state_machine.reporter.error( + '%s header row(s) specified but only %s row(s) of data ' + 'supplied ("%s" directive).' + % (header_rows, len(rows), self.name), nodes.literal_block( + self.block_text, self.block_text), line=self.lineno) + raise SystemMessagePropagation(error) + if len(rows) == header_rows > 0: + error = self.state_machine.reporter.error( + 'Insufficient data supplied (%s row(s)); no data remaining ' + 'for table body, required by "%s" directive.' + % (len(rows), self.name), nodes.literal_block( + self.block_text, self.block_text), line=self.lineno) + raise SystemMessagePropagation(error) + for row in rows: + if len(row) < stub_columns: + error = self.state_machine.reporter.error( + '%s stub column(s) specified but only %s columns(s) of ' + 'data supplied ("%s" directive).' % + (stub_columns, len(row), self.name), nodes.literal_block( + self.block_text, self.block_text), line=self.lineno) + raise SystemMessagePropagation(error) + if len(row) == stub_columns > 0: + error = self.state_machine.reporter.error( + 'Insufficient data supplied (%s columns(s)); no data remaining ' + 'for table body, required by "%s" directive.' + % (len(row), self.name), nodes.literal_block( + self.block_text, self.block_text), line=self.lineno) + raise SystemMessagePropagation(error) + + def get_column_widths(self, max_cols): + if self.options.has_key('widths'): + col_widths = self.options['widths'] + if len(col_widths) != max_cols: + error = self.state_machine.reporter.error( + '"%s" widths do not match the number of columns in table ' + '(%s).' % (self.name, max_cols), nodes.literal_block( + self.block_text, self.block_text), line=self.lineno) + raise SystemMessagePropagation(error) + elif max_cols: + col_widths = [100 // max_cols] * max_cols + else: + error = self.state_machine.reporter.error( + 'No table data detected in CSV file.', nodes.literal_block( + self.block_text, self.block_text), line=self.lineno) + raise SystemMessagePropagation(error) + return col_widths + + def extend_short_rows_with_empty_cells(self, columns, parts): + for part in parts: + for row in part: + if len(row) < columns: + row.extend([(0, 0, 0, [])] * (columns - len(row))) + + +class RSTTable(Table): + + def run(self): + if not self.content: + warning = self.state_machine.reporter.warning( + 'Content block expected for the "%s" directive; none found.' + % self.name, nodes.literal_block( + self.block_text, self.block_text), line=self.lineno) + return [warning] + title, messages = self.make_title() + node = nodes.Element() # anonymous container for parsing + self.state.nested_parse(self.content, self.content_offset, node) + if len(node) != 1 or not isinstance(node[0], nodes.table): + error = self.state_machine.reporter.error( + 'Error parsing content block for the "%s" directive: exactly ' + 'one table expected.' % self.name, nodes.literal_block( + self.block_text, self.block_text), line=self.lineno) + return [error] + table_node = node[0] + table_node['classes'] += self.options.get('class', []) + if title: + table_node.insert(0, title) + return [table_node] + messages + + +class CSVTable(Table): + + option_spec = {'header-rows': directives.nonnegative_int, + 'stub-columns': directives.nonnegative_int, + 'header': directives.unchanged, + 'widths': directives.positive_int_list, + 'file': directives.path, + 'url': directives.uri, + 'encoding': directives.encoding, + 'class': directives.class_option, + # field delimiter char + 'delim': directives.single_char_or_whitespace_or_unicode, + # treat whitespace after delimiter as significant + 'keepspace': directives.flag, + # text field quote/unquote char: + 'quote': directives.single_char_or_unicode, + # char used to escape delim & quote as-needed: + 'escape': directives.single_char_or_unicode,} + + if csv: + + class DocutilsDialect(csv.Dialect): + + """CSV dialect for `csv_table` directive.""" + + delimiter = ',' + quotechar = '"' + doublequote = True + skipinitialspace = True + lineterminator = '\n' + quoting = csv.QUOTE_MINIMAL + + def init(self, options): + if options.has_key('delim'): + self.delimiter = str(options['delim']) + if options.has_key('keepspace'): + self.skipinitialspace = False + if options.has_key('quote'): + self.quotechar = str(options['quote']) + if options.has_key('escape'): + self.doublequote = False + self.escapechar = str(options['escape']) + csv.Dialect.init(self) + + + class HeaderDialect(csv.Dialect): + + """CSV dialect to use for the "header" option data.""" + + delimiter = ',' + quotechar = '"' + escapechar = '\\' + doublequote = False + skipinitialspace = True + lineterminator = '\n' + quoting = csv.QUOTE_MINIMAL + + def check_requirements(self): + if not csv: + error = self.state_machine.reporter.error( + 'The "%s" directive is not compatible with this version of ' + 'Python (%s). Requires the "csv" module, new in Python 2.3.' + % (self.name, sys.version.split()[0]), nodes.literal_block( + self.block_text, self.block_text), line=self.lineno) + raise SystemMessagePropagation(error) + + def run(self): + try: + if (not self.state.document.settings.file_insertion_enabled + and (self.options.has_key('file') + or self.options.has_key('url'))): + warning = self.state_machine.reporter.warning( + 'File and URL access deactivated; ignoring "%s" ' + 'directive.' % self.name, nodes.literal_block( + self.block_text, self.block_text), line=self.lineno) + return [warning] + self.check_requirements() + title, messages = self.make_title() + csv_data, source = self.get_csv_data() + table_head, max_header_cols = self.process_header_option() + rows, max_cols = self.parse_csv_data_into_rows( + csv_data, self.DocutilsDialect(self.options), source) + max_cols = max(max_cols, max_header_cols) + header_rows = self.options.get('header-rows', 0) + stub_columns = self.options.get('stub-columns', 0) + self.check_table_dimensions(rows, header_rows, stub_columns) + table_head.extend(rows[:header_rows]) + table_body = rows[header_rows:] + col_widths = self.get_column_widths(max_cols) + self.extend_short_rows_with_empty_cells(max_cols, + (table_head, table_body)) + except SystemMessagePropagation, detail: + return [detail.args[0]] + except csv.Error, detail: + error = self.state_machine.reporter.error( + 'Error with CSV data in "%s" directive:\n%s' + % (self.name, detail), nodes.literal_block( + self.block_text, self.block_text), line=self.lineno) + return [error] + table = (col_widths, table_head, table_body) + table_node = self.state.build_table(table, self.content_offset, + stub_columns) + table_node['classes'] += self.options.get('class', []) + if title: + table_node.insert(0, title) + return [table_node] + messages + + def get_csv_data(self): + """ + Get CSV data from the directive content, from an external + file, or from a URL reference. + """ + encoding = self.options.get( + 'encoding', self.state.document.settings.input_encoding) + if self.content: + # CSV data is from directive content. + if self.options.has_key('file') or self.options.has_key('url'): + error = self.state_machine.reporter.error( + '"%s" directive may not both specify an external file and' + ' have content.' % self.name, nodes.literal_block( + self.block_text, self.block_text), line=self.lineno) + raise SystemMessagePropagation(error) + source = self.content.source(0) + csv_data = self.content + elif self.options.has_key('file'): + # CSV data is from an external file. + if self.options.has_key('url'): + error = self.state_machine.reporter.error( + 'The "file" and "url" options may not be simultaneously' + ' specified for the "%s" directive.' % self.name, + nodes.literal_block(self.block_text, self.block_text), + line=self.lineno) + raise SystemMessagePropagation(error) + source_dir = os.path.dirname( + os.path.abspath(self.state.document.current_source)) + source = os.path.normpath(os.path.join(source_dir, + self.options['file'])) + source = utils.relative_path(None, source) + try: + self.state.document.settings.record_dependencies.add(source) + csv_file = io.FileInput( + source_path=source, encoding=encoding, + error_handler=(self.state.document.settings.\ + input_encoding_error_handler), + handle_io_errors=None) + csv_data = csv_file.read().splitlines() + except IOError, error: + severe = self.state_machine.reporter.severe( + 'Problems with "%s" directive path:\n%s.' + % (self.name, error), nodes.literal_block( + self.block_text, self.block_text), line=self.lineno) + raise SystemMessagePropagation(severe) + elif self.options.has_key('url'): + # CSV data is from a URL. + # Do not import urllib2 at the top of the module because + # it may fail due to broken SSL dependencies, and it takes + # about 0.15 seconds to load. + import urllib2 + source = self.options['url'] + try: + csv_text = urllib2.urlopen(source).read() + except (urllib2.URLError, IOError, OSError, ValueError), error: + severe = self.state_machine.reporter.severe( + 'Problems with "%s" directive URL "%s":\n%s.' + % (self.name, self.options['url'], error), + nodes.literal_block(self.block_text, self.block_text), + line=self.lineno) + raise SystemMessagePropagation(severe) + csv_file = io.StringInput( + source=csv_text, source_path=source, encoding=encoding, + error_handler=(self.state.document.settings.\ + input_encoding_error_handler)) + csv_data = csv_file.read().splitlines() + else: + error = self.state_machine.reporter.warning( + 'The "%s" directive requires content; none supplied.' + % self.name, nodes.literal_block( + self.block_text, self.block_text), line=self.lineno) + raise SystemMessagePropagation(error) + return csv_data, source + + def parse_csv_data_into_rows(self, csv_data, dialect, source): + # csv.py doesn't do Unicode; encode temporarily as UTF-8 + csv_reader = csv.reader([(line.encode('utf-8') + '\n') + for line in csv_data], + dialect=dialect) + rows = [] + max_cols = 0 + for row in csv_reader: + row_data = [] + for cell in row: + # decode UTF-8 back to Unicode + cell_text = unicode(cell, 'utf-8') + cell_data = (0, 0, 0, statemachine.StringList( + cell_text.splitlines(), source=source)) + row_data.append(cell_data) + rows.append(row_data) + max_cols = max(max_cols, len(row)) + return rows, max_cols + + +class ListTable(Table): + + """ + Implement tables whose data is encoded as a uniform two-level bullet list. + For further ideas, see + http://docutils.sf.net/docs/dev/rst/alternatives.html#list-driven-tables + """ + + option_spec = {'header-rows': directives.nonnegative_int, + 'stub-columns': directives.nonnegative_int, + 'widths': directives.positive_int_list, + 'class': directives.class_option} + + def run(self): + if not self.content: + error = self.state_machine.reporter.error( + 'The "%s" directive is empty; content required.' % self.name, + nodes.literal_block(self.block_text, self.block_text), + line=self.lineno) + return [error] + title, messages = self.make_title() + node = nodes.Element() # anonymous container for parsing + self.state.nested_parse(self.content, self.content_offset, node) + try: + num_cols, col_widths = self.check_list_content(node) + table_data = [[item.children for item in row_list[0]] + for row_list in node[0]] + header_rows = self.options.get('header-rows', 0) + stub_columns = self.options.get('stub-columns', 0) + self.check_table_dimensions(table_data, header_rows, stub_columns) + except SystemMessagePropagation, detail: + return [detail.args[0]] + table_node = self.build_table_from_list(table_data, col_widths, + header_rows, stub_columns) + table_node['classes'] += self.options.get('class', []) + if title: + table_node.insert(0, title) + return [table_node] + messages + + def check_list_content(self, node): + if len(node) != 1 or not isinstance(node[0], nodes.bullet_list): + error = self.state_machine.reporter.error( + 'Error parsing content block for the "%s" directive: ' + 'exactly one bullet list expected.' % self.name, + nodes.literal_block(self.block_text, self.block_text), + line=self.lineno) + raise SystemMessagePropagation(error) + list_node = node[0] + # Check for a uniform two-level bullet list: + for item_index in range(len(list_node)): + item = list_node[item_index] + if len(item) != 1 or not isinstance(item[0], nodes.bullet_list): + error = self.state_machine.reporter.error( + 'Error parsing content block for the "%s" directive: ' + 'two-level bullet list expected, but row %s does not ' + 'contain a second-level bullet list.' + % (self.name, item_index + 1), nodes.literal_block( + self.block_text, self.block_text), line=self.lineno) + raise SystemMessagePropagation(error) + elif item_index: + # ATTN pychecker users: num_cols is guaranteed to be set in the + # "else" clause below for item_index==0, before this branch is + # triggered. + if len(item[0]) != num_cols: + error = self.state_machine.reporter.error( + 'Error parsing content block for the "%s" directive: ' + 'uniform two-level bullet list expected, but row %s ' + 'does not contain the same number of items as row 1 ' + '(%s vs %s).' + % (self.name, item_index + 1, len(item[0]), num_cols), + nodes.literal_block(self.block_text, self.block_text), + line=self.lineno) + raise SystemMessagePropagation(error) + else: + num_cols = len(item[0]) + col_widths = self.get_column_widths(num_cols) + return num_cols, col_widths + + def build_table_from_list(self, table_data, col_widths, header_rows, stub_columns): + table = nodes.table() + tgroup = nodes.tgroup(cols=len(col_widths)) + table += tgroup + for col_width in col_widths: + colspec = nodes.colspec(colwidth=col_width) + if stub_columns: + colspec.attributes['stub'] = 1 + stub_columns -= 1 + tgroup += colspec + rows = [] + for row in table_data: + row_node = nodes.row() + for cell in row: + entry = nodes.entry() + entry += cell + row_node += entry + rows.append(row_node) + if header_rows: + thead = nodes.thead() + thead.extend(rows[:header_rows]) + tgroup += thead + tbody = nodes.tbody() + tbody.extend(rows[header_rows:]) + tgroup += tbody + return table diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/README.txt --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/README.txt Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,17 @@ +============================================ + ``docutils/parsers/rst/include`` Directory +============================================ + +This directory contains standard data files intended for inclusion in +reStructuredText documents. To access these files, use the "include" +directive with the special syntax for standard "include" data files, +angle brackets around the file name:: + + .. include:: + +See the documentation for the `"include" directive` and +`reStructuredText Standard Substitution Definition Sets` for +details. + + http://docutils.sf.net/docs/ref/rst/directives.html#include + http://docutils.sf.net/docs/ref/rst/substitutions.html diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/isoamsa.txt --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/isoamsa.txt Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,162 @@ +.. This data file has been placed in the public domain. +.. Derived from the Unicode character mappings available from + . + Processed by unicode2rstsubs.py, part of Docutils: + . + +.. |angzarr| unicode:: U+0237C .. RIGHT ANGLE WITH DOWNWARDS ZIGZAG ARROW +.. |cirmid| unicode:: U+02AEF .. VERTICAL LINE WITH CIRCLE ABOVE +.. |cudarrl| unicode:: U+02938 .. RIGHT-SIDE ARC CLOCKWISE ARROW +.. |cudarrr| unicode:: U+02935 .. ARROW POINTING RIGHTWARDS THEN CURVING DOWNWARDS +.. |cularr| unicode:: U+021B6 .. ANTICLOCKWISE TOP SEMICIRCLE ARROW +.. |cularrp| unicode:: U+0293D .. TOP ARC ANTICLOCKWISE ARROW WITH PLUS +.. |curarr| unicode:: U+021B7 .. CLOCKWISE TOP SEMICIRCLE ARROW +.. |curarrm| unicode:: U+0293C .. TOP ARC CLOCKWISE ARROW WITH MINUS +.. |Darr| unicode:: U+021A1 .. DOWNWARDS TWO HEADED ARROW +.. |dArr| unicode:: U+021D3 .. DOWNWARDS DOUBLE ARROW +.. |darr2| unicode:: U+021CA .. DOWNWARDS PAIRED ARROWS +.. |ddarr| unicode:: U+021CA .. DOWNWARDS PAIRED ARROWS +.. |DDotrahd| unicode:: U+02911 .. RIGHTWARDS ARROW WITH DOTTED STEM +.. |dfisht| unicode:: U+0297F .. DOWN FISH TAIL +.. |dHar| unicode:: U+02965 .. DOWNWARDS HARPOON WITH BARB LEFT BESIDE DOWNWARDS HARPOON WITH BARB RIGHT +.. |dharl| unicode:: U+021C3 .. DOWNWARDS HARPOON WITH BARB LEFTWARDS +.. |dharr| unicode:: U+021C2 .. DOWNWARDS HARPOON WITH BARB RIGHTWARDS +.. |dlarr| unicode:: U+02199 .. SOUTH WEST ARROW +.. |drarr| unicode:: U+02198 .. SOUTH EAST ARROW +.. |duarr| unicode:: U+021F5 .. DOWNWARDS ARROW LEFTWARDS OF UPWARDS ARROW +.. |duhar| unicode:: U+0296F .. DOWNWARDS HARPOON WITH BARB LEFT BESIDE UPWARDS HARPOON WITH BARB RIGHT +.. |dzigrarr| unicode:: U+027FF .. LONG RIGHTWARDS SQUIGGLE ARROW +.. |erarr| unicode:: U+02971 .. EQUALS SIGN ABOVE RIGHTWARDS ARROW +.. |hArr| unicode:: U+021D4 .. LEFT RIGHT DOUBLE ARROW +.. |harr| unicode:: U+02194 .. LEFT RIGHT ARROW +.. |harrcir| unicode:: U+02948 .. LEFT RIGHT ARROW THROUGH SMALL CIRCLE +.. |harrw| unicode:: U+021AD .. LEFT RIGHT WAVE ARROW +.. |hoarr| unicode:: U+021FF .. LEFT RIGHT OPEN-HEADED ARROW +.. |imof| unicode:: U+022B7 .. IMAGE OF +.. |lAarr| unicode:: U+021DA .. LEFTWARDS TRIPLE ARROW +.. |Larr| unicode:: U+0219E .. LEFTWARDS TWO HEADED ARROW +.. |larr2| unicode:: U+021C7 .. LEFTWARDS PAIRED ARROWS +.. |larrbfs| unicode:: U+0291F .. LEFTWARDS ARROW FROM BAR TO BLACK DIAMOND +.. |larrfs| unicode:: U+0291D .. LEFTWARDS ARROW TO BLACK DIAMOND +.. |larrhk| unicode:: U+021A9 .. LEFTWARDS ARROW WITH HOOK +.. |larrlp| unicode:: U+021AB .. LEFTWARDS ARROW WITH LOOP +.. |larrpl| unicode:: U+02939 .. LEFT-SIDE ARC ANTICLOCKWISE ARROW +.. |larrsim| unicode:: U+02973 .. LEFTWARDS ARROW ABOVE TILDE OPERATOR +.. |larrtl| unicode:: U+021A2 .. LEFTWARDS ARROW WITH TAIL +.. |lAtail| unicode:: U+0291B .. LEFTWARDS DOUBLE ARROW-TAIL +.. |latail| unicode:: U+02919 .. LEFTWARDS ARROW-TAIL +.. |lBarr| unicode:: U+0290E .. LEFTWARDS TRIPLE DASH ARROW +.. |lbarr| unicode:: U+0290C .. LEFTWARDS DOUBLE DASH ARROW +.. |ldca| unicode:: U+02936 .. ARROW POINTING DOWNWARDS THEN CURVING LEFTWARDS +.. |ldrdhar| unicode:: U+02967 .. LEFTWARDS HARPOON WITH BARB DOWN ABOVE RIGHTWARDS HARPOON WITH BARB DOWN +.. |ldrushar| unicode:: U+0294B .. LEFT BARB DOWN RIGHT BARB UP HARPOON +.. |ldsh| unicode:: U+021B2 .. DOWNWARDS ARROW WITH TIP LEFTWARDS +.. |lfisht| unicode:: U+0297C .. LEFT FISH TAIL +.. |lHar| unicode:: U+02962 .. LEFTWARDS HARPOON WITH BARB UP ABOVE LEFTWARDS HARPOON WITH BARB DOWN +.. |lhard| unicode:: U+021BD .. LEFTWARDS HARPOON WITH BARB DOWNWARDS +.. |lharu| unicode:: U+021BC .. LEFTWARDS HARPOON WITH BARB UPWARDS +.. |lharul| unicode:: U+0296A .. LEFTWARDS HARPOON WITH BARB UP ABOVE LONG DASH +.. |llarr| unicode:: U+021C7 .. LEFTWARDS PAIRED ARROWS +.. |llhard| unicode:: U+0296B .. LEFTWARDS HARPOON WITH BARB DOWN BELOW LONG DASH +.. |loarr| unicode:: U+021FD .. LEFTWARDS OPEN-HEADED ARROW +.. |lrarr| unicode:: U+021C6 .. LEFTWARDS ARROW OVER RIGHTWARDS ARROW +.. |lrarr2| unicode:: U+021C6 .. LEFTWARDS ARROW OVER RIGHTWARDS ARROW +.. |lrhar| unicode:: U+021CB .. LEFTWARDS HARPOON OVER RIGHTWARDS HARPOON +.. |lrhar2| unicode:: U+021CB .. LEFTWARDS HARPOON OVER RIGHTWARDS HARPOON +.. |lrhard| unicode:: U+0296D .. RIGHTWARDS HARPOON WITH BARB DOWN BELOW LONG DASH +.. |lsh| unicode:: U+021B0 .. UPWARDS ARROW WITH TIP LEFTWARDS +.. |lurdshar| unicode:: U+0294A .. LEFT BARB UP RIGHT BARB DOWN HARPOON +.. |luruhar| unicode:: U+02966 .. LEFTWARDS HARPOON WITH BARB UP ABOVE RIGHTWARDS HARPOON WITH BARB UP +.. |Map| unicode:: U+02905 .. RIGHTWARDS TWO-HEADED ARROW FROM BAR +.. |map| unicode:: U+021A6 .. RIGHTWARDS ARROW FROM BAR +.. |midcir| unicode:: U+02AF0 .. VERTICAL LINE WITH CIRCLE BELOW +.. |mumap| unicode:: U+022B8 .. MULTIMAP +.. |nearhk| unicode:: U+02924 .. NORTH EAST ARROW WITH HOOK +.. |neArr| unicode:: U+021D7 .. NORTH EAST DOUBLE ARROW +.. |nearr| unicode:: U+02197 .. NORTH EAST ARROW +.. |nesear| unicode:: U+02928 .. NORTH EAST ARROW AND SOUTH EAST ARROW +.. |nhArr| unicode:: U+021CE .. LEFT RIGHT DOUBLE ARROW WITH STROKE +.. |nharr| unicode:: U+021AE .. LEFT RIGHT ARROW WITH STROKE +.. |nlArr| unicode:: U+021CD .. LEFTWARDS DOUBLE ARROW WITH STROKE +.. |nlarr| unicode:: U+0219A .. LEFTWARDS ARROW WITH STROKE +.. |nrArr| unicode:: U+021CF .. RIGHTWARDS DOUBLE ARROW WITH STROKE +.. |nrarr| unicode:: U+0219B .. RIGHTWARDS ARROW WITH STROKE +.. |nrarrc| unicode:: U+02933 U+00338 .. WAVE ARROW POINTING DIRECTLY RIGHT with slash +.. |nrarrw| unicode:: U+0219D U+00338 .. RIGHTWARDS WAVE ARROW with slash +.. |nvHarr| unicode:: U+02904 .. LEFT RIGHT DOUBLE ARROW WITH VERTICAL STROKE +.. |nvlArr| unicode:: U+02902 .. LEFTWARDS DOUBLE ARROW WITH VERTICAL STROKE +.. |nvrArr| unicode:: U+02903 .. RIGHTWARDS DOUBLE ARROW WITH VERTICAL STROKE +.. |nwarhk| unicode:: U+02923 .. NORTH WEST ARROW WITH HOOK +.. |nwArr| unicode:: U+021D6 .. NORTH WEST DOUBLE ARROW +.. |nwarr| unicode:: U+02196 .. NORTH WEST ARROW +.. |nwnear| unicode:: U+02927 .. NORTH WEST ARROW AND NORTH EAST ARROW +.. |olarr| unicode:: U+021BA .. ANTICLOCKWISE OPEN CIRCLE ARROW +.. |orarr| unicode:: U+021BB .. CLOCKWISE OPEN CIRCLE ARROW +.. |origof| unicode:: U+022B6 .. ORIGINAL OF +.. |rAarr| unicode:: U+021DB .. RIGHTWARDS TRIPLE ARROW +.. |Rarr| unicode:: U+021A0 .. RIGHTWARDS TWO HEADED ARROW +.. |rarr2| unicode:: U+021C9 .. RIGHTWARDS PAIRED ARROWS +.. |rarrap| unicode:: U+02975 .. RIGHTWARDS ARROW ABOVE ALMOST EQUAL TO +.. |rarrbfs| unicode:: U+02920 .. RIGHTWARDS ARROW FROM BAR TO BLACK DIAMOND +.. |rarrc| unicode:: U+02933 .. WAVE ARROW POINTING DIRECTLY RIGHT +.. |rarrfs| unicode:: U+0291E .. RIGHTWARDS ARROW TO BLACK DIAMOND +.. |rarrhk| unicode:: U+021AA .. RIGHTWARDS ARROW WITH HOOK +.. |rarrlp| unicode:: U+021AC .. RIGHTWARDS ARROW WITH LOOP +.. |rarrpl| unicode:: U+02945 .. RIGHTWARDS ARROW WITH PLUS BELOW +.. |rarrsim| unicode:: U+02974 .. RIGHTWARDS ARROW ABOVE TILDE OPERATOR +.. |Rarrtl| unicode:: U+02916 .. RIGHTWARDS TWO-HEADED ARROW WITH TAIL +.. |rarrtl| unicode:: U+021A3 .. RIGHTWARDS ARROW WITH TAIL +.. |rarrw| unicode:: U+0219D .. RIGHTWARDS WAVE ARROW +.. |rAtail| unicode:: U+0291C .. RIGHTWARDS DOUBLE ARROW-TAIL +.. |ratail| unicode:: U+0291A .. RIGHTWARDS ARROW-TAIL +.. |RBarr| unicode:: U+02910 .. RIGHTWARDS TWO-HEADED TRIPLE DASH ARROW +.. |rBarr| unicode:: U+0290F .. RIGHTWARDS TRIPLE DASH ARROW +.. |rbarr| unicode:: U+0290D .. RIGHTWARDS DOUBLE DASH ARROW +.. |rdca| unicode:: U+02937 .. ARROW POINTING DOWNWARDS THEN CURVING RIGHTWARDS +.. |rdldhar| unicode:: U+02969 .. RIGHTWARDS HARPOON WITH BARB DOWN ABOVE LEFTWARDS HARPOON WITH BARB DOWN +.. |rdsh| unicode:: U+021B3 .. DOWNWARDS ARROW WITH TIP RIGHTWARDS +.. |rfisht| unicode:: U+0297D .. RIGHT FISH TAIL +.. |rHar| unicode:: U+02964 .. RIGHTWARDS HARPOON WITH BARB UP ABOVE RIGHTWARDS HARPOON WITH BARB DOWN +.. |rhard| unicode:: U+021C1 .. RIGHTWARDS HARPOON WITH BARB DOWNWARDS +.. |rharu| unicode:: U+021C0 .. RIGHTWARDS HARPOON WITH BARB UPWARDS +.. |rharul| unicode:: U+0296C .. RIGHTWARDS HARPOON WITH BARB UP ABOVE LONG DASH +.. |rlarr| unicode:: U+021C4 .. RIGHTWARDS ARROW OVER LEFTWARDS ARROW +.. |rlarr2| unicode:: U+021C4 .. RIGHTWARDS ARROW OVER LEFTWARDS ARROW +.. |rlhar| unicode:: U+021CC .. RIGHTWARDS HARPOON OVER LEFTWARDS HARPOON +.. |rlhar2| unicode:: U+021CC .. RIGHTWARDS HARPOON OVER LEFTWARDS HARPOON +.. |roarr| unicode:: U+021FE .. RIGHTWARDS OPEN-HEADED ARROW +.. |rrarr| unicode:: U+021C9 .. RIGHTWARDS PAIRED ARROWS +.. |rsh| unicode:: U+021B1 .. UPWARDS ARROW WITH TIP RIGHTWARDS +.. |ruluhar| unicode:: U+02968 .. RIGHTWARDS HARPOON WITH BARB UP ABOVE LEFTWARDS HARPOON WITH BARB UP +.. |searhk| unicode:: U+02925 .. SOUTH EAST ARROW WITH HOOK +.. |seArr| unicode:: U+021D8 .. SOUTH EAST DOUBLE ARROW +.. |searr| unicode:: U+02198 .. SOUTH EAST ARROW +.. |seswar| unicode:: U+02929 .. SOUTH EAST ARROW AND SOUTH WEST ARROW +.. |simrarr| unicode:: U+02972 .. TILDE OPERATOR ABOVE RIGHTWARDS ARROW +.. |slarr| unicode:: U+02190 .. LEFTWARDS ARROW +.. |srarr| unicode:: U+02192 .. RIGHTWARDS ARROW +.. |swarhk| unicode:: U+02926 .. SOUTH WEST ARROW WITH HOOK +.. |swArr| unicode:: U+021D9 .. SOUTH WEST DOUBLE ARROW +.. |swarr| unicode:: U+02199 .. SOUTH WEST ARROW +.. |swnwar| unicode:: U+0292A .. SOUTH WEST ARROW AND NORTH WEST ARROW +.. |Uarr| unicode:: U+0219F .. UPWARDS TWO HEADED ARROW +.. |uArr| unicode:: U+021D1 .. UPWARDS DOUBLE ARROW +.. |uarr2| unicode:: U+021C8 .. UPWARDS PAIRED ARROWS +.. |Uarrocir| unicode:: U+02949 .. UPWARDS TWO-HEADED ARROW FROM SMALL CIRCLE +.. |udarr| unicode:: U+021C5 .. UPWARDS ARROW LEFTWARDS OF DOWNWARDS ARROW +.. |udhar| unicode:: U+0296E .. UPWARDS HARPOON WITH BARB LEFT BESIDE DOWNWARDS HARPOON WITH BARB RIGHT +.. |ufisht| unicode:: U+0297E .. UP FISH TAIL +.. |uHar| unicode:: U+02963 .. UPWARDS HARPOON WITH BARB LEFT BESIDE UPWARDS HARPOON WITH BARB RIGHT +.. |uharl| unicode:: U+021BF .. UPWARDS HARPOON WITH BARB LEFTWARDS +.. |uharr| unicode:: U+021BE .. UPWARDS HARPOON WITH BARB RIGHTWARDS +.. |uuarr| unicode:: U+021C8 .. UPWARDS PAIRED ARROWS +.. |vArr| unicode:: U+021D5 .. UP DOWN DOUBLE ARROW +.. |varr| unicode:: U+02195 .. UP DOWN ARROW +.. |xhArr| unicode:: U+027FA .. LONG LEFT RIGHT DOUBLE ARROW +.. |xharr| unicode:: U+027F7 .. LONG LEFT RIGHT ARROW +.. |xlArr| unicode:: U+027F8 .. LONG LEFTWARDS DOUBLE ARROW +.. |xlarr| unicode:: U+027F5 .. LONG LEFTWARDS ARROW +.. |xmap| unicode:: U+027FC .. LONG RIGHTWARDS ARROW FROM BAR +.. |xrArr| unicode:: U+027F9 .. LONG RIGHTWARDS DOUBLE ARROW +.. |xrarr| unicode:: U+027F6 .. LONG RIGHTWARDS ARROW +.. |zigrarr| unicode:: U+021DD .. RIGHTWARDS SQUIGGLE ARROW diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/isoamsb.txt --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/isoamsb.txt Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,126 @@ +.. This data file has been placed in the public domain. +.. Derived from the Unicode character mappings available from + . + Processed by unicode2rstsubs.py, part of Docutils: + . + +.. |ac| unicode:: U+0223E .. INVERTED LAZY S +.. |acE| unicode:: U+0223E U+00333 .. INVERTED LAZY S with double underline +.. |amalg| unicode:: U+02A3F .. AMALGAMATION OR COPRODUCT +.. |barvee| unicode:: U+022BD .. NOR +.. |Barwed| unicode:: U+02306 .. PERSPECTIVE +.. |barwed| unicode:: U+02305 .. PROJECTIVE +.. |bsolb| unicode:: U+029C5 .. SQUARED FALLING DIAGONAL SLASH +.. |Cap| unicode:: U+022D2 .. DOUBLE INTERSECTION +.. |capand| unicode:: U+02A44 .. INTERSECTION WITH LOGICAL AND +.. |capbrcup| unicode:: U+02A49 .. INTERSECTION ABOVE BAR ABOVE UNION +.. |capcap| unicode:: U+02A4B .. INTERSECTION BESIDE AND JOINED WITH INTERSECTION +.. |capcup| unicode:: U+02A47 .. INTERSECTION ABOVE UNION +.. |capdot| unicode:: U+02A40 .. INTERSECTION WITH DOT +.. |caps| unicode:: U+02229 U+0FE00 .. INTERSECTION with serifs +.. |ccaps| unicode:: U+02A4D .. CLOSED INTERSECTION WITH SERIFS +.. |ccups| unicode:: U+02A4C .. CLOSED UNION WITH SERIFS +.. |ccupssm| unicode:: U+02A50 .. CLOSED UNION WITH SERIFS AND SMASH PRODUCT +.. |coprod| unicode:: U+02210 .. N-ARY COPRODUCT +.. |Cup| unicode:: U+022D3 .. DOUBLE UNION +.. |cupbrcap| unicode:: U+02A48 .. UNION ABOVE BAR ABOVE INTERSECTION +.. |cupcap| unicode:: U+02A46 .. UNION ABOVE INTERSECTION +.. |cupcup| unicode:: U+02A4A .. UNION BESIDE AND JOINED WITH UNION +.. |cupdot| unicode:: U+0228D .. MULTISET MULTIPLICATION +.. |cupor| unicode:: U+02A45 .. UNION WITH LOGICAL OR +.. |cups| unicode:: U+0222A U+0FE00 .. UNION with serifs +.. |cuvee| unicode:: U+022CE .. CURLY LOGICAL OR +.. |cuwed| unicode:: U+022CF .. CURLY LOGICAL AND +.. |Dagger| unicode:: U+02021 .. DOUBLE DAGGER +.. |dagger| unicode:: U+02020 .. DAGGER +.. |diam| unicode:: U+022C4 .. DIAMOND OPERATOR +.. |divonx| unicode:: U+022C7 .. DIVISION TIMES +.. |eplus| unicode:: U+02A71 .. EQUALS SIGN ABOVE PLUS SIGN +.. |hercon| unicode:: U+022B9 .. HERMITIAN CONJUGATE MATRIX +.. |intcal| unicode:: U+022BA .. INTERCALATE +.. |iprod| unicode:: U+02A3C .. INTERIOR PRODUCT +.. |loplus| unicode:: U+02A2D .. PLUS SIGN IN LEFT HALF CIRCLE +.. |lotimes| unicode:: U+02A34 .. MULTIPLICATION SIGN IN LEFT HALF CIRCLE +.. |lthree| unicode:: U+022CB .. LEFT SEMIDIRECT PRODUCT +.. |ltimes| unicode:: U+022C9 .. LEFT NORMAL FACTOR SEMIDIRECT PRODUCT +.. |midast| unicode:: U+0002A .. ASTERISK +.. |minusb| unicode:: U+0229F .. SQUARED MINUS +.. |minusd| unicode:: U+02238 .. DOT MINUS +.. |minusdu| unicode:: U+02A2A .. MINUS SIGN WITH DOT BELOW +.. |ncap| unicode:: U+02A43 .. INTERSECTION WITH OVERBAR +.. |ncup| unicode:: U+02A42 .. UNION WITH OVERBAR +.. |oast| unicode:: U+0229B .. CIRCLED ASTERISK OPERATOR +.. |ocir| unicode:: U+0229A .. CIRCLED RING OPERATOR +.. |odash| unicode:: U+0229D .. CIRCLED DASH +.. |odiv| unicode:: U+02A38 .. CIRCLED DIVISION SIGN +.. |odot| unicode:: U+02299 .. CIRCLED DOT OPERATOR +.. |odsold| unicode:: U+029BC .. CIRCLED ANTICLOCKWISE-ROTATED DIVISION SIGN +.. |ofcir| unicode:: U+029BF .. CIRCLED BULLET +.. |ogt| unicode:: U+029C1 .. CIRCLED GREATER-THAN +.. |ohbar| unicode:: U+029B5 .. CIRCLE WITH HORIZONTAL BAR +.. |olcir| unicode:: U+029BE .. CIRCLED WHITE BULLET +.. |olt| unicode:: U+029C0 .. CIRCLED LESS-THAN +.. |omid| unicode:: U+029B6 .. CIRCLED VERTICAL BAR +.. |ominus| unicode:: U+02296 .. CIRCLED MINUS +.. |opar| unicode:: U+029B7 .. CIRCLED PARALLEL +.. |operp| unicode:: U+029B9 .. CIRCLED PERPENDICULAR +.. |oplus| unicode:: U+02295 .. CIRCLED PLUS +.. |osol| unicode:: U+02298 .. CIRCLED DIVISION SLASH +.. |Otimes| unicode:: U+02A37 .. MULTIPLICATION SIGN IN DOUBLE CIRCLE +.. |otimes| unicode:: U+02297 .. CIRCLED TIMES +.. |otimesas| unicode:: U+02A36 .. CIRCLED MULTIPLICATION SIGN WITH CIRCUMFLEX ACCENT +.. |ovbar| unicode:: U+0233D .. APL FUNCTIONAL SYMBOL CIRCLE STILE +.. |plusacir| unicode:: U+02A23 .. PLUS SIGN WITH CIRCUMFLEX ACCENT ABOVE +.. |plusb| unicode:: U+0229E .. SQUARED PLUS +.. |pluscir| unicode:: U+02A22 .. PLUS SIGN WITH SMALL CIRCLE ABOVE +.. |plusdo| unicode:: U+02214 .. DOT PLUS +.. |plusdu| unicode:: U+02A25 .. PLUS SIGN WITH DOT BELOW +.. |pluse| unicode:: U+02A72 .. PLUS SIGN ABOVE EQUALS SIGN +.. |plussim| unicode:: U+02A26 .. PLUS SIGN WITH TILDE BELOW +.. |plustwo| unicode:: U+02A27 .. PLUS SIGN WITH SUBSCRIPT TWO +.. |prod| unicode:: U+0220F .. N-ARY PRODUCT +.. |race| unicode:: U+029DA .. LEFT DOUBLE WIGGLY FENCE +.. |roplus| unicode:: U+02A2E .. PLUS SIGN IN RIGHT HALF CIRCLE +.. |rotimes| unicode:: U+02A35 .. MULTIPLICATION SIGN IN RIGHT HALF CIRCLE +.. |rthree| unicode:: U+022CC .. RIGHT SEMIDIRECT PRODUCT +.. |rtimes| unicode:: U+022CA .. RIGHT NORMAL FACTOR SEMIDIRECT PRODUCT +.. |sdot| unicode:: U+022C5 .. DOT OPERATOR +.. |sdotb| unicode:: U+022A1 .. SQUARED DOT OPERATOR +.. |setmn| unicode:: U+02216 .. SET MINUS +.. |simplus| unicode:: U+02A24 .. PLUS SIGN WITH TILDE ABOVE +.. |smashp| unicode:: U+02A33 .. SMASH PRODUCT +.. |solb| unicode:: U+029C4 .. SQUARED RISING DIAGONAL SLASH +.. |sqcap| unicode:: U+02293 .. SQUARE CAP +.. |sqcaps| unicode:: U+02293 U+0FE00 .. SQUARE CAP with serifs +.. |sqcup| unicode:: U+02294 .. SQUARE CUP +.. |sqcups| unicode:: U+02294 U+0FE00 .. SQUARE CUP with serifs +.. |ssetmn| unicode:: U+02216 .. SET MINUS +.. |sstarf| unicode:: U+022C6 .. STAR OPERATOR +.. |subdot| unicode:: U+02ABD .. SUBSET WITH DOT +.. |sum| unicode:: U+02211 .. N-ARY SUMMATION +.. |supdot| unicode:: U+02ABE .. SUPERSET WITH DOT +.. |timesb| unicode:: U+022A0 .. SQUARED TIMES +.. |timesbar| unicode:: U+02A31 .. MULTIPLICATION SIGN WITH UNDERBAR +.. |timesd| unicode:: U+02A30 .. MULTIPLICATION SIGN WITH DOT ABOVE +.. |top| unicode:: U+022A4 .. DOWN TACK +.. |tridot| unicode:: U+025EC .. WHITE UP-POINTING TRIANGLE WITH DOT +.. |triminus| unicode:: U+02A3A .. MINUS SIGN IN TRIANGLE +.. |triplus| unicode:: U+02A39 .. PLUS SIGN IN TRIANGLE +.. |trisb| unicode:: U+029CD .. TRIANGLE WITH SERIFS AT BOTTOM +.. |tritime| unicode:: U+02A3B .. MULTIPLICATION SIGN IN TRIANGLE +.. |uplus| unicode:: U+0228E .. MULTISET UNION +.. |veebar| unicode:: U+022BB .. XOR +.. |wedbar| unicode:: U+02A5F .. LOGICAL AND WITH UNDERBAR +.. |wreath| unicode:: U+02240 .. WREATH PRODUCT +.. |xcap| unicode:: U+022C2 .. N-ARY INTERSECTION +.. |xcirc| unicode:: U+025EF .. LARGE CIRCLE +.. |xcup| unicode:: U+022C3 .. N-ARY UNION +.. |xdtri| unicode:: U+025BD .. WHITE DOWN-POINTING TRIANGLE +.. |xodot| unicode:: U+02A00 .. N-ARY CIRCLED DOT OPERATOR +.. |xoplus| unicode:: U+02A01 .. N-ARY CIRCLED PLUS OPERATOR +.. |xotime| unicode:: U+02A02 .. N-ARY CIRCLED TIMES OPERATOR +.. |xsqcup| unicode:: U+02A06 .. N-ARY SQUARE UNION OPERATOR +.. |xuplus| unicode:: U+02A04 .. N-ARY UNION OPERATOR WITH PLUS +.. |xutri| unicode:: U+025B3 .. WHITE UP-POINTING TRIANGLE +.. |xvee| unicode:: U+022C1 .. N-ARY LOGICAL OR +.. |xwedge| unicode:: U+022C0 .. N-ARY LOGICAL AND diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/isoamsc.txt --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/isoamsc.txt Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,29 @@ +.. This data file has been placed in the public domain. +.. Derived from the Unicode character mappings available from + . + Processed by unicode2rstsubs.py, part of Docutils: + . + +.. |dlcorn| unicode:: U+0231E .. BOTTOM LEFT CORNER +.. |drcorn| unicode:: U+0231F .. BOTTOM RIGHT CORNER +.. |gtlPar| unicode:: U+02995 .. DOUBLE LEFT ARC GREATER-THAN BRACKET +.. |langd| unicode:: U+02991 .. LEFT ANGLE BRACKET WITH DOT +.. |lbrke| unicode:: U+0298B .. LEFT SQUARE BRACKET WITH UNDERBAR +.. |lbrksld| unicode:: U+0298F .. LEFT SQUARE BRACKET WITH TICK IN BOTTOM CORNER +.. |lbrkslu| unicode:: U+0298D .. LEFT SQUARE BRACKET WITH TICK IN TOP CORNER +.. |lceil| unicode:: U+02308 .. LEFT CEILING +.. |lfloor| unicode:: U+0230A .. LEFT FLOOR +.. |lmoust| unicode:: U+023B0 .. UPPER LEFT OR LOWER RIGHT CURLY BRACKET SECTION +.. |lpargt| unicode:: U+029A0 .. SPHERICAL ANGLE OPENING LEFT +.. |lparlt| unicode:: U+02993 .. LEFT ARC LESS-THAN BRACKET +.. |ltrPar| unicode:: U+02996 .. DOUBLE RIGHT ARC LESS-THAN BRACKET +.. |rangd| unicode:: U+02992 .. RIGHT ANGLE BRACKET WITH DOT +.. |rbrke| unicode:: U+0298C .. RIGHT SQUARE BRACKET WITH UNDERBAR +.. |rbrksld| unicode:: U+0298E .. RIGHT SQUARE BRACKET WITH TICK IN BOTTOM CORNER +.. |rbrkslu| unicode:: U+02990 .. RIGHT SQUARE BRACKET WITH TICK IN TOP CORNER +.. |rceil| unicode:: U+02309 .. RIGHT CEILING +.. |rfloor| unicode:: U+0230B .. RIGHT FLOOR +.. |rmoust| unicode:: U+023B1 .. UPPER RIGHT OR LOWER LEFT CURLY BRACKET SECTION +.. |rpargt| unicode:: U+02994 .. RIGHT ARC GREATER-THAN BRACKET +.. |ulcorn| unicode:: U+0231C .. TOP LEFT CORNER +.. |urcorn| unicode:: U+0231D .. TOP RIGHT CORNER diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/isoamsn.txt --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/isoamsn.txt Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,96 @@ +.. This data file has been placed in the public domain. +.. Derived from the Unicode character mappings available from + . + Processed by unicode2rstsubs.py, part of Docutils: + . + +.. |gnap| unicode:: U+02A8A .. GREATER-THAN AND NOT APPROXIMATE +.. |gnE| unicode:: U+02269 .. GREATER-THAN BUT NOT EQUAL TO +.. |gne| unicode:: U+02A88 .. GREATER-THAN AND SINGLE-LINE NOT EQUAL TO +.. |gnsim| unicode:: U+022E7 .. GREATER-THAN BUT NOT EQUIVALENT TO +.. |gvnE| unicode:: U+02269 U+0FE00 .. GREATER-THAN BUT NOT EQUAL TO - with vertical stroke +.. |lnap| unicode:: U+02A89 .. LESS-THAN AND NOT APPROXIMATE +.. |lnE| unicode:: U+02268 .. LESS-THAN BUT NOT EQUAL TO +.. |lne| unicode:: U+02A87 .. LESS-THAN AND SINGLE-LINE NOT EQUAL TO +.. |lnsim| unicode:: U+022E6 .. LESS-THAN BUT NOT EQUIVALENT TO +.. |lvnE| unicode:: U+02268 U+0FE00 .. LESS-THAN BUT NOT EQUAL TO - with vertical stroke +.. |nap| unicode:: U+02249 .. NOT ALMOST EQUAL TO +.. |napE| unicode:: U+02A70 U+00338 .. APPROXIMATELY EQUAL OR EQUAL TO with slash +.. |napid| unicode:: U+0224B U+00338 .. TRIPLE TILDE with slash +.. |ncong| unicode:: U+02247 .. NEITHER APPROXIMATELY NOR ACTUALLY EQUAL TO +.. |ncongdot| unicode:: U+02A6D U+00338 .. CONGRUENT WITH DOT ABOVE with slash +.. |nequiv| unicode:: U+02262 .. NOT IDENTICAL TO +.. |ngE| unicode:: U+02267 U+00338 .. GREATER-THAN OVER EQUAL TO with slash +.. |nge| unicode:: U+02271 .. NEITHER GREATER-THAN NOR EQUAL TO +.. |nges| unicode:: U+02A7E U+00338 .. GREATER-THAN OR SLANTED EQUAL TO with slash +.. |nGg| unicode:: U+022D9 U+00338 .. VERY MUCH GREATER-THAN with slash +.. |ngsim| unicode:: U+02275 .. NEITHER GREATER-THAN NOR EQUIVALENT TO +.. |nGt| unicode:: U+0226B U+020D2 .. MUCH GREATER THAN with vertical line +.. |ngt| unicode:: U+0226F .. NOT GREATER-THAN +.. |nGtv| unicode:: U+0226B U+00338 .. MUCH GREATER THAN with slash +.. |nlE| unicode:: U+02266 U+00338 .. LESS-THAN OVER EQUAL TO with slash +.. |nle| unicode:: U+02270 .. NEITHER LESS-THAN NOR EQUAL TO +.. |nles| unicode:: U+02A7D U+00338 .. LESS-THAN OR SLANTED EQUAL TO with slash +.. |nLl| unicode:: U+022D8 U+00338 .. VERY MUCH LESS-THAN with slash +.. |nlsim| unicode:: U+02274 .. NEITHER LESS-THAN NOR EQUIVALENT TO +.. |nLt| unicode:: U+0226A U+020D2 .. MUCH LESS THAN with vertical line +.. |nlt| unicode:: U+0226E .. NOT LESS-THAN +.. |nltri| unicode:: U+022EA .. NOT NORMAL SUBGROUP OF +.. |nltrie| unicode:: U+022EC .. NOT NORMAL SUBGROUP OF OR EQUAL TO +.. |nLtv| unicode:: U+0226A U+00338 .. MUCH LESS THAN with slash +.. |nmid| unicode:: U+02224 .. DOES NOT DIVIDE +.. |npar| unicode:: U+02226 .. NOT PARALLEL TO +.. |npr| unicode:: U+02280 .. DOES NOT PRECEDE +.. |nprcue| unicode:: U+022E0 .. DOES NOT PRECEDE OR EQUAL +.. |npre| unicode:: U+02AAF U+00338 .. PRECEDES ABOVE SINGLE-LINE EQUALS SIGN with slash +.. |nrtri| unicode:: U+022EB .. DOES NOT CONTAIN AS NORMAL SUBGROUP +.. |nrtrie| unicode:: U+022ED .. DOES NOT CONTAIN AS NORMAL SUBGROUP OR EQUAL +.. |nsc| unicode:: U+02281 .. DOES NOT SUCCEED +.. |nsccue| unicode:: U+022E1 .. DOES NOT SUCCEED OR EQUAL +.. |nsce| unicode:: U+02AB0 U+00338 .. SUCCEEDS ABOVE SINGLE-LINE EQUALS SIGN with slash +.. |nsim| unicode:: U+02241 .. NOT TILDE +.. |nsime| unicode:: U+02244 .. NOT ASYMPTOTICALLY EQUAL TO +.. |nsmid| unicode:: U+02224 .. DOES NOT DIVIDE +.. |nspar| unicode:: U+02226 .. NOT PARALLEL TO +.. |nsqsube| unicode:: U+022E2 .. NOT SQUARE IMAGE OF OR EQUAL TO +.. |nsqsupe| unicode:: U+022E3 .. NOT SQUARE ORIGINAL OF OR EQUAL TO +.. |nsub| unicode:: U+02284 .. NOT A SUBSET OF +.. |nsubE| unicode:: U+02AC5 U+00338 .. SUBSET OF ABOVE EQUALS SIGN with slash +.. |nsube| unicode:: U+02288 .. NEITHER A SUBSET OF NOR EQUAL TO +.. |nsup| unicode:: U+02285 .. NOT A SUPERSET OF +.. |nsupE| unicode:: U+02AC6 U+00338 .. SUPERSET OF ABOVE EQUALS SIGN with slash +.. |nsupe| unicode:: U+02289 .. NEITHER A SUPERSET OF NOR EQUAL TO +.. |ntgl| unicode:: U+02279 .. NEITHER GREATER-THAN NOR LESS-THAN +.. |ntlg| unicode:: U+02278 .. NEITHER LESS-THAN NOR GREATER-THAN +.. |nvap| unicode:: U+0224D U+020D2 .. EQUIVALENT TO with vertical line +.. |nVDash| unicode:: U+022AF .. NEGATED DOUBLE VERTICAL BAR DOUBLE RIGHT TURNSTILE +.. |nVdash| unicode:: U+022AE .. DOES NOT FORCE +.. |nvDash| unicode:: U+022AD .. NOT TRUE +.. |nvdash| unicode:: U+022AC .. DOES NOT PROVE +.. |nvge| unicode:: U+02265 U+020D2 .. GREATER-THAN OR EQUAL TO with vertical line +.. |nvgt| unicode:: U+0003E U+020D2 .. GREATER-THAN SIGN with vertical line +.. |nvle| unicode:: U+02264 U+020D2 .. LESS-THAN OR EQUAL TO with vertical line +.. |nvlt| unicode:: U+0003C U+020D2 .. LESS-THAN SIGN with vertical line +.. |nvltrie| unicode:: U+022B4 U+020D2 .. NORMAL SUBGROUP OF OR EQUAL TO with vertical line +.. |nvrtrie| unicode:: U+022B5 U+020D2 .. CONTAINS AS NORMAL SUBGROUP OR EQUAL TO with vertical line +.. |nvsim| unicode:: U+0223C U+020D2 .. TILDE OPERATOR with vertical line +.. |parsim| unicode:: U+02AF3 .. PARALLEL WITH TILDE OPERATOR +.. |prnap| unicode:: U+02AB9 .. PRECEDES ABOVE NOT ALMOST EQUAL TO +.. |prnE| unicode:: U+02AB5 .. PRECEDES ABOVE NOT EQUAL TO +.. |prnsim| unicode:: U+022E8 .. PRECEDES BUT NOT EQUIVALENT TO +.. |rnmid| unicode:: U+02AEE .. DOES NOT DIVIDE WITH REVERSED NEGATION SLASH +.. |scnap| unicode:: U+02ABA .. SUCCEEDS ABOVE NOT ALMOST EQUAL TO +.. |scnE| unicode:: U+02AB6 .. SUCCEEDS ABOVE NOT EQUAL TO +.. |scnsim| unicode:: U+022E9 .. SUCCEEDS BUT NOT EQUIVALENT TO +.. |simne| unicode:: U+02246 .. APPROXIMATELY BUT NOT ACTUALLY EQUAL TO +.. |solbar| unicode:: U+0233F .. APL FUNCTIONAL SYMBOL SLASH BAR +.. |subnE| unicode:: U+02ACB .. SUBSET OF ABOVE NOT EQUAL TO +.. |subne| unicode:: U+0228A .. SUBSET OF WITH NOT EQUAL TO +.. |supnE| unicode:: U+02ACC .. SUPERSET OF ABOVE NOT EQUAL TO +.. |supne| unicode:: U+0228B .. SUPERSET OF WITH NOT EQUAL TO +.. |vnsub| unicode:: U+02282 U+020D2 .. SUBSET OF with vertical line +.. |vnsup| unicode:: U+02283 U+020D2 .. SUPERSET OF with vertical line +.. |vsubnE| unicode:: U+02ACB U+0FE00 .. SUBSET OF ABOVE NOT EQUAL TO - variant with stroke through bottom members +.. |vsubne| unicode:: U+0228A U+0FE00 .. SUBSET OF WITH NOT EQUAL TO - variant with stroke through bottom members +.. |vsupnE| unicode:: U+02ACC U+0FE00 .. SUPERSET OF ABOVE NOT EQUAL TO - variant with stroke through bottom members +.. |vsupne| unicode:: U+0228B U+0FE00 .. SUPERSET OF WITH NOT EQUAL TO - variant with stroke through bottom members diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/isoamso.txt --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/isoamso.txt Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,62 @@ +.. This data file has been placed in the public domain. +.. Derived from the Unicode character mappings available from + . + Processed by unicode2rstsubs.py, part of Docutils: + . + +.. |ang| unicode:: U+02220 .. ANGLE +.. |ange| unicode:: U+029A4 .. ANGLE WITH UNDERBAR +.. |angmsd| unicode:: U+02221 .. MEASURED ANGLE +.. |angmsdaa| unicode:: U+029A8 .. MEASURED ANGLE WITH OPEN ARM ENDING IN ARROW POINTING UP AND RIGHT +.. |angmsdab| unicode:: U+029A9 .. MEASURED ANGLE WITH OPEN ARM ENDING IN ARROW POINTING UP AND LEFT +.. |angmsdac| unicode:: U+029AA .. MEASURED ANGLE WITH OPEN ARM ENDING IN ARROW POINTING DOWN AND RIGHT +.. |angmsdad| unicode:: U+029AB .. MEASURED ANGLE WITH OPEN ARM ENDING IN ARROW POINTING DOWN AND LEFT +.. |angmsdae| unicode:: U+029AC .. MEASURED ANGLE WITH OPEN ARM ENDING IN ARROW POINTING RIGHT AND UP +.. |angmsdaf| unicode:: U+029AD .. MEASURED ANGLE WITH OPEN ARM ENDING IN ARROW POINTING LEFT AND UP +.. |angmsdag| unicode:: U+029AE .. MEASURED ANGLE WITH OPEN ARM ENDING IN ARROW POINTING RIGHT AND DOWN +.. |angmsdah| unicode:: U+029AF .. MEASURED ANGLE WITH OPEN ARM ENDING IN ARROW POINTING LEFT AND DOWN +.. |angrtvb| unicode:: U+022BE .. RIGHT ANGLE WITH ARC +.. |angrtvbd| unicode:: U+0299D .. MEASURED RIGHT ANGLE WITH DOT +.. |bbrk| unicode:: U+023B5 .. BOTTOM SQUARE BRACKET +.. |bbrktbrk| unicode:: U+023B6 .. BOTTOM SQUARE BRACKET OVER TOP SQUARE BRACKET +.. |bemptyv| unicode:: U+029B0 .. REVERSED EMPTY SET +.. |beth| unicode:: U+02136 .. BET SYMBOL +.. |boxbox| unicode:: U+029C9 .. TWO JOINED SQUARES +.. |bprime| unicode:: U+02035 .. REVERSED PRIME +.. |bsemi| unicode:: U+0204F .. REVERSED SEMICOLON +.. |cemptyv| unicode:: U+029B2 .. EMPTY SET WITH SMALL CIRCLE ABOVE +.. |cirE| unicode:: U+029C3 .. CIRCLE WITH TWO HORIZONTAL STROKES TO THE RIGHT +.. |cirscir| unicode:: U+029C2 .. CIRCLE WITH SMALL CIRCLE TO THE RIGHT +.. |comp| unicode:: U+02201 .. COMPLEMENT +.. |daleth| unicode:: U+02138 .. DALET SYMBOL +.. |demptyv| unicode:: U+029B1 .. EMPTY SET WITH OVERBAR +.. |ell| unicode:: U+02113 .. SCRIPT SMALL L +.. |empty| unicode:: U+02205 .. EMPTY SET +.. |emptyv| unicode:: U+02205 .. EMPTY SET +.. |gimel| unicode:: U+02137 .. GIMEL SYMBOL +.. |iiota| unicode:: U+02129 .. TURNED GREEK SMALL LETTER IOTA +.. |image| unicode:: U+02111 .. BLACK-LETTER CAPITAL I +.. |imath| unicode:: U+00131 .. LATIN SMALL LETTER DOTLESS I +.. |inodot| unicode:: U+00131 .. LATIN SMALL LETTER DOTLESS I +.. |jmath| unicode:: U+0006A .. LATIN SMALL LETTER J +.. |jnodot| unicode:: U+0006A .. LATIN SMALL LETTER J +.. |laemptyv| unicode:: U+029B4 .. EMPTY SET WITH LEFT ARROW ABOVE +.. |lltri| unicode:: U+025FA .. LOWER LEFT TRIANGLE +.. |lrtri| unicode:: U+022BF .. RIGHT TRIANGLE +.. |mho| unicode:: U+02127 .. INVERTED OHM SIGN +.. |nang| unicode:: U+02220 U+020D2 .. ANGLE with vertical line +.. |nexist| unicode:: U+02204 .. THERE DOES NOT EXIST +.. |oS| unicode:: U+024C8 .. CIRCLED LATIN CAPITAL LETTER S +.. |planck| unicode:: U+0210F .. PLANCK CONSTANT OVER TWO PI +.. |plankv| unicode:: U+0210F .. PLANCK CONSTANT OVER TWO PI +.. |raemptyv| unicode:: U+029B3 .. EMPTY SET WITH RIGHT ARROW ABOVE +.. |range| unicode:: U+029A5 .. REVERSED ANGLE WITH UNDERBAR +.. |real| unicode:: U+0211C .. BLACK-LETTER CAPITAL R +.. |sbsol| unicode:: U+0FE68 .. SMALL REVERSE SOLIDUS +.. |tbrk| unicode:: U+023B4 .. TOP SQUARE BRACKET +.. |trpezium| unicode:: U+0FFFD .. REPLACEMENT CHARACTER +.. |ultri| unicode:: U+025F8 .. UPPER LEFT TRIANGLE +.. |urtri| unicode:: U+025F9 .. UPPER RIGHT TRIANGLE +.. |vprime| unicode:: U+02032 .. PRIME +.. |vzigzag| unicode:: U+0299A .. VERTICAL ZIGZAG LINE +.. |weierp| unicode:: U+02118 .. SCRIPT CAPITAL P diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/isoamsr.txt --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/isoamsr.txt Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,191 @@ +.. This data file has been placed in the public domain. +.. Derived from the Unicode character mappings available from + . + Processed by unicode2rstsubs.py, part of Docutils: + . + +.. |apE| unicode:: U+02A70 .. APPROXIMATELY EQUAL OR EQUAL TO +.. |ape| unicode:: U+0224A .. ALMOST EQUAL OR EQUAL TO +.. |apid| unicode:: U+0224B .. TRIPLE TILDE +.. |asymp| unicode:: U+02248 .. ALMOST EQUAL TO +.. |Barv| unicode:: U+02AE7 .. SHORT DOWN TACK WITH OVERBAR +.. |bcong| unicode:: U+0224C .. ALL EQUAL TO +.. |bepsi| unicode:: U+003F6 .. GREEK REVERSED LUNATE EPSILON SYMBOL +.. |bowtie| unicode:: U+022C8 .. BOWTIE +.. |bsim| unicode:: U+0223D .. REVERSED TILDE +.. |bsime| unicode:: U+022CD .. REVERSED TILDE EQUALS +.. |bsolhsub| unicode:: U+0005C U+02282 .. REVERSE SOLIDUS, SUBSET OF +.. |bump| unicode:: U+0224E .. GEOMETRICALLY EQUIVALENT TO +.. |bumpE| unicode:: U+02AAE .. EQUALS SIGN WITH BUMPY ABOVE +.. |bumpe| unicode:: U+0224F .. DIFFERENCE BETWEEN +.. |cire| unicode:: U+02257 .. RING EQUAL TO +.. |Colon| unicode:: U+02237 .. PROPORTION +.. |Colone| unicode:: U+02A74 .. DOUBLE COLON EQUAL +.. |colone| unicode:: U+02254 .. COLON EQUALS +.. |congdot| unicode:: U+02A6D .. CONGRUENT WITH DOT ABOVE +.. |csub| unicode:: U+02ACF .. CLOSED SUBSET +.. |csube| unicode:: U+02AD1 .. CLOSED SUBSET OR EQUAL TO +.. |csup| unicode:: U+02AD0 .. CLOSED SUPERSET +.. |csupe| unicode:: U+02AD2 .. CLOSED SUPERSET OR EQUAL TO +.. |cuepr| unicode:: U+022DE .. EQUAL TO OR PRECEDES +.. |cuesc| unicode:: U+022DF .. EQUAL TO OR SUCCEEDS +.. |cupre| unicode:: U+0227C .. PRECEDES OR EQUAL TO +.. |Dashv| unicode:: U+02AE4 .. VERTICAL BAR DOUBLE LEFT TURNSTILE +.. |dashv| unicode:: U+022A3 .. LEFT TACK +.. |easter| unicode:: U+02A6E .. EQUALS WITH ASTERISK +.. |ecir| unicode:: U+02256 .. RING IN EQUAL TO +.. |ecolon| unicode:: U+02255 .. EQUALS COLON +.. |eDDot| unicode:: U+02A77 .. EQUALS SIGN WITH TWO DOTS ABOVE AND TWO DOTS BELOW +.. |eDot| unicode:: U+02251 .. GEOMETRICALLY EQUAL TO +.. |efDot| unicode:: U+02252 .. APPROXIMATELY EQUAL TO OR THE IMAGE OF +.. |eg| unicode:: U+02A9A .. DOUBLE-LINE EQUAL TO OR GREATER-THAN +.. |egs| unicode:: U+02A96 .. SLANTED EQUAL TO OR GREATER-THAN +.. |egsdot| unicode:: U+02A98 .. SLANTED EQUAL TO OR GREATER-THAN WITH DOT INSIDE +.. |el| unicode:: U+02A99 .. DOUBLE-LINE EQUAL TO OR LESS-THAN +.. |els| unicode:: U+02A95 .. SLANTED EQUAL TO OR LESS-THAN +.. |elsdot| unicode:: U+02A97 .. SLANTED EQUAL TO OR LESS-THAN WITH DOT INSIDE +.. |equest| unicode:: U+0225F .. QUESTIONED EQUAL TO +.. |equivDD| unicode:: U+02A78 .. EQUIVALENT WITH FOUR DOTS ABOVE +.. |erDot| unicode:: U+02253 .. IMAGE OF OR APPROXIMATELY EQUAL TO +.. |esdot| unicode:: U+02250 .. APPROACHES THE LIMIT +.. |Esim| unicode:: U+02A73 .. EQUALS SIGN ABOVE TILDE OPERATOR +.. |esim| unicode:: U+02242 .. MINUS TILDE +.. |fork| unicode:: U+022D4 .. PITCHFORK +.. |forkv| unicode:: U+02AD9 .. ELEMENT OF OPENING DOWNWARDS +.. |frown| unicode:: U+02322 .. FROWN +.. |gap| unicode:: U+02A86 .. GREATER-THAN OR APPROXIMATE +.. |gE| unicode:: U+02267 .. GREATER-THAN OVER EQUAL TO +.. |gEl| unicode:: U+02A8C .. GREATER-THAN ABOVE DOUBLE-LINE EQUAL ABOVE LESS-THAN +.. |gel| unicode:: U+022DB .. GREATER-THAN EQUAL TO OR LESS-THAN +.. |ges| unicode:: U+02A7E .. GREATER-THAN OR SLANTED EQUAL TO +.. |gescc| unicode:: U+02AA9 .. GREATER-THAN CLOSED BY CURVE ABOVE SLANTED EQUAL +.. |gesdot| unicode:: U+02A80 .. GREATER-THAN OR SLANTED EQUAL TO WITH DOT INSIDE +.. |gesdoto| unicode:: U+02A82 .. GREATER-THAN OR SLANTED EQUAL TO WITH DOT ABOVE +.. |gesdotol| unicode:: U+02A84 .. GREATER-THAN OR SLANTED EQUAL TO WITH DOT ABOVE LEFT +.. |gesl| unicode:: U+022DB U+0FE00 .. GREATER-THAN slanted EQUAL TO OR LESS-THAN +.. |gesles| unicode:: U+02A94 .. GREATER-THAN ABOVE SLANTED EQUAL ABOVE LESS-THAN ABOVE SLANTED EQUAL +.. |Gg| unicode:: U+022D9 .. VERY MUCH GREATER-THAN +.. |gl| unicode:: U+02277 .. GREATER-THAN OR LESS-THAN +.. |gla| unicode:: U+02AA5 .. GREATER-THAN BESIDE LESS-THAN +.. |glE| unicode:: U+02A92 .. GREATER-THAN ABOVE LESS-THAN ABOVE DOUBLE-LINE EQUAL +.. |glj| unicode:: U+02AA4 .. GREATER-THAN OVERLAPPING LESS-THAN +.. |gsdot| unicode:: U+022D7 .. GREATER-THAN WITH DOT +.. |gsim| unicode:: U+02273 .. GREATER-THAN OR EQUIVALENT TO +.. |gsime| unicode:: U+02A8E .. GREATER-THAN ABOVE SIMILAR OR EQUAL +.. |gsiml| unicode:: U+02A90 .. GREATER-THAN ABOVE SIMILAR ABOVE LESS-THAN +.. |Gt| unicode:: U+0226B .. MUCH GREATER-THAN +.. |gtcc| unicode:: U+02AA7 .. GREATER-THAN CLOSED BY CURVE +.. |gtcir| unicode:: U+02A7A .. GREATER-THAN WITH CIRCLE INSIDE +.. |gtdot| unicode:: U+022D7 .. GREATER-THAN WITH DOT +.. |gtquest| unicode:: U+02A7C .. GREATER-THAN WITH QUESTION MARK ABOVE +.. |gtrarr| unicode:: U+02978 .. GREATER-THAN ABOVE RIGHTWARDS ARROW +.. |homtht| unicode:: U+0223B .. HOMOTHETIC +.. |lap| unicode:: U+02A85 .. LESS-THAN OR APPROXIMATE +.. |lat| unicode:: U+02AAB .. LARGER THAN +.. |late| unicode:: U+02AAD .. LARGER THAN OR EQUAL TO +.. |lates| unicode:: U+02AAD U+0FE00 .. LARGER THAN OR slanted EQUAL +.. |ldot| unicode:: U+022D6 .. LESS-THAN WITH DOT +.. |lE| unicode:: U+02266 .. LESS-THAN OVER EQUAL TO +.. |lEg| unicode:: U+02A8B .. LESS-THAN ABOVE DOUBLE-LINE EQUAL ABOVE GREATER-THAN +.. |leg| unicode:: U+022DA .. LESS-THAN EQUAL TO OR GREATER-THAN +.. |les| unicode:: U+02A7D .. LESS-THAN OR SLANTED EQUAL TO +.. |lescc| unicode:: U+02AA8 .. LESS-THAN CLOSED BY CURVE ABOVE SLANTED EQUAL +.. |lesdot| unicode:: U+02A7F .. LESS-THAN OR SLANTED EQUAL TO WITH DOT INSIDE +.. |lesdoto| unicode:: U+02A81 .. LESS-THAN OR SLANTED EQUAL TO WITH DOT ABOVE +.. |lesdotor| unicode:: U+02A83 .. LESS-THAN OR SLANTED EQUAL TO WITH DOT ABOVE RIGHT +.. |lesg| unicode:: U+022DA U+0FE00 .. LESS-THAN slanted EQUAL TO OR GREATER-THAN +.. |lesges| unicode:: U+02A93 .. LESS-THAN ABOVE SLANTED EQUAL ABOVE GREATER-THAN ABOVE SLANTED EQUAL +.. |lg| unicode:: U+02276 .. LESS-THAN OR GREATER-THAN +.. |lgE| unicode:: U+02A91 .. LESS-THAN ABOVE GREATER-THAN ABOVE DOUBLE-LINE EQUAL +.. |Ll| unicode:: U+022D8 .. VERY MUCH LESS-THAN +.. |lsim| unicode:: U+02272 .. LESS-THAN OR EQUIVALENT TO +.. |lsime| unicode:: U+02A8D .. LESS-THAN ABOVE SIMILAR OR EQUAL +.. |lsimg| unicode:: U+02A8F .. LESS-THAN ABOVE SIMILAR ABOVE GREATER-THAN +.. |Lt| unicode:: U+0226A .. MUCH LESS-THAN +.. |ltcc| unicode:: U+02AA6 .. LESS-THAN CLOSED BY CURVE +.. |ltcir| unicode:: U+02A79 .. LESS-THAN WITH CIRCLE INSIDE +.. |ltdot| unicode:: U+022D6 .. LESS-THAN WITH DOT +.. |ltlarr| unicode:: U+02976 .. LESS-THAN ABOVE LEFTWARDS ARROW +.. |ltquest| unicode:: U+02A7B .. LESS-THAN WITH QUESTION MARK ABOVE +.. |ltrie| unicode:: U+022B4 .. NORMAL SUBGROUP OF OR EQUAL TO +.. |mcomma| unicode:: U+02A29 .. MINUS SIGN WITH COMMA ABOVE +.. |mDDot| unicode:: U+0223A .. GEOMETRIC PROPORTION +.. |mid| unicode:: U+02223 .. DIVIDES +.. |mlcp| unicode:: U+02ADB .. TRANSVERSAL INTERSECTION +.. |models| unicode:: U+022A7 .. MODELS +.. |mstpos| unicode:: U+0223E .. INVERTED LAZY S +.. |Pr| unicode:: U+02ABB .. DOUBLE PRECEDES +.. |pr| unicode:: U+0227A .. PRECEDES +.. |prap| unicode:: U+02AB7 .. PRECEDES ABOVE ALMOST EQUAL TO +.. |prcue| unicode:: U+0227C .. PRECEDES OR EQUAL TO +.. |prE| unicode:: U+02AB3 .. PRECEDES ABOVE EQUALS SIGN +.. |pre| unicode:: U+02AAF .. PRECEDES ABOVE SINGLE-LINE EQUALS SIGN +.. |prsim| unicode:: U+0227E .. PRECEDES OR EQUIVALENT TO +.. |prurel| unicode:: U+022B0 .. PRECEDES UNDER RELATION +.. |ratio| unicode:: U+02236 .. RATIO +.. |rtrie| unicode:: U+022B5 .. CONTAINS AS NORMAL SUBGROUP OR EQUAL TO +.. |rtriltri| unicode:: U+029CE .. RIGHT TRIANGLE ABOVE LEFT TRIANGLE +.. |samalg| unicode:: U+02210 .. N-ARY COPRODUCT +.. |Sc| unicode:: U+02ABC .. DOUBLE SUCCEEDS +.. |sc| unicode:: U+0227B .. SUCCEEDS +.. |scap| unicode:: U+02AB8 .. SUCCEEDS ABOVE ALMOST EQUAL TO +.. |sccue| unicode:: U+0227D .. SUCCEEDS OR EQUAL TO +.. |scE| unicode:: U+02AB4 .. SUCCEEDS ABOVE EQUALS SIGN +.. |sce| unicode:: U+02AB0 .. SUCCEEDS ABOVE SINGLE-LINE EQUALS SIGN +.. |scsim| unicode:: U+0227F .. SUCCEEDS OR EQUIVALENT TO +.. |sdote| unicode:: U+02A66 .. EQUALS SIGN WITH DOT BELOW +.. |sfrown| unicode:: U+02322 .. FROWN +.. |simg| unicode:: U+02A9E .. SIMILAR OR GREATER-THAN +.. |simgE| unicode:: U+02AA0 .. SIMILAR ABOVE GREATER-THAN ABOVE EQUALS SIGN +.. |siml| unicode:: U+02A9D .. SIMILAR OR LESS-THAN +.. |simlE| unicode:: U+02A9F .. SIMILAR ABOVE LESS-THAN ABOVE EQUALS SIGN +.. |smid| unicode:: U+02223 .. DIVIDES +.. |smile| unicode:: U+02323 .. SMILE +.. |smt| unicode:: U+02AAA .. SMALLER THAN +.. |smte| unicode:: U+02AAC .. SMALLER THAN OR EQUAL TO +.. |smtes| unicode:: U+02AAC U+0FE00 .. SMALLER THAN OR slanted EQUAL +.. |spar| unicode:: U+02225 .. PARALLEL TO +.. |sqsub| unicode:: U+0228F .. SQUARE IMAGE OF +.. |sqsube| unicode:: U+02291 .. SQUARE IMAGE OF OR EQUAL TO +.. |sqsup| unicode:: U+02290 .. SQUARE ORIGINAL OF +.. |sqsupe| unicode:: U+02292 .. SQUARE ORIGINAL OF OR EQUAL TO +.. |ssmile| unicode:: U+02323 .. SMILE +.. |Sub| unicode:: U+022D0 .. DOUBLE SUBSET +.. |subE| unicode:: U+02AC5 .. SUBSET OF ABOVE EQUALS SIGN +.. |subedot| unicode:: U+02AC3 .. SUBSET OF OR EQUAL TO WITH DOT ABOVE +.. |submult| unicode:: U+02AC1 .. SUBSET WITH MULTIPLICATION SIGN BELOW +.. |subplus| unicode:: U+02ABF .. SUBSET WITH PLUS SIGN BELOW +.. |subrarr| unicode:: U+02979 .. SUBSET ABOVE RIGHTWARDS ARROW +.. |subsim| unicode:: U+02AC7 .. SUBSET OF ABOVE TILDE OPERATOR +.. |subsub| unicode:: U+02AD5 .. SUBSET ABOVE SUBSET +.. |subsup| unicode:: U+02AD3 .. SUBSET ABOVE SUPERSET +.. |Sup| unicode:: U+022D1 .. DOUBLE SUPERSET +.. |supdsub| unicode:: U+02AD8 .. SUPERSET BESIDE AND JOINED BY DASH WITH SUBSET +.. |supE| unicode:: U+02AC6 .. SUPERSET OF ABOVE EQUALS SIGN +.. |supedot| unicode:: U+02AC4 .. SUPERSET OF OR EQUAL TO WITH DOT ABOVE +.. |suphsol| unicode:: U+02283 U+0002F .. SUPERSET OF, SOLIDUS +.. |suphsub| unicode:: U+02AD7 .. SUPERSET BESIDE SUBSET +.. |suplarr| unicode:: U+0297B .. SUPERSET ABOVE LEFTWARDS ARROW +.. |supmult| unicode:: U+02AC2 .. SUPERSET WITH MULTIPLICATION SIGN BELOW +.. |supplus| unicode:: U+02AC0 .. SUPERSET WITH PLUS SIGN BELOW +.. |supsim| unicode:: U+02AC8 .. SUPERSET OF ABOVE TILDE OPERATOR +.. |supsub| unicode:: U+02AD4 .. SUPERSET ABOVE SUBSET +.. |supsup| unicode:: U+02AD6 .. SUPERSET ABOVE SUPERSET +.. |thkap| unicode:: U+02248 .. ALMOST EQUAL TO +.. |thksim| unicode:: U+0223C .. TILDE OPERATOR +.. |topfork| unicode:: U+02ADA .. PITCHFORK WITH TEE TOP +.. |trie| unicode:: U+0225C .. DELTA EQUAL TO +.. |twixt| unicode:: U+0226C .. BETWEEN +.. |Vbar| unicode:: U+02AEB .. DOUBLE UP TACK +.. |vBar| unicode:: U+02AE8 .. SHORT UP TACK WITH UNDERBAR +.. |vBarv| unicode:: U+02AE9 .. SHORT UP TACK ABOVE SHORT DOWN TACK +.. |VDash| unicode:: U+022AB .. DOUBLE VERTICAL BAR DOUBLE RIGHT TURNSTILE +.. |Vdash| unicode:: U+022A9 .. FORCES +.. |vDash| unicode:: U+022A8 .. TRUE +.. |vdash| unicode:: U+022A2 .. RIGHT TACK +.. |Vdashl| unicode:: U+02AE6 .. LONG DASH FROM LEFT MEMBER OF DOUBLE VERTICAL +.. |veebar| unicode:: U+022BB .. XOR +.. |vltri| unicode:: U+022B2 .. NORMAL SUBGROUP OF +.. |vprop| unicode:: U+0221D .. PROPORTIONAL TO +.. |vrtri| unicode:: U+022B3 .. CONTAINS AS NORMAL SUBGROUP +.. |Vvdash| unicode:: U+022AA .. TRIPLE VERTICAL BAR RIGHT TURNSTILE diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/isobox.txt --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/isobox.txt Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,46 @@ +.. This data file has been placed in the public domain. +.. Derived from the Unicode character mappings available from + . + Processed by unicode2rstsubs.py, part of Docutils: + . + +.. |boxDL| unicode:: U+02557 .. BOX DRAWINGS DOUBLE DOWN AND LEFT +.. |boxDl| unicode:: U+02556 .. BOX DRAWINGS DOWN DOUBLE AND LEFT SINGLE +.. |boxdL| unicode:: U+02555 .. BOX DRAWINGS DOWN SINGLE AND LEFT DOUBLE +.. |boxdl| unicode:: U+02510 .. BOX DRAWINGS LIGHT DOWN AND LEFT +.. |boxDR| unicode:: U+02554 .. BOX DRAWINGS DOUBLE DOWN AND RIGHT +.. |boxDr| unicode:: U+02553 .. BOX DRAWINGS DOWN DOUBLE AND RIGHT SINGLE +.. |boxdR| unicode:: U+02552 .. BOX DRAWINGS DOWN SINGLE AND RIGHT DOUBLE +.. |boxdr| unicode:: U+0250C .. BOX DRAWINGS LIGHT DOWN AND RIGHT +.. |boxH| unicode:: U+02550 .. BOX DRAWINGS DOUBLE HORIZONTAL +.. |boxh| unicode:: U+02500 .. BOX DRAWINGS LIGHT HORIZONTAL +.. |boxHD| unicode:: U+02566 .. BOX DRAWINGS DOUBLE DOWN AND HORIZONTAL +.. |boxHd| unicode:: U+02564 .. BOX DRAWINGS DOWN SINGLE AND HORIZONTAL DOUBLE +.. |boxhD| unicode:: U+02565 .. BOX DRAWINGS DOWN DOUBLE AND HORIZONTAL SINGLE +.. |boxhd| unicode:: U+0252C .. BOX DRAWINGS LIGHT DOWN AND HORIZONTAL +.. |boxHU| unicode:: U+02569 .. BOX DRAWINGS DOUBLE UP AND HORIZONTAL +.. |boxHu| unicode:: U+02567 .. BOX DRAWINGS UP SINGLE AND HORIZONTAL DOUBLE +.. |boxhU| unicode:: U+02568 .. BOX DRAWINGS UP DOUBLE AND HORIZONTAL SINGLE +.. |boxhu| unicode:: U+02534 .. BOX DRAWINGS LIGHT UP AND HORIZONTAL +.. |boxUL| unicode:: U+0255D .. BOX DRAWINGS DOUBLE UP AND LEFT +.. |boxUl| unicode:: U+0255C .. BOX DRAWINGS UP DOUBLE AND LEFT SINGLE +.. |boxuL| unicode:: U+0255B .. BOX DRAWINGS UP SINGLE AND LEFT DOUBLE +.. |boxul| unicode:: U+02518 .. BOX DRAWINGS LIGHT UP AND LEFT +.. |boxUR| unicode:: U+0255A .. BOX DRAWINGS DOUBLE UP AND RIGHT +.. |boxUr| unicode:: U+02559 .. BOX DRAWINGS UP DOUBLE AND RIGHT SINGLE +.. |boxuR| unicode:: U+02558 .. BOX DRAWINGS UP SINGLE AND RIGHT DOUBLE +.. |boxur| unicode:: U+02514 .. BOX DRAWINGS LIGHT UP AND RIGHT +.. |boxV| unicode:: U+02551 .. BOX DRAWINGS DOUBLE VERTICAL +.. |boxv| unicode:: U+02502 .. BOX DRAWINGS LIGHT VERTICAL +.. |boxVH| unicode:: U+0256C .. BOX DRAWINGS DOUBLE VERTICAL AND HORIZONTAL +.. |boxVh| unicode:: U+0256B .. BOX DRAWINGS VERTICAL DOUBLE AND HORIZONTAL SINGLE +.. |boxvH| unicode:: U+0256A .. BOX DRAWINGS VERTICAL SINGLE AND HORIZONTAL DOUBLE +.. |boxvh| unicode:: U+0253C .. BOX DRAWINGS LIGHT VERTICAL AND HORIZONTAL +.. |boxVL| unicode:: U+02563 .. BOX DRAWINGS DOUBLE VERTICAL AND LEFT +.. |boxVl| unicode:: U+02562 .. BOX DRAWINGS VERTICAL DOUBLE AND LEFT SINGLE +.. |boxvL| unicode:: U+02561 .. BOX DRAWINGS VERTICAL SINGLE AND LEFT DOUBLE +.. |boxvl| unicode:: U+02524 .. BOX DRAWINGS LIGHT VERTICAL AND LEFT +.. |boxVR| unicode:: U+02560 .. BOX DRAWINGS DOUBLE VERTICAL AND RIGHT +.. |boxVr| unicode:: U+0255F .. BOX DRAWINGS VERTICAL DOUBLE AND RIGHT SINGLE +.. |boxvR| unicode:: U+0255E .. BOX DRAWINGS VERTICAL SINGLE AND RIGHT DOUBLE +.. |boxvr| unicode:: U+0251C .. BOX DRAWINGS LIGHT VERTICAL AND RIGHT diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/isocyr1.txt --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/isocyr1.txt Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,73 @@ +.. This data file has been placed in the public domain. +.. Derived from the Unicode character mappings available from + . + Processed by unicode2rstsubs.py, part of Docutils: + . + +.. |Acy| unicode:: U+00410 .. CYRILLIC CAPITAL LETTER A +.. |acy| unicode:: U+00430 .. CYRILLIC SMALL LETTER A +.. |Bcy| unicode:: U+00411 .. CYRILLIC CAPITAL LETTER BE +.. |bcy| unicode:: U+00431 .. CYRILLIC SMALL LETTER BE +.. |CHcy| unicode:: U+00427 .. CYRILLIC CAPITAL LETTER CHE +.. |chcy| unicode:: U+00447 .. CYRILLIC SMALL LETTER CHE +.. |Dcy| unicode:: U+00414 .. CYRILLIC CAPITAL LETTER DE +.. |dcy| unicode:: U+00434 .. CYRILLIC SMALL LETTER DE +.. |Ecy| unicode:: U+0042D .. CYRILLIC CAPITAL LETTER E +.. |ecy| unicode:: U+0044D .. CYRILLIC SMALL LETTER E +.. |Fcy| unicode:: U+00424 .. CYRILLIC CAPITAL LETTER EF +.. |fcy| unicode:: U+00444 .. CYRILLIC SMALL LETTER EF +.. |Gcy| unicode:: U+00413 .. CYRILLIC CAPITAL LETTER GHE +.. |gcy| unicode:: U+00433 .. CYRILLIC SMALL LETTER GHE +.. |HARDcy| unicode:: U+0042A .. CYRILLIC CAPITAL LETTER HARD SIGN +.. |hardcy| unicode:: U+0044A .. CYRILLIC SMALL LETTER HARD SIGN +.. |Icy| unicode:: U+00418 .. CYRILLIC CAPITAL LETTER I +.. |icy| unicode:: U+00438 .. CYRILLIC SMALL LETTER I +.. |IEcy| unicode:: U+00415 .. CYRILLIC CAPITAL LETTER IE +.. |iecy| unicode:: U+00435 .. CYRILLIC SMALL LETTER IE +.. |IOcy| unicode:: U+00401 .. CYRILLIC CAPITAL LETTER IO +.. |iocy| unicode:: U+00451 .. CYRILLIC SMALL LETTER IO +.. |Jcy| unicode:: U+00419 .. CYRILLIC CAPITAL LETTER SHORT I +.. |jcy| unicode:: U+00439 .. CYRILLIC SMALL LETTER SHORT I +.. |Kcy| unicode:: U+0041A .. CYRILLIC CAPITAL LETTER KA +.. |kcy| unicode:: U+0043A .. CYRILLIC SMALL LETTER KA +.. |KHcy| unicode:: U+00425 .. CYRILLIC CAPITAL LETTER HA +.. |khcy| unicode:: U+00445 .. CYRILLIC SMALL LETTER HA +.. |Lcy| unicode:: U+0041B .. CYRILLIC CAPITAL LETTER EL +.. |lcy| unicode:: U+0043B .. CYRILLIC SMALL LETTER EL +.. |Mcy| unicode:: U+0041C .. CYRILLIC CAPITAL LETTER EM +.. |mcy| unicode:: U+0043C .. CYRILLIC SMALL LETTER EM +.. |Ncy| unicode:: U+0041D .. CYRILLIC CAPITAL LETTER EN +.. |ncy| unicode:: U+0043D .. CYRILLIC SMALL LETTER EN +.. |numero| unicode:: U+02116 .. NUMERO SIGN +.. |Ocy| unicode:: U+0041E .. CYRILLIC CAPITAL LETTER O +.. |ocy| unicode:: U+0043E .. CYRILLIC SMALL LETTER O +.. |Pcy| unicode:: U+0041F .. CYRILLIC CAPITAL LETTER PE +.. |pcy| unicode:: U+0043F .. CYRILLIC SMALL LETTER PE +.. |Rcy| unicode:: U+00420 .. CYRILLIC CAPITAL LETTER ER +.. |rcy| unicode:: U+00440 .. CYRILLIC SMALL LETTER ER +.. |Scy| unicode:: U+00421 .. CYRILLIC CAPITAL LETTER ES +.. |scy| unicode:: U+00441 .. CYRILLIC SMALL LETTER ES +.. |SHCHcy| unicode:: U+00429 .. CYRILLIC CAPITAL LETTER SHCHA +.. |shchcy| unicode:: U+00449 .. CYRILLIC SMALL LETTER SHCHA +.. |SHcy| unicode:: U+00428 .. CYRILLIC CAPITAL LETTER SHA +.. |shcy| unicode:: U+00448 .. CYRILLIC SMALL LETTER SHA +.. |SOFTcy| unicode:: U+0042C .. CYRILLIC CAPITAL LETTER SOFT SIGN +.. |softcy| unicode:: U+0044C .. CYRILLIC SMALL LETTER SOFT SIGN +.. |Tcy| unicode:: U+00422 .. CYRILLIC CAPITAL LETTER TE +.. |tcy| unicode:: U+00442 .. CYRILLIC SMALL LETTER TE +.. |TScy| unicode:: U+00426 .. CYRILLIC CAPITAL LETTER TSE +.. |tscy| unicode:: U+00446 .. CYRILLIC SMALL LETTER TSE +.. |Ucy| unicode:: U+00423 .. CYRILLIC CAPITAL LETTER U +.. |ucy| unicode:: U+00443 .. CYRILLIC SMALL LETTER U +.. |Vcy| unicode:: U+00412 .. CYRILLIC CAPITAL LETTER VE +.. |vcy| unicode:: U+00432 .. CYRILLIC SMALL LETTER VE +.. |YAcy| unicode:: U+0042F .. CYRILLIC CAPITAL LETTER YA +.. |yacy| unicode:: U+0044F .. CYRILLIC SMALL LETTER YA +.. |Ycy| unicode:: U+0042B .. CYRILLIC CAPITAL LETTER YERU +.. |ycy| unicode:: U+0044B .. CYRILLIC SMALL LETTER YERU +.. |YUcy| unicode:: U+0042E .. CYRILLIC CAPITAL LETTER YU +.. |yucy| unicode:: U+0044E .. CYRILLIC SMALL LETTER YU +.. |Zcy| unicode:: U+00417 .. CYRILLIC CAPITAL LETTER ZE +.. |zcy| unicode:: U+00437 .. CYRILLIC SMALL LETTER ZE +.. |ZHcy| unicode:: U+00416 .. CYRILLIC CAPITAL LETTER ZHE +.. |zhcy| unicode:: U+00436 .. CYRILLIC SMALL LETTER ZHE diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/isocyr2.txt --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/isocyr2.txt Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,32 @@ +.. This data file has been placed in the public domain. +.. Derived from the Unicode character mappings available from + . + Processed by unicode2rstsubs.py, part of Docutils: + . + +.. |DJcy| unicode:: U+00402 .. CYRILLIC CAPITAL LETTER DJE +.. |djcy| unicode:: U+00452 .. CYRILLIC SMALL LETTER DJE +.. |DScy| unicode:: U+00405 .. CYRILLIC CAPITAL LETTER DZE +.. |dscy| unicode:: U+00455 .. CYRILLIC SMALL LETTER DZE +.. |DZcy| unicode:: U+0040F .. CYRILLIC CAPITAL LETTER DZHE +.. |dzcy| unicode:: U+0045F .. CYRILLIC SMALL LETTER DZHE +.. |GJcy| unicode:: U+00403 .. CYRILLIC CAPITAL LETTER GJE +.. |gjcy| unicode:: U+00453 .. CYRILLIC SMALL LETTER GJE +.. |Iukcy| unicode:: U+00406 .. CYRILLIC CAPITAL LETTER BYELORUSSIAN-UKRAINIAN I +.. |iukcy| unicode:: U+00456 .. CYRILLIC SMALL LETTER BYELORUSSIAN-UKRAINIAN I +.. |Jsercy| unicode:: U+00408 .. CYRILLIC CAPITAL LETTER JE +.. |jsercy| unicode:: U+00458 .. CYRILLIC SMALL LETTER JE +.. |Jukcy| unicode:: U+00404 .. CYRILLIC CAPITAL LETTER UKRAINIAN IE +.. |jukcy| unicode:: U+00454 .. CYRILLIC SMALL LETTER UKRAINIAN IE +.. |KJcy| unicode:: U+0040C .. CYRILLIC CAPITAL LETTER KJE +.. |kjcy| unicode:: U+0045C .. CYRILLIC SMALL LETTER KJE +.. |LJcy| unicode:: U+00409 .. CYRILLIC CAPITAL LETTER LJE +.. |ljcy| unicode:: U+00459 .. CYRILLIC SMALL LETTER LJE +.. |NJcy| unicode:: U+0040A .. CYRILLIC CAPITAL LETTER NJE +.. |njcy| unicode:: U+0045A .. CYRILLIC SMALL LETTER NJE +.. |TSHcy| unicode:: U+0040B .. CYRILLIC CAPITAL LETTER TSHE +.. |tshcy| unicode:: U+0045B .. CYRILLIC SMALL LETTER TSHE +.. |Ubrcy| unicode:: U+0040E .. CYRILLIC CAPITAL LETTER SHORT U +.. |ubrcy| unicode:: U+0045E .. CYRILLIC SMALL LETTER SHORT U +.. |YIcy| unicode:: U+00407 .. CYRILLIC CAPITAL LETTER YI +.. |yicy| unicode:: U+00457 .. CYRILLIC SMALL LETTER YI diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/isodia.txt --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/isodia.txt Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,20 @@ +.. This data file has been placed in the public domain. +.. Derived from the Unicode character mappings available from + . + Processed by unicode2rstsubs.py, part of Docutils: + . + +.. |acute| unicode:: U+000B4 .. ACUTE ACCENT +.. |breve| unicode:: U+002D8 .. BREVE +.. |caron| unicode:: U+002C7 .. CARON +.. |cedil| unicode:: U+000B8 .. CEDILLA +.. |circ| unicode:: U+002C6 .. MODIFIER LETTER CIRCUMFLEX ACCENT +.. |dblac| unicode:: U+002DD .. DOUBLE ACUTE ACCENT +.. |die| unicode:: U+000A8 .. DIAERESIS +.. |dot| unicode:: U+002D9 .. DOT ABOVE +.. |grave| unicode:: U+00060 .. GRAVE ACCENT +.. |macr| unicode:: U+000AF .. MACRON +.. |ogon| unicode:: U+002DB .. OGONEK +.. |ring| unicode:: U+002DA .. RING ABOVE +.. |tilde| unicode:: U+002DC .. SMALL TILDE +.. |uml| unicode:: U+000A8 .. DIAERESIS diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/isogrk1.txt --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/isogrk1.txt Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,55 @@ +.. This data file has been placed in the public domain. +.. Derived from the Unicode character mappings available from + . + Processed by unicode2rstsubs.py, part of Docutils: + . + +.. |Agr| unicode:: U+00391 .. GREEK CAPITAL LETTER ALPHA +.. |agr| unicode:: U+003B1 .. GREEK SMALL LETTER ALPHA +.. |Bgr| unicode:: U+00392 .. GREEK CAPITAL LETTER BETA +.. |bgr| unicode:: U+003B2 .. GREEK SMALL LETTER BETA +.. |Dgr| unicode:: U+00394 .. GREEK CAPITAL LETTER DELTA +.. |dgr| unicode:: U+003B4 .. GREEK SMALL LETTER DELTA +.. |EEgr| unicode:: U+00397 .. GREEK CAPITAL LETTER ETA +.. |eegr| unicode:: U+003B7 .. GREEK SMALL LETTER ETA +.. |Egr| unicode:: U+00395 .. GREEK CAPITAL LETTER EPSILON +.. |egr| unicode:: U+003B5 .. GREEK SMALL LETTER EPSILON +.. |Ggr| unicode:: U+00393 .. GREEK CAPITAL LETTER GAMMA +.. |ggr| unicode:: U+003B3 .. GREEK SMALL LETTER GAMMA +.. |Igr| unicode:: U+00399 .. GREEK CAPITAL LETTER IOTA +.. |igr| unicode:: U+003B9 .. GREEK SMALL LETTER IOTA +.. |Kgr| unicode:: U+0039A .. GREEK CAPITAL LETTER KAPPA +.. |kgr| unicode:: U+003BA .. GREEK SMALL LETTER KAPPA +.. |KHgr| unicode:: U+003A7 .. GREEK CAPITAL LETTER CHI +.. |khgr| unicode:: U+003C7 .. GREEK SMALL LETTER CHI +.. |Lgr| unicode:: U+0039B .. GREEK CAPITAL LETTER LAMDA +.. |lgr| unicode:: U+003BB .. GREEK SMALL LETTER LAMDA +.. |Mgr| unicode:: U+0039C .. GREEK CAPITAL LETTER MU +.. |mgr| unicode:: U+003BC .. GREEK SMALL LETTER MU +.. |Ngr| unicode:: U+0039D .. GREEK CAPITAL LETTER NU +.. |ngr| unicode:: U+003BD .. GREEK SMALL LETTER NU +.. |Ogr| unicode:: U+0039F .. GREEK CAPITAL LETTER OMICRON +.. |ogr| unicode:: U+003BF .. GREEK SMALL LETTER OMICRON +.. |OHgr| unicode:: U+003A9 .. GREEK CAPITAL LETTER OMEGA +.. |ohgr| unicode:: U+003C9 .. GREEK SMALL LETTER OMEGA +.. |Pgr| unicode:: U+003A0 .. GREEK CAPITAL LETTER PI +.. |pgr| unicode:: U+003C0 .. GREEK SMALL LETTER PI +.. |PHgr| unicode:: U+003A6 .. GREEK CAPITAL LETTER PHI +.. |phgr| unicode:: U+003C6 .. GREEK SMALL LETTER PHI +.. |PSgr| unicode:: U+003A8 .. GREEK CAPITAL LETTER PSI +.. |psgr| unicode:: U+003C8 .. GREEK SMALL LETTER PSI +.. |Rgr| unicode:: U+003A1 .. GREEK CAPITAL LETTER RHO +.. |rgr| unicode:: U+003C1 .. GREEK SMALL LETTER RHO +.. |sfgr| unicode:: U+003C2 .. GREEK SMALL LETTER FINAL SIGMA +.. |Sgr| unicode:: U+003A3 .. GREEK CAPITAL LETTER SIGMA +.. |sgr| unicode:: U+003C3 .. GREEK SMALL LETTER SIGMA +.. |Tgr| unicode:: U+003A4 .. GREEK CAPITAL LETTER TAU +.. |tgr| unicode:: U+003C4 .. GREEK SMALL LETTER TAU +.. |THgr| unicode:: U+00398 .. GREEK CAPITAL LETTER THETA +.. |thgr| unicode:: U+003B8 .. GREEK SMALL LETTER THETA +.. |Ugr| unicode:: U+003A5 .. GREEK CAPITAL LETTER UPSILON +.. |ugr| unicode:: U+003C5 .. GREEK SMALL LETTER UPSILON +.. |Xgr| unicode:: U+0039E .. GREEK CAPITAL LETTER XI +.. |xgr| unicode:: U+003BE .. GREEK SMALL LETTER XI +.. |Zgr| unicode:: U+00396 .. GREEK CAPITAL LETTER ZETA +.. |zgr| unicode:: U+003B6 .. GREEK SMALL LETTER ZETA diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/isogrk2.txt --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/isogrk2.txt Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,26 @@ +.. This data file has been placed in the public domain. +.. Derived from the Unicode character mappings available from + . + Processed by unicode2rstsubs.py, part of Docutils: + . + +.. |Aacgr| unicode:: U+00386 .. GREEK CAPITAL LETTER ALPHA WITH TONOS +.. |aacgr| unicode:: U+003AC .. GREEK SMALL LETTER ALPHA WITH TONOS +.. |Eacgr| unicode:: U+00388 .. GREEK CAPITAL LETTER EPSILON WITH TONOS +.. |eacgr| unicode:: U+003AD .. GREEK SMALL LETTER EPSILON WITH TONOS +.. |EEacgr| unicode:: U+00389 .. GREEK CAPITAL LETTER ETA WITH TONOS +.. |eeacgr| unicode:: U+003AE .. GREEK SMALL LETTER ETA WITH TONOS +.. |Iacgr| unicode:: U+0038A .. GREEK CAPITAL LETTER IOTA WITH TONOS +.. |iacgr| unicode:: U+003AF .. GREEK SMALL LETTER IOTA WITH TONOS +.. |idiagr| unicode:: U+00390 .. GREEK SMALL LETTER IOTA WITH DIALYTIKA AND TONOS +.. |Idigr| unicode:: U+003AA .. GREEK CAPITAL LETTER IOTA WITH DIALYTIKA +.. |idigr| unicode:: U+003CA .. GREEK SMALL LETTER IOTA WITH DIALYTIKA +.. |Oacgr| unicode:: U+0038C .. GREEK CAPITAL LETTER OMICRON WITH TONOS +.. |oacgr| unicode:: U+003CC .. GREEK SMALL LETTER OMICRON WITH TONOS +.. |OHacgr| unicode:: U+0038F .. GREEK CAPITAL LETTER OMEGA WITH TONOS +.. |ohacgr| unicode:: U+003CE .. GREEK SMALL LETTER OMEGA WITH TONOS +.. |Uacgr| unicode:: U+0038E .. GREEK CAPITAL LETTER UPSILON WITH TONOS +.. |uacgr| unicode:: U+003CD .. GREEK SMALL LETTER UPSILON WITH TONOS +.. |udiagr| unicode:: U+003B0 .. GREEK SMALL LETTER UPSILON WITH DIALYTIKA AND TONOS +.. |Udigr| unicode:: U+003AB .. GREEK CAPITAL LETTER UPSILON WITH DIALYTIKA +.. |udigr| unicode:: U+003CB .. GREEK SMALL LETTER UPSILON WITH DIALYTIKA diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/isogrk3.txt --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/isogrk3.txt Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,52 @@ +.. This data file has been placed in the public domain. +.. Derived from the Unicode character mappings available from + . + Processed by unicode2rstsubs.py, part of Docutils: + . + +.. |alpha| unicode:: U+003B1 .. GREEK SMALL LETTER ALPHA +.. |beta| unicode:: U+003B2 .. GREEK SMALL LETTER BETA +.. |chi| unicode:: U+003C7 .. GREEK SMALL LETTER CHI +.. |Delta| unicode:: U+00394 .. GREEK CAPITAL LETTER DELTA +.. |delta| unicode:: U+003B4 .. GREEK SMALL LETTER DELTA +.. |epsi| unicode:: U+003F5 .. GREEK LUNATE EPSILON SYMBOL +.. |epsis| unicode:: U+003F5 .. GREEK LUNATE EPSILON SYMBOL +.. |epsiv| unicode:: U+003B5 .. GREEK SMALL LETTER EPSILON +.. |eta| unicode:: U+003B7 .. GREEK SMALL LETTER ETA +.. |Gamma| unicode:: U+00393 .. GREEK CAPITAL LETTER GAMMA +.. |gamma| unicode:: U+003B3 .. GREEK SMALL LETTER GAMMA +.. |Gammad| unicode:: U+003DC .. GREEK LETTER DIGAMMA +.. |gammad| unicode:: U+003DD .. GREEK SMALL LETTER DIGAMMA +.. |iota| unicode:: U+003B9 .. GREEK SMALL LETTER IOTA +.. |kappa| unicode:: U+003BA .. GREEK SMALL LETTER KAPPA +.. |kappav| unicode:: U+003F0 .. GREEK KAPPA SYMBOL +.. |Lambda| unicode:: U+0039B .. GREEK CAPITAL LETTER LAMDA +.. |lambda| unicode:: U+003BB .. GREEK SMALL LETTER LAMDA +.. |mu| unicode:: U+003BC .. GREEK SMALL LETTER MU +.. |nu| unicode:: U+003BD .. GREEK SMALL LETTER NU +.. |Omega| unicode:: U+003A9 .. GREEK CAPITAL LETTER OMEGA +.. |omega| unicode:: U+003C9 .. GREEK SMALL LETTER OMEGA +.. |Phi| unicode:: U+003A6 .. GREEK CAPITAL LETTER PHI +.. |phi| unicode:: U+003D5 .. GREEK PHI SYMBOL +.. |phis| unicode:: U+003D5 .. GREEK PHI SYMBOL +.. |phiv| unicode:: U+003C6 .. GREEK SMALL LETTER PHI +.. |Pi| unicode:: U+003A0 .. GREEK CAPITAL LETTER PI +.. |pi| unicode:: U+003C0 .. GREEK SMALL LETTER PI +.. |piv| unicode:: U+003D6 .. GREEK PI SYMBOL +.. |Psi| unicode:: U+003A8 .. GREEK CAPITAL LETTER PSI +.. |psi| unicode:: U+003C8 .. GREEK SMALL LETTER PSI +.. |rho| unicode:: U+003C1 .. GREEK SMALL LETTER RHO +.. |rhov| unicode:: U+003F1 .. GREEK RHO SYMBOL +.. |Sigma| unicode:: U+003A3 .. GREEK CAPITAL LETTER SIGMA +.. |sigma| unicode:: U+003C3 .. GREEK SMALL LETTER SIGMA +.. |sigmav| unicode:: U+003C2 .. GREEK SMALL LETTER FINAL SIGMA +.. |tau| unicode:: U+003C4 .. GREEK SMALL LETTER TAU +.. |Theta| unicode:: U+00398 .. GREEK CAPITAL LETTER THETA +.. |theta| unicode:: U+003B8 .. GREEK SMALL LETTER THETA +.. |thetas| unicode:: U+003B8 .. GREEK SMALL LETTER THETA +.. |thetav| unicode:: U+003D1 .. GREEK THETA SYMBOL +.. |Upsi| unicode:: U+003D2 .. GREEK UPSILON WITH HOOK SYMBOL +.. |upsi| unicode:: U+003C5 .. GREEK SMALL LETTER UPSILON +.. |Xi| unicode:: U+0039E .. GREEK CAPITAL LETTER XI +.. |xi| unicode:: U+003BE .. GREEK SMALL LETTER XI +.. |zeta| unicode:: U+003B6 .. GREEK SMALL LETTER ZETA diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/isogrk4-wide.txt --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/isogrk4-wide.txt Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,49 @@ +.. This data file has been placed in the public domain. +.. Derived from the Unicode character mappings available from + . + Processed by unicode2rstsubs.py, part of Docutils: + . + +.. |b.alpha| unicode:: U+1D6C2 .. MATHEMATICAL BOLD SMALL ALPHA +.. |b.beta| unicode:: U+1D6C3 .. MATHEMATICAL BOLD SMALL BETA +.. |b.chi| unicode:: U+1D6D8 .. MATHEMATICAL BOLD SMALL CHI +.. |b.Delta| unicode:: U+1D6AB .. MATHEMATICAL BOLD CAPITAL DELTA +.. |b.delta| unicode:: U+1D6C5 .. MATHEMATICAL BOLD SMALL DELTA +.. |b.epsi| unicode:: U+1D6C6 .. MATHEMATICAL BOLD SMALL EPSILON +.. |b.epsiv| unicode:: U+1D6DC .. MATHEMATICAL BOLD EPSILON SYMBOL +.. |b.eta| unicode:: U+1D6C8 .. MATHEMATICAL BOLD SMALL ETA +.. |b.Gamma| unicode:: U+1D6AA .. MATHEMATICAL BOLD CAPITAL GAMMA +.. |b.gamma| unicode:: U+1D6C4 .. MATHEMATICAL BOLD SMALL GAMMA +.. |b.Gammad| unicode:: U+003DC .. GREEK LETTER DIGAMMA +.. |b.gammad| unicode:: U+003DD .. GREEK SMALL LETTER DIGAMMA +.. |b.iota| unicode:: U+1D6CA .. MATHEMATICAL BOLD SMALL IOTA +.. |b.kappa| unicode:: U+1D6CB .. MATHEMATICAL BOLD SMALL KAPPA +.. |b.kappav| unicode:: U+1D6DE .. MATHEMATICAL BOLD KAPPA SYMBOL +.. |b.Lambda| unicode:: U+1D6B2 .. MATHEMATICAL BOLD CAPITAL LAMDA +.. |b.lambda| unicode:: U+1D6CC .. MATHEMATICAL BOLD SMALL LAMDA +.. |b.mu| unicode:: U+1D6CD .. MATHEMATICAL BOLD SMALL MU +.. |b.nu| unicode:: U+1D6CE .. MATHEMATICAL BOLD SMALL NU +.. |b.Omega| unicode:: U+1D6C0 .. MATHEMATICAL BOLD CAPITAL OMEGA +.. |b.omega| unicode:: U+1D6DA .. MATHEMATICAL BOLD SMALL OMEGA +.. |b.Phi| unicode:: U+1D6BD .. MATHEMATICAL BOLD CAPITAL PHI +.. |b.phi| unicode:: U+1D6D7 .. MATHEMATICAL BOLD SMALL PHI +.. |b.phiv| unicode:: U+1D6DF .. MATHEMATICAL BOLD PHI SYMBOL +.. |b.Pi| unicode:: U+1D6B7 .. MATHEMATICAL BOLD CAPITAL PI +.. |b.pi| unicode:: U+1D6D1 .. MATHEMATICAL BOLD SMALL PI +.. |b.piv| unicode:: U+1D6E1 .. MATHEMATICAL BOLD PI SYMBOL +.. |b.Psi| unicode:: U+1D6BF .. MATHEMATICAL BOLD CAPITAL PSI +.. |b.psi| unicode:: U+1D6D9 .. MATHEMATICAL BOLD SMALL PSI +.. |b.rho| unicode:: U+1D6D2 .. MATHEMATICAL BOLD SMALL RHO +.. |b.rhov| unicode:: U+1D6E0 .. MATHEMATICAL BOLD RHO SYMBOL +.. |b.Sigma| unicode:: U+1D6BA .. MATHEMATICAL BOLD CAPITAL SIGMA +.. |b.sigma| unicode:: U+1D6D4 .. MATHEMATICAL BOLD SMALL SIGMA +.. |b.sigmav| unicode:: U+1D6D3 .. MATHEMATICAL BOLD SMALL FINAL SIGMA +.. |b.tau| unicode:: U+1D6D5 .. MATHEMATICAL BOLD SMALL TAU +.. |b.Theta| unicode:: U+1D6AF .. MATHEMATICAL BOLD CAPITAL THETA +.. |b.thetas| unicode:: U+1D6C9 .. MATHEMATICAL BOLD SMALL THETA +.. |b.thetav| unicode:: U+1D6DD .. MATHEMATICAL BOLD THETA SYMBOL +.. |b.Upsi| unicode:: U+1D6BC .. MATHEMATICAL BOLD CAPITAL UPSILON +.. |b.upsi| unicode:: U+1D6D6 .. MATHEMATICAL BOLD SMALL UPSILON +.. |b.Xi| unicode:: U+1D6B5 .. MATHEMATICAL BOLD CAPITAL XI +.. |b.xi| unicode:: U+1D6CF .. MATHEMATICAL BOLD SMALL XI +.. |b.zeta| unicode:: U+1D6C7 .. MATHEMATICAL BOLD SMALL ZETA diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/isogrk4.txt --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/isogrk4.txt Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,8 @@ +.. This data file has been placed in the public domain. +.. Derived from the Unicode character mappings available from + . + Processed by unicode2rstsubs.py, part of Docutils: + . + +.. |b.Gammad| unicode:: U+003DC .. GREEK LETTER DIGAMMA +.. |b.gammad| unicode:: U+003DD .. GREEK SMALL LETTER DIGAMMA diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/isolat1.txt --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/isolat1.txt Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,68 @@ +.. This data file has been placed in the public domain. +.. Derived from the Unicode character mappings available from + . + Processed by unicode2rstsubs.py, part of Docutils: + . + +.. |Aacute| unicode:: U+000C1 .. LATIN CAPITAL LETTER A WITH ACUTE +.. |aacute| unicode:: U+000E1 .. LATIN SMALL LETTER A WITH ACUTE +.. |Acirc| unicode:: U+000C2 .. LATIN CAPITAL LETTER A WITH CIRCUMFLEX +.. |acirc| unicode:: U+000E2 .. LATIN SMALL LETTER A WITH CIRCUMFLEX +.. |AElig| unicode:: U+000C6 .. LATIN CAPITAL LETTER AE +.. |aelig| unicode:: U+000E6 .. LATIN SMALL LETTER AE +.. |Agrave| unicode:: U+000C0 .. LATIN CAPITAL LETTER A WITH GRAVE +.. |agrave| unicode:: U+000E0 .. LATIN SMALL LETTER A WITH GRAVE +.. |Aring| unicode:: U+000C5 .. LATIN CAPITAL LETTER A WITH RING ABOVE +.. |aring| unicode:: U+000E5 .. LATIN SMALL LETTER A WITH RING ABOVE +.. |Atilde| unicode:: U+000C3 .. LATIN CAPITAL LETTER A WITH TILDE +.. |atilde| unicode:: U+000E3 .. LATIN SMALL LETTER A WITH TILDE +.. |Auml| unicode:: U+000C4 .. LATIN CAPITAL LETTER A WITH DIAERESIS +.. |auml| unicode:: U+000E4 .. LATIN SMALL LETTER A WITH DIAERESIS +.. |Ccedil| unicode:: U+000C7 .. LATIN CAPITAL LETTER C WITH CEDILLA +.. |ccedil| unicode:: U+000E7 .. LATIN SMALL LETTER C WITH CEDILLA +.. |Eacute| unicode:: U+000C9 .. LATIN CAPITAL LETTER E WITH ACUTE +.. |eacute| unicode:: U+000E9 .. LATIN SMALL LETTER E WITH ACUTE +.. |Ecirc| unicode:: U+000CA .. LATIN CAPITAL LETTER E WITH CIRCUMFLEX +.. |ecirc| unicode:: U+000EA .. LATIN SMALL LETTER E WITH CIRCUMFLEX +.. |Egrave| unicode:: U+000C8 .. LATIN CAPITAL LETTER E WITH GRAVE +.. |egrave| unicode:: U+000E8 .. LATIN SMALL LETTER E WITH GRAVE +.. |ETH| unicode:: U+000D0 .. LATIN CAPITAL LETTER ETH +.. |eth| unicode:: U+000F0 .. LATIN SMALL LETTER ETH +.. |Euml| unicode:: U+000CB .. LATIN CAPITAL LETTER E WITH DIAERESIS +.. |euml| unicode:: U+000EB .. LATIN SMALL LETTER E WITH DIAERESIS +.. |Iacute| unicode:: U+000CD .. LATIN CAPITAL LETTER I WITH ACUTE +.. |iacute| unicode:: U+000ED .. LATIN SMALL LETTER I WITH ACUTE +.. |Icirc| unicode:: U+000CE .. LATIN CAPITAL LETTER I WITH CIRCUMFLEX +.. |icirc| unicode:: U+000EE .. LATIN SMALL LETTER I WITH CIRCUMFLEX +.. |Igrave| unicode:: U+000CC .. LATIN CAPITAL LETTER I WITH GRAVE +.. |igrave| unicode:: U+000EC .. LATIN SMALL LETTER I WITH GRAVE +.. |Iuml| unicode:: U+000CF .. LATIN CAPITAL LETTER I WITH DIAERESIS +.. |iuml| unicode:: U+000EF .. LATIN SMALL LETTER I WITH DIAERESIS +.. |Ntilde| unicode:: U+000D1 .. LATIN CAPITAL LETTER N WITH TILDE +.. |ntilde| unicode:: U+000F1 .. LATIN SMALL LETTER N WITH TILDE +.. |Oacute| unicode:: U+000D3 .. LATIN CAPITAL LETTER O WITH ACUTE +.. |oacute| unicode:: U+000F3 .. LATIN SMALL LETTER O WITH ACUTE +.. |Ocirc| unicode:: U+000D4 .. LATIN CAPITAL LETTER O WITH CIRCUMFLEX +.. |ocirc| unicode:: U+000F4 .. LATIN SMALL LETTER O WITH CIRCUMFLEX +.. |Ograve| unicode:: U+000D2 .. LATIN CAPITAL LETTER O WITH GRAVE +.. |ograve| unicode:: U+000F2 .. LATIN SMALL LETTER O WITH GRAVE +.. |Oslash| unicode:: U+000D8 .. LATIN CAPITAL LETTER O WITH STROKE +.. |oslash| unicode:: U+000F8 .. LATIN SMALL LETTER O WITH STROKE +.. |Otilde| unicode:: U+000D5 .. LATIN CAPITAL LETTER O WITH TILDE +.. |otilde| unicode:: U+000F5 .. LATIN SMALL LETTER O WITH TILDE +.. |Ouml| unicode:: U+000D6 .. LATIN CAPITAL LETTER O WITH DIAERESIS +.. |ouml| unicode:: U+000F6 .. LATIN SMALL LETTER O WITH DIAERESIS +.. |szlig| unicode:: U+000DF .. LATIN SMALL LETTER SHARP S +.. |THORN| unicode:: U+000DE .. LATIN CAPITAL LETTER THORN +.. |thorn| unicode:: U+000FE .. LATIN SMALL LETTER THORN +.. |Uacute| unicode:: U+000DA .. LATIN CAPITAL LETTER U WITH ACUTE +.. |uacute| unicode:: U+000FA .. LATIN SMALL LETTER U WITH ACUTE +.. |Ucirc| unicode:: U+000DB .. LATIN CAPITAL LETTER U WITH CIRCUMFLEX +.. |ucirc| unicode:: U+000FB .. LATIN SMALL LETTER U WITH CIRCUMFLEX +.. |Ugrave| unicode:: U+000D9 .. LATIN CAPITAL LETTER U WITH GRAVE +.. |ugrave| unicode:: U+000F9 .. LATIN SMALL LETTER U WITH GRAVE +.. |Uuml| unicode:: U+000DC .. LATIN CAPITAL LETTER U WITH DIAERESIS +.. |uuml| unicode:: U+000FC .. LATIN SMALL LETTER U WITH DIAERESIS +.. |Yacute| unicode:: U+000DD .. LATIN CAPITAL LETTER Y WITH ACUTE +.. |yacute| unicode:: U+000FD .. LATIN SMALL LETTER Y WITH ACUTE +.. |yuml| unicode:: U+000FF .. LATIN SMALL LETTER Y WITH DIAERESIS diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/isolat2.txt --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/isolat2.txt Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,128 @@ +.. This data file has been placed in the public domain. +.. Derived from the Unicode character mappings available from + . + Processed by unicode2rstsubs.py, part of Docutils: + . + +.. |Abreve| unicode:: U+00102 .. LATIN CAPITAL LETTER A WITH BREVE +.. |abreve| unicode:: U+00103 .. LATIN SMALL LETTER A WITH BREVE +.. |Amacr| unicode:: U+00100 .. LATIN CAPITAL LETTER A WITH MACRON +.. |amacr| unicode:: U+00101 .. LATIN SMALL LETTER A WITH MACRON +.. |Aogon| unicode:: U+00104 .. LATIN CAPITAL LETTER A WITH OGONEK +.. |aogon| unicode:: U+00105 .. LATIN SMALL LETTER A WITH OGONEK +.. |Cacute| unicode:: U+00106 .. LATIN CAPITAL LETTER C WITH ACUTE +.. |cacute| unicode:: U+00107 .. LATIN SMALL LETTER C WITH ACUTE +.. |Ccaron| unicode:: U+0010C .. LATIN CAPITAL LETTER C WITH CARON +.. |ccaron| unicode:: U+0010D .. LATIN SMALL LETTER C WITH CARON +.. |Ccirc| unicode:: U+00108 .. LATIN CAPITAL LETTER C WITH CIRCUMFLEX +.. |ccirc| unicode:: U+00109 .. LATIN SMALL LETTER C WITH CIRCUMFLEX +.. |Cdot| unicode:: U+0010A .. LATIN CAPITAL LETTER C WITH DOT ABOVE +.. |cdot| unicode:: U+0010B .. LATIN SMALL LETTER C WITH DOT ABOVE +.. |Dcaron| unicode:: U+0010E .. LATIN CAPITAL LETTER D WITH CARON +.. |dcaron| unicode:: U+0010F .. LATIN SMALL LETTER D WITH CARON +.. |Dstrok| unicode:: U+00110 .. LATIN CAPITAL LETTER D WITH STROKE +.. |dstrok| unicode:: U+00111 .. LATIN SMALL LETTER D WITH STROKE +.. |Ecaron| unicode:: U+0011A .. LATIN CAPITAL LETTER E WITH CARON +.. |ecaron| unicode:: U+0011B .. LATIN SMALL LETTER E WITH CARON +.. |Edot| unicode:: U+00116 .. LATIN CAPITAL LETTER E WITH DOT ABOVE +.. |edot| unicode:: U+00117 .. LATIN SMALL LETTER E WITH DOT ABOVE +.. |Emacr| unicode:: U+00112 .. LATIN CAPITAL LETTER E WITH MACRON +.. |emacr| unicode:: U+00113 .. LATIN SMALL LETTER E WITH MACRON +.. |ENG| unicode:: U+0014A .. LATIN CAPITAL LETTER ENG +.. |eng| unicode:: U+0014B .. LATIN SMALL LETTER ENG +.. |Eogon| unicode:: U+00118 .. LATIN CAPITAL LETTER E WITH OGONEK +.. |eogon| unicode:: U+00119 .. LATIN SMALL LETTER E WITH OGONEK +.. |gacute| unicode:: U+001F5 .. LATIN SMALL LETTER G WITH ACUTE +.. |Gbreve| unicode:: U+0011E .. LATIN CAPITAL LETTER G WITH BREVE +.. |gbreve| unicode:: U+0011F .. LATIN SMALL LETTER G WITH BREVE +.. |Gcedil| unicode:: U+00122 .. LATIN CAPITAL LETTER G WITH CEDILLA +.. |gcedil| unicode:: U+00123 .. LATIN SMALL LETTER G WITH CEDILLA +.. |Gcirc| unicode:: U+0011C .. LATIN CAPITAL LETTER G WITH CIRCUMFLEX +.. |gcirc| unicode:: U+0011D .. LATIN SMALL LETTER G WITH CIRCUMFLEX +.. |Gdot| unicode:: U+00120 .. LATIN CAPITAL LETTER G WITH DOT ABOVE +.. |gdot| unicode:: U+00121 .. LATIN SMALL LETTER G WITH DOT ABOVE +.. |Hcirc| unicode:: U+00124 .. LATIN CAPITAL LETTER H WITH CIRCUMFLEX +.. |hcirc| unicode:: U+00125 .. LATIN SMALL LETTER H WITH CIRCUMFLEX +.. |Hstrok| unicode:: U+00126 .. LATIN CAPITAL LETTER H WITH STROKE +.. |hstrok| unicode:: U+00127 .. LATIN SMALL LETTER H WITH STROKE +.. |Idot| unicode:: U+00130 .. LATIN CAPITAL LETTER I WITH DOT ABOVE +.. |IJlig| unicode:: U+00132 .. LATIN CAPITAL LIGATURE IJ +.. |ijlig| unicode:: U+00133 .. LATIN SMALL LIGATURE IJ +.. |Imacr| unicode:: U+0012A .. LATIN CAPITAL LETTER I WITH MACRON +.. |imacr| unicode:: U+0012B .. LATIN SMALL LETTER I WITH MACRON +.. |inodot| unicode:: U+00131 .. LATIN SMALL LETTER DOTLESS I +.. |Iogon| unicode:: U+0012E .. LATIN CAPITAL LETTER I WITH OGONEK +.. |iogon| unicode:: U+0012F .. LATIN SMALL LETTER I WITH OGONEK +.. |Itilde| unicode:: U+00128 .. LATIN CAPITAL LETTER I WITH TILDE +.. |itilde| unicode:: U+00129 .. LATIN SMALL LETTER I WITH TILDE +.. |Jcirc| unicode:: U+00134 .. LATIN CAPITAL LETTER J WITH CIRCUMFLEX +.. |jcirc| unicode:: U+00135 .. LATIN SMALL LETTER J WITH CIRCUMFLEX +.. |Kcedil| unicode:: U+00136 .. LATIN CAPITAL LETTER K WITH CEDILLA +.. |kcedil| unicode:: U+00137 .. LATIN SMALL LETTER K WITH CEDILLA +.. |kgreen| unicode:: U+00138 .. LATIN SMALL LETTER KRA +.. |Lacute| unicode:: U+00139 .. LATIN CAPITAL LETTER L WITH ACUTE +.. |lacute| unicode:: U+0013A .. LATIN SMALL LETTER L WITH ACUTE +.. |Lcaron| unicode:: U+0013D .. LATIN CAPITAL LETTER L WITH CARON +.. |lcaron| unicode:: U+0013E .. LATIN SMALL LETTER L WITH CARON +.. |Lcedil| unicode:: U+0013B .. LATIN CAPITAL LETTER L WITH CEDILLA +.. |lcedil| unicode:: U+0013C .. LATIN SMALL LETTER L WITH CEDILLA +.. |Lmidot| unicode:: U+0013F .. LATIN CAPITAL LETTER L WITH MIDDLE DOT +.. |lmidot| unicode:: U+00140 .. LATIN SMALL LETTER L WITH MIDDLE DOT +.. |Lstrok| unicode:: U+00141 .. LATIN CAPITAL LETTER L WITH STROKE +.. |lstrok| unicode:: U+00142 .. LATIN SMALL LETTER L WITH STROKE +.. |Nacute| unicode:: U+00143 .. LATIN CAPITAL LETTER N WITH ACUTE +.. |nacute| unicode:: U+00144 .. LATIN SMALL LETTER N WITH ACUTE +.. |napos| unicode:: U+00149 .. LATIN SMALL LETTER N PRECEDED BY APOSTROPHE +.. |Ncaron| unicode:: U+00147 .. LATIN CAPITAL LETTER N WITH CARON +.. |ncaron| unicode:: U+00148 .. LATIN SMALL LETTER N WITH CARON +.. |Ncedil| unicode:: U+00145 .. LATIN CAPITAL LETTER N WITH CEDILLA +.. |ncedil| unicode:: U+00146 .. LATIN SMALL LETTER N WITH CEDILLA +.. |Odblac| unicode:: U+00150 .. LATIN CAPITAL LETTER O WITH DOUBLE ACUTE +.. |odblac| unicode:: U+00151 .. LATIN SMALL LETTER O WITH DOUBLE ACUTE +.. |OElig| unicode:: U+00152 .. LATIN CAPITAL LIGATURE OE +.. |oelig| unicode:: U+00153 .. LATIN SMALL LIGATURE OE +.. |Omacr| unicode:: U+0014C .. LATIN CAPITAL LETTER O WITH MACRON +.. |omacr| unicode:: U+0014D .. LATIN SMALL LETTER O WITH MACRON +.. |Racute| unicode:: U+00154 .. LATIN CAPITAL LETTER R WITH ACUTE +.. |racute| unicode:: U+00155 .. LATIN SMALL LETTER R WITH ACUTE +.. |Rcaron| unicode:: U+00158 .. LATIN CAPITAL LETTER R WITH CARON +.. |rcaron| unicode:: U+00159 .. LATIN SMALL LETTER R WITH CARON +.. |Rcedil| unicode:: U+00156 .. LATIN CAPITAL LETTER R WITH CEDILLA +.. |rcedil| unicode:: U+00157 .. LATIN SMALL LETTER R WITH CEDILLA +.. |Sacute| unicode:: U+0015A .. LATIN CAPITAL LETTER S WITH ACUTE +.. |sacute| unicode:: U+0015B .. LATIN SMALL LETTER S WITH ACUTE +.. |Scaron| unicode:: U+00160 .. LATIN CAPITAL LETTER S WITH CARON +.. |scaron| unicode:: U+00161 .. LATIN SMALL LETTER S WITH CARON +.. |Scedil| unicode:: U+0015E .. LATIN CAPITAL LETTER S WITH CEDILLA +.. |scedil| unicode:: U+0015F .. LATIN SMALL LETTER S WITH CEDILLA +.. |Scirc| unicode:: U+0015C .. LATIN CAPITAL LETTER S WITH CIRCUMFLEX +.. |scirc| unicode:: U+0015D .. LATIN SMALL LETTER S WITH CIRCUMFLEX +.. |Tcaron| unicode:: U+00164 .. LATIN CAPITAL LETTER T WITH CARON +.. |tcaron| unicode:: U+00165 .. LATIN SMALL LETTER T WITH CARON +.. |Tcedil| unicode:: U+00162 .. LATIN CAPITAL LETTER T WITH CEDILLA +.. |tcedil| unicode:: U+00163 .. LATIN SMALL LETTER T WITH CEDILLA +.. |Tstrok| unicode:: U+00166 .. LATIN CAPITAL LETTER T WITH STROKE +.. |tstrok| unicode:: U+00167 .. LATIN SMALL LETTER T WITH STROKE +.. |Ubreve| unicode:: U+0016C .. LATIN CAPITAL LETTER U WITH BREVE +.. |ubreve| unicode:: U+0016D .. LATIN SMALL LETTER U WITH BREVE +.. |Udblac| unicode:: U+00170 .. LATIN CAPITAL LETTER U WITH DOUBLE ACUTE +.. |udblac| unicode:: U+00171 .. LATIN SMALL LETTER U WITH DOUBLE ACUTE +.. |Umacr| unicode:: U+0016A .. LATIN CAPITAL LETTER U WITH MACRON +.. |umacr| unicode:: U+0016B .. LATIN SMALL LETTER U WITH MACRON +.. |Uogon| unicode:: U+00172 .. LATIN CAPITAL LETTER U WITH OGONEK +.. |uogon| unicode:: U+00173 .. LATIN SMALL LETTER U WITH OGONEK +.. |Uring| unicode:: U+0016E .. LATIN CAPITAL LETTER U WITH RING ABOVE +.. |uring| unicode:: U+0016F .. LATIN SMALL LETTER U WITH RING ABOVE +.. |Utilde| unicode:: U+00168 .. LATIN CAPITAL LETTER U WITH TILDE +.. |utilde| unicode:: U+00169 .. LATIN SMALL LETTER U WITH TILDE +.. |Wcirc| unicode:: U+00174 .. LATIN CAPITAL LETTER W WITH CIRCUMFLEX +.. |wcirc| unicode:: U+00175 .. LATIN SMALL LETTER W WITH CIRCUMFLEX +.. |Ycirc| unicode:: U+00176 .. LATIN CAPITAL LETTER Y WITH CIRCUMFLEX +.. |ycirc| unicode:: U+00177 .. LATIN SMALL LETTER Y WITH CIRCUMFLEX +.. |Yuml| unicode:: U+00178 .. LATIN CAPITAL LETTER Y WITH DIAERESIS +.. |Zacute| unicode:: U+00179 .. LATIN CAPITAL LETTER Z WITH ACUTE +.. |zacute| unicode:: U+0017A .. LATIN SMALL LETTER Z WITH ACUTE +.. |Zcaron| unicode:: U+0017D .. LATIN CAPITAL LETTER Z WITH CARON +.. |zcaron| unicode:: U+0017E .. LATIN SMALL LETTER Z WITH CARON +.. |Zdot| unicode:: U+0017B .. LATIN CAPITAL LETTER Z WITH DOT ABOVE +.. |zdot| unicode:: U+0017C .. LATIN SMALL LETTER Z WITH DOT ABOVE diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/isomfrk-wide.txt --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/isomfrk-wide.txt Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,58 @@ +.. This data file has been placed in the public domain. +.. Derived from the Unicode character mappings available from + . + Processed by unicode2rstsubs.py, part of Docutils: + . + +.. |Afr| unicode:: U+1D504 .. MATHEMATICAL FRAKTUR CAPITAL A +.. |afr| unicode:: U+1D51E .. MATHEMATICAL FRAKTUR SMALL A +.. |Bfr| unicode:: U+1D505 .. MATHEMATICAL FRAKTUR CAPITAL B +.. |bfr| unicode:: U+1D51F .. MATHEMATICAL FRAKTUR SMALL B +.. |Cfr| unicode:: U+0212D .. BLACK-LETTER CAPITAL C +.. |cfr| unicode:: U+1D520 .. MATHEMATICAL FRAKTUR SMALL C +.. |Dfr| unicode:: U+1D507 .. MATHEMATICAL FRAKTUR CAPITAL D +.. |dfr| unicode:: U+1D521 .. MATHEMATICAL FRAKTUR SMALL D +.. |Efr| unicode:: U+1D508 .. MATHEMATICAL FRAKTUR CAPITAL E +.. |efr| unicode:: U+1D522 .. MATHEMATICAL FRAKTUR SMALL E +.. |Ffr| unicode:: U+1D509 .. MATHEMATICAL FRAKTUR CAPITAL F +.. |ffr| unicode:: U+1D523 .. MATHEMATICAL FRAKTUR SMALL F +.. |Gfr| unicode:: U+1D50A .. MATHEMATICAL FRAKTUR CAPITAL G +.. |gfr| unicode:: U+1D524 .. MATHEMATICAL FRAKTUR SMALL G +.. |Hfr| unicode:: U+0210C .. BLACK-LETTER CAPITAL H +.. |hfr| unicode:: U+1D525 .. MATHEMATICAL FRAKTUR SMALL H +.. |Ifr| unicode:: U+02111 .. BLACK-LETTER CAPITAL I +.. |ifr| unicode:: U+1D526 .. MATHEMATICAL FRAKTUR SMALL I +.. |Jfr| unicode:: U+1D50D .. MATHEMATICAL FRAKTUR CAPITAL J +.. |jfr| unicode:: U+1D527 .. MATHEMATICAL FRAKTUR SMALL J +.. |Kfr| unicode:: U+1D50E .. MATHEMATICAL FRAKTUR CAPITAL K +.. |kfr| unicode:: U+1D528 .. MATHEMATICAL FRAKTUR SMALL K +.. |Lfr| unicode:: U+1D50F .. MATHEMATICAL FRAKTUR CAPITAL L +.. |lfr| unicode:: U+1D529 .. MATHEMATICAL FRAKTUR SMALL L +.. |Mfr| unicode:: U+1D510 .. MATHEMATICAL FRAKTUR CAPITAL M +.. |mfr| unicode:: U+1D52A .. MATHEMATICAL FRAKTUR SMALL M +.. |Nfr| unicode:: U+1D511 .. MATHEMATICAL FRAKTUR CAPITAL N +.. |nfr| unicode:: U+1D52B .. MATHEMATICAL FRAKTUR SMALL N +.. |Ofr| unicode:: U+1D512 .. MATHEMATICAL FRAKTUR CAPITAL O +.. |ofr| unicode:: U+1D52C .. MATHEMATICAL FRAKTUR SMALL O +.. |Pfr| unicode:: U+1D513 .. MATHEMATICAL FRAKTUR CAPITAL P +.. |pfr| unicode:: U+1D52D .. MATHEMATICAL FRAKTUR SMALL P +.. |Qfr| unicode:: U+1D514 .. MATHEMATICAL FRAKTUR CAPITAL Q +.. |qfr| unicode:: U+1D52E .. MATHEMATICAL FRAKTUR SMALL Q +.. |Rfr| unicode:: U+0211C .. BLACK-LETTER CAPITAL R +.. |rfr| unicode:: U+1D52F .. MATHEMATICAL FRAKTUR SMALL R +.. |Sfr| unicode:: U+1D516 .. MATHEMATICAL FRAKTUR CAPITAL S +.. |sfr| unicode:: U+1D530 .. MATHEMATICAL FRAKTUR SMALL S +.. |Tfr| unicode:: U+1D517 .. MATHEMATICAL FRAKTUR CAPITAL T +.. |tfr| unicode:: U+1D531 .. MATHEMATICAL FRAKTUR SMALL T +.. |Ufr| unicode:: U+1D518 .. MATHEMATICAL FRAKTUR CAPITAL U +.. |ufr| unicode:: U+1D532 .. MATHEMATICAL FRAKTUR SMALL U +.. |Vfr| unicode:: U+1D519 .. MATHEMATICAL FRAKTUR CAPITAL V +.. |vfr| unicode:: U+1D533 .. MATHEMATICAL FRAKTUR SMALL V +.. |Wfr| unicode:: U+1D51A .. MATHEMATICAL FRAKTUR CAPITAL W +.. |wfr| unicode:: U+1D534 .. MATHEMATICAL FRAKTUR SMALL W +.. |Xfr| unicode:: U+1D51B .. MATHEMATICAL FRAKTUR CAPITAL X +.. |xfr| unicode:: U+1D535 .. MATHEMATICAL FRAKTUR SMALL X +.. |Yfr| unicode:: U+1D51C .. MATHEMATICAL FRAKTUR CAPITAL Y +.. |yfr| unicode:: U+1D536 .. MATHEMATICAL FRAKTUR SMALL Y +.. |Zfr| unicode:: U+02128 .. BLACK-LETTER CAPITAL Z +.. |zfr| unicode:: U+1D537 .. MATHEMATICAL FRAKTUR SMALL Z diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/isomfrk.txt --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/isomfrk.txt Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,11 @@ +.. This data file has been placed in the public domain. +.. Derived from the Unicode character mappings available from + . + Processed by unicode2rstsubs.py, part of Docutils: + . + +.. |Cfr| unicode:: U+0212D .. BLACK-LETTER CAPITAL C +.. |Hfr| unicode:: U+0210C .. BLACK-LETTER CAPITAL H +.. |Ifr| unicode:: U+02111 .. BLACK-LETTER CAPITAL I +.. |Rfr| unicode:: U+0211C .. BLACK-LETTER CAPITAL R +.. |Zfr| unicode:: U+02128 .. BLACK-LETTER CAPITAL Z diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/isomopf-wide.txt --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/isomopf-wide.txt Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,32 @@ +.. This data file has been placed in the public domain. +.. Derived from the Unicode character mappings available from + . + Processed by unicode2rstsubs.py, part of Docutils: + . + +.. |Aopf| unicode:: U+1D538 .. MATHEMATICAL DOUBLE-STRUCK CAPITAL A +.. |Bopf| unicode:: U+1D539 .. MATHEMATICAL DOUBLE-STRUCK CAPITAL B +.. |Copf| unicode:: U+02102 .. DOUBLE-STRUCK CAPITAL C +.. |Dopf| unicode:: U+1D53B .. MATHEMATICAL DOUBLE-STRUCK CAPITAL D +.. |Eopf| unicode:: U+1D53C .. MATHEMATICAL DOUBLE-STRUCK CAPITAL E +.. |Fopf| unicode:: U+1D53D .. MATHEMATICAL DOUBLE-STRUCK CAPITAL F +.. |Gopf| unicode:: U+1D53E .. MATHEMATICAL DOUBLE-STRUCK CAPITAL G +.. |Hopf| unicode:: U+0210D .. DOUBLE-STRUCK CAPITAL H +.. |Iopf| unicode:: U+1D540 .. MATHEMATICAL DOUBLE-STRUCK CAPITAL I +.. |Jopf| unicode:: U+1D541 .. MATHEMATICAL DOUBLE-STRUCK CAPITAL J +.. |Kopf| unicode:: U+1D542 .. MATHEMATICAL DOUBLE-STRUCK CAPITAL K +.. |Lopf| unicode:: U+1D543 .. MATHEMATICAL DOUBLE-STRUCK CAPITAL L +.. |Mopf| unicode:: U+1D544 .. MATHEMATICAL DOUBLE-STRUCK CAPITAL M +.. |Nopf| unicode:: U+02115 .. DOUBLE-STRUCK CAPITAL N +.. |Oopf| unicode:: U+1D546 .. MATHEMATICAL DOUBLE-STRUCK CAPITAL O +.. |Popf| unicode:: U+02119 .. DOUBLE-STRUCK CAPITAL P +.. |Qopf| unicode:: U+0211A .. DOUBLE-STRUCK CAPITAL Q +.. |Ropf| unicode:: U+0211D .. DOUBLE-STRUCK CAPITAL R +.. |Sopf| unicode:: U+1D54A .. MATHEMATICAL DOUBLE-STRUCK CAPITAL S +.. |Topf| unicode:: U+1D54B .. MATHEMATICAL DOUBLE-STRUCK CAPITAL T +.. |Uopf| unicode:: U+1D54C .. MATHEMATICAL DOUBLE-STRUCK CAPITAL U +.. |Vopf| unicode:: U+1D54D .. MATHEMATICAL DOUBLE-STRUCK CAPITAL V +.. |Wopf| unicode:: U+1D54E .. MATHEMATICAL DOUBLE-STRUCK CAPITAL W +.. |Xopf| unicode:: U+1D54F .. MATHEMATICAL DOUBLE-STRUCK CAPITAL X +.. |Yopf| unicode:: U+1D550 .. MATHEMATICAL DOUBLE-STRUCK CAPITAL Y +.. |Zopf| unicode:: U+02124 .. DOUBLE-STRUCK CAPITAL Z diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/isomopf.txt --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/isomopf.txt Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,13 @@ +.. This data file has been placed in the public domain. +.. Derived from the Unicode character mappings available from + . + Processed by unicode2rstsubs.py, part of Docutils: + . + +.. |Copf| unicode:: U+02102 .. DOUBLE-STRUCK CAPITAL C +.. |Hopf| unicode:: U+0210D .. DOUBLE-STRUCK CAPITAL H +.. |Nopf| unicode:: U+02115 .. DOUBLE-STRUCK CAPITAL N +.. |Popf| unicode:: U+02119 .. DOUBLE-STRUCK CAPITAL P +.. |Qopf| unicode:: U+0211A .. DOUBLE-STRUCK CAPITAL Q +.. |Ropf| unicode:: U+0211D .. DOUBLE-STRUCK CAPITAL R +.. |Zopf| unicode:: U+02124 .. DOUBLE-STRUCK CAPITAL Z diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/isomscr-wide.txt --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/isomscr-wide.txt Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,58 @@ +.. This data file has been placed in the public domain. +.. Derived from the Unicode character mappings available from + . + Processed by unicode2rstsubs.py, part of Docutils: + . + +.. |Ascr| unicode:: U+1D49C .. MATHEMATICAL SCRIPT CAPITAL A +.. |ascr| unicode:: U+1D4B6 .. MATHEMATICAL SCRIPT SMALL A +.. |Bscr| unicode:: U+0212C .. SCRIPT CAPITAL B +.. |bscr| unicode:: U+1D4B7 .. MATHEMATICAL SCRIPT SMALL B +.. |Cscr| unicode:: U+1D49E .. MATHEMATICAL SCRIPT CAPITAL C +.. |cscr| unicode:: U+1D4B8 .. MATHEMATICAL SCRIPT SMALL C +.. |Dscr| unicode:: U+1D49F .. MATHEMATICAL SCRIPT CAPITAL D +.. |dscr| unicode:: U+1D4B9 .. MATHEMATICAL SCRIPT SMALL D +.. |Escr| unicode:: U+02130 .. SCRIPT CAPITAL E +.. |escr| unicode:: U+0212F .. SCRIPT SMALL E +.. |Fscr| unicode:: U+02131 .. SCRIPT CAPITAL F +.. |fscr| unicode:: U+1D4BB .. MATHEMATICAL SCRIPT SMALL F +.. |Gscr| unicode:: U+1D4A2 .. MATHEMATICAL SCRIPT CAPITAL G +.. |gscr| unicode:: U+0210A .. SCRIPT SMALL G +.. |Hscr| unicode:: U+0210B .. SCRIPT CAPITAL H +.. |hscr| unicode:: U+1D4BD .. MATHEMATICAL SCRIPT SMALL H +.. |Iscr| unicode:: U+02110 .. SCRIPT CAPITAL I +.. |iscr| unicode:: U+1D4BE .. MATHEMATICAL SCRIPT SMALL I +.. |Jscr| unicode:: U+1D4A5 .. MATHEMATICAL SCRIPT CAPITAL J +.. |jscr| unicode:: U+1D4BF .. MATHEMATICAL SCRIPT SMALL J +.. |Kscr| unicode:: U+1D4A6 .. MATHEMATICAL SCRIPT CAPITAL K +.. |kscr| unicode:: U+1D4C0 .. MATHEMATICAL SCRIPT SMALL K +.. |Lscr| unicode:: U+02112 .. SCRIPT CAPITAL L +.. |lscr| unicode:: U+1D4C1 .. MATHEMATICAL SCRIPT SMALL L +.. |Mscr| unicode:: U+02133 .. SCRIPT CAPITAL M +.. |mscr| unicode:: U+1D4C2 .. MATHEMATICAL SCRIPT SMALL M +.. |Nscr| unicode:: U+1D4A9 .. MATHEMATICAL SCRIPT CAPITAL N +.. |nscr| unicode:: U+1D4C3 .. MATHEMATICAL SCRIPT SMALL N +.. |Oscr| unicode:: U+1D4AA .. MATHEMATICAL SCRIPT CAPITAL O +.. |oscr| unicode:: U+02134 .. SCRIPT SMALL O +.. |Pscr| unicode:: U+1D4AB .. MATHEMATICAL SCRIPT CAPITAL P +.. |pscr| unicode:: U+1D4C5 .. MATHEMATICAL SCRIPT SMALL P +.. |Qscr| unicode:: U+1D4AC .. MATHEMATICAL SCRIPT CAPITAL Q +.. |qscr| unicode:: U+1D4C6 .. MATHEMATICAL SCRIPT SMALL Q +.. |Rscr| unicode:: U+0211B .. SCRIPT CAPITAL R +.. |rscr| unicode:: U+1D4C7 .. MATHEMATICAL SCRIPT SMALL R +.. |Sscr| unicode:: U+1D4AE .. MATHEMATICAL SCRIPT CAPITAL S +.. |sscr| unicode:: U+1D4C8 .. MATHEMATICAL SCRIPT SMALL S +.. |Tscr| unicode:: U+1D4AF .. MATHEMATICAL SCRIPT CAPITAL T +.. |tscr| unicode:: U+1D4C9 .. MATHEMATICAL SCRIPT SMALL T +.. |Uscr| unicode:: U+1D4B0 .. MATHEMATICAL SCRIPT CAPITAL U +.. |uscr| unicode:: U+1D4CA .. MATHEMATICAL SCRIPT SMALL U +.. |Vscr| unicode:: U+1D4B1 .. MATHEMATICAL SCRIPT CAPITAL V +.. |vscr| unicode:: U+1D4CB .. MATHEMATICAL SCRIPT SMALL V +.. |Wscr| unicode:: U+1D4B2 .. MATHEMATICAL SCRIPT CAPITAL W +.. |wscr| unicode:: U+1D4CC .. MATHEMATICAL SCRIPT SMALL W +.. |Xscr| unicode:: U+1D4B3 .. MATHEMATICAL SCRIPT CAPITAL X +.. |xscr| unicode:: U+1D4CD .. MATHEMATICAL SCRIPT SMALL X +.. |Yscr| unicode:: U+1D4B4 .. MATHEMATICAL SCRIPT CAPITAL Y +.. |yscr| unicode:: U+1D4CE .. MATHEMATICAL SCRIPT SMALL Y +.. |Zscr| unicode:: U+1D4B5 .. MATHEMATICAL SCRIPT CAPITAL Z +.. |zscr| unicode:: U+1D4CF .. MATHEMATICAL SCRIPT SMALL Z diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/isomscr.txt --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/isomscr.txt Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,17 @@ +.. This data file has been placed in the public domain. +.. Derived from the Unicode character mappings available from + . + Processed by unicode2rstsubs.py, part of Docutils: + . + +.. |Bscr| unicode:: U+0212C .. SCRIPT CAPITAL B +.. |Escr| unicode:: U+02130 .. SCRIPT CAPITAL E +.. |escr| unicode:: U+0212F .. SCRIPT SMALL E +.. |Fscr| unicode:: U+02131 .. SCRIPT CAPITAL F +.. |gscr| unicode:: U+0210A .. SCRIPT SMALL G +.. |Hscr| unicode:: U+0210B .. SCRIPT CAPITAL H +.. |Iscr| unicode:: U+02110 .. SCRIPT CAPITAL I +.. |Lscr| unicode:: U+02112 .. SCRIPT CAPITAL L +.. |Mscr| unicode:: U+02133 .. SCRIPT CAPITAL M +.. |oscr| unicode:: U+02134 .. SCRIPT SMALL O +.. |Rscr| unicode:: U+0211B .. SCRIPT CAPITAL R diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/isonum.txt --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/isonum.txt Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,82 @@ +.. This data file has been placed in the public domain. +.. Derived from the Unicode character mappings available from + . + Processed by unicode2rstsubs.py, part of Docutils: + . + +.. |amp| unicode:: U+00026 .. AMPERSAND +.. |apos| unicode:: U+00027 .. APOSTROPHE +.. |ast| unicode:: U+0002A .. ASTERISK +.. |brvbar| unicode:: U+000A6 .. BROKEN BAR +.. |bsol| unicode:: U+0005C .. REVERSE SOLIDUS +.. |cent| unicode:: U+000A2 .. CENT SIGN +.. |colon| unicode:: U+0003A .. COLON +.. |comma| unicode:: U+0002C .. COMMA +.. |commat| unicode:: U+00040 .. COMMERCIAL AT +.. |copy| unicode:: U+000A9 .. COPYRIGHT SIGN +.. |curren| unicode:: U+000A4 .. CURRENCY SIGN +.. |darr| unicode:: U+02193 .. DOWNWARDS ARROW +.. |deg| unicode:: U+000B0 .. DEGREE SIGN +.. |divide| unicode:: U+000F7 .. DIVISION SIGN +.. |dollar| unicode:: U+00024 .. DOLLAR SIGN +.. |equals| unicode:: U+0003D .. EQUALS SIGN +.. |excl| unicode:: U+00021 .. EXCLAMATION MARK +.. |frac12| unicode:: U+000BD .. VULGAR FRACTION ONE HALF +.. |frac14| unicode:: U+000BC .. VULGAR FRACTION ONE QUARTER +.. |frac18| unicode:: U+0215B .. VULGAR FRACTION ONE EIGHTH +.. |frac34| unicode:: U+000BE .. VULGAR FRACTION THREE QUARTERS +.. |frac38| unicode:: U+0215C .. VULGAR FRACTION THREE EIGHTHS +.. |frac58| unicode:: U+0215D .. VULGAR FRACTION FIVE EIGHTHS +.. |frac78| unicode:: U+0215E .. VULGAR FRACTION SEVEN EIGHTHS +.. |gt| unicode:: U+0003E .. GREATER-THAN SIGN +.. |half| unicode:: U+000BD .. VULGAR FRACTION ONE HALF +.. |horbar| unicode:: U+02015 .. HORIZONTAL BAR +.. |hyphen| unicode:: U+02010 .. HYPHEN +.. |iexcl| unicode:: U+000A1 .. INVERTED EXCLAMATION MARK +.. |iquest| unicode:: U+000BF .. INVERTED QUESTION MARK +.. |laquo| unicode:: U+000AB .. LEFT-POINTING DOUBLE ANGLE QUOTATION MARK +.. |larr| unicode:: U+02190 .. LEFTWARDS ARROW +.. |lcub| unicode:: U+0007B .. LEFT CURLY BRACKET +.. |ldquo| unicode:: U+0201C .. LEFT DOUBLE QUOTATION MARK +.. |lowbar| unicode:: U+0005F .. LOW LINE +.. |lpar| unicode:: U+00028 .. LEFT PARENTHESIS +.. |lsqb| unicode:: U+0005B .. LEFT SQUARE BRACKET +.. |lsquo| unicode:: U+02018 .. LEFT SINGLE QUOTATION MARK +.. |lt| unicode:: U+0003C .. LESS-THAN SIGN +.. |micro| unicode:: U+000B5 .. MICRO SIGN +.. |middot| unicode:: U+000B7 .. MIDDLE DOT +.. |nbsp| unicode:: U+000A0 .. NO-BREAK SPACE +.. |not| unicode:: U+000AC .. NOT SIGN +.. |num| unicode:: U+00023 .. NUMBER SIGN +.. |ohm| unicode:: U+02126 .. OHM SIGN +.. |ordf| unicode:: U+000AA .. FEMININE ORDINAL INDICATOR +.. |ordm| unicode:: U+000BA .. MASCULINE ORDINAL INDICATOR +.. |para| unicode:: U+000B6 .. PILCROW SIGN +.. |percnt| unicode:: U+00025 .. PERCENT SIGN +.. |period| unicode:: U+0002E .. FULL STOP +.. |plus| unicode:: U+0002B .. PLUS SIGN +.. |plusmn| unicode:: U+000B1 .. PLUS-MINUS SIGN +.. |pound| unicode:: U+000A3 .. POUND SIGN +.. |quest| unicode:: U+0003F .. QUESTION MARK +.. |quot| unicode:: U+00022 .. QUOTATION MARK +.. |raquo| unicode:: U+000BB .. RIGHT-POINTING DOUBLE ANGLE QUOTATION MARK +.. |rarr| unicode:: U+02192 .. RIGHTWARDS ARROW +.. |rcub| unicode:: U+0007D .. RIGHT CURLY BRACKET +.. |rdquo| unicode:: U+0201D .. RIGHT DOUBLE QUOTATION MARK +.. |reg| unicode:: U+000AE .. REGISTERED SIGN +.. |rpar| unicode:: U+00029 .. RIGHT PARENTHESIS +.. |rsqb| unicode:: U+0005D .. RIGHT SQUARE BRACKET +.. |rsquo| unicode:: U+02019 .. RIGHT SINGLE QUOTATION MARK +.. |sect| unicode:: U+000A7 .. SECTION SIGN +.. |semi| unicode:: U+0003B .. SEMICOLON +.. |shy| unicode:: U+000AD .. SOFT HYPHEN +.. |sol| unicode:: U+0002F .. SOLIDUS +.. |sung| unicode:: U+0266A .. EIGHTH NOTE +.. |sup1| unicode:: U+000B9 .. SUPERSCRIPT ONE +.. |sup2| unicode:: U+000B2 .. SUPERSCRIPT TWO +.. |sup3| unicode:: U+000B3 .. SUPERSCRIPT THREE +.. |times| unicode:: U+000D7 .. MULTIPLICATION SIGN +.. |trade| unicode:: U+02122 .. TRADE MARK SIGN +.. |uarr| unicode:: U+02191 .. UPWARDS ARROW +.. |verbar| unicode:: U+0007C .. VERTICAL LINE +.. |yen| unicode:: U+000A5 .. YEN SIGN diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/isopub.txt --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/isopub.txt Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,90 @@ +.. This data file has been placed in the public domain. +.. Derived from the Unicode character mappings available from + . + Processed by unicode2rstsubs.py, part of Docutils: + . + +.. |blank| unicode:: U+02423 .. OPEN BOX +.. |blk12| unicode:: U+02592 .. MEDIUM SHADE +.. |blk14| unicode:: U+02591 .. LIGHT SHADE +.. |blk34| unicode:: U+02593 .. DARK SHADE +.. |block| unicode:: U+02588 .. FULL BLOCK +.. |bull| unicode:: U+02022 .. BULLET +.. |caret| unicode:: U+02041 .. CARET INSERTION POINT +.. |check| unicode:: U+02713 .. CHECK MARK +.. |cir| unicode:: U+025CB .. WHITE CIRCLE +.. |clubs| unicode:: U+02663 .. BLACK CLUB SUIT +.. |copysr| unicode:: U+02117 .. SOUND RECORDING COPYRIGHT +.. |cross| unicode:: U+02717 .. BALLOT X +.. |Dagger| unicode:: U+02021 .. DOUBLE DAGGER +.. |dagger| unicode:: U+02020 .. DAGGER +.. |dash| unicode:: U+02010 .. HYPHEN +.. |diams| unicode:: U+02666 .. BLACK DIAMOND SUIT +.. |dlcrop| unicode:: U+0230D .. BOTTOM LEFT CROP +.. |drcrop| unicode:: U+0230C .. BOTTOM RIGHT CROP +.. |dtri| unicode:: U+025BF .. WHITE DOWN-POINTING SMALL TRIANGLE +.. |dtrif| unicode:: U+025BE .. BLACK DOWN-POINTING SMALL TRIANGLE +.. |emsp| unicode:: U+02003 .. EM SPACE +.. |emsp13| unicode:: U+02004 .. THREE-PER-EM SPACE +.. |emsp14| unicode:: U+02005 .. FOUR-PER-EM SPACE +.. |ensp| unicode:: U+02002 .. EN SPACE +.. |female| unicode:: U+02640 .. FEMALE SIGN +.. |ffilig| unicode:: U+0FB03 .. LATIN SMALL LIGATURE FFI +.. |fflig| unicode:: U+0FB00 .. LATIN SMALL LIGATURE FF +.. |ffllig| unicode:: U+0FB04 .. LATIN SMALL LIGATURE FFL +.. |filig| unicode:: U+0FB01 .. LATIN SMALL LIGATURE FI +.. |flat| unicode:: U+0266D .. MUSIC FLAT SIGN +.. |fllig| unicode:: U+0FB02 .. LATIN SMALL LIGATURE FL +.. |frac13| unicode:: U+02153 .. VULGAR FRACTION ONE THIRD +.. |frac15| unicode:: U+02155 .. VULGAR FRACTION ONE FIFTH +.. |frac16| unicode:: U+02159 .. VULGAR FRACTION ONE SIXTH +.. |frac23| unicode:: U+02154 .. VULGAR FRACTION TWO THIRDS +.. |frac25| unicode:: U+02156 .. VULGAR FRACTION TWO FIFTHS +.. |frac35| unicode:: U+02157 .. VULGAR FRACTION THREE FIFTHS +.. |frac45| unicode:: U+02158 .. VULGAR FRACTION FOUR FIFTHS +.. |frac56| unicode:: U+0215A .. VULGAR FRACTION FIVE SIXTHS +.. |hairsp| unicode:: U+0200A .. HAIR SPACE +.. |hearts| unicode:: U+02665 .. BLACK HEART SUIT +.. |hellip| unicode:: U+02026 .. HORIZONTAL ELLIPSIS +.. |hybull| unicode:: U+02043 .. HYPHEN BULLET +.. |incare| unicode:: U+02105 .. CARE OF +.. |ldquor| unicode:: U+0201E .. DOUBLE LOW-9 QUOTATION MARK +.. |lhblk| unicode:: U+02584 .. LOWER HALF BLOCK +.. |loz| unicode:: U+025CA .. LOZENGE +.. |lozf| unicode:: U+029EB .. BLACK LOZENGE +.. |lsquor| unicode:: U+0201A .. SINGLE LOW-9 QUOTATION MARK +.. |ltri| unicode:: U+025C3 .. WHITE LEFT-POINTING SMALL TRIANGLE +.. |ltrif| unicode:: U+025C2 .. BLACK LEFT-POINTING SMALL TRIANGLE +.. |male| unicode:: U+02642 .. MALE SIGN +.. |malt| unicode:: U+02720 .. MALTESE CROSS +.. |marker| unicode:: U+025AE .. BLACK VERTICAL RECTANGLE +.. |mdash| unicode:: U+02014 .. EM DASH +.. |mldr| unicode:: U+02026 .. HORIZONTAL ELLIPSIS +.. |natur| unicode:: U+0266E .. MUSIC NATURAL SIGN +.. |ndash| unicode:: U+02013 .. EN DASH +.. |nldr| unicode:: U+02025 .. TWO DOT LEADER +.. |numsp| unicode:: U+02007 .. FIGURE SPACE +.. |phone| unicode:: U+0260E .. BLACK TELEPHONE +.. |puncsp| unicode:: U+02008 .. PUNCTUATION SPACE +.. |rdquor| unicode:: U+0201D .. RIGHT DOUBLE QUOTATION MARK +.. |rect| unicode:: U+025AD .. WHITE RECTANGLE +.. |rsquor| unicode:: U+02019 .. RIGHT SINGLE QUOTATION MARK +.. |rtri| unicode:: U+025B9 .. WHITE RIGHT-POINTING SMALL TRIANGLE +.. |rtrif| unicode:: U+025B8 .. BLACK RIGHT-POINTING SMALL TRIANGLE +.. |rx| unicode:: U+0211E .. PRESCRIPTION TAKE +.. |sext| unicode:: U+02736 .. SIX POINTED BLACK STAR +.. |sharp| unicode:: U+0266F .. MUSIC SHARP SIGN +.. |spades| unicode:: U+02660 .. BLACK SPADE SUIT +.. |squ| unicode:: U+025A1 .. WHITE SQUARE +.. |squf| unicode:: U+025AA .. BLACK SMALL SQUARE +.. |star| unicode:: U+02606 .. WHITE STAR +.. |starf| unicode:: U+02605 .. BLACK STAR +.. |target| unicode:: U+02316 .. POSITION INDICATOR +.. |telrec| unicode:: U+02315 .. TELEPHONE RECORDER +.. |thinsp| unicode:: U+02009 .. THIN SPACE +.. |uhblk| unicode:: U+02580 .. UPPER HALF BLOCK +.. |ulcrop| unicode:: U+0230F .. TOP LEFT CROP +.. |urcrop| unicode:: U+0230E .. TOP RIGHT CROP +.. |utri| unicode:: U+025B5 .. WHITE UP-POINTING SMALL TRIANGLE +.. |utrif| unicode:: U+025B4 .. BLACK UP-POINTING SMALL TRIANGLE +.. |vellip| unicode:: U+022EE .. VERTICAL ELLIPSIS diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/isotech.txt --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/isotech.txt Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,168 @@ +.. This data file has been placed in the public domain. +.. Derived from the Unicode character mappings available from + . + Processed by unicode2rstsubs.py, part of Docutils: + . + +.. |acd| unicode:: U+0223F .. SINE WAVE +.. |aleph| unicode:: U+02135 .. ALEF SYMBOL +.. |And| unicode:: U+02A53 .. DOUBLE LOGICAL AND +.. |and| unicode:: U+02227 .. LOGICAL AND +.. |andand| unicode:: U+02A55 .. TWO INTERSECTING LOGICAL AND +.. |andd| unicode:: U+02A5C .. LOGICAL AND WITH HORIZONTAL DASH +.. |andslope| unicode:: U+02A58 .. SLOPING LARGE AND +.. |andv| unicode:: U+02A5A .. LOGICAL AND WITH MIDDLE STEM +.. |ang90| unicode:: U+0221F .. RIGHT ANGLE +.. |angrt| unicode:: U+0221F .. RIGHT ANGLE +.. |angsph| unicode:: U+02222 .. SPHERICAL ANGLE +.. |angst| unicode:: U+0212B .. ANGSTROM SIGN +.. |ap| unicode:: U+02248 .. ALMOST EQUAL TO +.. |apacir| unicode:: U+02A6F .. ALMOST EQUAL TO WITH CIRCUMFLEX ACCENT +.. |awconint| unicode:: U+02233 .. ANTICLOCKWISE CONTOUR INTEGRAL +.. |awint| unicode:: U+02A11 .. ANTICLOCKWISE INTEGRATION +.. |becaus| unicode:: U+02235 .. BECAUSE +.. |bernou| unicode:: U+0212C .. SCRIPT CAPITAL B +.. |bne| unicode:: U+0003D U+020E5 .. EQUALS SIGN with reverse slash +.. |bnequiv| unicode:: U+02261 U+020E5 .. IDENTICAL TO with reverse slash +.. |bNot| unicode:: U+02AED .. REVERSED DOUBLE STROKE NOT SIGN +.. |bnot| unicode:: U+02310 .. REVERSED NOT SIGN +.. |bottom| unicode:: U+022A5 .. UP TACK +.. |cap| unicode:: U+02229 .. INTERSECTION +.. |Cconint| unicode:: U+02230 .. VOLUME INTEGRAL +.. |cirfnint| unicode:: U+02A10 .. CIRCULATION FUNCTION +.. |compfn| unicode:: U+02218 .. RING OPERATOR +.. |cong| unicode:: U+02245 .. APPROXIMATELY EQUAL TO +.. |Conint| unicode:: U+0222F .. SURFACE INTEGRAL +.. |conint| unicode:: U+0222E .. CONTOUR INTEGRAL +.. |ctdot| unicode:: U+022EF .. MIDLINE HORIZONTAL ELLIPSIS +.. |cup| unicode:: U+0222A .. UNION +.. |cwconint| unicode:: U+02232 .. CLOCKWISE CONTOUR INTEGRAL +.. |cwint| unicode:: U+02231 .. CLOCKWISE INTEGRAL +.. |cylcty| unicode:: U+0232D .. CYLINDRICITY +.. |disin| unicode:: U+022F2 .. ELEMENT OF WITH LONG HORIZONTAL STROKE +.. |Dot| unicode:: U+000A8 .. DIAERESIS +.. |DotDot| unicode:: U+020DC .. COMBINING FOUR DOTS ABOVE +.. |dsol| unicode:: U+029F6 .. SOLIDUS WITH OVERBAR +.. |dtdot| unicode:: U+022F1 .. DOWN RIGHT DIAGONAL ELLIPSIS +.. |dwangle| unicode:: U+029A6 .. OBLIQUE ANGLE OPENING UP +.. |elinters| unicode:: U+0FFFD .. REPLACEMENT CHARACTER +.. |epar| unicode:: U+022D5 .. EQUAL AND PARALLEL TO +.. |eparsl| unicode:: U+029E3 .. EQUALS SIGN AND SLANTED PARALLEL +.. |equiv| unicode:: U+02261 .. IDENTICAL TO +.. |eqvparsl| unicode:: U+029E5 .. IDENTICAL TO AND SLANTED PARALLEL +.. |exist| unicode:: U+02203 .. THERE EXISTS +.. |fltns| unicode:: U+025B1 .. WHITE PARALLELOGRAM +.. |fnof| unicode:: U+00192 .. LATIN SMALL LETTER F WITH HOOK +.. |forall| unicode:: U+02200 .. FOR ALL +.. |fpartint| unicode:: U+02A0D .. FINITE PART INTEGRAL +.. |ge| unicode:: U+02265 .. GREATER-THAN OR EQUAL TO +.. |hamilt| unicode:: U+0210B .. SCRIPT CAPITAL H +.. |iff| unicode:: U+021D4 .. LEFT RIGHT DOUBLE ARROW +.. |iinfin| unicode:: U+029DC .. INCOMPLETE INFINITY +.. |imped| unicode:: U+001B5 .. LATIN CAPITAL LETTER Z WITH STROKE +.. |infin| unicode:: U+0221E .. INFINITY +.. |infintie| unicode:: U+029DD .. TIE OVER INFINITY +.. |Int| unicode:: U+0222C .. DOUBLE INTEGRAL +.. |int| unicode:: U+0222B .. INTEGRAL +.. |intlarhk| unicode:: U+02A17 .. INTEGRAL WITH LEFTWARDS ARROW WITH HOOK +.. |isin| unicode:: U+02208 .. ELEMENT OF +.. |isindot| unicode:: U+022F5 .. ELEMENT OF WITH DOT ABOVE +.. |isinE| unicode:: U+022F9 .. ELEMENT OF WITH TWO HORIZONTAL STROKES +.. |isins| unicode:: U+022F4 .. SMALL ELEMENT OF WITH VERTICAL BAR AT END OF HORIZONTAL STROKE +.. |isinsv| unicode:: U+022F3 .. ELEMENT OF WITH VERTICAL BAR AT END OF HORIZONTAL STROKE +.. |isinv| unicode:: U+02208 .. ELEMENT OF +.. |lagran| unicode:: U+02112 .. SCRIPT CAPITAL L +.. |Lang| unicode:: U+0300A .. LEFT DOUBLE ANGLE BRACKET +.. |lang| unicode:: U+02329 .. LEFT-POINTING ANGLE BRACKET +.. |lArr| unicode:: U+021D0 .. LEFTWARDS DOUBLE ARROW +.. |lbbrk| unicode:: U+03014 .. LEFT TORTOISE SHELL BRACKET +.. |le| unicode:: U+02264 .. LESS-THAN OR EQUAL TO +.. |loang| unicode:: U+03018 .. LEFT WHITE TORTOISE SHELL BRACKET +.. |lobrk| unicode:: U+0301A .. LEFT WHITE SQUARE BRACKET +.. |lopar| unicode:: U+02985 .. LEFT WHITE PARENTHESIS +.. |lowast| unicode:: U+02217 .. ASTERISK OPERATOR +.. |minus| unicode:: U+02212 .. MINUS SIGN +.. |mnplus| unicode:: U+02213 .. MINUS-OR-PLUS SIGN +.. |nabla| unicode:: U+02207 .. NABLA +.. |ne| unicode:: U+02260 .. NOT EQUAL TO +.. |nedot| unicode:: U+02250 U+00338 .. APPROACHES THE LIMIT with slash +.. |nhpar| unicode:: U+02AF2 .. PARALLEL WITH HORIZONTAL STROKE +.. |ni| unicode:: U+0220B .. CONTAINS AS MEMBER +.. |nis| unicode:: U+022FC .. SMALL CONTAINS WITH VERTICAL BAR AT END OF HORIZONTAL STROKE +.. |nisd| unicode:: U+022FA .. CONTAINS WITH LONG HORIZONTAL STROKE +.. |niv| unicode:: U+0220B .. CONTAINS AS MEMBER +.. |Not| unicode:: U+02AEC .. DOUBLE STROKE NOT SIGN +.. |notin| unicode:: U+02209 .. NOT AN ELEMENT OF +.. |notindot| unicode:: U+022F5 U+00338 .. ELEMENT OF WITH DOT ABOVE with slash +.. |notinE| unicode:: U+022F9 U+00338 .. ELEMENT OF WITH TWO HORIZONTAL STROKES with slash +.. |notinva| unicode:: U+02209 .. NOT AN ELEMENT OF +.. |notinvb| unicode:: U+022F7 .. SMALL ELEMENT OF WITH OVERBAR +.. |notinvc| unicode:: U+022F6 .. ELEMENT OF WITH OVERBAR +.. |notni| unicode:: U+0220C .. DOES NOT CONTAIN AS MEMBER +.. |notniva| unicode:: U+0220C .. DOES NOT CONTAIN AS MEMBER +.. |notnivb| unicode:: U+022FE .. SMALL CONTAINS WITH OVERBAR +.. |notnivc| unicode:: U+022FD .. CONTAINS WITH OVERBAR +.. |nparsl| unicode:: U+02AFD U+020E5 .. DOUBLE SOLIDUS OPERATOR with reverse slash +.. |npart| unicode:: U+02202 U+00338 .. PARTIAL DIFFERENTIAL with slash +.. |npolint| unicode:: U+02A14 .. LINE INTEGRATION NOT INCLUDING THE POLE +.. |nvinfin| unicode:: U+029DE .. INFINITY NEGATED WITH VERTICAL BAR +.. |olcross| unicode:: U+029BB .. CIRCLE WITH SUPERIMPOSED X +.. |Or| unicode:: U+02A54 .. DOUBLE LOGICAL OR +.. |or| unicode:: U+02228 .. LOGICAL OR +.. |ord| unicode:: U+02A5D .. LOGICAL OR WITH HORIZONTAL DASH +.. |order| unicode:: U+02134 .. SCRIPT SMALL O +.. |oror| unicode:: U+02A56 .. TWO INTERSECTING LOGICAL OR +.. |orslope| unicode:: U+02A57 .. SLOPING LARGE OR +.. |orv| unicode:: U+02A5B .. LOGICAL OR WITH MIDDLE STEM +.. |par| unicode:: U+02225 .. PARALLEL TO +.. |parsl| unicode:: U+02AFD .. DOUBLE SOLIDUS OPERATOR +.. |part| unicode:: U+02202 .. PARTIAL DIFFERENTIAL +.. |permil| unicode:: U+02030 .. PER MILLE SIGN +.. |perp| unicode:: U+022A5 .. UP TACK +.. |pertenk| unicode:: U+02031 .. PER TEN THOUSAND SIGN +.. |phmmat| unicode:: U+02133 .. SCRIPT CAPITAL M +.. |pointint| unicode:: U+02A15 .. INTEGRAL AROUND A POINT OPERATOR +.. |Prime| unicode:: U+02033 .. DOUBLE PRIME +.. |prime| unicode:: U+02032 .. PRIME +.. |profalar| unicode:: U+0232E .. ALL AROUND-PROFILE +.. |profline| unicode:: U+02312 .. ARC +.. |profsurf| unicode:: U+02313 .. SEGMENT +.. |prop| unicode:: U+0221D .. PROPORTIONAL TO +.. |qint| unicode:: U+02A0C .. QUADRUPLE INTEGRAL OPERATOR +.. |qprime| unicode:: U+02057 .. QUADRUPLE PRIME +.. |quatint| unicode:: U+02A16 .. QUATERNION INTEGRAL OPERATOR +.. |radic| unicode:: U+0221A .. SQUARE ROOT +.. |Rang| unicode:: U+0300B .. RIGHT DOUBLE ANGLE BRACKET +.. |rang| unicode:: U+0232A .. RIGHT-POINTING ANGLE BRACKET +.. |rArr| unicode:: U+021D2 .. RIGHTWARDS DOUBLE ARROW +.. |rbbrk| unicode:: U+03015 .. RIGHT TORTOISE SHELL BRACKET +.. |roang| unicode:: U+03019 .. RIGHT WHITE TORTOISE SHELL BRACKET +.. |robrk| unicode:: U+0301B .. RIGHT WHITE SQUARE BRACKET +.. |ropar| unicode:: U+02986 .. RIGHT WHITE PARENTHESIS +.. |rppolint| unicode:: U+02A12 .. LINE INTEGRATION WITH RECTANGULAR PATH AROUND POLE +.. |scpolint| unicode:: U+02A13 .. LINE INTEGRATION WITH SEMICIRCULAR PATH AROUND POLE +.. |sim| unicode:: U+0223C .. TILDE OPERATOR +.. |simdot| unicode:: U+02A6A .. TILDE OPERATOR WITH DOT ABOVE +.. |sime| unicode:: U+02243 .. ASYMPTOTICALLY EQUAL TO +.. |smeparsl| unicode:: U+029E4 .. EQUALS SIGN AND SLANTED PARALLEL WITH TILDE ABOVE +.. |square| unicode:: U+025A1 .. WHITE SQUARE +.. |squarf| unicode:: U+025AA .. BLACK SMALL SQUARE +.. |strns| unicode:: U+000AF .. MACRON +.. |sub| unicode:: U+02282 .. SUBSET OF +.. |sube| unicode:: U+02286 .. SUBSET OF OR EQUAL TO +.. |sup| unicode:: U+02283 .. SUPERSET OF +.. |supe| unicode:: U+02287 .. SUPERSET OF OR EQUAL TO +.. |tdot| unicode:: U+020DB .. COMBINING THREE DOTS ABOVE +.. |there4| unicode:: U+02234 .. THEREFORE +.. |tint| unicode:: U+0222D .. TRIPLE INTEGRAL +.. |top| unicode:: U+022A4 .. DOWN TACK +.. |topbot| unicode:: U+02336 .. APL FUNCTIONAL SYMBOL I-BEAM +.. |topcir| unicode:: U+02AF1 .. DOWN TACK WITH CIRCLE BELOW +.. |tprime| unicode:: U+02034 .. TRIPLE PRIME +.. |utdot| unicode:: U+022F0 .. UP RIGHT DIAGONAL ELLIPSIS +.. |uwangle| unicode:: U+029A7 .. OBLIQUE ANGLE OPENING DOWN +.. |vangrt| unicode:: U+0299C .. RIGHT ANGLE VARIANT WITH SQUARE +.. |veeeq| unicode:: U+0225A .. EQUIANGULAR TO +.. |Verbar| unicode:: U+02016 .. DOUBLE VERTICAL LINE +.. |wedgeq| unicode:: U+02259 .. ESTIMATES +.. |xnis| unicode:: U+022FB .. CONTAINS WITH VERTICAL BAR AT END OF HORIZONTAL STROKE diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/mmlalias.txt --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/mmlalias.txt Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,554 @@ +.. This data file has been placed in the public domain. +.. Derived from the Unicode character mappings available from + . + Processed by unicode2rstsubs.py, part of Docutils: + . + +.. |angle| unicode:: U+02220 .. ANGLE +.. |ApplyFunction| unicode:: U+02061 .. FUNCTION APPLICATION +.. |approx| unicode:: U+02248 .. ALMOST EQUAL TO +.. |approxeq| unicode:: U+0224A .. ALMOST EQUAL OR EQUAL TO +.. |Assign| unicode:: U+02254 .. COLON EQUALS +.. |backcong| unicode:: U+0224C .. ALL EQUAL TO +.. |backepsilon| unicode:: U+003F6 .. GREEK REVERSED LUNATE EPSILON SYMBOL +.. |backprime| unicode:: U+02035 .. REVERSED PRIME +.. |backsim| unicode:: U+0223D .. REVERSED TILDE +.. |backsimeq| unicode:: U+022CD .. REVERSED TILDE EQUALS +.. |Backslash| unicode:: U+02216 .. SET MINUS +.. |barwedge| unicode:: U+02305 .. PROJECTIVE +.. |Because| unicode:: U+02235 .. BECAUSE +.. |because| unicode:: U+02235 .. BECAUSE +.. |Bernoullis| unicode:: U+0212C .. SCRIPT CAPITAL B +.. |between| unicode:: U+0226C .. BETWEEN +.. |bigcap| unicode:: U+022C2 .. N-ARY INTERSECTION +.. |bigcirc| unicode:: U+025EF .. LARGE CIRCLE +.. |bigcup| unicode:: U+022C3 .. N-ARY UNION +.. |bigodot| unicode:: U+02A00 .. N-ARY CIRCLED DOT OPERATOR +.. |bigoplus| unicode:: U+02A01 .. N-ARY CIRCLED PLUS OPERATOR +.. |bigotimes| unicode:: U+02A02 .. N-ARY CIRCLED TIMES OPERATOR +.. |bigsqcup| unicode:: U+02A06 .. N-ARY SQUARE UNION OPERATOR +.. |bigstar| unicode:: U+02605 .. BLACK STAR +.. |bigtriangledown| unicode:: U+025BD .. WHITE DOWN-POINTING TRIANGLE +.. |bigtriangleup| unicode:: U+025B3 .. WHITE UP-POINTING TRIANGLE +.. |biguplus| unicode:: U+02A04 .. N-ARY UNION OPERATOR WITH PLUS +.. |bigvee| unicode:: U+022C1 .. N-ARY LOGICAL OR +.. |bigwedge| unicode:: U+022C0 .. N-ARY LOGICAL AND +.. |bkarow| unicode:: U+0290D .. RIGHTWARDS DOUBLE DASH ARROW +.. |blacklozenge| unicode:: U+029EB .. BLACK LOZENGE +.. |blacksquare| unicode:: U+025AA .. BLACK SMALL SQUARE +.. |blacktriangle| unicode:: U+025B4 .. BLACK UP-POINTING SMALL TRIANGLE +.. |blacktriangledown| unicode:: U+025BE .. BLACK DOWN-POINTING SMALL TRIANGLE +.. |blacktriangleleft| unicode:: U+025C2 .. BLACK LEFT-POINTING SMALL TRIANGLE +.. |blacktriangleright| unicode:: U+025B8 .. BLACK RIGHT-POINTING SMALL TRIANGLE +.. |bot| unicode:: U+022A5 .. UP TACK +.. |boxminus| unicode:: U+0229F .. SQUARED MINUS +.. |boxplus| unicode:: U+0229E .. SQUARED PLUS +.. |boxtimes| unicode:: U+022A0 .. SQUARED TIMES +.. |Breve| unicode:: U+002D8 .. BREVE +.. |bullet| unicode:: U+02022 .. BULLET +.. |Bumpeq| unicode:: U+0224E .. GEOMETRICALLY EQUIVALENT TO +.. |bumpeq| unicode:: U+0224F .. DIFFERENCE BETWEEN +.. |CapitalDifferentialD| unicode:: U+02145 .. DOUBLE-STRUCK ITALIC CAPITAL D +.. |Cayleys| unicode:: U+0212D .. BLACK-LETTER CAPITAL C +.. |Cedilla| unicode:: U+000B8 .. CEDILLA +.. |CenterDot| unicode:: U+000B7 .. MIDDLE DOT +.. |centerdot| unicode:: U+000B7 .. MIDDLE DOT +.. |checkmark| unicode:: U+02713 .. CHECK MARK +.. |circeq| unicode:: U+02257 .. RING EQUAL TO +.. |circlearrowleft| unicode:: U+021BA .. ANTICLOCKWISE OPEN CIRCLE ARROW +.. |circlearrowright| unicode:: U+021BB .. CLOCKWISE OPEN CIRCLE ARROW +.. |circledast| unicode:: U+0229B .. CIRCLED ASTERISK OPERATOR +.. |circledcirc| unicode:: U+0229A .. CIRCLED RING OPERATOR +.. |circleddash| unicode:: U+0229D .. CIRCLED DASH +.. |CircleDot| unicode:: U+02299 .. CIRCLED DOT OPERATOR +.. |circledR| unicode:: U+000AE .. REGISTERED SIGN +.. |circledS| unicode:: U+024C8 .. CIRCLED LATIN CAPITAL LETTER S +.. |CircleMinus| unicode:: U+02296 .. CIRCLED MINUS +.. |CirclePlus| unicode:: U+02295 .. CIRCLED PLUS +.. |CircleTimes| unicode:: U+02297 .. CIRCLED TIMES +.. |ClockwiseContourIntegral| unicode:: U+02232 .. CLOCKWISE CONTOUR INTEGRAL +.. |CloseCurlyDoubleQuote| unicode:: U+0201D .. RIGHT DOUBLE QUOTATION MARK +.. |CloseCurlyQuote| unicode:: U+02019 .. RIGHT SINGLE QUOTATION MARK +.. |clubsuit| unicode:: U+02663 .. BLACK CLUB SUIT +.. |coloneq| unicode:: U+02254 .. COLON EQUALS +.. |complement| unicode:: U+02201 .. COMPLEMENT +.. |complexes| unicode:: U+02102 .. DOUBLE-STRUCK CAPITAL C +.. |Congruent| unicode:: U+02261 .. IDENTICAL TO +.. |ContourIntegral| unicode:: U+0222E .. CONTOUR INTEGRAL +.. |Coproduct| unicode:: U+02210 .. N-ARY COPRODUCT +.. |CounterClockwiseContourIntegral| unicode:: U+02233 .. ANTICLOCKWISE CONTOUR INTEGRAL +.. |CupCap| unicode:: U+0224D .. EQUIVALENT TO +.. |curlyeqprec| unicode:: U+022DE .. EQUAL TO OR PRECEDES +.. |curlyeqsucc| unicode:: U+022DF .. EQUAL TO OR SUCCEEDS +.. |curlyvee| unicode:: U+022CE .. CURLY LOGICAL OR +.. |curlywedge| unicode:: U+022CF .. CURLY LOGICAL AND +.. |curvearrowleft| unicode:: U+021B6 .. ANTICLOCKWISE TOP SEMICIRCLE ARROW +.. |curvearrowright| unicode:: U+021B7 .. CLOCKWISE TOP SEMICIRCLE ARROW +.. |dbkarow| unicode:: U+0290F .. RIGHTWARDS TRIPLE DASH ARROW +.. |ddagger| unicode:: U+02021 .. DOUBLE DAGGER +.. |ddotseq| unicode:: U+02A77 .. EQUALS SIGN WITH TWO DOTS ABOVE AND TWO DOTS BELOW +.. |Del| unicode:: U+02207 .. NABLA +.. |DiacriticalAcute| unicode:: U+000B4 .. ACUTE ACCENT +.. |DiacriticalDot| unicode:: U+002D9 .. DOT ABOVE +.. |DiacriticalDoubleAcute| unicode:: U+002DD .. DOUBLE ACUTE ACCENT +.. |DiacriticalGrave| unicode:: U+00060 .. GRAVE ACCENT +.. |DiacriticalTilde| unicode:: U+002DC .. SMALL TILDE +.. |Diamond| unicode:: U+022C4 .. DIAMOND OPERATOR +.. |diamond| unicode:: U+022C4 .. DIAMOND OPERATOR +.. |diamondsuit| unicode:: U+02666 .. BLACK DIAMOND SUIT +.. |DifferentialD| unicode:: U+02146 .. DOUBLE-STRUCK ITALIC SMALL D +.. |digamma| unicode:: U+003DD .. GREEK SMALL LETTER DIGAMMA +.. |div| unicode:: U+000F7 .. DIVISION SIGN +.. |divideontimes| unicode:: U+022C7 .. DIVISION TIMES +.. |doteq| unicode:: U+02250 .. APPROACHES THE LIMIT +.. |doteqdot| unicode:: U+02251 .. GEOMETRICALLY EQUAL TO +.. |DotEqual| unicode:: U+02250 .. APPROACHES THE LIMIT +.. |dotminus| unicode:: U+02238 .. DOT MINUS +.. |dotplus| unicode:: U+02214 .. DOT PLUS +.. |dotsquare| unicode:: U+022A1 .. SQUARED DOT OPERATOR +.. |doublebarwedge| unicode:: U+02306 .. PERSPECTIVE +.. |DoubleContourIntegral| unicode:: U+0222F .. SURFACE INTEGRAL +.. |DoubleDot| unicode:: U+000A8 .. DIAERESIS +.. |DoubleDownArrow| unicode:: U+021D3 .. DOWNWARDS DOUBLE ARROW +.. |DoubleLeftArrow| unicode:: U+021D0 .. LEFTWARDS DOUBLE ARROW +.. |DoubleLeftRightArrow| unicode:: U+021D4 .. LEFT RIGHT DOUBLE ARROW +.. |DoubleLeftTee| unicode:: U+02AE4 .. VERTICAL BAR DOUBLE LEFT TURNSTILE +.. |DoubleLongLeftArrow| unicode:: U+027F8 .. LONG LEFTWARDS DOUBLE ARROW +.. |DoubleLongLeftRightArrow| unicode:: U+027FA .. LONG LEFT RIGHT DOUBLE ARROW +.. |DoubleLongRightArrow| unicode:: U+027F9 .. LONG RIGHTWARDS DOUBLE ARROW +.. |DoubleRightArrow| unicode:: U+021D2 .. RIGHTWARDS DOUBLE ARROW +.. |DoubleRightTee| unicode:: U+022A8 .. TRUE +.. |DoubleUpArrow| unicode:: U+021D1 .. UPWARDS DOUBLE ARROW +.. |DoubleUpDownArrow| unicode:: U+021D5 .. UP DOWN DOUBLE ARROW +.. |DoubleVerticalBar| unicode:: U+02225 .. PARALLEL TO +.. |DownArrow| unicode:: U+02193 .. DOWNWARDS ARROW +.. |Downarrow| unicode:: U+021D3 .. DOWNWARDS DOUBLE ARROW +.. |downarrow| unicode:: U+02193 .. DOWNWARDS ARROW +.. |DownArrowUpArrow| unicode:: U+021F5 .. DOWNWARDS ARROW LEFTWARDS OF UPWARDS ARROW +.. |downdownarrows| unicode:: U+021CA .. DOWNWARDS PAIRED ARROWS +.. |downharpoonleft| unicode:: U+021C3 .. DOWNWARDS HARPOON WITH BARB LEFTWARDS +.. |downharpoonright| unicode:: U+021C2 .. DOWNWARDS HARPOON WITH BARB RIGHTWARDS +.. |DownLeftVector| unicode:: U+021BD .. LEFTWARDS HARPOON WITH BARB DOWNWARDS +.. |DownRightVector| unicode:: U+021C1 .. RIGHTWARDS HARPOON WITH BARB DOWNWARDS +.. |DownTee| unicode:: U+022A4 .. DOWN TACK +.. |DownTeeArrow| unicode:: U+021A7 .. DOWNWARDS ARROW FROM BAR +.. |drbkarow| unicode:: U+02910 .. RIGHTWARDS TWO-HEADED TRIPLE DASH ARROW +.. |Element| unicode:: U+02208 .. ELEMENT OF +.. |emptyset| unicode:: U+02205 .. EMPTY SET +.. |eqcirc| unicode:: U+02256 .. RING IN EQUAL TO +.. |eqcolon| unicode:: U+02255 .. EQUALS COLON +.. |eqsim| unicode:: U+02242 .. MINUS TILDE +.. |eqslantgtr| unicode:: U+02A96 .. SLANTED EQUAL TO OR GREATER-THAN +.. |eqslantless| unicode:: U+02A95 .. SLANTED EQUAL TO OR LESS-THAN +.. |EqualTilde| unicode:: U+02242 .. MINUS TILDE +.. |Equilibrium| unicode:: U+021CC .. RIGHTWARDS HARPOON OVER LEFTWARDS HARPOON +.. |Exists| unicode:: U+02203 .. THERE EXISTS +.. |expectation| unicode:: U+02130 .. SCRIPT CAPITAL E +.. |ExponentialE| unicode:: U+02147 .. DOUBLE-STRUCK ITALIC SMALL E +.. |exponentiale| unicode:: U+02147 .. DOUBLE-STRUCK ITALIC SMALL E +.. |fallingdotseq| unicode:: U+02252 .. APPROXIMATELY EQUAL TO OR THE IMAGE OF +.. |ForAll| unicode:: U+02200 .. FOR ALL +.. |Fouriertrf| unicode:: U+02131 .. SCRIPT CAPITAL F +.. |geq| unicode:: U+02265 .. GREATER-THAN OR EQUAL TO +.. |geqq| unicode:: U+02267 .. GREATER-THAN OVER EQUAL TO +.. |geqslant| unicode:: U+02A7E .. GREATER-THAN OR SLANTED EQUAL TO +.. |gg| unicode:: U+0226B .. MUCH GREATER-THAN +.. |ggg| unicode:: U+022D9 .. VERY MUCH GREATER-THAN +.. |gnapprox| unicode:: U+02A8A .. GREATER-THAN AND NOT APPROXIMATE +.. |gneq| unicode:: U+02A88 .. GREATER-THAN AND SINGLE-LINE NOT EQUAL TO +.. |gneqq| unicode:: U+02269 .. GREATER-THAN BUT NOT EQUAL TO +.. |GreaterEqual| unicode:: U+02265 .. GREATER-THAN OR EQUAL TO +.. |GreaterEqualLess| unicode:: U+022DB .. GREATER-THAN EQUAL TO OR LESS-THAN +.. |GreaterFullEqual| unicode:: U+02267 .. GREATER-THAN OVER EQUAL TO +.. |GreaterLess| unicode:: U+02277 .. GREATER-THAN OR LESS-THAN +.. |GreaterSlantEqual| unicode:: U+02A7E .. GREATER-THAN OR SLANTED EQUAL TO +.. |GreaterTilde| unicode:: U+02273 .. GREATER-THAN OR EQUIVALENT TO +.. |gtrapprox| unicode:: U+02A86 .. GREATER-THAN OR APPROXIMATE +.. |gtrdot| unicode:: U+022D7 .. GREATER-THAN WITH DOT +.. |gtreqless| unicode:: U+022DB .. GREATER-THAN EQUAL TO OR LESS-THAN +.. |gtreqqless| unicode:: U+02A8C .. GREATER-THAN ABOVE DOUBLE-LINE EQUAL ABOVE LESS-THAN +.. |gtrless| unicode:: U+02277 .. GREATER-THAN OR LESS-THAN +.. |gtrsim| unicode:: U+02273 .. GREATER-THAN OR EQUIVALENT TO +.. |gvertneqq| unicode:: U+02269 U+0FE00 .. GREATER-THAN BUT NOT EQUAL TO - with vertical stroke +.. |Hacek| unicode:: U+002C7 .. CARON +.. |hbar| unicode:: U+0210F .. PLANCK CONSTANT OVER TWO PI +.. |heartsuit| unicode:: U+02665 .. BLACK HEART SUIT +.. |HilbertSpace| unicode:: U+0210B .. SCRIPT CAPITAL H +.. |hksearow| unicode:: U+02925 .. SOUTH EAST ARROW WITH HOOK +.. |hkswarow| unicode:: U+02926 .. SOUTH WEST ARROW WITH HOOK +.. |hookleftarrow| unicode:: U+021A9 .. LEFTWARDS ARROW WITH HOOK +.. |hookrightarrow| unicode:: U+021AA .. RIGHTWARDS ARROW WITH HOOK +.. |hslash| unicode:: U+0210F .. PLANCK CONSTANT OVER TWO PI +.. |HumpDownHump| unicode:: U+0224E .. GEOMETRICALLY EQUIVALENT TO +.. |HumpEqual| unicode:: U+0224F .. DIFFERENCE BETWEEN +.. |iiiint| unicode:: U+02A0C .. QUADRUPLE INTEGRAL OPERATOR +.. |iiint| unicode:: U+0222D .. TRIPLE INTEGRAL +.. |Im| unicode:: U+02111 .. BLACK-LETTER CAPITAL I +.. |ImaginaryI| unicode:: U+02148 .. DOUBLE-STRUCK ITALIC SMALL I +.. |imagline| unicode:: U+02110 .. SCRIPT CAPITAL I +.. |imagpart| unicode:: U+02111 .. BLACK-LETTER CAPITAL I +.. |Implies| unicode:: U+021D2 .. RIGHTWARDS DOUBLE ARROW +.. |in| unicode:: U+02208 .. ELEMENT OF +.. |integers| unicode:: U+02124 .. DOUBLE-STRUCK CAPITAL Z +.. |Integral| unicode:: U+0222B .. INTEGRAL +.. |intercal| unicode:: U+022BA .. INTERCALATE +.. |Intersection| unicode:: U+022C2 .. N-ARY INTERSECTION +.. |intprod| unicode:: U+02A3C .. INTERIOR PRODUCT +.. |InvisibleComma| unicode:: U+02063 .. INVISIBLE SEPARATOR +.. |InvisibleTimes| unicode:: U+02062 .. INVISIBLE TIMES +.. |langle| unicode:: U+02329 .. LEFT-POINTING ANGLE BRACKET +.. |Laplacetrf| unicode:: U+02112 .. SCRIPT CAPITAL L +.. |lbrace| unicode:: U+0007B .. LEFT CURLY BRACKET +.. |lbrack| unicode:: U+0005B .. LEFT SQUARE BRACKET +.. |LeftAngleBracket| unicode:: U+02329 .. LEFT-POINTING ANGLE BRACKET +.. |LeftArrow| unicode:: U+02190 .. LEFTWARDS ARROW +.. |Leftarrow| unicode:: U+021D0 .. LEFTWARDS DOUBLE ARROW +.. |leftarrow| unicode:: U+02190 .. LEFTWARDS ARROW +.. |LeftArrowBar| unicode:: U+021E4 .. LEFTWARDS ARROW TO BAR +.. |LeftArrowRightArrow| unicode:: U+021C6 .. LEFTWARDS ARROW OVER RIGHTWARDS ARROW +.. |leftarrowtail| unicode:: U+021A2 .. LEFTWARDS ARROW WITH TAIL +.. |LeftCeiling| unicode:: U+02308 .. LEFT CEILING +.. |LeftDoubleBracket| unicode:: U+0301A .. LEFT WHITE SQUARE BRACKET +.. |LeftDownVector| unicode:: U+021C3 .. DOWNWARDS HARPOON WITH BARB LEFTWARDS +.. |LeftFloor| unicode:: U+0230A .. LEFT FLOOR +.. |leftharpoondown| unicode:: U+021BD .. LEFTWARDS HARPOON WITH BARB DOWNWARDS +.. |leftharpoonup| unicode:: U+021BC .. LEFTWARDS HARPOON WITH BARB UPWARDS +.. |leftleftarrows| unicode:: U+021C7 .. LEFTWARDS PAIRED ARROWS +.. |LeftRightArrow| unicode:: U+02194 .. LEFT RIGHT ARROW +.. |Leftrightarrow| unicode:: U+021D4 .. LEFT RIGHT DOUBLE ARROW +.. |leftrightarrow| unicode:: U+02194 .. LEFT RIGHT ARROW +.. |leftrightarrows| unicode:: U+021C6 .. LEFTWARDS ARROW OVER RIGHTWARDS ARROW +.. |leftrightharpoons| unicode:: U+021CB .. LEFTWARDS HARPOON OVER RIGHTWARDS HARPOON +.. |leftrightsquigarrow| unicode:: U+021AD .. LEFT RIGHT WAVE ARROW +.. |LeftTee| unicode:: U+022A3 .. LEFT TACK +.. |LeftTeeArrow| unicode:: U+021A4 .. LEFTWARDS ARROW FROM BAR +.. |leftthreetimes| unicode:: U+022CB .. LEFT SEMIDIRECT PRODUCT +.. |LeftTriangle| unicode:: U+022B2 .. NORMAL SUBGROUP OF +.. |LeftTriangleEqual| unicode:: U+022B4 .. NORMAL SUBGROUP OF OR EQUAL TO +.. |LeftUpVector| unicode:: U+021BF .. UPWARDS HARPOON WITH BARB LEFTWARDS +.. |LeftVector| unicode:: U+021BC .. LEFTWARDS HARPOON WITH BARB UPWARDS +.. |leq| unicode:: U+02264 .. LESS-THAN OR EQUAL TO +.. |leqq| unicode:: U+02266 .. LESS-THAN OVER EQUAL TO +.. |leqslant| unicode:: U+02A7D .. LESS-THAN OR SLANTED EQUAL TO +.. |lessapprox| unicode:: U+02A85 .. LESS-THAN OR APPROXIMATE +.. |lessdot| unicode:: U+022D6 .. LESS-THAN WITH DOT +.. |lesseqgtr| unicode:: U+022DA .. LESS-THAN EQUAL TO OR GREATER-THAN +.. |lesseqqgtr| unicode:: U+02A8B .. LESS-THAN ABOVE DOUBLE-LINE EQUAL ABOVE GREATER-THAN +.. |LessEqualGreater| unicode:: U+022DA .. LESS-THAN EQUAL TO OR GREATER-THAN +.. |LessFullEqual| unicode:: U+02266 .. LESS-THAN OVER EQUAL TO +.. |LessGreater| unicode:: U+02276 .. LESS-THAN OR GREATER-THAN +.. |lessgtr| unicode:: U+02276 .. LESS-THAN OR GREATER-THAN +.. |lesssim| unicode:: U+02272 .. LESS-THAN OR EQUIVALENT TO +.. |LessSlantEqual| unicode:: U+02A7D .. LESS-THAN OR SLANTED EQUAL TO +.. |LessTilde| unicode:: U+02272 .. LESS-THAN OR EQUIVALENT TO +.. |ll| unicode:: U+0226A .. MUCH LESS-THAN +.. |llcorner| unicode:: U+0231E .. BOTTOM LEFT CORNER +.. |Lleftarrow| unicode:: U+021DA .. LEFTWARDS TRIPLE ARROW +.. |lmoustache| unicode:: U+023B0 .. UPPER LEFT OR LOWER RIGHT CURLY BRACKET SECTION +.. |lnapprox| unicode:: U+02A89 .. LESS-THAN AND NOT APPROXIMATE +.. |lneq| unicode:: U+02A87 .. LESS-THAN AND SINGLE-LINE NOT EQUAL TO +.. |lneqq| unicode:: U+02268 .. LESS-THAN BUT NOT EQUAL TO +.. |LongLeftArrow| unicode:: U+027F5 .. LONG LEFTWARDS ARROW +.. |Longleftarrow| unicode:: U+027F8 .. LONG LEFTWARDS DOUBLE ARROW +.. |longleftarrow| unicode:: U+027F5 .. LONG LEFTWARDS ARROW +.. |LongLeftRightArrow| unicode:: U+027F7 .. LONG LEFT RIGHT ARROW +.. |Longleftrightarrow| unicode:: U+027FA .. LONG LEFT RIGHT DOUBLE ARROW +.. |longleftrightarrow| unicode:: U+027F7 .. LONG LEFT RIGHT ARROW +.. |longmapsto| unicode:: U+027FC .. LONG RIGHTWARDS ARROW FROM BAR +.. |LongRightArrow| unicode:: U+027F6 .. LONG RIGHTWARDS ARROW +.. |Longrightarrow| unicode:: U+027F9 .. LONG RIGHTWARDS DOUBLE ARROW +.. |longrightarrow| unicode:: U+027F6 .. LONG RIGHTWARDS ARROW +.. |looparrowleft| unicode:: U+021AB .. LEFTWARDS ARROW WITH LOOP +.. |looparrowright| unicode:: U+021AC .. RIGHTWARDS ARROW WITH LOOP +.. |LowerLeftArrow| unicode:: U+02199 .. SOUTH WEST ARROW +.. |LowerRightArrow| unicode:: U+02198 .. SOUTH EAST ARROW +.. |lozenge| unicode:: U+025CA .. LOZENGE +.. |lrcorner| unicode:: U+0231F .. BOTTOM RIGHT CORNER +.. |Lsh| unicode:: U+021B0 .. UPWARDS ARROW WITH TIP LEFTWARDS +.. |lvertneqq| unicode:: U+02268 U+0FE00 .. LESS-THAN BUT NOT EQUAL TO - with vertical stroke +.. |maltese| unicode:: U+02720 .. MALTESE CROSS +.. |mapsto| unicode:: U+021A6 .. RIGHTWARDS ARROW FROM BAR +.. |measuredangle| unicode:: U+02221 .. MEASURED ANGLE +.. |Mellintrf| unicode:: U+02133 .. SCRIPT CAPITAL M +.. |MinusPlus| unicode:: U+02213 .. MINUS-OR-PLUS SIGN +.. |mp| unicode:: U+02213 .. MINUS-OR-PLUS SIGN +.. |multimap| unicode:: U+022B8 .. MULTIMAP +.. |napprox| unicode:: U+02249 .. NOT ALMOST EQUAL TO +.. |natural| unicode:: U+0266E .. MUSIC NATURAL SIGN +.. |naturals| unicode:: U+02115 .. DOUBLE-STRUCK CAPITAL N +.. |nearrow| unicode:: U+02197 .. NORTH EAST ARROW +.. |NegativeMediumSpace| unicode:: U+0200B .. ZERO WIDTH SPACE +.. |NegativeThickSpace| unicode:: U+0200B .. ZERO WIDTH SPACE +.. |NegativeThinSpace| unicode:: U+0200B .. ZERO WIDTH SPACE +.. |NegativeVeryThinSpace| unicode:: U+0200B .. ZERO WIDTH SPACE +.. |NestedGreaterGreater| unicode:: U+0226B .. MUCH GREATER-THAN +.. |NestedLessLess| unicode:: U+0226A .. MUCH LESS-THAN +.. |nexists| unicode:: U+02204 .. THERE DOES NOT EXIST +.. |ngeq| unicode:: U+02271 .. NEITHER GREATER-THAN NOR EQUAL TO +.. |ngeqq| unicode:: U+02267 U+00338 .. GREATER-THAN OVER EQUAL TO with slash +.. |ngeqslant| unicode:: U+02A7E U+00338 .. GREATER-THAN OR SLANTED EQUAL TO with slash +.. |ngtr| unicode:: U+0226F .. NOT GREATER-THAN +.. |nLeftarrow| unicode:: U+021CD .. LEFTWARDS DOUBLE ARROW WITH STROKE +.. |nleftarrow| unicode:: U+0219A .. LEFTWARDS ARROW WITH STROKE +.. |nLeftrightarrow| unicode:: U+021CE .. LEFT RIGHT DOUBLE ARROW WITH STROKE +.. |nleftrightarrow| unicode:: U+021AE .. LEFT RIGHT ARROW WITH STROKE +.. |nleq| unicode:: U+02270 .. NEITHER LESS-THAN NOR EQUAL TO +.. |nleqq| unicode:: U+02266 U+00338 .. LESS-THAN OVER EQUAL TO with slash +.. |nleqslant| unicode:: U+02A7D U+00338 .. LESS-THAN OR SLANTED EQUAL TO with slash +.. |nless| unicode:: U+0226E .. NOT LESS-THAN +.. |NonBreakingSpace| unicode:: U+000A0 .. NO-BREAK SPACE +.. |NotCongruent| unicode:: U+02262 .. NOT IDENTICAL TO +.. |NotDoubleVerticalBar| unicode:: U+02226 .. NOT PARALLEL TO +.. |NotElement| unicode:: U+02209 .. NOT AN ELEMENT OF +.. |NotEqual| unicode:: U+02260 .. NOT EQUAL TO +.. |NotEqualTilde| unicode:: U+02242 U+00338 .. MINUS TILDE with slash +.. |NotExists| unicode:: U+02204 .. THERE DOES NOT EXIST +.. |NotGreater| unicode:: U+0226F .. NOT GREATER-THAN +.. |NotGreaterEqual| unicode:: U+02271 .. NEITHER GREATER-THAN NOR EQUAL TO +.. |NotGreaterFullEqual| unicode:: U+02266 U+00338 .. LESS-THAN OVER EQUAL TO with slash +.. |NotGreaterGreater| unicode:: U+0226B U+00338 .. MUCH GREATER THAN with slash +.. |NotGreaterLess| unicode:: U+02279 .. NEITHER GREATER-THAN NOR LESS-THAN +.. |NotGreaterSlantEqual| unicode:: U+02A7E U+00338 .. GREATER-THAN OR SLANTED EQUAL TO with slash +.. |NotGreaterTilde| unicode:: U+02275 .. NEITHER GREATER-THAN NOR EQUIVALENT TO +.. |NotHumpDownHump| unicode:: U+0224E U+00338 .. GEOMETRICALLY EQUIVALENT TO with slash +.. |NotLeftTriangle| unicode:: U+022EA .. NOT NORMAL SUBGROUP OF +.. |NotLeftTriangleEqual| unicode:: U+022EC .. NOT NORMAL SUBGROUP OF OR EQUAL TO +.. |NotLess| unicode:: U+0226E .. NOT LESS-THAN +.. |NotLessEqual| unicode:: U+02270 .. NEITHER LESS-THAN NOR EQUAL TO +.. |NotLessGreater| unicode:: U+02278 .. NEITHER LESS-THAN NOR GREATER-THAN +.. |NotLessLess| unicode:: U+0226A U+00338 .. MUCH LESS THAN with slash +.. |NotLessSlantEqual| unicode:: U+02A7D U+00338 .. LESS-THAN OR SLANTED EQUAL TO with slash +.. |NotLessTilde| unicode:: U+02274 .. NEITHER LESS-THAN NOR EQUIVALENT TO +.. |NotPrecedes| unicode:: U+02280 .. DOES NOT PRECEDE +.. |NotPrecedesEqual| unicode:: U+02AAF U+00338 .. PRECEDES ABOVE SINGLE-LINE EQUALS SIGN with slash +.. |NotPrecedesSlantEqual| unicode:: U+022E0 .. DOES NOT PRECEDE OR EQUAL +.. |NotReverseElement| unicode:: U+0220C .. DOES NOT CONTAIN AS MEMBER +.. |NotRightTriangle| unicode:: U+022EB .. DOES NOT CONTAIN AS NORMAL SUBGROUP +.. |NotRightTriangleEqual| unicode:: U+022ED .. DOES NOT CONTAIN AS NORMAL SUBGROUP OR EQUAL +.. |NotSquareSubsetEqual| unicode:: U+022E2 .. NOT SQUARE IMAGE OF OR EQUAL TO +.. |NotSquareSupersetEqual| unicode:: U+022E3 .. NOT SQUARE ORIGINAL OF OR EQUAL TO +.. |NotSubset| unicode:: U+02282 U+020D2 .. SUBSET OF with vertical line +.. |NotSubsetEqual| unicode:: U+02288 .. NEITHER A SUBSET OF NOR EQUAL TO +.. |NotSucceeds| unicode:: U+02281 .. DOES NOT SUCCEED +.. |NotSucceedsEqual| unicode:: U+02AB0 U+00338 .. SUCCEEDS ABOVE SINGLE-LINE EQUALS SIGN with slash +.. |NotSucceedsSlantEqual| unicode:: U+022E1 .. DOES NOT SUCCEED OR EQUAL +.. |NotSuperset| unicode:: U+02283 U+020D2 .. SUPERSET OF with vertical line +.. |NotSupersetEqual| unicode:: U+02289 .. NEITHER A SUPERSET OF NOR EQUAL TO +.. |NotTilde| unicode:: U+02241 .. NOT TILDE +.. |NotTildeEqual| unicode:: U+02244 .. NOT ASYMPTOTICALLY EQUAL TO +.. |NotTildeFullEqual| unicode:: U+02247 .. NEITHER APPROXIMATELY NOR ACTUALLY EQUAL TO +.. |NotTildeTilde| unicode:: U+02249 .. NOT ALMOST EQUAL TO +.. |NotVerticalBar| unicode:: U+02224 .. DOES NOT DIVIDE +.. |nparallel| unicode:: U+02226 .. NOT PARALLEL TO +.. |nprec| unicode:: U+02280 .. DOES NOT PRECEDE +.. |npreceq| unicode:: U+02AAF U+00338 .. PRECEDES ABOVE SINGLE-LINE EQUALS SIGN with slash +.. |nRightarrow| unicode:: U+021CF .. RIGHTWARDS DOUBLE ARROW WITH STROKE +.. |nrightarrow| unicode:: U+0219B .. RIGHTWARDS ARROW WITH STROKE +.. |nshortmid| unicode:: U+02224 .. DOES NOT DIVIDE +.. |nshortparallel| unicode:: U+02226 .. NOT PARALLEL TO +.. |nsimeq| unicode:: U+02244 .. NOT ASYMPTOTICALLY EQUAL TO +.. |nsubset| unicode:: U+02282 U+020D2 .. SUBSET OF with vertical line +.. |nsubseteq| unicode:: U+02288 .. NEITHER A SUBSET OF NOR EQUAL TO +.. |nsubseteqq| unicode:: U+02AC5 U+00338 .. SUBSET OF ABOVE EQUALS SIGN with slash +.. |nsucc| unicode:: U+02281 .. DOES NOT SUCCEED +.. |nsucceq| unicode:: U+02AB0 U+00338 .. SUCCEEDS ABOVE SINGLE-LINE EQUALS SIGN with slash +.. |nsupset| unicode:: U+02283 U+020D2 .. SUPERSET OF with vertical line +.. |nsupseteq| unicode:: U+02289 .. NEITHER A SUPERSET OF NOR EQUAL TO +.. |nsupseteqq| unicode:: U+02AC6 U+00338 .. SUPERSET OF ABOVE EQUALS SIGN with slash +.. |ntriangleleft| unicode:: U+022EA .. NOT NORMAL SUBGROUP OF +.. |ntrianglelefteq| unicode:: U+022EC .. NOT NORMAL SUBGROUP OF OR EQUAL TO +.. |ntriangleright| unicode:: U+022EB .. DOES NOT CONTAIN AS NORMAL SUBGROUP +.. |ntrianglerighteq| unicode:: U+022ED .. DOES NOT CONTAIN AS NORMAL SUBGROUP OR EQUAL +.. |nwarrow| unicode:: U+02196 .. NORTH WEST ARROW +.. |oint| unicode:: U+0222E .. CONTOUR INTEGRAL +.. |OpenCurlyDoubleQuote| unicode:: U+0201C .. LEFT DOUBLE QUOTATION MARK +.. |OpenCurlyQuote| unicode:: U+02018 .. LEFT SINGLE QUOTATION MARK +.. |orderof| unicode:: U+02134 .. SCRIPT SMALL O +.. |parallel| unicode:: U+02225 .. PARALLEL TO +.. |PartialD| unicode:: U+02202 .. PARTIAL DIFFERENTIAL +.. |pitchfork| unicode:: U+022D4 .. PITCHFORK +.. |PlusMinus| unicode:: U+000B1 .. PLUS-MINUS SIGN +.. |pm| unicode:: U+000B1 .. PLUS-MINUS SIGN +.. |Poincareplane| unicode:: U+0210C .. BLACK-LETTER CAPITAL H +.. |prec| unicode:: U+0227A .. PRECEDES +.. |precapprox| unicode:: U+02AB7 .. PRECEDES ABOVE ALMOST EQUAL TO +.. |preccurlyeq| unicode:: U+0227C .. PRECEDES OR EQUAL TO +.. |Precedes| unicode:: U+0227A .. PRECEDES +.. |PrecedesEqual| unicode:: U+02AAF .. PRECEDES ABOVE SINGLE-LINE EQUALS SIGN +.. |PrecedesSlantEqual| unicode:: U+0227C .. PRECEDES OR EQUAL TO +.. |PrecedesTilde| unicode:: U+0227E .. PRECEDES OR EQUIVALENT TO +.. |preceq| unicode:: U+02AAF .. PRECEDES ABOVE SINGLE-LINE EQUALS SIGN +.. |precnapprox| unicode:: U+02AB9 .. PRECEDES ABOVE NOT ALMOST EQUAL TO +.. |precneqq| unicode:: U+02AB5 .. PRECEDES ABOVE NOT EQUAL TO +.. |precnsim| unicode:: U+022E8 .. PRECEDES BUT NOT EQUIVALENT TO +.. |precsim| unicode:: U+0227E .. PRECEDES OR EQUIVALENT TO +.. |primes| unicode:: U+02119 .. DOUBLE-STRUCK CAPITAL P +.. |Proportion| unicode:: U+02237 .. PROPORTION +.. |Proportional| unicode:: U+0221D .. PROPORTIONAL TO +.. |propto| unicode:: U+0221D .. PROPORTIONAL TO +.. |quaternions| unicode:: U+0210D .. DOUBLE-STRUCK CAPITAL H +.. |questeq| unicode:: U+0225F .. QUESTIONED EQUAL TO +.. |rangle| unicode:: U+0232A .. RIGHT-POINTING ANGLE BRACKET +.. |rationals| unicode:: U+0211A .. DOUBLE-STRUCK CAPITAL Q +.. |rbrace| unicode:: U+0007D .. RIGHT CURLY BRACKET +.. |rbrack| unicode:: U+0005D .. RIGHT SQUARE BRACKET +.. |Re| unicode:: U+0211C .. BLACK-LETTER CAPITAL R +.. |realine| unicode:: U+0211B .. SCRIPT CAPITAL R +.. |realpart| unicode:: U+0211C .. BLACK-LETTER CAPITAL R +.. |reals| unicode:: U+0211D .. DOUBLE-STRUCK CAPITAL R +.. |ReverseElement| unicode:: U+0220B .. CONTAINS AS MEMBER +.. |ReverseEquilibrium| unicode:: U+021CB .. LEFTWARDS HARPOON OVER RIGHTWARDS HARPOON +.. |ReverseUpEquilibrium| unicode:: U+0296F .. DOWNWARDS HARPOON WITH BARB LEFT BESIDE UPWARDS HARPOON WITH BARB RIGHT +.. |RightAngleBracket| unicode:: U+0232A .. RIGHT-POINTING ANGLE BRACKET +.. |RightArrow| unicode:: U+02192 .. RIGHTWARDS ARROW +.. |Rightarrow| unicode:: U+021D2 .. RIGHTWARDS DOUBLE ARROW +.. |rightarrow| unicode:: U+02192 .. RIGHTWARDS ARROW +.. |RightArrowBar| unicode:: U+021E5 .. RIGHTWARDS ARROW TO BAR +.. |RightArrowLeftArrow| unicode:: U+021C4 .. RIGHTWARDS ARROW OVER LEFTWARDS ARROW +.. |rightarrowtail| unicode:: U+021A3 .. RIGHTWARDS ARROW WITH TAIL +.. |RightCeiling| unicode:: U+02309 .. RIGHT CEILING +.. |RightDoubleBracket| unicode:: U+0301B .. RIGHT WHITE SQUARE BRACKET +.. |RightDownVector| unicode:: U+021C2 .. DOWNWARDS HARPOON WITH BARB RIGHTWARDS +.. |RightFloor| unicode:: U+0230B .. RIGHT FLOOR +.. |rightharpoondown| unicode:: U+021C1 .. RIGHTWARDS HARPOON WITH BARB DOWNWARDS +.. |rightharpoonup| unicode:: U+021C0 .. RIGHTWARDS HARPOON WITH BARB UPWARDS +.. |rightleftarrows| unicode:: U+021C4 .. RIGHTWARDS ARROW OVER LEFTWARDS ARROW +.. |rightleftharpoons| unicode:: U+021CC .. RIGHTWARDS HARPOON OVER LEFTWARDS HARPOON +.. |rightrightarrows| unicode:: U+021C9 .. RIGHTWARDS PAIRED ARROWS +.. |rightsquigarrow| unicode:: U+0219D .. RIGHTWARDS WAVE ARROW +.. |RightTee| unicode:: U+022A2 .. RIGHT TACK +.. |RightTeeArrow| unicode:: U+021A6 .. RIGHTWARDS ARROW FROM BAR +.. |rightthreetimes| unicode:: U+022CC .. RIGHT SEMIDIRECT PRODUCT +.. |RightTriangle| unicode:: U+022B3 .. CONTAINS AS NORMAL SUBGROUP +.. |RightTriangleEqual| unicode:: U+022B5 .. CONTAINS AS NORMAL SUBGROUP OR EQUAL TO +.. |RightUpVector| unicode:: U+021BE .. UPWARDS HARPOON WITH BARB RIGHTWARDS +.. |RightVector| unicode:: U+021C0 .. RIGHTWARDS HARPOON WITH BARB UPWARDS +.. |risingdotseq| unicode:: U+02253 .. IMAGE OF OR APPROXIMATELY EQUAL TO +.. |rmoustache| unicode:: U+023B1 .. UPPER RIGHT OR LOWER LEFT CURLY BRACKET SECTION +.. |Rrightarrow| unicode:: U+021DB .. RIGHTWARDS TRIPLE ARROW +.. |Rsh| unicode:: U+021B1 .. UPWARDS ARROW WITH TIP RIGHTWARDS +.. |searrow| unicode:: U+02198 .. SOUTH EAST ARROW +.. |setminus| unicode:: U+02216 .. SET MINUS +.. |ShortDownArrow| unicode:: U+02193 .. DOWNWARDS ARROW +.. |ShortLeftArrow| unicode:: U+02190 .. LEFTWARDS ARROW +.. |shortmid| unicode:: U+02223 .. DIVIDES +.. |shortparallel| unicode:: U+02225 .. PARALLEL TO +.. |ShortRightArrow| unicode:: U+02192 .. RIGHTWARDS ARROW +.. |ShortUpArrow| unicode:: U+02191 .. UPWARDS ARROW +.. |simeq| unicode:: U+02243 .. ASYMPTOTICALLY EQUAL TO +.. |SmallCircle| unicode:: U+02218 .. RING OPERATOR +.. |smallsetminus| unicode:: U+02216 .. SET MINUS +.. |spadesuit| unicode:: U+02660 .. BLACK SPADE SUIT +.. |Sqrt| unicode:: U+0221A .. SQUARE ROOT +.. |sqsubset| unicode:: U+0228F .. SQUARE IMAGE OF +.. |sqsubseteq| unicode:: U+02291 .. SQUARE IMAGE OF OR EQUAL TO +.. |sqsupset| unicode:: U+02290 .. SQUARE ORIGINAL OF +.. |sqsupseteq| unicode:: U+02292 .. SQUARE ORIGINAL OF OR EQUAL TO +.. |Square| unicode:: U+025A1 .. WHITE SQUARE +.. |SquareIntersection| unicode:: U+02293 .. SQUARE CAP +.. |SquareSubset| unicode:: U+0228F .. SQUARE IMAGE OF +.. |SquareSubsetEqual| unicode:: U+02291 .. SQUARE IMAGE OF OR EQUAL TO +.. |SquareSuperset| unicode:: U+02290 .. SQUARE ORIGINAL OF +.. |SquareSupersetEqual| unicode:: U+02292 .. SQUARE ORIGINAL OF OR EQUAL TO +.. |SquareUnion| unicode:: U+02294 .. SQUARE CUP +.. |Star| unicode:: U+022C6 .. STAR OPERATOR +.. |straightepsilon| unicode:: U+003F5 .. GREEK LUNATE EPSILON SYMBOL +.. |straightphi| unicode:: U+003D5 .. GREEK PHI SYMBOL +.. |Subset| unicode:: U+022D0 .. DOUBLE SUBSET +.. |subset| unicode:: U+02282 .. SUBSET OF +.. |subseteq| unicode:: U+02286 .. SUBSET OF OR EQUAL TO +.. |subseteqq| unicode:: U+02AC5 .. SUBSET OF ABOVE EQUALS SIGN +.. |SubsetEqual| unicode:: U+02286 .. SUBSET OF OR EQUAL TO +.. |subsetneq| unicode:: U+0228A .. SUBSET OF WITH NOT EQUAL TO +.. |subsetneqq| unicode:: U+02ACB .. SUBSET OF ABOVE NOT EQUAL TO +.. |succ| unicode:: U+0227B .. SUCCEEDS +.. |succapprox| unicode:: U+02AB8 .. SUCCEEDS ABOVE ALMOST EQUAL TO +.. |succcurlyeq| unicode:: U+0227D .. SUCCEEDS OR EQUAL TO +.. |Succeeds| unicode:: U+0227B .. SUCCEEDS +.. |SucceedsEqual| unicode:: U+02AB0 .. SUCCEEDS ABOVE SINGLE-LINE EQUALS SIGN +.. |SucceedsSlantEqual| unicode:: U+0227D .. SUCCEEDS OR EQUAL TO +.. |SucceedsTilde| unicode:: U+0227F .. SUCCEEDS OR EQUIVALENT TO +.. |succeq| unicode:: U+02AB0 .. SUCCEEDS ABOVE SINGLE-LINE EQUALS SIGN +.. |succnapprox| unicode:: U+02ABA .. SUCCEEDS ABOVE NOT ALMOST EQUAL TO +.. |succneqq| unicode:: U+02AB6 .. SUCCEEDS ABOVE NOT EQUAL TO +.. |succnsim| unicode:: U+022E9 .. SUCCEEDS BUT NOT EQUIVALENT TO +.. |succsim| unicode:: U+0227F .. SUCCEEDS OR EQUIVALENT TO +.. |SuchThat| unicode:: U+0220B .. CONTAINS AS MEMBER +.. |Sum| unicode:: U+02211 .. N-ARY SUMMATION +.. |Superset| unicode:: U+02283 .. SUPERSET OF +.. |SupersetEqual| unicode:: U+02287 .. SUPERSET OF OR EQUAL TO +.. |Supset| unicode:: U+022D1 .. DOUBLE SUPERSET +.. |supset| unicode:: U+02283 .. SUPERSET OF +.. |supseteq| unicode:: U+02287 .. SUPERSET OF OR EQUAL TO +.. |supseteqq| unicode:: U+02AC6 .. SUPERSET OF ABOVE EQUALS SIGN +.. |supsetneq| unicode:: U+0228B .. SUPERSET OF WITH NOT EQUAL TO +.. |supsetneqq| unicode:: U+02ACC .. SUPERSET OF ABOVE NOT EQUAL TO +.. |swarrow| unicode:: U+02199 .. SOUTH WEST ARROW +.. |Therefore| unicode:: U+02234 .. THEREFORE +.. |therefore| unicode:: U+02234 .. THEREFORE +.. |thickapprox| unicode:: U+02248 .. ALMOST EQUAL TO +.. |thicksim| unicode:: U+0223C .. TILDE OPERATOR +.. |ThinSpace| unicode:: U+02009 .. THIN SPACE +.. |Tilde| unicode:: U+0223C .. TILDE OPERATOR +.. |TildeEqual| unicode:: U+02243 .. ASYMPTOTICALLY EQUAL TO +.. |TildeFullEqual| unicode:: U+02245 .. APPROXIMATELY EQUAL TO +.. |TildeTilde| unicode:: U+02248 .. ALMOST EQUAL TO +.. |toea| unicode:: U+02928 .. NORTH EAST ARROW AND SOUTH EAST ARROW +.. |tosa| unicode:: U+02929 .. SOUTH EAST ARROW AND SOUTH WEST ARROW +.. |triangle| unicode:: U+025B5 .. WHITE UP-POINTING SMALL TRIANGLE +.. |triangledown| unicode:: U+025BF .. WHITE DOWN-POINTING SMALL TRIANGLE +.. |triangleleft| unicode:: U+025C3 .. WHITE LEFT-POINTING SMALL TRIANGLE +.. |trianglelefteq| unicode:: U+022B4 .. NORMAL SUBGROUP OF OR EQUAL TO +.. |triangleq| unicode:: U+0225C .. DELTA EQUAL TO +.. |triangleright| unicode:: U+025B9 .. WHITE RIGHT-POINTING SMALL TRIANGLE +.. |trianglerighteq| unicode:: U+022B5 .. CONTAINS AS NORMAL SUBGROUP OR EQUAL TO +.. |TripleDot| unicode:: U+020DB .. COMBINING THREE DOTS ABOVE +.. |twoheadleftarrow| unicode:: U+0219E .. LEFTWARDS TWO HEADED ARROW +.. |twoheadrightarrow| unicode:: U+021A0 .. RIGHTWARDS TWO HEADED ARROW +.. |ulcorner| unicode:: U+0231C .. TOP LEFT CORNER +.. |Union| unicode:: U+022C3 .. N-ARY UNION +.. |UnionPlus| unicode:: U+0228E .. MULTISET UNION +.. |UpArrow| unicode:: U+02191 .. UPWARDS ARROW +.. |Uparrow| unicode:: U+021D1 .. UPWARDS DOUBLE ARROW +.. |uparrow| unicode:: U+02191 .. UPWARDS ARROW +.. |UpArrowDownArrow| unicode:: U+021C5 .. UPWARDS ARROW LEFTWARDS OF DOWNWARDS ARROW +.. |UpDownArrow| unicode:: U+02195 .. UP DOWN ARROW +.. |Updownarrow| unicode:: U+021D5 .. UP DOWN DOUBLE ARROW +.. |updownarrow| unicode:: U+02195 .. UP DOWN ARROW +.. |UpEquilibrium| unicode:: U+0296E .. UPWARDS HARPOON WITH BARB LEFT BESIDE DOWNWARDS HARPOON WITH BARB RIGHT +.. |upharpoonleft| unicode:: U+021BF .. UPWARDS HARPOON WITH BARB LEFTWARDS +.. |upharpoonright| unicode:: U+021BE .. UPWARDS HARPOON WITH BARB RIGHTWARDS +.. |UpperLeftArrow| unicode:: U+02196 .. NORTH WEST ARROW +.. |UpperRightArrow| unicode:: U+02197 .. NORTH EAST ARROW +.. |upsilon| unicode:: U+003C5 .. GREEK SMALL LETTER UPSILON +.. |UpTee| unicode:: U+022A5 .. UP TACK +.. |UpTeeArrow| unicode:: U+021A5 .. UPWARDS ARROW FROM BAR +.. |upuparrows| unicode:: U+021C8 .. UPWARDS PAIRED ARROWS +.. |urcorner| unicode:: U+0231D .. TOP RIGHT CORNER +.. |varepsilon| unicode:: U+003B5 .. GREEK SMALL LETTER EPSILON +.. |varkappa| unicode:: U+003F0 .. GREEK KAPPA SYMBOL +.. |varnothing| unicode:: U+02205 .. EMPTY SET +.. |varphi| unicode:: U+003C6 .. GREEK SMALL LETTER PHI +.. |varpi| unicode:: U+003D6 .. GREEK PI SYMBOL +.. |varpropto| unicode:: U+0221D .. PROPORTIONAL TO +.. |varrho| unicode:: U+003F1 .. GREEK RHO SYMBOL +.. |varsigma| unicode:: U+003C2 .. GREEK SMALL LETTER FINAL SIGMA +.. |varsubsetneq| unicode:: U+0228A U+0FE00 .. SUBSET OF WITH NOT EQUAL TO - variant with stroke through bottom members +.. |varsubsetneqq| unicode:: U+02ACB U+0FE00 .. SUBSET OF ABOVE NOT EQUAL TO - variant with stroke through bottom members +.. |varsupsetneq| unicode:: U+0228B U+0FE00 .. SUPERSET OF WITH NOT EQUAL TO - variant with stroke through bottom members +.. |varsupsetneqq| unicode:: U+02ACC U+0FE00 .. SUPERSET OF ABOVE NOT EQUAL TO - variant with stroke through bottom members +.. |vartheta| unicode:: U+003D1 .. GREEK THETA SYMBOL +.. |vartriangleleft| unicode:: U+022B2 .. NORMAL SUBGROUP OF +.. |vartriangleright| unicode:: U+022B3 .. CONTAINS AS NORMAL SUBGROUP +.. |Vee| unicode:: U+022C1 .. N-ARY LOGICAL OR +.. |vee| unicode:: U+02228 .. LOGICAL OR +.. |Vert| unicode:: U+02016 .. DOUBLE VERTICAL LINE +.. |vert| unicode:: U+0007C .. VERTICAL LINE +.. |VerticalBar| unicode:: U+02223 .. DIVIDES +.. |VerticalTilde| unicode:: U+02240 .. WREATH PRODUCT +.. |VeryThinSpace| unicode:: U+0200A .. HAIR SPACE +.. |Wedge| unicode:: U+022C0 .. N-ARY LOGICAL AND +.. |wedge| unicode:: U+02227 .. LOGICAL AND +.. |wp| unicode:: U+02118 .. SCRIPT CAPITAL P +.. |wr| unicode:: U+02240 .. WREATH PRODUCT +.. |zeetrf| unicode:: U+02128 .. BLACK-LETTER CAPITAL Z diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/mmlextra-wide.txt --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/mmlextra-wide.txt Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,113 @@ +.. This data file has been placed in the public domain. +.. Derived from the Unicode character mappings available from + . + Processed by unicode2rstsubs.py, part of Docutils: + . + +.. |af| unicode:: U+02061 .. FUNCTION APPLICATION +.. |aopf| unicode:: U+1D552 .. MATHEMATICAL DOUBLE-STRUCK SMALL A +.. |asympeq| unicode:: U+0224D .. EQUIVALENT TO +.. |bopf| unicode:: U+1D553 .. MATHEMATICAL DOUBLE-STRUCK SMALL B +.. |copf| unicode:: U+1D554 .. MATHEMATICAL DOUBLE-STRUCK SMALL C +.. |Cross| unicode:: U+02A2F .. VECTOR OR CROSS PRODUCT +.. |DD| unicode:: U+02145 .. DOUBLE-STRUCK ITALIC CAPITAL D +.. |dd| unicode:: U+02146 .. DOUBLE-STRUCK ITALIC SMALL D +.. |dopf| unicode:: U+1D555 .. MATHEMATICAL DOUBLE-STRUCK SMALL D +.. |DownArrowBar| unicode:: U+02913 .. DOWNWARDS ARROW TO BAR +.. |DownBreve| unicode:: U+00311 .. COMBINING INVERTED BREVE +.. |DownLeftRightVector| unicode:: U+02950 .. LEFT BARB DOWN RIGHT BARB DOWN HARPOON +.. |DownLeftTeeVector| unicode:: U+0295E .. LEFTWARDS HARPOON WITH BARB DOWN FROM BAR +.. |DownLeftVectorBar| unicode:: U+02956 .. LEFTWARDS HARPOON WITH BARB DOWN TO BAR +.. |DownRightTeeVector| unicode:: U+0295F .. RIGHTWARDS HARPOON WITH BARB DOWN FROM BAR +.. |DownRightVectorBar| unicode:: U+02957 .. RIGHTWARDS HARPOON WITH BARB DOWN TO BAR +.. |ee| unicode:: U+02147 .. DOUBLE-STRUCK ITALIC SMALL E +.. |EmptySmallSquare| unicode:: U+025FB .. WHITE MEDIUM SQUARE +.. |EmptyVerySmallSquare| unicode:: U+025AB .. WHITE SMALL SQUARE +.. |eopf| unicode:: U+1D556 .. MATHEMATICAL DOUBLE-STRUCK SMALL E +.. |Equal| unicode:: U+02A75 .. TWO CONSECUTIVE EQUALS SIGNS +.. |FilledSmallSquare| unicode:: U+025FC .. BLACK MEDIUM SQUARE +.. |FilledVerySmallSquare| unicode:: U+025AA .. BLACK SMALL SQUARE +.. |fopf| unicode:: U+1D557 .. MATHEMATICAL DOUBLE-STRUCK SMALL F +.. |gopf| unicode:: U+1D558 .. MATHEMATICAL DOUBLE-STRUCK SMALL G +.. |GreaterGreater| unicode:: U+02AA2 .. DOUBLE NESTED GREATER-THAN +.. |Hat| unicode:: U+0005E .. CIRCUMFLEX ACCENT +.. |hopf| unicode:: U+1D559 .. MATHEMATICAL DOUBLE-STRUCK SMALL H +.. |HorizontalLine| unicode:: U+02500 .. BOX DRAWINGS LIGHT HORIZONTAL +.. |ic| unicode:: U+02063 .. INVISIBLE SEPARATOR +.. |ii| unicode:: U+02148 .. DOUBLE-STRUCK ITALIC SMALL I +.. |iopf| unicode:: U+1D55A .. MATHEMATICAL DOUBLE-STRUCK SMALL I +.. |it| unicode:: U+02062 .. INVISIBLE TIMES +.. |jopf| unicode:: U+1D55B .. MATHEMATICAL DOUBLE-STRUCK SMALL J +.. |kopf| unicode:: U+1D55C .. MATHEMATICAL DOUBLE-STRUCK SMALL K +.. |larrb| unicode:: U+021E4 .. LEFTWARDS ARROW TO BAR +.. |LeftDownTeeVector| unicode:: U+02961 .. DOWNWARDS HARPOON WITH BARB LEFT FROM BAR +.. |LeftDownVectorBar| unicode:: U+02959 .. DOWNWARDS HARPOON WITH BARB LEFT TO BAR +.. |LeftRightVector| unicode:: U+0294E .. LEFT BARB UP RIGHT BARB UP HARPOON +.. |LeftTeeVector| unicode:: U+0295A .. LEFTWARDS HARPOON WITH BARB UP FROM BAR +.. |LeftTriangleBar| unicode:: U+029CF .. LEFT TRIANGLE BESIDE VERTICAL BAR +.. |LeftUpDownVector| unicode:: U+02951 .. UP BARB LEFT DOWN BARB LEFT HARPOON +.. |LeftUpTeeVector| unicode:: U+02960 .. UPWARDS HARPOON WITH BARB LEFT FROM BAR +.. |LeftUpVectorBar| unicode:: U+02958 .. UPWARDS HARPOON WITH BARB LEFT TO BAR +.. |LeftVectorBar| unicode:: U+02952 .. LEFTWARDS HARPOON WITH BARB UP TO BAR +.. |LessLess| unicode:: U+02AA1 .. DOUBLE NESTED LESS-THAN +.. |lopf| unicode:: U+1D55D .. MATHEMATICAL DOUBLE-STRUCK SMALL L +.. |mapstodown| unicode:: U+021A7 .. DOWNWARDS ARROW FROM BAR +.. |mapstoleft| unicode:: U+021A4 .. LEFTWARDS ARROW FROM BAR +.. |mapstoup| unicode:: U+021A5 .. UPWARDS ARROW FROM BAR +.. |MediumSpace| unicode:: U+0205F .. MEDIUM MATHEMATICAL SPACE +.. |mopf| unicode:: U+1D55E .. MATHEMATICAL DOUBLE-STRUCK SMALL M +.. |nbump| unicode:: U+0224E U+00338 .. GEOMETRICALLY EQUIVALENT TO with slash +.. |nbumpe| unicode:: U+0224F U+00338 .. DIFFERENCE BETWEEN with slash +.. |nesim| unicode:: U+02242 U+00338 .. MINUS TILDE with slash +.. |NewLine| unicode:: U+0000A .. LINE FEED (LF) +.. |NoBreak| unicode:: U+02060 .. WORD JOINER +.. |nopf| unicode:: U+1D55F .. MATHEMATICAL DOUBLE-STRUCK SMALL N +.. |NotCupCap| unicode:: U+0226D .. NOT EQUIVALENT TO +.. |NotHumpEqual| unicode:: U+0224F U+00338 .. DIFFERENCE BETWEEN with slash +.. |NotLeftTriangleBar| unicode:: U+029CF U+00338 .. LEFT TRIANGLE BESIDE VERTICAL BAR with slash +.. |NotNestedGreaterGreater| unicode:: U+02AA2 U+00338 .. DOUBLE NESTED GREATER-THAN with slash +.. |NotNestedLessLess| unicode:: U+02AA1 U+00338 .. DOUBLE NESTED LESS-THAN with slash +.. |NotRightTriangleBar| unicode:: U+029D0 U+00338 .. VERTICAL BAR BESIDE RIGHT TRIANGLE with slash +.. |NotSquareSubset| unicode:: U+0228F U+00338 .. SQUARE IMAGE OF with slash +.. |NotSquareSuperset| unicode:: U+02290 U+00338 .. SQUARE ORIGINAL OF with slash +.. |NotSucceedsTilde| unicode:: U+0227F U+00338 .. SUCCEEDS OR EQUIVALENT TO with slash +.. |oopf| unicode:: U+1D560 .. MATHEMATICAL DOUBLE-STRUCK SMALL O +.. |OverBar| unicode:: U+000AF .. MACRON +.. |OverBrace| unicode:: U+0FE37 .. PRESENTATION FORM FOR VERTICAL LEFT CURLY BRACKET +.. |OverBracket| unicode:: U+023B4 .. TOP SQUARE BRACKET +.. |OverParenthesis| unicode:: U+0FE35 .. PRESENTATION FORM FOR VERTICAL LEFT PARENTHESIS +.. |planckh| unicode:: U+0210E .. PLANCK CONSTANT +.. |popf| unicode:: U+1D561 .. MATHEMATICAL DOUBLE-STRUCK SMALL P +.. |Product| unicode:: U+0220F .. N-ARY PRODUCT +.. |qopf| unicode:: U+1D562 .. MATHEMATICAL DOUBLE-STRUCK SMALL Q +.. |rarrb| unicode:: U+021E5 .. RIGHTWARDS ARROW TO BAR +.. |RightDownTeeVector| unicode:: U+0295D .. DOWNWARDS HARPOON WITH BARB RIGHT FROM BAR +.. |RightDownVectorBar| unicode:: U+02955 .. DOWNWARDS HARPOON WITH BARB RIGHT TO BAR +.. |RightTeeVector| unicode:: U+0295B .. RIGHTWARDS HARPOON WITH BARB UP FROM BAR +.. |RightTriangleBar| unicode:: U+029D0 .. VERTICAL BAR BESIDE RIGHT TRIANGLE +.. |RightUpDownVector| unicode:: U+0294F .. UP BARB RIGHT DOWN BARB RIGHT HARPOON +.. |RightUpTeeVector| unicode:: U+0295C .. UPWARDS HARPOON WITH BARB RIGHT FROM BAR +.. |RightUpVectorBar| unicode:: U+02954 .. UPWARDS HARPOON WITH BARB RIGHT TO BAR +.. |RightVectorBar| unicode:: U+02953 .. RIGHTWARDS HARPOON WITH BARB UP TO BAR +.. |ropf| unicode:: U+1D563 .. MATHEMATICAL DOUBLE-STRUCK SMALL R +.. |RoundImplies| unicode:: U+02970 .. RIGHT DOUBLE ARROW WITH ROUNDED HEAD +.. |RuleDelayed| unicode:: U+029F4 .. RULE-DELAYED +.. |sopf| unicode:: U+1D564 .. MATHEMATICAL DOUBLE-STRUCK SMALL S +.. |Tab| unicode:: U+00009 .. CHARACTER TABULATION +.. |ThickSpace| unicode:: U+02009 U+0200A U+0200A .. space of width 5/18 em +.. |topf| unicode:: U+1D565 .. MATHEMATICAL DOUBLE-STRUCK SMALL T +.. |UnderBar| unicode:: U+00332 .. COMBINING LOW LINE +.. |UnderBrace| unicode:: U+0FE38 .. PRESENTATION FORM FOR VERTICAL RIGHT CURLY BRACKET +.. |UnderBracket| unicode:: U+023B5 .. BOTTOM SQUARE BRACKET +.. |UnderParenthesis| unicode:: U+0FE36 .. PRESENTATION FORM FOR VERTICAL RIGHT PARENTHESIS +.. |uopf| unicode:: U+1D566 .. MATHEMATICAL DOUBLE-STRUCK SMALL U +.. |UpArrowBar| unicode:: U+02912 .. UPWARDS ARROW TO BAR +.. |Upsilon| unicode:: U+003A5 .. GREEK CAPITAL LETTER UPSILON +.. |VerticalLine| unicode:: U+0007C .. VERTICAL LINE +.. |VerticalSeparator| unicode:: U+02758 .. LIGHT VERTICAL BAR +.. |vopf| unicode:: U+1D567 .. MATHEMATICAL DOUBLE-STRUCK SMALL V +.. |wopf| unicode:: U+1D568 .. MATHEMATICAL DOUBLE-STRUCK SMALL W +.. |xopf| unicode:: U+1D569 .. MATHEMATICAL DOUBLE-STRUCK SMALL X +.. |yopf| unicode:: U+1D56A .. MATHEMATICAL DOUBLE-STRUCK SMALL Y +.. |ZeroWidthSpace| unicode:: U+0200B .. ZERO WIDTH SPACE +.. |zopf| unicode:: U+1D56B .. MATHEMATICAL DOUBLE-STRUCK SMALL Z diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/mmlextra.txt --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/mmlextra.txt Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,87 @@ +.. This data file has been placed in the public domain. +.. Derived from the Unicode character mappings available from + . + Processed by unicode2rstsubs.py, part of Docutils: + . + +.. |af| unicode:: U+02061 .. FUNCTION APPLICATION +.. |asympeq| unicode:: U+0224D .. EQUIVALENT TO +.. |Cross| unicode:: U+02A2F .. VECTOR OR CROSS PRODUCT +.. |DD| unicode:: U+02145 .. DOUBLE-STRUCK ITALIC CAPITAL D +.. |dd| unicode:: U+02146 .. DOUBLE-STRUCK ITALIC SMALL D +.. |DownArrowBar| unicode:: U+02913 .. DOWNWARDS ARROW TO BAR +.. |DownBreve| unicode:: U+00311 .. COMBINING INVERTED BREVE +.. |DownLeftRightVector| unicode:: U+02950 .. LEFT BARB DOWN RIGHT BARB DOWN HARPOON +.. |DownLeftTeeVector| unicode:: U+0295E .. LEFTWARDS HARPOON WITH BARB DOWN FROM BAR +.. |DownLeftVectorBar| unicode:: U+02956 .. LEFTWARDS HARPOON WITH BARB DOWN TO BAR +.. |DownRightTeeVector| unicode:: U+0295F .. RIGHTWARDS HARPOON WITH BARB DOWN FROM BAR +.. |DownRightVectorBar| unicode:: U+02957 .. RIGHTWARDS HARPOON WITH BARB DOWN TO BAR +.. |ee| unicode:: U+02147 .. DOUBLE-STRUCK ITALIC SMALL E +.. |EmptySmallSquare| unicode:: U+025FB .. WHITE MEDIUM SQUARE +.. |EmptyVerySmallSquare| unicode:: U+025AB .. WHITE SMALL SQUARE +.. |Equal| unicode:: U+02A75 .. TWO CONSECUTIVE EQUALS SIGNS +.. |FilledSmallSquare| unicode:: U+025FC .. BLACK MEDIUM SQUARE +.. |FilledVerySmallSquare| unicode:: U+025AA .. BLACK SMALL SQUARE +.. |GreaterGreater| unicode:: U+02AA2 .. DOUBLE NESTED GREATER-THAN +.. |Hat| unicode:: U+0005E .. CIRCUMFLEX ACCENT +.. |HorizontalLine| unicode:: U+02500 .. BOX DRAWINGS LIGHT HORIZONTAL +.. |ic| unicode:: U+02063 .. INVISIBLE SEPARATOR +.. |ii| unicode:: U+02148 .. DOUBLE-STRUCK ITALIC SMALL I +.. |it| unicode:: U+02062 .. INVISIBLE TIMES +.. |larrb| unicode:: U+021E4 .. LEFTWARDS ARROW TO BAR +.. |LeftDownTeeVector| unicode:: U+02961 .. DOWNWARDS HARPOON WITH BARB LEFT FROM BAR +.. |LeftDownVectorBar| unicode:: U+02959 .. DOWNWARDS HARPOON WITH BARB LEFT TO BAR +.. |LeftRightVector| unicode:: U+0294E .. LEFT BARB UP RIGHT BARB UP HARPOON +.. |LeftTeeVector| unicode:: U+0295A .. LEFTWARDS HARPOON WITH BARB UP FROM BAR +.. |LeftTriangleBar| unicode:: U+029CF .. LEFT TRIANGLE BESIDE VERTICAL BAR +.. |LeftUpDownVector| unicode:: U+02951 .. UP BARB LEFT DOWN BARB LEFT HARPOON +.. |LeftUpTeeVector| unicode:: U+02960 .. UPWARDS HARPOON WITH BARB LEFT FROM BAR +.. |LeftUpVectorBar| unicode:: U+02958 .. UPWARDS HARPOON WITH BARB LEFT TO BAR +.. |LeftVectorBar| unicode:: U+02952 .. LEFTWARDS HARPOON WITH BARB UP TO BAR +.. |LessLess| unicode:: U+02AA1 .. DOUBLE NESTED LESS-THAN +.. |mapstodown| unicode:: U+021A7 .. DOWNWARDS ARROW FROM BAR +.. |mapstoleft| unicode:: U+021A4 .. LEFTWARDS ARROW FROM BAR +.. |mapstoup| unicode:: U+021A5 .. UPWARDS ARROW FROM BAR +.. |MediumSpace| unicode:: U+0205F .. MEDIUM MATHEMATICAL SPACE +.. |nbump| unicode:: U+0224E U+00338 .. GEOMETRICALLY EQUIVALENT TO with slash +.. |nbumpe| unicode:: U+0224F U+00338 .. DIFFERENCE BETWEEN with slash +.. |nesim| unicode:: U+02242 U+00338 .. MINUS TILDE with slash +.. |NewLine| unicode:: U+0000A .. LINE FEED (LF) +.. |NoBreak| unicode:: U+02060 .. WORD JOINER +.. |NotCupCap| unicode:: U+0226D .. NOT EQUIVALENT TO +.. |NotHumpEqual| unicode:: U+0224F U+00338 .. DIFFERENCE BETWEEN with slash +.. |NotLeftTriangleBar| unicode:: U+029CF U+00338 .. LEFT TRIANGLE BESIDE VERTICAL BAR with slash +.. |NotNestedGreaterGreater| unicode:: U+02AA2 U+00338 .. DOUBLE NESTED GREATER-THAN with slash +.. |NotNestedLessLess| unicode:: U+02AA1 U+00338 .. DOUBLE NESTED LESS-THAN with slash +.. |NotRightTriangleBar| unicode:: U+029D0 U+00338 .. VERTICAL BAR BESIDE RIGHT TRIANGLE with slash +.. |NotSquareSubset| unicode:: U+0228F U+00338 .. SQUARE IMAGE OF with slash +.. |NotSquareSuperset| unicode:: U+02290 U+00338 .. SQUARE ORIGINAL OF with slash +.. |NotSucceedsTilde| unicode:: U+0227F U+00338 .. SUCCEEDS OR EQUIVALENT TO with slash +.. |OverBar| unicode:: U+000AF .. MACRON +.. |OverBrace| unicode:: U+0FE37 .. PRESENTATION FORM FOR VERTICAL LEFT CURLY BRACKET +.. |OverBracket| unicode:: U+023B4 .. TOP SQUARE BRACKET +.. |OverParenthesis| unicode:: U+0FE35 .. PRESENTATION FORM FOR VERTICAL LEFT PARENTHESIS +.. |planckh| unicode:: U+0210E .. PLANCK CONSTANT +.. |Product| unicode:: U+0220F .. N-ARY PRODUCT +.. |rarrb| unicode:: U+021E5 .. RIGHTWARDS ARROW TO BAR +.. |RightDownTeeVector| unicode:: U+0295D .. DOWNWARDS HARPOON WITH BARB RIGHT FROM BAR +.. |RightDownVectorBar| unicode:: U+02955 .. DOWNWARDS HARPOON WITH BARB RIGHT TO BAR +.. |RightTeeVector| unicode:: U+0295B .. RIGHTWARDS HARPOON WITH BARB UP FROM BAR +.. |RightTriangleBar| unicode:: U+029D0 .. VERTICAL BAR BESIDE RIGHT TRIANGLE +.. |RightUpDownVector| unicode:: U+0294F .. UP BARB RIGHT DOWN BARB RIGHT HARPOON +.. |RightUpTeeVector| unicode:: U+0295C .. UPWARDS HARPOON WITH BARB RIGHT FROM BAR +.. |RightUpVectorBar| unicode:: U+02954 .. UPWARDS HARPOON WITH BARB RIGHT TO BAR +.. |RightVectorBar| unicode:: U+02953 .. RIGHTWARDS HARPOON WITH BARB UP TO BAR +.. |RoundImplies| unicode:: U+02970 .. RIGHT DOUBLE ARROW WITH ROUNDED HEAD +.. |RuleDelayed| unicode:: U+029F4 .. RULE-DELAYED +.. |Tab| unicode:: U+00009 .. CHARACTER TABULATION +.. |ThickSpace| unicode:: U+02009 U+0200A U+0200A .. space of width 5/18 em +.. |UnderBar| unicode:: U+00332 .. COMBINING LOW LINE +.. |UnderBrace| unicode:: U+0FE38 .. PRESENTATION FORM FOR VERTICAL RIGHT CURLY BRACKET +.. |UnderBracket| unicode:: U+023B5 .. BOTTOM SQUARE BRACKET +.. |UnderParenthesis| unicode:: U+0FE36 .. PRESENTATION FORM FOR VERTICAL RIGHT PARENTHESIS +.. |UpArrowBar| unicode:: U+02912 .. UPWARDS ARROW TO BAR +.. |Upsilon| unicode:: U+003A5 .. GREEK CAPITAL LETTER UPSILON +.. |VerticalLine| unicode:: U+0007C .. VERTICAL LINE +.. |VerticalSeparator| unicode:: U+02758 .. LIGHT VERTICAL BAR +.. |ZeroWidthSpace| unicode:: U+0200B .. ZERO WIDTH SPACE diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/s5defs.txt --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/s5defs.txt Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,68 @@ +.. Definitions of interpreted text roles (classes) for S5/HTML data. +.. This data file has been placed in the public domain. + +.. Colours + ======= + +.. role:: black +.. role:: gray +.. role:: silver +.. role:: white + +.. role:: maroon +.. role:: red +.. role:: magenta +.. role:: fuchsia +.. role:: pink +.. role:: orange +.. role:: yellow +.. role:: lime +.. role:: green +.. role:: olive +.. role:: teal +.. role:: cyan +.. role:: aqua +.. role:: blue +.. role:: navy +.. role:: purple + + +.. Text Sizes + ========== + +.. role:: huge +.. role:: big +.. role:: small +.. role:: tiny + + +.. Display in Slides (Presentation Mode) Only + ========================================== + +.. role:: slide + :class: slide-display + + +.. Display in Outline Mode Only + ============================ + +.. role:: outline + + +.. Display in Print Only + ===================== + +.. role:: print + + +.. Display in Handout Mode Only + ============================ + +.. role:: handout + + +.. Incremental Display + =================== + +.. role:: incremental +.. default-role:: incremental diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/xhtml1-lat1.txt --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/xhtml1-lat1.txt Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,102 @@ +.. This data file has been placed in the public domain. +.. Derived from the Unicode character mappings available from + . + Processed by unicode2rstsubs.py, part of Docutils: + . + +.. |Aacute| unicode:: U+000C1 .. LATIN CAPITAL LETTER A WITH ACUTE +.. |aacute| unicode:: U+000E1 .. LATIN SMALL LETTER A WITH ACUTE +.. |Acirc| unicode:: U+000C2 .. LATIN CAPITAL LETTER A WITH CIRCUMFLEX +.. |acirc| unicode:: U+000E2 .. LATIN SMALL LETTER A WITH CIRCUMFLEX +.. |acute| unicode:: U+000B4 .. ACUTE ACCENT +.. |AElig| unicode:: U+000C6 .. LATIN CAPITAL LETTER AE +.. |aelig| unicode:: U+000E6 .. LATIN SMALL LETTER AE +.. |Agrave| unicode:: U+000C0 .. LATIN CAPITAL LETTER A WITH GRAVE +.. |agrave| unicode:: U+000E0 .. LATIN SMALL LETTER A WITH GRAVE +.. |Aring| unicode:: U+000C5 .. LATIN CAPITAL LETTER A WITH RING ABOVE +.. |aring| unicode:: U+000E5 .. LATIN SMALL LETTER A WITH RING ABOVE +.. |Atilde| unicode:: U+000C3 .. LATIN CAPITAL LETTER A WITH TILDE +.. |atilde| unicode:: U+000E3 .. LATIN SMALL LETTER A WITH TILDE +.. |Auml| unicode:: U+000C4 .. LATIN CAPITAL LETTER A WITH DIAERESIS +.. |auml| unicode:: U+000E4 .. LATIN SMALL LETTER A WITH DIAERESIS +.. |brvbar| unicode:: U+000A6 .. BROKEN BAR +.. |Ccedil| unicode:: U+000C7 .. LATIN CAPITAL LETTER C WITH CEDILLA +.. |ccedil| unicode:: U+000E7 .. LATIN SMALL LETTER C WITH CEDILLA +.. |cedil| unicode:: U+000B8 .. CEDILLA +.. |cent| unicode:: U+000A2 .. CENT SIGN +.. |copy| unicode:: U+000A9 .. COPYRIGHT SIGN +.. |curren| unicode:: U+000A4 .. CURRENCY SIGN +.. |deg| unicode:: U+000B0 .. DEGREE SIGN +.. |divide| unicode:: U+000F7 .. DIVISION SIGN +.. |Eacute| unicode:: U+000C9 .. LATIN CAPITAL LETTER E WITH ACUTE +.. |eacute| unicode:: U+000E9 .. LATIN SMALL LETTER E WITH ACUTE +.. |Ecirc| unicode:: U+000CA .. LATIN CAPITAL LETTER E WITH CIRCUMFLEX +.. |ecirc| unicode:: U+000EA .. LATIN SMALL LETTER E WITH CIRCUMFLEX +.. |Egrave| unicode:: U+000C8 .. LATIN CAPITAL LETTER E WITH GRAVE +.. |egrave| unicode:: U+000E8 .. LATIN SMALL LETTER E WITH GRAVE +.. |ETH| unicode:: U+000D0 .. LATIN CAPITAL LETTER ETH +.. |eth| unicode:: U+000F0 .. LATIN SMALL LETTER ETH +.. |Euml| unicode:: U+000CB .. LATIN CAPITAL LETTER E WITH DIAERESIS +.. |euml| unicode:: U+000EB .. LATIN SMALL LETTER E WITH DIAERESIS +.. |frac12| unicode:: U+000BD .. VULGAR FRACTION ONE HALF +.. |frac14| unicode:: U+000BC .. VULGAR FRACTION ONE QUARTER +.. |frac34| unicode:: U+000BE .. VULGAR FRACTION THREE QUARTERS +.. |Iacute| unicode:: U+000CD .. LATIN CAPITAL LETTER I WITH ACUTE +.. |iacute| unicode:: U+000ED .. LATIN SMALL LETTER I WITH ACUTE +.. |Icirc| unicode:: U+000CE .. LATIN CAPITAL LETTER I WITH CIRCUMFLEX +.. |icirc| unicode:: U+000EE .. LATIN SMALL LETTER I WITH CIRCUMFLEX +.. |iexcl| unicode:: U+000A1 .. INVERTED EXCLAMATION MARK +.. |Igrave| unicode:: U+000CC .. LATIN CAPITAL LETTER I WITH GRAVE +.. |igrave| unicode:: U+000EC .. LATIN SMALL LETTER I WITH GRAVE +.. |iquest| unicode:: U+000BF .. INVERTED QUESTION MARK +.. |Iuml| unicode:: U+000CF .. LATIN CAPITAL LETTER I WITH DIAERESIS +.. |iuml| unicode:: U+000EF .. LATIN SMALL LETTER I WITH DIAERESIS +.. |laquo| unicode:: U+000AB .. LEFT-POINTING DOUBLE ANGLE QUOTATION MARK +.. |macr| unicode:: U+000AF .. MACRON +.. |micro| unicode:: U+000B5 .. MICRO SIGN +.. |middot| unicode:: U+000B7 .. MIDDLE DOT +.. |nbsp| unicode:: U+000A0 .. NO-BREAK SPACE +.. |not| unicode:: U+000AC .. NOT SIGN +.. |Ntilde| unicode:: U+000D1 .. LATIN CAPITAL LETTER N WITH TILDE +.. |ntilde| unicode:: U+000F1 .. LATIN SMALL LETTER N WITH TILDE +.. |Oacute| unicode:: U+000D3 .. LATIN CAPITAL LETTER O WITH ACUTE +.. |oacute| unicode:: U+000F3 .. LATIN SMALL LETTER O WITH ACUTE +.. |Ocirc| unicode:: U+000D4 .. LATIN CAPITAL LETTER O WITH CIRCUMFLEX +.. |ocirc| unicode:: U+000F4 .. LATIN SMALL LETTER O WITH CIRCUMFLEX +.. |Ograve| unicode:: U+000D2 .. LATIN CAPITAL LETTER O WITH GRAVE +.. |ograve| unicode:: U+000F2 .. LATIN SMALL LETTER O WITH GRAVE +.. |ordf| unicode:: U+000AA .. FEMININE ORDINAL INDICATOR +.. |ordm| unicode:: U+000BA .. MASCULINE ORDINAL INDICATOR +.. |Oslash| unicode:: U+000D8 .. LATIN CAPITAL LETTER O WITH STROKE +.. |oslash| unicode:: U+000F8 .. LATIN SMALL LETTER O WITH STROKE +.. |Otilde| unicode:: U+000D5 .. LATIN CAPITAL LETTER O WITH TILDE +.. |otilde| unicode:: U+000F5 .. LATIN SMALL LETTER O WITH TILDE +.. |Ouml| unicode:: U+000D6 .. LATIN CAPITAL LETTER O WITH DIAERESIS +.. |ouml| unicode:: U+000F6 .. LATIN SMALL LETTER O WITH DIAERESIS +.. |para| unicode:: U+000B6 .. PILCROW SIGN +.. |plusmn| unicode:: U+000B1 .. PLUS-MINUS SIGN +.. |pound| unicode:: U+000A3 .. POUND SIGN +.. |raquo| unicode:: U+000BB .. RIGHT-POINTING DOUBLE ANGLE QUOTATION MARK +.. |reg| unicode:: U+000AE .. REGISTERED SIGN +.. |sect| unicode:: U+000A7 .. SECTION SIGN +.. |shy| unicode:: U+000AD .. SOFT HYPHEN +.. |sup1| unicode:: U+000B9 .. SUPERSCRIPT ONE +.. |sup2| unicode:: U+000B2 .. SUPERSCRIPT TWO +.. |sup3| unicode:: U+000B3 .. SUPERSCRIPT THREE +.. |szlig| unicode:: U+000DF .. LATIN SMALL LETTER SHARP S +.. |THORN| unicode:: U+000DE .. LATIN CAPITAL LETTER THORN +.. |thorn| unicode:: U+000FE .. LATIN SMALL LETTER THORN +.. |times| unicode:: U+000D7 .. MULTIPLICATION SIGN +.. |Uacute| unicode:: U+000DA .. LATIN CAPITAL LETTER U WITH ACUTE +.. |uacute| unicode:: U+000FA .. LATIN SMALL LETTER U WITH ACUTE +.. |Ucirc| unicode:: U+000DB .. LATIN CAPITAL LETTER U WITH CIRCUMFLEX +.. |ucirc| unicode:: U+000FB .. LATIN SMALL LETTER U WITH CIRCUMFLEX +.. |Ugrave| unicode:: U+000D9 .. LATIN CAPITAL LETTER U WITH GRAVE +.. |ugrave| unicode:: U+000F9 .. LATIN SMALL LETTER U WITH GRAVE +.. |uml| unicode:: U+000A8 .. DIAERESIS +.. |Uuml| unicode:: U+000DC .. LATIN CAPITAL LETTER U WITH DIAERESIS +.. |uuml| unicode:: U+000FC .. LATIN SMALL LETTER U WITH DIAERESIS +.. |Yacute| unicode:: U+000DD .. LATIN CAPITAL LETTER Y WITH ACUTE +.. |yacute| unicode:: U+000FD .. LATIN SMALL LETTER Y WITH ACUTE +.. |yen| unicode:: U+000A5 .. YEN SIGN +.. |yuml| unicode:: U+000FF .. LATIN SMALL LETTER Y WITH DIAERESIS diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/xhtml1-special.txt --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/xhtml1-special.txt Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,37 @@ +.. This data file has been placed in the public domain. +.. Derived from the Unicode character mappings available from + . + Processed by unicode2rstsubs.py, part of Docutils: + . + +.. |bdquo| unicode:: U+0201E .. DOUBLE LOW-9 QUOTATION MARK +.. |circ| unicode:: U+002C6 .. MODIFIER LETTER CIRCUMFLEX ACCENT +.. |Dagger| unicode:: U+02021 .. DOUBLE DAGGER +.. |dagger| unicode:: U+02020 .. DAGGER +.. |emsp| unicode:: U+02003 .. EM SPACE +.. |ensp| unicode:: U+02002 .. EN SPACE +.. |euro| unicode:: U+020AC .. EURO SIGN +.. |gt| unicode:: U+0003E .. GREATER-THAN SIGN +.. |ldquo| unicode:: U+0201C .. LEFT DOUBLE QUOTATION MARK +.. |lrm| unicode:: U+0200E .. LEFT-TO-RIGHT MARK +.. |lsaquo| unicode:: U+02039 .. SINGLE LEFT-POINTING ANGLE QUOTATION MARK +.. |lsquo| unicode:: U+02018 .. LEFT SINGLE QUOTATION MARK +.. |lt| unicode:: U+0003C .. LESS-THAN SIGN +.. |mdash| unicode:: U+02014 .. EM DASH +.. |ndash| unicode:: U+02013 .. EN DASH +.. |OElig| unicode:: U+00152 .. LATIN CAPITAL LIGATURE OE +.. |oelig| unicode:: U+00153 .. LATIN SMALL LIGATURE OE +.. |permil| unicode:: U+02030 .. PER MILLE SIGN +.. |quot| unicode:: U+00022 .. QUOTATION MARK +.. |rdquo| unicode:: U+0201D .. RIGHT DOUBLE QUOTATION MARK +.. |rlm| unicode:: U+0200F .. RIGHT-TO-LEFT MARK +.. |rsaquo| unicode:: U+0203A .. SINGLE RIGHT-POINTING ANGLE QUOTATION MARK +.. |rsquo| unicode:: U+02019 .. RIGHT SINGLE QUOTATION MARK +.. |sbquo| unicode:: U+0201A .. SINGLE LOW-9 QUOTATION MARK +.. |Scaron| unicode:: U+00160 .. LATIN CAPITAL LETTER S WITH CARON +.. |scaron| unicode:: U+00161 .. LATIN SMALL LETTER S WITH CARON +.. |thinsp| unicode:: U+02009 .. THIN SPACE +.. |tilde| unicode:: U+002DC .. SMALL TILDE +.. |Yuml| unicode:: U+00178 .. LATIN CAPITAL LETTER Y WITH DIAERESIS +.. |zwj| unicode:: U+0200D .. ZERO WIDTH JOINER +.. |zwnj| unicode:: U+0200C .. ZERO WIDTH NON-JOINER diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/xhtml1-symbol.txt --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/include/xhtml1-symbol.txt Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,130 @@ +.. This data file has been placed in the public domain. +.. Derived from the Unicode character mappings available from + . + Processed by unicode2rstsubs.py, part of Docutils: + . + +.. |alefsym| unicode:: U+02135 .. ALEF SYMBOL +.. |Alpha| unicode:: U+00391 .. GREEK CAPITAL LETTER ALPHA +.. |alpha| unicode:: U+003B1 .. GREEK SMALL LETTER ALPHA +.. |and| unicode:: U+02227 .. LOGICAL AND +.. |ang| unicode:: U+02220 .. ANGLE +.. |asymp| unicode:: U+02248 .. ALMOST EQUAL TO +.. |Beta| unicode:: U+00392 .. GREEK CAPITAL LETTER BETA +.. |beta| unicode:: U+003B2 .. GREEK SMALL LETTER BETA +.. |bull| unicode:: U+02022 .. BULLET +.. |cap| unicode:: U+02229 .. INTERSECTION +.. |Chi| unicode:: U+003A7 .. GREEK CAPITAL LETTER CHI +.. |chi| unicode:: U+003C7 .. GREEK SMALL LETTER CHI +.. |clubs| unicode:: U+02663 .. BLACK CLUB SUIT +.. |cong| unicode:: U+02245 .. APPROXIMATELY EQUAL TO +.. |crarr| unicode:: U+021B5 .. DOWNWARDS ARROW WITH CORNER LEFTWARDS +.. |cup| unicode:: U+0222A .. UNION +.. |dArr| unicode:: U+021D3 .. DOWNWARDS DOUBLE ARROW +.. |darr| unicode:: U+02193 .. DOWNWARDS ARROW +.. |Delta| unicode:: U+00394 .. GREEK CAPITAL LETTER DELTA +.. |delta| unicode:: U+003B4 .. GREEK SMALL LETTER DELTA +.. |diams| unicode:: U+02666 .. BLACK DIAMOND SUIT +.. |empty| unicode:: U+02205 .. EMPTY SET +.. |Epsilon| unicode:: U+00395 .. GREEK CAPITAL LETTER EPSILON +.. |epsilon| unicode:: U+003B5 .. GREEK SMALL LETTER EPSILON +.. |equiv| unicode:: U+02261 .. IDENTICAL TO +.. |Eta| unicode:: U+00397 .. GREEK CAPITAL LETTER ETA +.. |eta| unicode:: U+003B7 .. GREEK SMALL LETTER ETA +.. |exist| unicode:: U+02203 .. THERE EXISTS +.. |fnof| unicode:: U+00192 .. LATIN SMALL LETTER F WITH HOOK +.. |forall| unicode:: U+02200 .. FOR ALL +.. |frasl| unicode:: U+02044 .. FRACTION SLASH +.. |Gamma| unicode:: U+00393 .. GREEK CAPITAL LETTER GAMMA +.. |gamma| unicode:: U+003B3 .. GREEK SMALL LETTER GAMMA +.. |ge| unicode:: U+02265 .. GREATER-THAN OR EQUAL TO +.. |hArr| unicode:: U+021D4 .. LEFT RIGHT DOUBLE ARROW +.. |harr| unicode:: U+02194 .. LEFT RIGHT ARROW +.. |hearts| unicode:: U+02665 .. BLACK HEART SUIT +.. |hellip| unicode:: U+02026 .. HORIZONTAL ELLIPSIS +.. |image| unicode:: U+02111 .. BLACK-LETTER CAPITAL I +.. |infin| unicode:: U+0221E .. INFINITY +.. |int| unicode:: U+0222B .. INTEGRAL +.. |Iota| unicode:: U+00399 .. GREEK CAPITAL LETTER IOTA +.. |iota| unicode:: U+003B9 .. GREEK SMALL LETTER IOTA +.. |isin| unicode:: U+02208 .. ELEMENT OF +.. |Kappa| unicode:: U+0039A .. GREEK CAPITAL LETTER KAPPA +.. |kappa| unicode:: U+003BA .. GREEK SMALL LETTER KAPPA +.. |Lambda| unicode:: U+0039B .. GREEK CAPITAL LETTER LAMDA +.. |lambda| unicode:: U+003BB .. GREEK SMALL LETTER LAMDA +.. |lang| unicode:: U+02329 .. LEFT-POINTING ANGLE BRACKET +.. |lArr| unicode:: U+021D0 .. LEFTWARDS DOUBLE ARROW +.. |larr| unicode:: U+02190 .. LEFTWARDS ARROW +.. |lceil| unicode:: U+02308 .. LEFT CEILING +.. |le| unicode:: U+02264 .. LESS-THAN OR EQUAL TO +.. |lfloor| unicode:: U+0230A .. LEFT FLOOR +.. |lowast| unicode:: U+02217 .. ASTERISK OPERATOR +.. |loz| unicode:: U+025CA .. LOZENGE +.. |minus| unicode:: U+02212 .. MINUS SIGN +.. |Mu| unicode:: U+0039C .. GREEK CAPITAL LETTER MU +.. |mu| unicode:: U+003BC .. GREEK SMALL LETTER MU +.. |nabla| unicode:: U+02207 .. NABLA +.. |ne| unicode:: U+02260 .. NOT EQUAL TO +.. |ni| unicode:: U+0220B .. CONTAINS AS MEMBER +.. |notin| unicode:: U+02209 .. NOT AN ELEMENT OF +.. |nsub| unicode:: U+02284 .. NOT A SUBSET OF +.. |Nu| unicode:: U+0039D .. GREEK CAPITAL LETTER NU +.. |nu| unicode:: U+003BD .. GREEK SMALL LETTER NU +.. |oline| unicode:: U+0203E .. OVERLINE +.. |Omega| unicode:: U+003A9 .. GREEK CAPITAL LETTER OMEGA +.. |omega| unicode:: U+003C9 .. GREEK SMALL LETTER OMEGA +.. |Omicron| unicode:: U+0039F .. GREEK CAPITAL LETTER OMICRON +.. |omicron| unicode:: U+003BF .. GREEK SMALL LETTER OMICRON +.. |oplus| unicode:: U+02295 .. CIRCLED PLUS +.. |or| unicode:: U+02228 .. LOGICAL OR +.. |otimes| unicode:: U+02297 .. CIRCLED TIMES +.. |part| unicode:: U+02202 .. PARTIAL DIFFERENTIAL +.. |perp| unicode:: U+022A5 .. UP TACK +.. |Phi| unicode:: U+003A6 .. GREEK CAPITAL LETTER PHI +.. |phi| unicode:: U+003D5 .. GREEK PHI SYMBOL +.. |Pi| unicode:: U+003A0 .. GREEK CAPITAL LETTER PI +.. |pi| unicode:: U+003C0 .. GREEK SMALL LETTER PI +.. |piv| unicode:: U+003D6 .. GREEK PI SYMBOL +.. |Prime| unicode:: U+02033 .. DOUBLE PRIME +.. |prime| unicode:: U+02032 .. PRIME +.. |prod| unicode:: U+0220F .. N-ARY PRODUCT +.. |prop| unicode:: U+0221D .. PROPORTIONAL TO +.. |Psi| unicode:: U+003A8 .. GREEK CAPITAL LETTER PSI +.. |psi| unicode:: U+003C8 .. GREEK SMALL LETTER PSI +.. |radic| unicode:: U+0221A .. SQUARE ROOT +.. |rang| unicode:: U+0232A .. RIGHT-POINTING ANGLE BRACKET +.. |rArr| unicode:: U+021D2 .. RIGHTWARDS DOUBLE ARROW +.. |rarr| unicode:: U+02192 .. RIGHTWARDS ARROW +.. |rceil| unicode:: U+02309 .. RIGHT CEILING +.. |real| unicode:: U+0211C .. BLACK-LETTER CAPITAL R +.. |rfloor| unicode:: U+0230B .. RIGHT FLOOR +.. |Rho| unicode:: U+003A1 .. GREEK CAPITAL LETTER RHO +.. |rho| unicode:: U+003C1 .. GREEK SMALL LETTER RHO +.. |sdot| unicode:: U+022C5 .. DOT OPERATOR +.. |Sigma| unicode:: U+003A3 .. GREEK CAPITAL LETTER SIGMA +.. |sigma| unicode:: U+003C3 .. GREEK SMALL LETTER SIGMA +.. |sigmaf| unicode:: U+003C2 .. GREEK SMALL LETTER FINAL SIGMA +.. |sim| unicode:: U+0223C .. TILDE OPERATOR +.. |spades| unicode:: U+02660 .. BLACK SPADE SUIT +.. |sub| unicode:: U+02282 .. SUBSET OF +.. |sube| unicode:: U+02286 .. SUBSET OF OR EQUAL TO +.. |sum| unicode:: U+02211 .. N-ARY SUMMATION +.. |sup| unicode:: U+02283 .. SUPERSET OF +.. |supe| unicode:: U+02287 .. SUPERSET OF OR EQUAL TO +.. |Tau| unicode:: U+003A4 .. GREEK CAPITAL LETTER TAU +.. |tau| unicode:: U+003C4 .. GREEK SMALL LETTER TAU +.. |there4| unicode:: U+02234 .. THEREFORE +.. |Theta| unicode:: U+00398 .. GREEK CAPITAL LETTER THETA +.. |theta| unicode:: U+003B8 .. GREEK SMALL LETTER THETA +.. |thetasym| unicode:: U+003D1 .. GREEK THETA SYMBOL +.. |trade| unicode:: U+02122 .. TRADE MARK SIGN +.. |uArr| unicode:: U+021D1 .. UPWARDS DOUBLE ARROW +.. |uarr| unicode:: U+02191 .. UPWARDS ARROW +.. |upsih| unicode:: U+003D2 .. GREEK UPSILON WITH HOOK SYMBOL +.. |Upsilon| unicode:: U+003A5 .. GREEK CAPITAL LETTER UPSILON +.. |upsilon| unicode:: U+003C5 .. GREEK SMALL LETTER UPSILON +.. |weierp| unicode:: U+02118 .. SCRIPT CAPITAL P +.. |Xi| unicode:: U+0039E .. GREEK CAPITAL LETTER XI +.. |xi| unicode:: U+003BE .. GREEK SMALL LETTER XI +.. |Zeta| unicode:: U+00396 .. GREEK CAPITAL LETTER ZETA +.. |zeta| unicode:: U+003B6 .. GREEK SMALL LETTER ZETA diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/languages/init.py --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/languages/init.py Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,25 @@ +# $Id: init.py 4564 2006-05-21 20:44:42Z wiemann $ +# Author: David Goodger +# Copyright: This module has been placed in the public domain. + +# Internationalization details are documented in +# . + +""" +This package contains modules for language-dependent features of +reStructuredText. +""" + +docformat = 'reStructuredText' + +_languages = {} + +def get_language(language_code): + if _languages.has_key(language_code): + return _languages[language_code] + try: + module = import(language_code, globals(), locals()) + except ImportError: + return None + _languages[language_code] = module + return module diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/languages/af.py --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/languages/af.py Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,102 @@ +# $Id: af.py 4564 2006-05-21 20:44:42Z wiemann $ +# Author: Jannie Hofmeyr +# Copyright: This module has been placed in the public domain. + +# New language mappings are welcome. Before doing a new translation, please +# read . Two files must be +# translated for each language: one in docutils/languages, the other in +# docutils/parsers/rst/languages. + +""" +Afrikaans-language mappings for language-dependent features of +reStructuredText. +""" + +docformat = 'reStructuredText' + + +directives = { + 'aandag': 'attention', + 'versigtig': 'caution', + 'gevaar': 'danger', + 'fout': 'error', + 'wenk': 'hint', + 'belangrik': 'important', + 'nota': 'note', + 'tip': 'tip', # hint and tip both have the same translation: wenk + 'waarskuwing': 'warning', + 'vermaning': 'admonition', + 'kantstreep': 'sidebar', + 'onderwerp': 'topic', + 'lynblok': 'line-block', + 'parsed-literal (translation required)': 'parsed-literal', + 'rubriek': 'rubric', + 'epigraaf': 'epigraph', + 'hoogtepunte': 'highlights', + 'pull-quote (translation required)': 'pull-quote', + u'compound (translation required)': 'compound', + u'container (translation required)': 'container', + #'vrae': 'questions', + #'qa': 'questions', + #'faq': 'questions', + 'table (translation required)': 'table', + 'csv-table (translation required)': 'csv-table', + 'list-table (translation required)': 'list-table', + 'meta': 'meta', + #'beeldkaart': 'imagemap', + 'beeld': 'image', + 'figuur': 'figure', + 'insluiting': 'include', + 'rou': 'raw', + 'vervang': 'replace', + 'unicode': 'unicode', # should this be translated? unikode + 'datum': 'date', + 'klas': 'class', + 'role (translation required)': 'role', + 'default-role (translation required)': 'default-role', + 'title (translation required)': 'title', + 'inhoud': 'contents', + 'sectnum': 'sectnum', + 'section-numbering': 'sectnum', + u'header (translation required)': 'header', + u'footer (translation required)': 'footer', + #'voetnote': 'footnotes', + #'aanhalings': 'citations', + 'teikennotas': 'target-notes', + 'restructuredtext-test-directive': 'restructuredtext-test-directive'} +"""Afrikaans name to registered (in directives/init.py) directive name +mapping.""" + +roles = { + 'afkorting': 'abbreviation', + 'ab': 'abbreviation', + 'akroniem': 'acronym', + 'ac': 'acronym', + 'indeks': 'index', + 'i': 'index', + 'voetskrif': 'subscript', + 'sub': 'subscript', + 'boskrif': 'superscript', + 'sup': 'superscript', + 'titelverwysing': 'title-reference', + 'titel': 'title-reference', + 't': 'title-reference', + 'pep-verwysing': 'pep-reference', + 'pep': 'pep-reference', + 'rfc-verwysing': 'rfc-reference', + 'rfc': 'rfc-reference', + 'nadruk': 'emphasis', + 'sterk': 'strong', + 'literal (translation required)': 'literal', + 'benoemde verwysing': 'named-reference', + 'anonieme verwysing': 'anonymous-reference', + 'voetnootverwysing': 'footnote-reference', + 'aanhalingverwysing': 'citation-reference', + 'vervangingsverwysing': 'substitution-reference', + 'teiken': 'target', + 'uri-verwysing': 'uri-reference', + 'uri': 'uri-reference', + 'url': 'uri-reference', + 'rou': 'raw',} +"""Mapping of Afrikaans role names to canonical role names for interpreted text. +""" diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/languages/ca.py --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/languages/ca.py Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,121 @@ +# $Id: ca.py 4564 2006-05-21 20:44:42Z wiemann $ +# Author: Ivan Vilata i Balaguer +# Copyright: This module has been placed in the public domain. + +# New language mappings are welcome. Before doing a new translation, please +# read . Two files must be +# translated for each language: one in docutils/languages, the other in +# docutils/parsers/rst/languages. + +""" +Catalan-language mappings for language-dependent features of +reStructuredText. +""" + +docformat = 'reStructuredText' + + +directives = { + # language-dependent: fixed + u'atenci\u00F3': 'attention', + u'compte': 'caution', + u'perill': 'danger', + u'error': 'error', + u'suggeriment': 'hint', + u'important': 'important', + u'nota': 'note', + u'consell': 'tip', + u'av\u00EDs': 'warning', + u'advertiment': 'admonition', + u'nota-al-marge': 'sidebar', + u'nota-marge': 'sidebar', + u'tema': 'topic', + u'bloc-de-l\u00EDnies': 'line-block', + u'bloc-l\u00EDnies': 'line-block', + u'literal-analitzat': 'parsed-literal', + u'r\u00FAbrica': 'rubric', + u'ep\u00EDgraf': 'epigraph', + u'sumari': 'highlights', + u'cita-destacada': 'pull-quote', + u'compost': 'compound', + u'container (translation required)': 'container', + #'questions': 'questions', + u'taula': 'table', + u'taula-csv': 'csv-table', + u'taula-llista': 'list-table', + #'qa': 'questions', + #'faq': 'questions', + u'meta': 'meta', + #'imagemap': 'imagemap', + u'imatge': 'image', + u'figura': 'figure', + u'inclou': 'include', + u'incloure': 'include', + u'cru': 'raw', + u'reempla\u00E7a': 'replace', + u'reempla\u00E7ar': 'replace', + u'unicode': 'unicode', + u'data': 'date', + u'classe': 'class', + u'rol': 'role', + u'default-role (translation required)': 'default-role', + u'title (translation required)': 'title', + u'contingut': 'contents', + u'numsec': 'sectnum', + u'numeraci\u00F3-de-seccions': 'sectnum', + u'numeraci\u00F3-seccions': 'sectnum', + u'cap\u00E7alera': 'header', + u'peu-de-p\u00E0gina': 'footer', + u'peu-p\u00E0gina': 'footer', + #'footnotes': 'footnotes', + #'citations': 'citations', + u'notes-amb-destinacions': 'target-notes', + u'notes-destinacions': 'target-notes', + u'directiva-de-prova-de-restructuredtext': 'restructuredtext-test-directive'} +"""Catalan name to registered (in directives/init.py) directive name +mapping.""" + +roles = { + # language-dependent: fixed + u'abreviatura': 'abbreviation', + u'abreviaci\u00F3': 'abbreviation', + u'abrev': 'abbreviation', + u'ab': 'abbreviation', + u'acr\u00F2nim': 'acronym', + u'ac': 'acronym', + u'\u00EDndex': 'index', + u'i': 'index', + u'sub\u00EDndex': 'subscript', + u'sub': 'subscript', + u'super\u00EDndex': 'superscript', + u'sup': 'superscript', + u'refer\u00E8ncia-a-t\u00EDtol': 'title-reference', + u'refer\u00E8ncia-t\u00EDtol': 'title-reference', + u't\u00EDtol': 'title-reference', + u't': 'title-reference', + u'refer\u00E8ncia-a-pep': 'pep-reference', + u'refer\u00E8ncia-pep': 'pep-reference', + u'pep': 'pep-reference', + u'refer\u00E8ncia-a-rfc': 'rfc-reference', + u'refer\u00E8ncia-rfc': 'rfc-reference', + u'rfc': 'rfc-reference', + u'\u00E8mfasi': 'emphasis', + u'destacat': 'strong', + u'literal': 'literal', + u'refer\u00E8ncia-amb-nom': 'named-reference', + u'refer\u00E8ncia-nom': 'named-reference', + u'refer\u00E8ncia-an\u00F2nima': 'anonymous-reference', + u'refer\u00E8ncia-a-nota-al-peu': 'footnote-reference', + u'refer\u00E8ncia-nota-al-peu': 'footnote-reference', + u'refer\u00E8ncia-a-cita': 'citation-reference', + u'refer\u00E8ncia-cita': 'citation-reference', + u'refer\u00E8ncia-a-substituci\u00F3': 'substitution-reference', + u'refer\u00E8ncia-substituci\u00F3': 'substitution-reference', + u'destinaci\u00F3': 'target', + u'refer\u00E8ncia-a-uri': 'uri-reference', + u'refer\u00E8ncia-uri': 'uri-reference', + u'uri': 'uri-reference', + u'url': 'uri-reference', + u'cru': 'raw',} +"""Mapping of Catalan role names to canonical role names for interpreted text. +""" diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/languages/cs.py --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/languages/cs.py Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,104 @@ +# $Id: cs.py 4564 2006-05-21 20:44:42Z wiemann $ +# Author: Marek Blaha +# Copyright: This module has been placed in the public domain. + +# New language mappings are welcome. Before doing a new translation, please +# read . Two files must be +# translated for each language: one in docutils/languages, the other in +# docutils/parsers/rst/languages. + +""" +Czech-language mappings for language-dependent features of +reStructuredText. +""" + +docformat = 'reStructuredText' + + +directives = { + # language-dependent: fixed + u'pozor': 'attention', + u'caution (translation required)': 'caution', # jak rozlisit caution a warning? + u'nebezpe\u010D\u00ED': 'danger', + u'chyba': 'error', + u'rada': 'hint', + u'd\u016Fle\u017Eit\u00E9': 'important', + u'pozn\u00E1mka': 'note', + u'tip (translation required)': 'tip', + u'varov\u00E1n\u00ED': 'warning', + u'admonition (translation required)': 'admonition', + u'sidebar (translation required)': 'sidebar', + u't\u00E9ma': 'topic', + u'line-block (translation required)': 'line-block', + u'parsed-literal (translation required)': 'parsed-literal', + u'odd\u00EDl': 'rubric', + u'moto': 'epigraph', + u'highlights (translation required)': 'highlights', + u'pull-quote (translation required)': 'pull-quote', + u'compound (translation required)': 'compound', + u'container (translation required)': 'container', + #'questions': 'questions', + #'qa': 'questions', + #'faq': 'questions', + u'table (translation required)': 'table', + u'csv-table (translation required)': 'csv-table', + u'list-table (translation required)': 'list-table', + u'meta (translation required)': 'meta', + #'imagemap': 'imagemap', + u'image (translation required)': 'image', # obrazek + u'figure (translation required)': 'figure', # a tady? + u'include (translation required)': 'include', + u'raw (translation required)': 'raw', + u'replace (translation required)': 'replace', + u'unicode (translation required)': 'unicode', + u'datum': 'date', + u't\u0159\u00EDda': 'class', + u'role (translation required)': 'role', + u'default-role (translation required)': 'default-role', + u'title (translation required)': 'title', + u'obsah': 'contents', + u'sectnum (translation required)': 'sectnum', + u'section-numbering (translation required)': 'sectnum', + u'header (translation required)': 'header', + u'footer (translation required)': 'footer', + #'footnotes': 'footnotes', + #'citations': 'citations', + u'target-notes (translation required)': 'target-notes', + u'restructuredtext-test-directive': 'restructuredtext-test-directive'} +"""Czech name to registered (in directives/init.py) directive name +mapping.""" + +roles = { + # language-dependent: fixed + u'abbreviation (translation required)': 'abbreviation', + u'ab (translation required)': 'abbreviation', + u'acronym (translation required)': 'acronym', + u'ac (translation required)': 'acronym', + u'index (translation required)': 'index', + u'i (translation required)': 'index', + u'subscript (translation required)': 'subscript', + u'sub (translation required)': 'subscript', + u'superscript (translation required)': 'superscript', + u'sup (translation required)': 'superscript', + u'title-reference (translation required)': 'title-reference', + u'title (translation required)': 'title-reference', + u't (translation required)': 'title-reference', + u'pep-reference (translation required)': 'pep-reference', + u'pep (translation required)': 'pep-reference', + u'rfc-reference (translation required)': 'rfc-reference', + u'rfc (translation required)': 'rfc-reference', + u'emphasis (translation required)': 'emphasis', + u'strong (translation required)': 'strong', + u'literal (translation required)': 'literal', + u'named-reference (translation required)': 'named-reference', + u'anonymous-reference (translation required)': 'anonymous-reference', + u'footnote-reference (translation required)': 'footnote-reference', + u'citation-reference (translation required)': 'citation-reference', + u'substitution-reference (translation required)': 'substitution-reference', + u'target (translation required)': 'target', + u'uri-reference (translation required)': 'uri-reference', + u'uri (translation required)': 'uri-reference', + u'url (translation required)': 'uri-reference', + u'raw (translation required)': 'raw',} +"""Mapping of Czech role names to canonical role names for interpreted text. +""" diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/languages/de.py --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/languages/de.py Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,96 @@ +# $Id: de.py 5174 2007-05-31 00:01:52Z wiemann $ +# Authors: Engelbert Gruber ; +# Lea Wiemann +# Copyright: This module has been placed in the public domain. + +# New language mappings are welcome. Before doing a new translation, please +# read . Two files must be +# translated for each language: one in docutils/languages, the other in +# docutils/parsers/rst/languages. + +""" +German-language mappings for language-dependent features of +reStructuredText. +""" + +docformat = 'reStructuredText' + + +directives = { + 'achtung': 'attention', + 'vorsicht': 'caution', + 'gefahr': 'danger', + 'fehler': 'error', + 'hinweis': 'hint', + 'wichtig': 'important', + 'notiz': 'note', + 'tipp': 'tip', + 'warnung': 'warning', + 'ermahnung': 'admonition', + 'kasten': 'sidebar', + 'seitenkasten': 'sidebar', + 'thema': 'topic', + 'zeilen-block': 'line-block', + 'parsed-literal (translation required)': 'parsed-literal', + 'rubrik': 'rubric', + 'epigraph': 'epigraph', + 'highlights (translation required)': 'highlights', + 'pull-quote (translation required)': 'pull-quote', # kasten too ? + 'zusammengesetzt': 'compound', + 'verbund': 'compound', + u'container (translation required)': 'container', + #'fragen': 'questions', + 'tabelle': 'table', + 'csv-tabelle': 'csv-table', + 'list-table (translation required)': 'list-table', + 'meta': 'meta', + #'imagemap': 'imagemap', + 'bild': 'image', + 'abbildung': 'figure', + u'unver\xe4ndert': 'raw', + u'roh': 'raw', + u'einf\xfcgen': 'include', + 'ersetzung': 'replace', + 'ersetzen': 'replace', + 'ersetze': 'replace', + 'unicode': 'unicode', + 'datum': 'date', + 'klasse': 'class', + 'rolle': 'role', + u'default-role (translation required)': 'default-role', + u'title (translation required)': 'title', + 'inhalt': 'contents', + 'kapitel-nummerierung': 'sectnum', + 'abschnitts-nummerierung': 'sectnum', + u'linkziel-fu\xdfnoten': 'target-notes', + u'header (translation required)': 'header', + u'footer (translation required)': 'footer', + #u'fu\xdfnoten': 'footnotes', + #'zitate': 'citations', + } +"""German name to registered (in directives/init.py) directive name +mapping.""" + +roles = { + u'abk\xfcrzung': 'abbreviation', + 'akronym': 'acronym', + 'index': 'index', + 'tiefgestellt': 'subscript', + 'hochgestellt': 'superscript', + 'titel-referenz': 'title-reference', + 'pep-referenz': 'pep-reference', + 'rfc-referenz': 'rfc-reference', + 'betonung': 'emphasis', + 'fett': 'strong', + u'w\xf6rtlich': 'literal', + 'benannte-referenz': 'named-reference', + 'unbenannte-referenz': 'anonymous-reference', + u'fu\xdfnoten-referenz': 'footnote-reference', + 'zitat-referenz': 'citation-reference', + 'ersetzungs-referenz': 'substitution-reference', + 'ziel': 'target', + 'uri-referenz': 'uri-reference', + u'unver\xe4ndert': 'raw', + u'roh': 'raw',} +"""Mapping of German role names to canonical role names for interpreted text. +""" diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/languages/en.py --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/languages/en.py Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,104 @@ +# $Id: en.py 4564 2006-05-21 20:44:42Z wiemann $ +# Author: David Goodger +# Copyright: This module has been placed in the public domain. + +# New language mappings are welcome. Before doing a new translation, please +# read . Two files must be +# translated for each language: one in docutils/languages, the other in +# docutils/parsers/rst/languages. + +""" +English-language mappings for language-dependent features of +reStructuredText. +""" + +docformat = 'reStructuredText' + + +directives = { + # language-dependent: fixed + 'attention': 'attention', + 'caution': 'caution', + 'danger': 'danger', + 'error': 'error', + 'hint': 'hint', + 'important': 'important', + 'note': 'note', + 'tip': 'tip', + 'warning': 'warning', + 'admonition': 'admonition', + 'sidebar': 'sidebar', + 'topic': 'topic', + 'line-block': 'line-block', + 'parsed-literal': 'parsed-literal', + 'rubric': 'rubric', + 'epigraph': 'epigraph', + 'highlights': 'highlights', + 'pull-quote': 'pull-quote', + 'compound': 'compound', + 'container': 'container', + #'questions': 'questions', + 'table': 'table', + 'csv-table': 'csv-table', + 'list-table': 'list-table', + #'qa': 'questions', + #'faq': 'questions', + 'meta': 'meta', + #'imagemap': 'imagemap', + 'image': 'image', + 'figure': 'figure', + 'include': 'include', + 'raw': 'raw', + 'replace': 'replace', + 'unicode': 'unicode', + 'date': 'date', + 'class': 'class', + 'role': 'role', + 'default-role': 'default-role', + 'title': 'title', + 'contents': 'contents', + 'sectnum': 'sectnum', + 'section-numbering': 'sectnum', + 'header': 'header', + 'footer': 'footer', + #'footnotes': 'footnotes', + #'citations': 'citations', + 'target-notes': 'target-notes', + 'restructuredtext-test-directive': 'restructuredtext-test-directive'} +"""English name to registered (in directives/init.py) directive name +mapping.""" + +roles = { + # language-dependent: fixed + 'abbreviation': 'abbreviation', + 'ab': 'abbreviation', + 'acronym': 'acronym', + 'ac': 'acronym', + 'index': 'index', + 'i': 'index', + 'subscript': 'subscript', + 'sub': 'subscript', + 'superscript': 'superscript', + 'sup': 'superscript', + 'title-reference': 'title-reference', + 'title': 'title-reference', + 't': 'title-reference', + 'pep-reference': 'pep-reference', + 'pep': 'pep-reference', + 'rfc-reference': 'rfc-reference', + 'rfc': 'rfc-reference', + 'emphasis': 'emphasis', + 'strong': 'strong', + 'literal': 'literal', + 'named-reference': 'named-reference', + 'anonymous-reference': 'anonymous-reference', + 'footnote-reference': 'footnote-reference', + 'citation-reference': 'citation-reference', + 'substitution-reference': 'substitution-reference', + 'target': 'target', + 'uri-reference': 'uri-reference', + 'uri': 'uri-reference', + 'url': 'uri-reference', + 'raw': 'raw',} +"""Mapping of English role names to canonical role names for interpreted text. +""" diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/languages/eo.py --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/languages/eo.py Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,114 @@ +# $Id: eo.py 4564 2006-05-21 20:44:42Z wiemann $ +# Author: Marcelo Huerta San Martin +# Copyright: This module has been placed in the public domain. + +# New language mappings are welcome. Before doing a new translation, please +# read . Two files must be +# translated for each language: one in docutils/languages, the other in +# docutils/parsers/rst/languages. + +""" +Esperanto-language mappings for language-dependent features of +reStructuredText. +""" + +docformat = 'reStructuredText' + + +directives = { + # language-dependent: fixed + u'atentu': 'attention', + u'zorgu': 'caution', + u'dangxero': 'danger', + u'dan\u011dero': 'danger', + u'eraro': 'error', + u'spuro': 'hint', + u'grava': 'important', + u'noto': 'note', + u'helpeto': 'tip', + u'averto': 'warning', + u'admono': 'admonition', + u'flankteksto': 'sidebar', + u'temo': 'topic', + u'linea-bloko': 'line-block', + u'analizota-literalo': 'parsed-literal', + u'rubriko': 'rubric', + u'epigrafo': 'epigraph', + u'elstarajxoj': 'highlights', + u'elstara\u0135oj': 'highlights', + u'ekstera-citajxo': 'pull-quote', + u'ekstera-cita\u0135o': 'pull-quote', + u'kombinajxo': 'compound', + u'kombina\u0135o': 'compound', + u'tekstingo': 'container', + u'enhavilo': 'container', + #'questions': 'questions', + #'qa': 'questions', + #'faq': 'questions', + u'tabelo': 'table', + u'tabelo-vdk': 'csv-table', # "valoroj disigitaj per komoj" + u'tabelo-csv': 'csv-table', + u'tabelo-lista': 'list-table', + u'meta': 'meta', + #'imagemap': 'imagemap', + u'bildo': 'image', + u'figuro': 'figure', + u'inkludi': 'include', + u'senanaliza': 'raw', + u'anstatauxi': 'replace', + u'anstata\u016di': 'replace', + u'unicode': 'unicode', + u'dato': 'date', + u'klaso': 'class', + u'rolo': 'role', + u'preterlasita-rolo': 'default-role', + u'titolo': 'title', + u'enhavo': 'contents', + u'seknum': 'sectnum', + u'sekcia-numerado': 'sectnum', + u'kapsekcio': 'header', + u'piedsekcio': 'footer', + #'footnotes': 'footnotes', + #'citations': 'citations', + u'celaj-notoj': 'target-notes', + u'restructuredtext-test-directive': 'restructuredtext-test-directive'} +"""Esperanto name to registered (in directives/init.py) directive name +mapping.""" + +roles = { + # language-dependent: fixed + u'mallongigo': 'abbreviation', + u'mall': 'abbreviation', + u'komenclitero': 'acronym', + u'kl': 'acronym', + u'indekso': 'index', + u'i': 'index', + u'subskribo': 'subscript', + u'sub': 'subscript', + u'supraskribo': 'superscript', + u'sup': 'superscript', + u'titola-referenco': 'title-reference', + u'titolo': 'title-reference', + u't': 'title-reference', + u'pep-referenco': 'pep-reference', + u'pep': 'pep-reference', + u'rfc-referenco': 'rfc-reference', + u'rfc': 'rfc-reference', + u'emfazo': 'emphasis', + u'forta': 'strong', + u'litera': 'literal', + u'nomita-referenco': 'named-reference', + u'nenomita-referenco': 'anonymous-reference', + u'piednota-referenco': 'footnote-reference', + u'citajxo-referenco': 'citation-reference', + u'cita\u0135o-referenco': 'citation-reference', + u'anstatauxa-referenco': 'substitution-reference', + u'anstata\u016da-referenco': 'substitution-reference', + u'celo': 'target', + u'uri-referenco': 'uri-reference', + u'uri': 'uri-reference', + u'url': 'uri-reference', + u'senanaliza': 'raw', +} +"""Mapping of Esperanto role names to canonical role names for interpreted text. +""" diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/languages/es.py --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/languages/es.py Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,121 @@ +# -- coding: utf-8 -- +# $Id: es.py 4564 2006-05-21 20:44:42Z wiemann $ +# Author: Marcelo Huerta San Martín +# Copyright: This module has been placed in the public domain. + +# New language mappings are welcome. Before doing a new translation, please +# read . Two files must be +# translated for each language: one in docutils/languages, the other in +# docutils/parsers/rst/languages. + +""" +Spanish-language mappings for language-dependent features of +reStructuredText. +""" + +docformat = 'reStructuredText' + + +directives = { + u'atenci\u00f3n': 'attention', + u'atencion': 'attention', + u'precauci\u00f3n': 'caution', + u'precaucion': 'caution', + u'peligro': 'danger', + u'error': 'error', + u'sugerencia': 'hint', + u'importante': 'important', + u'nota': 'note', + u'consejo': 'tip', + u'advertencia': 'warning', + u'exhortacion': 'admonition', + u'exhortaci\u00f3n': 'admonition', + u'nota-al-margen': 'sidebar', + u'tema': 'topic', + u'bloque-de-lineas': 'line-block', + u'bloque-de-l\u00edneas': 'line-block', + u'literal-evaluado': 'parsed-literal', + u'firma': 'rubric', + u'ep\u00edgrafe': 'epigraph', + u'epigrafe': 'epigraph', + u'destacado': 'highlights', + u'cita-destacada': 'pull-quote', + u'combinacion': 'compound', + u'combinaci\u00f3n': 'compound', + u'contenedor': 'container', + #'questions': 'questions', + #'qa': 'questions', + #'faq': 'questions', + u'tabla': 'table', + u'tabla-vsc': 'csv-table', + u'tabla-csv': 'csv-table', + u'tabla-lista': 'list-table', + u'meta': 'meta', + #'imagemap': 'imagemap', + u'imagen': 'image', + u'figura': 'figure', + u'incluir': 'include', + u'sin-analisis': 'raw', + u'sin-an\u00e1lisis': 'raw', + u'reemplazar': 'replace', + u'unicode': 'unicode', + u'fecha': 'date', + u'clase': 'class', + u'rol': 'role', + u'rol-por-omision': 'default-role', + u'rol-por-omisi\u00f3n': 'default-role', + u'titulo': 'title', + u't\u00edtulo': 'title', + u'contenido': 'contents', + u'numseccion': 'sectnum', + u'numsecci\u00f3n': 'sectnum', + u'numeracion-seccion': 'sectnum', + u'numeraci\u00f3n-secci\u00f3n': 'sectnum', + u'notas-destino': 'target-notes', + u'cabecera': 'header', + u'pie': 'footer', + #'footnotes': 'footnotes', + #'citations': 'citations', + u'restructuredtext-test-directive': 'restructuredtext-test-directive'} +"""Spanish name to registered (in directives/init.py) directive name +mapping.""" + +roles = { + u'abreviatura': 'abbreviation', + u'ab': 'abbreviation', + u'acronimo': 'acronym', + u'acronimo': 'acronym', + u'ac': 'acronym', + u'indice': 'index', + u'i': 'index', + u'subindice': 'subscript', + u'sub\u00edndice': 'subscript', + u'superindice': 'superscript', + u'super\u00edndice': 'superscript', + u'referencia-titulo': 'title-reference', + u'titulo': 'title-reference', + u't': 'title-reference', + u'referencia-pep': 'pep-reference', + u'pep': 'pep-reference', + u'referencia-rfc': 'rfc-reference', + u'rfc': 'rfc-reference', + u'enfasis': 'emphasis', + u'\u00e9nfasis': 'emphasis', + u'destacado': 'strong', + u'literal': 'literal', # "literal" is also a word in Spanish :-) + u'referencia-con-nombre': 'named-reference', + u'referencia-anonima': 'anonymous-reference', + u'referencia-an\u00f3nima': 'anonymous-reference', + u'referencia-nota-al-pie': 'footnote-reference', + u'referencia-cita': 'citation-reference', + u'referencia-sustitucion': 'substitution-reference', + u'referencia-sustituci\u00f3n': 'substitution-reference', + u'destino': 'target', + u'referencia-uri': 'uri-reference', + u'uri': 'uri-reference', + u'url': 'uri-reference', + u'sin-analisis': 'raw', + u'sin-an\u00e1lisis': 'raw', +} +"""Mapping of Spanish role names to canonical role names for interpreted text. +""" diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/languages/fi.py --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/languages/fi.py Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,93 @@ +# $Id: fi.py 4564 2006-05-21 20:44:42Z wiemann $ +# Author: Asko Soukka +# Copyright: This module has been placed in the public domain. + +# New language mappings are welcome. Before doing a new translation, please +# read . Two files must be +# translated for each language: one in docutils/languages, the other in +# docutils/parsers/rst/languages. + +""" +Finnish-language mappings for language-dependent features of +reStructuredText. +""" + +docformat = 'reStructuredText' + + +directives = { + # language-dependent: fixed + u'huomio': u'attention', + u'varo': u'caution', + u'vaara': u'danger', + u'virhe': u'error', + u'vihje': u'hint', + u't\u00e4rke\u00e4\u00e4': u'important', + u'huomautus': u'note', + u'neuvo': u'tip', + u'varoitus': u'warning', + u'kehotus': u'admonition', + u'sivupalkki': u'sidebar', + u'aihe': u'topic', + u'rivi': u'line-block', + u'tasalevyinen': u'parsed-literal', + u'ohje': u'rubric', + u'epigraafi': u'epigraph', + u'kohokohdat': u'highlights', + u'lainaus': u'pull-quote', + u'taulukko': u'table', + u'csv-taulukko': u'csv-table', + u'list-table (translation required)': 'list-table', + u'compound (translation required)': 'compound', + u'container (translation required)': 'container', + #u'kysymykset': u'questions', + u'meta': u'meta', + #u'kuvakartta': u'imagemap', + u'kuva': u'image', + u'kaavio': u'figure', + u'sis\u00e4llyt\u00e4': u'include', + u'raaka': u'raw', + u'korvaa': u'replace', + u'unicode': u'unicode', + u'p\u00e4iv\u00e4ys': u'date', + u'luokka': u'class', + u'rooli': u'role', + u'default-role (translation required)': 'default-role', + u'title (translation required)': 'title', + u'sis\u00e4llys': u'contents', + u'kappale': u'sectnum', + u'header (translation required)': 'header', + u'footer (translation required)': 'footer', + #u'alaviitteet': u'footnotes', + #u'viitaukset': u'citations', + u'target-notes (translation required)': u'target-notes'} +"""Finnish name to registered (in directives/init.py) directive name +mapping.""" + +roles = { + # language-dependent: fixed + u'lyhennys': u'abbreviation', + u'akronyymi': u'acronym', + u'kirjainsana': u'acronym', + u'hakemisto': u'index', + u'luettelo': u'index', + u'alaindeksi': u'subscript', + u'indeksi': u'subscript', + u'yl\u00e4indeksi': u'superscript', + u'title-reference (translation required)': u'title-reference', + u'title (translation required)': u'title-reference', + u'pep-reference (translation required)': u'pep-reference', + u'rfc-reference (translation required)': u'rfc-reference', + u'korostus': u'emphasis', + u'vahvistus': u'strong', + u'tasalevyinen': u'literal', + u'named-reference (translation required)': u'named-reference', + u'anonymous-reference (translation required)': u'anonymous-reference', + u'footnote-reference (translation required)': u'footnote-reference', + u'citation-reference (translation required)': u'citation-reference', + u'substitution-reference (translation required)': u'substitution-reference', + u'kohde': u'target', + u'uri-reference (translation required)': u'uri-reference', + u'raw (translation required)': 'raw',} +"""Mapping of Finnish role names to canonical role names for interpreted text. +""" diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/languages/fr.py --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/languages/fr.py Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,99 @@ +# $Id: fr.py 4564 2006-05-21 20:44:42Z wiemann $ +# Authors: David Goodger ; William Dode +# Copyright: This module has been placed in the public domain. + +# New language mappings are welcome. Before doing a new translation, please +# read . Two files must be +# translated for each language: one in docutils/languages, the other in +# docutils/parsers/rst/languages. + +""" +French-language mappings for language-dependent features of +reStructuredText. +""" + +docformat = 'reStructuredText' + + +directives = { + u'attention': 'attention', + u'pr\u00E9caution': 'caution', + u'danger': 'danger', + u'erreur': 'error', + u'conseil': 'hint', + u'important': 'important', + u'note': 'note', + u'astuce': 'tip', + u'avertissement': 'warning', + u'admonition': 'admonition', + u'encadr\u00E9': 'sidebar', + u'sujet': 'topic', + u'bloc-textuel': 'line-block', + u'bloc-interpr\u00E9t\u00E9': 'parsed-literal', + u'code-interpr\u00E9t\u00E9': 'parsed-literal', + u'intertitre': 'rubric', + u'exergue': 'epigraph', + u'\u00E9pigraphe': 'epigraph', + u'chapeau': 'highlights', + u'accroche': 'pull-quote', + u'compound (translation required)': 'compound', + u'container (translation required)': 'container', + #u'questions': 'questions', + #u'qr': 'questions', + #u'faq': 'questions', + u'tableau': 'table', + u'csv-table (translation required)': 'csv-table', + u'list-table (translation required)': 'list-table', + u'm\u00E9ta': 'meta', + #u'imagemap (translation required)': 'imagemap', + u'image': 'image', + u'figure': 'figure', + u'inclure': 'include', + u'brut': 'raw', + u'remplacer': 'replace', + u'remplace': 'replace', + u'unicode': 'unicode', + u'date': 'date', + u'classe': 'class', + u'role (translation required)': 'role', + u'default-role (translation required)': 'default-role', + u'titre (translation required)': 'title', + u'sommaire': 'contents', + u'table-des-mati\u00E8res': 'contents', + u'sectnum': 'sectnum', + u'section-num\u00E9rot\u00E9e': 'sectnum', + u'liens': 'target-notes', + u'header (translation required)': 'header', + u'footer (translation required)': 'footer', + #u'footnotes (translation required)': 'footnotes', + #u'citations (translation required)': 'citations', + } +"""French name to registered (in directives/init.py) directive name +mapping.""" + +roles = { + u'abr\u00E9viation': 'abbreviation', + u'acronyme': 'acronym', + u'sigle': 'acronym', + u'index': 'index', + u'indice': 'subscript', + u'ind': 'subscript', + u'exposant': 'superscript', + u'exp': 'superscript', + u'titre-r\u00E9f\u00E9rence': 'title-reference', + u'titre': 'title-reference', + u'pep-r\u00E9f\u00E9rence': 'pep-reference', + u'rfc-r\u00E9f\u00E9rence': 'rfc-reference', + u'emphase': 'emphasis', + u'fort': 'strong', + u'litt\u00E9ral': 'literal', + u'nomm\u00E9e-r\u00E9f\u00E9rence': 'named-reference', + u'anonyme-r\u00E9f\u00E9rence': 'anonymous-reference', + u'note-r\u00E9f\u00E9rence': 'footnote-reference', + u'citation-r\u00E9f\u00E9rence': 'citation-reference', + u'substitution-r\u00E9f\u00E9rence': 'substitution-reference', + u'lien': 'target', + u'uri-r\u00E9f\u00E9rence': 'uri-reference', + u'brut': 'raw',} +"""Mapping of French role names to canonical role names for interpreted text. +""" diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/languages/he.py --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/languages/he.py Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,104 @@ +# Author: Meir Kriheli +# Id: $Id: he.py 4837 2006-12-26 09:59:41Z sfcben $ +# Copyright: This module has been placed in the public domain. + +# New language mappings are welcome. Before doing a new translation, please +# read . Two files must be +# translated for each language: one in docutils/languages, the other in +# docutils/parsers/rst/languages. + +""" +English-language mappings for language-dependent features of +reStructuredText. +""" + +docformat = 'reStructuredText' + + +directives = { + # language-dependent: fixed + u'\u05ea\u05e9\u05d5\u05de\u05ea \u05dc\u05d1': 'attention', + u'\u05d6\u05d4\u05d9\u05e8\u05d5\u05ea': 'caution', + u'\u05e1\u05db\u05e0\u05d4': 'danger', + u'\u05e9\u05d2\u05d9\u05d0\u05d4' : 'error', + u'\u05e8\u05de\u05d6': 'hint', + u'\u05d7\u05e9\u05d5\u05d1': 'important', + u'\u05d4\u05e2\u05e8\u05d4': 'note', + u'\u05d8\u05d9\u05e4': 'tip', + u'\u05d0\u05d6\u05d4\u05e8\u05d4': 'warning', + 'admonition': 'admonition', + 'sidebar': 'sidebar', + 'topic': 'topic', + 'line-block': 'line-block', + 'parsed-literal': 'parsed-literal', + 'rubric': 'rubric', + 'epigraph': 'epigraph', + 'highlights': 'highlights', + 'pull-quote': 'pull-quote', + 'compound': 'compound', + 'container': 'container', + #'questions': 'questions', + 'table': 'table', + 'csv-table': 'csv-table', + 'list-table': 'list-table', + #'qa': 'questions', + #'faq': 'questions', + 'meta': 'meta', + #'imagemap': 'imagemap', + u'\u05ea\u05de\u05d5\u05e0\u05d4': 'image', + 'figure': 'figure', + 'include': 'include', + 'raw': 'raw', + 'replace': 'replace', + 'unicode': 'unicode', + 'date': 'date', + u'\u05e1\u05d2\u05e0\u05d5\u05df': 'class', + 'role': 'role', + 'default-role': 'default-role', + 'title': 'title', + u'\u05ea\u05d5\u05db\u05df': 'contents', + 'sectnum': 'sectnum', + 'section-numbering': 'sectnum', + 'header': 'header', + 'footer': 'footer', + #'footnotes': 'footnotes', + #'citations': 'citations', + 'target-notes': 'target-notes', + 'restructuredtext-test-directive': 'restructuredtext-test-directive'} +"""English name to registered (in directives/init.py) directive name +mapping.""" + +roles = { + # language-dependent: fixed + 'abbreviation': 'abbreviation', + 'ab': 'abbreviation', + 'acronym': 'acronym', + 'ac': 'acronym', + 'index': 'index', + 'i': 'index', + u'\u05ea\u05d7\u05ea\u05d9': 'subscript', + 'sub': 'subscript', + u'\u05e2\u05d9\u05dc\u05d9': 'superscript', + 'sup': 'superscript', + 'title-reference': 'title-reference', + 'title': 'title-reference', + 't': 'title-reference', + 'pep-reference': 'pep-reference', + 'pep': 'pep-reference', + 'rfc-reference': 'rfc-reference', + 'rfc': 'rfc-reference', + 'emphasis': 'emphasis', + 'strong': 'strong', + 'literal': 'literal', + 'named-reference': 'named-reference', + 'anonymous-reference': 'anonymous-reference', + 'footnote-reference': 'footnote-reference', + 'citation-reference': 'citation-reference', + 'substitution-reference': 'substitution-reference', + 'target': 'target', + 'uri-reference': 'uri-reference', + 'uri': 'uri-reference', + 'url': 'uri-reference', + 'raw': 'raw',} +"""Mapping of English role names to canonical role names for interpreted text. +""" diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/languages/it.py --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/languages/it.py Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,93 @@ +# $Id: it.py 4564 2006-05-21 20:44:42Z wiemann $ +# Authors: Nicola Larosa ; +# Lele Gaifax +# Copyright: This module has been placed in the public domain. + +# Beware: the italian translation of the reStructuredText documentation +# at http://docit.bice.dyndns.org/static/ReST, in particular +# http://docit.bice.dyndns.org/static/ReST/ref/rst/directives.html, needs +# to be synced with the content of this file. + +""" +Italian-language mappings for language-dependent features of +reStructuredText. +""" + +docformat = 'reStructuredText' + + +directives = { + 'attenzione': 'attention', + 'cautela': 'caution', + 'pericolo': 'danger', + 'errore': 'error', + 'suggerimento': 'hint', + 'importante': 'important', + 'nota': 'note', + 'consiglio': 'tip', + 'avvertenza': 'warning', + 'ammonizione': 'admonition', + 'riquadro': 'sidebar', + 'argomento': 'topic', + 'blocco-di-righe': 'line-block', + 'blocco-interpretato': 'parsed-literal', + 'rubrica': 'rubric', + 'epigrafe': 'epigraph', + 'punti-salienti': 'highlights', + 'estratto-evidenziato': 'pull-quote', + 'composito': 'compound', + u'container (translation required)': 'container', + #'questions': 'questions', + #'qa': 'questions', + #'faq': 'questions', + 'tabella': 'table', + 'tabella-csv': 'csv-table', + 'tabella-elenco': 'list-table', + 'meta': 'meta', + #'imagemap': 'imagemap', + 'immagine': 'image', + 'figura': 'figure', + 'includi': 'include', + 'grezzo': 'raw', + 'sostituisci': 'replace', + 'unicode': 'unicode', + 'data': 'date', + 'classe': 'class', + 'ruolo': 'role', + 'ruolo-predefinito': 'default-role', + 'titolo': 'title', + 'indice': 'contents', + 'contenuti': 'contents', + 'seznum': 'sectnum', + 'sezioni-autonumerate': 'sectnum', + 'annota-riferimenti-esterni': 'target-notes', + 'intestazione': 'header', + 'piede-pagina': 'footer', + #'footnotes': 'footnotes', + #'citations': 'citations', + 'restructuredtext-test-directive': 'restructuredtext-test-directive'} +"""Italian name to registered (in directives/init.py) directive name +mapping.""" + +roles = { + 'abbreviazione': 'abbreviation', + 'acronimo': 'acronym', + 'indice': 'index', + 'deponente': 'subscript', + 'esponente': 'superscript', + 'riferimento-titolo': 'title-reference', + 'riferimento-pep': 'pep-reference', + 'riferimento-rfc': 'rfc-reference', + 'enfasi': 'emphasis', + 'forte': 'strong', + 'letterale': 'literal', + 'riferimento-con-nome': 'named-reference', + 'riferimento-anonimo': 'anonymous-reference', + 'riferimento-nota': 'footnote-reference', + 'riferimento-citazione': 'citation-reference', + 'riferimento-sostituzione': 'substitution-reference', + 'destinazione': 'target', + 'riferimento-uri': 'uri-reference', + 'grezzo': 'raw',} +"""Mapping of Italian role names to canonical role names for interpreted text. +""" diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/languages/ja.py --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/languages/ja.py Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,115 @@ +# -- coding: utf-8 -- +# $Id: ja.py 4564 2006-05-21 20:44:42Z wiemann $ +# Author: David Goodger +# Copyright: This module has been placed in the public domain. + +# New language mappings are welcome. Before doing a new translation, please +# read . Two files must be +# translated for each language: one in docutils/languages, the other in +# docutils/parsers/rst/languages. + +""" +Japanese-language mappings for language-dependent features of +reStructuredText. +""" + +docformat = 'reStructuredText' + +# Corrections to these translations are welcome! +# 間違いがあれば、どうぞ正しい翻訳を教えて下さい。 + +directives = { + # language-dependent: fixed + u'注目': 'attention', + u'注意': 'caution', + u'危険': 'danger', + u'エラー': 'error', + u'ヒント': 'hint', + u'重要': 'important', + u'備考': 'note', + u'通報': 'tip', + u'警告': 'warning', + u'戒告': 'admonition', + u'サイドバー': 'sidebar', + u'トピック': 'topic', + u'ラインブロック': 'line-block', + u'パーズドリテラル': 'parsed-literal', + u'ルブリック': 'rubric', + u'エピグラフ': 'epigraph', + u'題言': 'epigraph', + u'ハイライト': 'highlights', + u'見所': 'highlights', + u'プルクオート': 'pull-quote', + u'合成': 'compound', + u'コンテナー': 'container', + u'容器': 'container', + u'表': 'table', + u'csv表': 'csv-table', + u'リスト表': 'list-table', + #u'質問': 'questions', + #u'問答': 'questions', + #u'faq': 'questions', + u'メタ': 'meta', + #u'イメージマプ': 'imagemap', + u'イメージ': 'image', + u'画像': 'image', + u'フィグア': 'figure', + u'図版': 'figure', + u'インクルード': 'include', + u'含む': 'include', + u'組み込み': 'include', + u'生': 'raw', + u'原': 'raw', + u'換える': 'replace', + u'取り換える': 'replace', + u'掛け替える': 'replace', + u'ユニコード': 'unicode', + u'日付': 'date', + u'クラス': 'class', + u'ロール': 'role', + u'役': 'role', + u'ディフォルトロール': 'default-role', + u'既定役': 'default-role', + u'タイトル': 'title', + u'題': 'title', # 題名　件名 + u'目次': 'contents', + u'節数': 'sectnum', + u'ヘッダ': 'header', + u'フッタ': 'footer', + #u'脚注': 'footnotes', # 脚註? + #u'サイテーション': 'citations',　　　# 出典　引証　引用 + u'ターゲットノート': 'target-notes', # 的注　的脚注 + } +"""Japanese name to registered (in directives/init.py) directive name +mapping.""" + +roles = { + # language-dependent: fixed + u'略': 'abbreviation', + u'頭字語': 'acronym', + u'インデックス': 'index', + u'索引': 'index', + u'添字': 'subscript', + u'下付': 'subscript', + u'下': 'subscript', + u'上付': 'superscript', + u'上': 'superscript', + u'題参照': 'title-reference', + u'pep参照': 'pep-reference', + u'rfc参照': 'rfc-reference', + u'強調': 'emphasis', + u'強い': 'strong', + u'リテラル': 'literal', + u'整形済み': 'literal', + u'名付参照': 'named-reference', + u'無名参照': 'anonymous-reference', + u'脚注参照': 'footnote-reference', + u'出典参照': 'citation-reference', + u'代入参照': 'substitution-reference', + u'的': 'target', + u'uri参照': 'uri-reference', + u'uri': 'uri-reference', + u'url': 'uri-reference', + u'生': 'raw',} +"""Mapping of Japanese role names to canonical role names for interpreted +text.""" diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/languages/nl.py --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/languages/nl.py Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,108 @@ +# $Id: nl.py 4564 2006-05-21 20:44:42Z wiemann $ +# Author: Martijn Pieters +# Copyright: This module has been placed in the public domain. + +# New language mappings are welcome. Before doing a new translation, please +# read . Two files must be +# translated for each language: one in docutils/languages, the other in +# docutils/parsers/rst/languages. + +""" +Dutch-language mappings for language-dependent features of +reStructuredText. +""" + +docformat = 'reStructuredText' + + +directives = { + # language-dependent: fixed + 'attentie': 'attention', + 'let-op': 'caution', + 'gevaar': 'danger', + 'fout': 'error', + 'hint': 'hint', + 'belangrijk': 'important', + 'opmerking': 'note', + 'tip': 'tip', + 'waarschuwing': 'warning', + 'aanmaning': 'admonition', + 'katern': 'sidebar', + 'onderwerp': 'topic', + 'lijn-blok': 'line-block', + 'letterlijk-ontleed': 'parsed-literal', + 'rubriek': 'rubric', + 'opschrift': 'epigraph', + 'hoogtepunten': 'highlights', + 'pull-quote': 'pull-quote', # Dutch printers use the english term + 'samenstelling': 'compound', + 'verbinding': 'compound', + u'container (translation required)': 'container', + #'vragen': 'questions', + 'tabel': 'table', + 'csv-tabel': 'csv-table', + 'lijst-tabel': 'list-table', + #'veelgestelde-vragen': 'questions', + 'meta': 'meta', + #'imagemap': 'imagemap', + 'beeld': 'image', + 'figuur': 'figure', + 'opnemen': 'include', + 'onbewerkt': 'raw', + 'vervang': 'replace', + 'vervanging': 'replace', + 'unicode': 'unicode', + 'datum': 'date', + 'klasse': 'class', + 'rol': 'role', + u'default-role (translation required)': 'default-role', + 'title (translation required)': 'title', + 'inhoud': 'contents', + 'sectnum': 'sectnum', + 'sectie-nummering': 'sectnum', + 'hoofdstuk-nummering': 'sectnum', + u'header (translation required)': 'header', + u'footer (translation required)': 'footer', + #'voetnoten': 'footnotes', + #'citaten': 'citations', + 'verwijzing-voetnoten': 'target-notes', + 'restructuredtext-test-instructie': 'restructuredtext-test-directive'} +"""Dutch name to registered (in directives/init.py) directive name +mapping.""" + +roles = { + # language-dependent: fixed + 'afkorting': 'abbreviation', + # 'ab': 'abbreviation', + 'acroniem': 'acronym', + 'ac': 'acronym', + 'index': 'index', + 'i': 'index', + 'inferieur': 'subscript', + 'inf': 'subscript', + 'superieur': 'superscript', + 'sup': 'superscript', + 'titel-referentie': 'title-reference', + 'titel': 'title-reference', + 't': 'title-reference', + 'pep-referentie': 'pep-reference', + 'pep': 'pep-reference', + 'rfc-referentie': 'rfc-reference', + 'rfc': 'rfc-reference', + 'nadruk': 'emphasis', + 'extra': 'strong', + 'extra-nadruk': 'strong', + 'vet': 'strong', + 'letterlijk': 'literal', + 'benoemde-referentie': 'named-reference', + 'anonieme-referentie': 'anonymous-reference', + 'voetnoot-referentie': 'footnote-reference', + 'citaat-referentie': 'citation-reference', + 'substitie-reference': 'substitution-reference', + 'verwijzing': 'target', + 'uri-referentie': 'uri-reference', + 'uri': 'uri-reference', + 'url': 'uri-reference', + 'onbewerkt': 'raw',} +"""Mapping of Dutch role names to canonical role names for interpreted text. +""" diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/languages/pt_br.py --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/languages/pt_br.py Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,104 @@ +# $Id: pt_br.py 4564 2006-05-21 20:44:42Z wiemann $ +# Author: David Goodger +# Copyright: This module has been placed in the public domain. + +# New language mappings are welcome. Before doing a new translation, please +# read . Two files must be +# translated for each language: one in docutils/languages, the other in +# docutils/parsers/rst/languages. + +""" +Brazilian Portuguese-language mappings for language-dependent features of +reStructuredText. +""" + +docformat = 'reStructuredText' + + +directives = { + # language-dependent: fixed + u'aten\u00E7\u00E3o': 'attention', + 'cuidado': 'caution', + 'perigo': 'danger', + 'erro': 'error', + u'sugest\u00E3o': 'hint', + 'importante': 'important', + 'nota': 'note', + 'dica': 'tip', + 'aviso': 'warning', + u'exorta\u00E7\u00E3o': 'admonition', + 'barra-lateral': 'sidebar', + u't\u00F3pico': 'topic', + 'bloco-de-linhas': 'line-block', + 'literal-interpretado': 'parsed-literal', + 'rubrica': 'rubric', + u'ep\u00EDgrafo': 'epigraph', + 'destaques': 'highlights', + u'cita\u00E7\u00E3o-destacada': 'pull-quote', + u'compound (translation required)': 'compound', + u'container (translation required)': 'container', + #'perguntas': 'questions', + #'qa': 'questions', + #'faq': 'questions', + u'table (translation required)': 'table', + u'csv-table (translation required)': 'csv-table', + u'list-table (translation required)': 'list-table', + 'meta': 'meta', + #'imagemap': 'imagemap', + 'imagem': 'image', + 'figura': 'figure', + u'inclus\u00E3o': 'include', + 'cru': 'raw', + u'substitui\u00E7\u00E3o': 'replace', + 'unicode': 'unicode', + 'data': 'date', + 'classe': 'class', + 'role (translation required)': 'role', + u'default-role (translation required)': 'default-role', + u'title (translation required)': 'title', + u'\u00EDndice': 'contents', + 'numsec': 'sectnum', + u'numera\u00E7\u00E3o-de-se\u00E7\u00F5es': 'sectnum', + u'header (translation required)': 'header', + u'footer (translation required)': 'footer', + #u'notas-de-rorap\u00E9': 'footnotes', + #u'cita\u00E7\u00F5es': 'citations', + u'links-no-rodap\u00E9': 'target-notes', + 'restructuredtext-test-directive': 'restructuredtext-test-directive'} +"""Brazilian Portuguese name to registered (in directives/init.py) +directive name mapping.""" + +roles = { + # language-dependent: fixed + u'abbrevia\u00E7\u00E3o': 'abbreviation', + 'ab': 'abbreviation', + u'acr\u00F4nimo': 'acronym', + 'ac': 'acronym', + u'\u00EDndice-remissivo': 'index', + 'i': 'index', + 'subscrito': 'subscript', + 'sub': 'subscript', + 'sobrescrito': 'superscript', + 'sob': 'superscript', + u'refer\u00EAncia-a-t\u00EDtulo': 'title-reference', + u't\u00EDtulo': 'title-reference', + 't': 'title-reference', + u'refer\u00EAncia-a-pep': 'pep-reference', + 'pep': 'pep-reference', + u'refer\u00EAncia-a-rfc': 'rfc-reference', + 'rfc': 'rfc-reference', + u'\u00EAnfase': 'emphasis', + 'forte': 'strong', + 'literal': 'literal', # translation required? + u'refer\u00EAncia-por-nome': 'named-reference', + u'refer\u00EAncia-an\u00F4nima': 'anonymous-reference', + u'refer\u00EAncia-a-nota-de-rodap\u00E9': 'footnote-reference', + u'refer\u00EAncia-a-cita\u00E7\u00E3o': 'citation-reference', + u'refer\u00EAncia-a-substitui\u00E7\u00E3o': 'substitution-reference', + 'alvo': 'target', + u'refer\u00EAncia-a-uri': 'uri-reference', + 'uri': 'uri-reference', + 'url': 'uri-reference', + 'cru': 'raw',} +"""Mapping of Brazilian Portuguese role names to canonical role names +for interpreted text.""" diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/languages/ru.py --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/languages/ru.py Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,103 @@ +# $Id: ru.py 4564 2006-05-21 20:44:42Z wiemann $ +# Author: Roman Suzi +# Copyright: This module has been placed in the public domain. + +# New language mappings are welcome. Before doing a new translation, please +# read . Two files must be +# translated for each language: one in docutils/languages, the other in +# docutils/parsers/rst/languages. + +""" +Russian-language mappings for language-dependent features of +reStructuredText. +""" + +docformat = 'reStructuredText' + +directives = { + u'\u0431\u043b\u043e\u043a-\u0441\u0442\u0440\u043e\u043a': u'line-block', + u'meta': u'meta', + u'\u043e\u0431\u0440\u0430\u0431\u043e\u0442\u0430\u043d\u043d\u044b\u0439-\u043b\u0438\u0442\u0435\u0440\u0430\u043b': + u'parsed-literal', + u'\u0432\u044b\u0434\u0435\u043b\u0435\u043d\u043d\u0430\u044f-\u0446\u0438\u0442\u0430\u0442\u0430': + u'pull-quote', + u'compound (translation required)': 'compound', + u'container (translation required)': 'container', + u'table (translation required)': 'table', + u'csv-table (translation required)': 'csv-table', + u'list-table (translation required)': 'list-table', + u'\u0441\u044b\u0440\u043e\u0439': u'raw', + u'\u0437\u0430\u043c\u0435\u043d\u0430': u'replace', + u'\u0442\u0435\u0441\u0442\u043e\u0432\u0430\u044f-\u0434\u0438\u0440\u0435\u043a\u0442\u0438\u0432\u0430-restructuredtext': + u'restructuredtext-test-directive', + u'\u0446\u0435\u043b\u0435\u0432\u044b\u0435-\u0441\u043d\u043e\u0441\u043a\u0438': + u'target-notes', + u'unicode': u'unicode', + u'\u0434\u0430\u0442\u0430': u'date', + u'\u0431\u043e\u043a\u043e\u0432\u0430\u044f-\u043f\u043e\u043b\u043e\u0441\u0430': + u'sidebar', + u'\u0432\u0430\u0436\u043d\u043e': u'important', + u'\u0432\u043a\u043b\u044e\u0447\u0430\u0442\u044c': u'include', + u'\u0432\u043d\u0438\u043c\u0430\u043d\u0438\u0435': u'attention', + u'\u0432\u044b\u0434\u0435\u043b\u0435\u043d\u0438\u0435': u'highlights', + u'\u0437\u0430\u043c\u0435\u0447\u0430\u043d\u0438\u0435': u'admonition', + u'\u0438\u0437\u043e\u0431\u0440\u0430\u0436\u0435\u043d\u0438\u0435': + u'image', + u'\u043a\u043b\u0430\u0441\u0441': u'class', + u'role (translation required)': 'role', + u'default-role (translation required)': 'default-role', + u'title (translation required)': 'title', + u'\u043d\u043e\u043c\u0435\u0440-\u0440\u0430\u0437\u0434\u0435\u043b\u0430': + u'sectnum', + u'\u043d\u0443\u043c\u0435\u0440\u0430\u0446\u0438\u044f-\u0440\u0430\u0437' + u'\u0434\u0435\u043b\u043e\u0432': u'sectnum', + u'\u043e\u043f\u0430\u0441\u043d\u043e': u'danger', + u'\u043e\u0441\u0442\u043e\u0440\u043e\u0436\u043d\u043e': u'caution', + u'\u043e\u0448\u0438\u0431\u043a\u0430': u'error', + u'\u043f\u043e\u0434\u0441\u043a\u0430\u0437\u043a\u0430': u'tip', + u'\u043f\u0440\u0435\u0434\u0443\u043f\u0440\u0435\u0436\u0434\u0435\u043d' + u'\u0438\u0435': u'warning', + u'\u043f\u0440\u0438\u043c\u0435\u0447\u0430\u043d\u0438\u0435': u'note', + u'\u0440\u0438\u0441\u0443\u043d\u043e\u043a': u'figure', + u'\u0440\u0443\u0431\u0440\u0438\u043a\u0430': u'rubric', + u'\u0441\u043e\u0432\u0435\u0442': u'hint', + u'\u0441\u043e\u0434\u0435\u0440\u0436\u0430\u043d\u0438\u0435': u'contents', + u'\u0442\u0435\u043c\u0430': u'topic', + u'\u044d\u043f\u0438\u0433\u0440\u0430\u0444': u'epigraph', + u'header (translation required)': 'header', + u'footer (translation required)': 'footer',} +"""Russian name to registered (in directives/init.py) directive name +mapping.""" + +roles = { + u'\u0430\u043a\u0440\u043e\u043d\u0438\u043c': 'acronym', + u'\u0430\u043d\u043e\u043d\u0438\u043c\u043d\u0430\u044f-\u0441\u0441\u044b\u043b\u043a\u0430': + 'anonymous-reference', + u'\u0431\u0443\u043a\u0432\u0430\u043b\u044c\u043d\u043e': 'literal', + u'\u0432\u0435\u0440\u0445\u043d\u0438\u0439-\u0438\u043d\u0434\u0435\u043a\u0441': + 'superscript', + u'\u0432\u044b\u0434\u0435\u043b\u0435\u043d\u0438\u0435': 'emphasis', + u'\u0438\u043c\u0435\u043d\u043e\u0432\u0430\u043d\u043d\u0430\u044f-\u0441\u0441\u044b\u043b\u043a\u0430': + 'named-reference', + u'\u0438\u043d\u0434\u0435\u043a\u0441': 'index', + u'\u043d\u0438\u0436\u043d\u0438\u0439-\u0438\u043d\u0434\u0435\u043a\u0441': + 'subscript', + u'\u0441\u0438\u043b\u044c\u043d\u043e\u0435-\u0432\u044b\u0434\u0435\u043b\u0435\u043d\u0438\u0435': + 'strong', + u'\u0441\u043e\u043a\u0440\u0430\u0449\u0435\u043d\u0438\u0435': + 'abbreviation', + u'\u0441\u0441\u044b\u043b\u043a\u0430-\u0437\u0430\u043c\u0435\u043d\u0430': + 'substitution-reference', + u'\u0441\u0441\u044b\u043b\u043a\u0430-\u043d\u0430-pep': 'pep-reference', + u'\u0441\u0441\u044b\u043b\u043a\u0430-\u043d\u0430-rfc': 'rfc-reference', + u'\u0441\u0441\u044b\u043b\u043a\u0430-\u043d\u0430-uri': 'uri-reference', + u'\u0441\u0441\u044b\u043b\u043a\u0430-\u043d\u0430-\u0437\u0430\u0433\u043b\u0430\u0432\u0438\u0435': + 'title-reference', + u'\u0441\u0441\u044b\u043b\u043a\u0430-\u043d\u0430-\u0441\u043d\u043e\u0441\u043a\u0443': + 'footnote-reference', + u'\u0446\u0438\u0442\u0430\u0442\u043d\u0430\u044f-\u0441\u0441\u044b\u043b\u043a\u0430': + 'citation-reference', + u'\u0446\u0435\u043b\u044c': 'target', + u'raw (translation required)': 'raw',} +"""Mapping of Russian role names to canonical role names for interpreted text. +""" diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/languages/sk.py --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/languages/sk.py Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,91 @@ +# $Id: sk.py 4564 2006-05-21 20:44:42Z wiemann $ +# Author: Miroslav Vasko +# Copyright: This module has been placed in the public domain. + +# New language mappings are welcome. Before doing a new translation, please +# read . Two files must be +# translated for each language: one in docutils/languages, the other in +# docutils/parsers/rst/languages. + +""" +Slovak-language mappings for language-dependent features of +reStructuredText. +""" + +docformat = 'reStructuredText' + + +directives = { + u'pozor': 'attention', + u'opatrne': 'caution', + u'nebezpe\xe8enstvo': 'danger', + u'chyba': 'error', + u'rada': 'hint', + u'd\xf4le\x9eit\xe9': 'important', + u'pozn\xe1mka': 'note', + u'tip (translation required)': 'tip', + u'varovanie': 'warning', + u'admonition (translation required)': 'admonition', + u'sidebar (translation required)': 'sidebar', + u't\xe9ma': 'topic', + u'blok-riadkov': 'line-block', + u'parsed-literal': 'parsed-literal', + u'rubric (translation required)': 'rubric', + u'epigraph (translation required)': 'epigraph', + u'highlights (translation required)': 'highlights', + u'pull-quote (translation required)': 'pull-quote', + u'compound (translation required)': 'compound', + u'container (translation required)': 'container', + #u'questions': 'questions', + #u'qa': 'questions', + #u'faq': 'questions', + u'table (translation required)': 'table', + u'csv-table (translation required)': 'csv-table', + u'list-table (translation required)': 'list-table', + u'meta': 'meta', + #u'imagemap': 'imagemap', + u'obr\xe1zok': 'image', + u'tvar': 'figure', + u'vlo\x9ei\x9d': 'include', + u'raw (translation required)': 'raw', + u'nahradi\x9d': 'replace', + u'unicode': 'unicode', + u'd\u00E1tum': 'date', + u'class (translation required)': 'class', + u'role (translation required)': 'role', + u'default-role (translation required)': 'default-role', + u'title (translation required)': 'title', + u'obsah': 'contents', + u'\xe8as\x9d': 'sectnum', + u'\xe8as\x9d-\xe8\xedslovanie': 'sectnum', + u'cie\xbeov\xe9-pozn\xe1mky': 'target-notes', + u'header (translation required)': 'header', + u'footer (translation required)': 'footer', + #u'footnotes': 'footnotes', + #u'citations': 'citations', + } +"""Slovak name to registered (in directives/init.py) directive name +mapping.""" + +roles = { + u'abbreviation (translation required)': 'abbreviation', + u'acronym (translation required)': 'acronym', + u'index (translation required)': 'index', + u'subscript (translation required)': 'subscript', + u'superscript (translation required)': 'superscript', + u'title-reference (translation required)': 'title-reference', + u'pep-reference (translation required)': 'pep-reference', + u'rfc-reference (translation required)': 'rfc-reference', + u'emphasis (translation required)': 'emphasis', + u'strong (translation required)': 'strong', + u'literal (translation required)': 'literal', + u'named-reference (translation required)': 'named-reference', + u'anonymous-reference (translation required)': 'anonymous-reference', + u'footnote-reference (translation required)': 'footnote-reference', + u'citation-reference (translation required)': 'citation-reference', + u'substitution-reference (translation required)': 'substitution-reference', + u'target (translation required)': 'target', + u'uri-reference (translation required)': 'uri-reference', + u'raw (translation required)': 'raw',} +"""Mapping of Slovak role names to canonical role names for interpreted text. +""" diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/languages/sv.py --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/languages/sv.py Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,90 @@ +# $Id: sv.py 4564 2006-05-21 20:44:42Z wiemann $ +# Author: Adam Chodorowski +# Copyright: This module has been placed in the public domain. + +# New language mappings are welcome. Before doing a new translation, please +# read . Two files must be +# translated for each language: one in docutils/languages, the other in +# docutils/parsers/rst/languages. + +""" +Swedish language mappings for language-dependent features of reStructuredText. +""" + +docformat = 'reStructuredText' + + +directives = { + u'observera': 'attention', + u'caution (translation required)': 'caution', + u'fara': 'danger', + u'fel': 'error', + u'v\u00e4gledning': 'hint', + u'viktigt': 'important', + u'notera': 'note', + u'tips': 'tip', + u'varning': 'warning', + u'admonition (translation required)': 'admonition', + u'sidebar (translation required)': 'sidebar', + u'\u00e4mne': 'topic', + u'line-block (translation required)': 'line-block', + u'parsed-literal (translation required)': 'parsed-literal', + u'mellanrubrik': 'rubric', + u'epigraph (translation required)': 'epigraph', + u'highlights (translation required)': 'highlights', + u'pull-quote (translation required)': 'pull-quote', + u'compound (translation required)': 'compound', + u'container (translation required)': 'container', + # u'fr\u00e5gor': 'questions', + # NOTE: A bit long, but recommended by http://www.nada.kth.se/dataterm/: + # u'fr\u00e5gor-och-svar': 'questions', + # u'vanliga-fr\u00e5gor': 'questions', + u'table (translation required)': 'table', + u'csv-table (translation required)': 'csv-table', + u'list-table (translation required)': 'list-table', + u'meta': 'meta', + # u'bildkarta': 'imagemap', # FIXME: Translation might be too literal. + u'bild': 'image', + u'figur': 'figure', + u'inkludera': 'include', + u'r\u00e5': 'raw', # FIXME: Translation might be too literal. + u'ers\u00e4tt': 'replace', + u'unicode': 'unicode', + u'datum': 'date', + u'class (translation required)': 'class', + u'role (translation required)': 'role', + u'default-role (translation required)': 'default-role', + u'title (translation required)': 'title', + u'inneh\u00e5ll': 'contents', + u'sektionsnumrering': 'sectnum', + u'target-notes (translation required)': 'target-notes', + u'header (translation required)': 'header', + u'footer (translation required)': 'footer', + # u'fotnoter': 'footnotes', + # u'citeringar': 'citations', + } +"""Swedish name to registered (in directives/init.py) directive name +mapping.""" + +roles = { + u'abbreviation (translation required)': 'abbreviation', + u'acronym (translation required)': 'acronym', + u'index (translation required)': 'index', + u'subscript (translation required)': 'subscript', + u'superscript (translation required)': 'superscript', + u'title-reference (translation required)': 'title-reference', + u'pep-reference (translation required)': 'pep-reference', + u'rfc-reference (translation required)': 'rfc-reference', + u'emphasis (translation required)': 'emphasis', + u'strong (translation required)': 'strong', + u'literal (translation required)': 'literal', + u'named-reference (translation required)': 'named-reference', + u'anonymous-reference (translation required)': 'anonymous-reference', + u'footnote-reference (translation required)': 'footnote-reference', + u'citation-reference (translation required)': 'citation-reference', + u'substitution-reference (translation required)': 'substitution-reference', + u'target (translation required)': 'target', + u'uri-reference (translation required)': 'uri-reference', + u'r\u00e5': 'raw',} +"""Mapping of Swedish role names to canonical role names for interpreted text. +""" diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/languages/zh_cn.py --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/languages/zh_cn.py Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,100 @@ +# -- coding: utf-8 -- +# $Id: zh_cn.py 4564 2006-05-21 20:44:42Z wiemann $ +# Author: Panjunyong +# Copyright: This module has been placed in the public domain. + +# New language mappings are welcome. Before doing a new translation, please +# read . Two files must be +# translated for each language: one in docutils/languages, the other in +# docutils/parsers/rst/languages. + +""" +Simplified Chinese language mappings for language-dependent features of +reStructuredText. +""" + +docformat = 'reStructuredText' + + +directives = { + # language-dependent: fixed + u'注意': 'attention', + u'小心': 'caution', + u'危险': 'danger', + u'错误': 'error', + u'提示': 'hint', + u'重要': 'important', + u'注解': 'note', + u'技巧': 'tip', + u'警告': 'warning', + u'忠告': 'admonition', + u'侧框': 'sidebar', + u'主题': 'topic', + u'line-block (translation required)': 'line-block', + u'parsed-literal (translation required)': 'parsed-literal', + u'醒目': 'rubric', + u'铭文': 'epigraph', + u'要点': 'highlights', + u'pull-quote (translation required)': 'pull-quote', + u'复合': 'compound', + u'容器': 'container', + #u'questions (translation required)': 'questions', + u'表格': 'table', + u'csv表格': 'csv-table', + u'列表表格': 'list-table', + #u'qa (translation required)': 'questions', + #u'faq (translation required)': 'questions', + u'元数据': 'meta', + #u'imagemap (translation required)': 'imagemap', + u'图片': 'image', + u'图例': 'figure', + u'包含': 'include', + u'原文': 'raw', + u'代替': 'replace', + u'统一码': 'unicode', + u'日期': 'date', + u'类型': 'class', + u'角色': 'role', + u'默认角色': 'default-role', + u'标题': 'title', + u'目录': 'contents', + u'章节序号': 'sectnum', + u'题头': 'header', + u'页脚': 'footer', + #u'footnotes (translation required)': 'footnotes', + #u'citations (translation required)': 'citations', + u'target-notes (translation required)': 'target-notes', + u'restructuredtext-test-directive': 'restructuredtext-test-directive'} +"""Simplified Chinese name to registered (in directives/init.py) +directive name mapping.""" + +roles = { + # language-dependent: fixed + u'缩写': 'abbreviation', + u'简称': 'acronym', + u'index (translation required)': 'index', + u'i (translation required)': 'index', + u'下标': 'subscript', + u'上标': 'superscript', + u'title-reference (translation required)': 'title-reference', + u'title (translation required)': 'title-reference', + u't (translation required)': 'title-reference', + u'pep-reference (translation required)': 'pep-reference', + u'pep (translation required)': 'pep-reference', + u'rfc-reference (translation required)': 'rfc-reference', + u'rfc (translation required)': 'rfc-reference', + u'强调': 'emphasis', + u'加粗': 'strong', + u'字面': 'literal', + u'named-reference (translation required)': 'named-reference', + u'anonymous-reference (translation required)': 'anonymous-reference', + u'footnote-reference (translation required)': 'footnote-reference', + u'citation-reference (translation required)': 'citation-reference', + u'substitution-reference (translation required)': 'substitution-reference', + u'target (translation required)': 'target', + u'uri-reference (translation required)': 'uri-reference', + u'uri (translation required)': 'uri-reference', + u'url (translation required)': 'uri-reference', + u'raw (translation required)': 'raw',} +"""Mapping of Simplified Chinese role names to canonical role names +for interpreted text.""" diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/languages/zh_tw.py --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/languages/zh_tw.py Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,105 @@ +# -- coding: utf-8 -- +# $Id: zh_tw.py 4564 2006-05-21 20:44:42Z wiemann $ +# Author: David Goodger +# Copyright: This module has been placed in the public domain. + +# New language mappings are welcome. Before doing a new translation, please +# read . Two files must be +# translated for each language: one in docutils/languages, the other in +# docutils/parsers/rst/languages. + +""" +Traditional Chinese language mappings for language-dependent features of +reStructuredText. +""" + +docformat = 'reStructuredText' + + +directives = { + # language-dependent: fixed + 'attention (translation required)': 'attention', + 'caution (translation required)': 'caution', + 'danger (translation required)': 'danger', + 'error (translation required)': 'error', + 'hint (translation required)': 'hint', + 'important (translation required)': 'important', + 'note (translation required)': 'note', + 'tip (translation required)': 'tip', + 'warning (translation required)': 'warning', + 'admonition (translation required)': 'admonition', + 'sidebar (translation required)': 'sidebar', + 'topic (translation required)': 'topic', + 'line-block (translation required)': 'line-block', + 'parsed-literal (translation required)': 'parsed-literal', + 'rubric (translation required)': 'rubric', + 'epigraph (translation required)': 'epigraph', + 'highlights (translation required)': 'highlights', + 'pull-quote (translation required)': 'pull-quote', + 'compound (translation required)': 'compound', + u'container (translation required)': 'container', + #'questions (translation required)': 'questions', + 'table (translation required)': 'table', + 'csv-table (translation required)': 'csv-table', + 'list-table (translation required)': 'list-table', + #'qa (translation required)': 'questions', + #'faq (translation required)': 'questions', + 'meta (translation required)': 'meta', + #'imagemap (translation required)': 'imagemap', + 'image (translation required)': 'image', + 'figure (translation required)': 'figure', + 'include (translation required)': 'include', + 'raw (translation required)': 'raw', + 'replace (translation required)': 'replace', + 'unicode (translation required)': 'unicode', + u'日期': 'date', + 'class (translation required)': 'class', + 'role (translation required)': 'role', + u'default-role (translation required)': 'default-role', + u'title (translation required)': 'title', + 'contents (translation required)': 'contents', + 'sectnum (translation required)': 'sectnum', + 'section-numbering (translation required)': 'sectnum', + u'header (translation required)': 'header', + u'footer (translation required)': 'footer', + #'footnotes (translation required)': 'footnotes', + #'citations (translation required)': 'citations', + 'target-notes (translation required)': 'target-notes', + 'restructuredtext-test-directive': 'restructuredtext-test-directive'} +"""Traditional Chinese name to registered (in directives/init.py) +directive name mapping.""" + +roles = { + # language-dependent: fixed + 'abbreviation (translation required)': 'abbreviation', + 'ab (translation required)': 'abbreviation', + 'acronym (translation required)': 'acronym', + 'ac (translation required)': 'acronym', + 'index (translation required)': 'index', + 'i (translation required)': 'index', + 'subscript (translation required)': 'subscript', + 'sub (translation required)': 'subscript', + 'superscript (translation required)': 'superscript', + 'sup (translation required)': 'superscript', + 'title-reference (translation required)': 'title-reference', + 'title (translation required)': 'title-reference', + 't (translation required)': 'title-reference', + 'pep-reference (translation required)': 'pep-reference', + 'pep (translation required)': 'pep-reference', + 'rfc-reference (translation required)': 'rfc-reference', + 'rfc (translation required)': 'rfc-reference', + 'emphasis (translation required)': 'emphasis', + 'strong (translation required)': 'strong', + 'literal (translation required)': 'literal', + 'named-reference (translation required)': 'named-reference', + 'anonymous-reference (translation required)': 'anonymous-reference', + 'footnote-reference (translation required)': 'footnote-reference', + 'citation-reference (translation required)': 'citation-reference', + 'substitution-reference (translation required)': 'substitution-reference', + 'target (translation required)': 'target', + 'uri-reference (translation required)': 'uri-reference', + 'uri (translation required)': 'uri-reference', + 'url (translation required)': 'uri-reference', + 'raw (translation required)': 'raw',} +"""Mapping of Traditional Chinese role names to canonical role names for +interpreted text.""" diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/roles.py --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/roles.py Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,346 @@ +# $Id: roles.py 4564 2006-05-21 20:44:42Z wiemann $ +# Author: Edward Loper +# Copyright: This module has been placed in the public domain. + +""" +This module defines standard interpreted text role functions, a registry for +interpreted text roles, and an API for adding to and retrieving from the +registry. + +The interface for interpreted role functions is as follows:: + + def role_fn(name, rawtext, text, lineno, inliner, + options={}, content=[]): + code... + + # Set function attributes for customization: + role_fn.options = ... + role_fn.content = ... + +Parameters: + +- ``name`` is the local name of the interpreted text role, the role name + actually used in the document. + +- ``rawtext`` is a string containing the entire interpreted text construct. + Return it as a ``problematic`` node linked to a system message if there is a + problem. + +- ``text`` is the interpreted text content, with backslash escapes converted + to nulls (``\x00``). + +- ``lineno`` is the line number where the interpreted text beings. + +- ``inliner`` is the Inliner object that called the role function. + It defines the following useful attributes: ``reporter``, + ``problematic``, ``memo``, ``parent``, ``document``. + +- ``options``: A dictionary of directive options for customization, to be + interpreted by the role function. Used for additional attributes for the + generated elements and other functionality. + +- ``content``: A list of strings, the directive content for customization + ("role" directive). To be interpreted by the role function. + +Function attributes for customization, interpreted by the "role" directive: + +- ``options``: A dictionary, mapping known option names to conversion + functions such as `int` or `float`. ``None`` or an empty dict implies no + options to parse. Several directive option conversion functions are defined + in the `directives` module. + + All role functions implicitly support the "class" option, unless disabled + with an explicit ``{'class': None}``. + +- ``content``: A boolean; true if content is allowed. Client code must handle + the case where content is required but not supplied (an empty content list + will be supplied). + +Note that unlike directives, the "arguments" function attribute is not +supported for role customization. Directive arguments are handled by the +"role" directive itself. + +Interpreted role functions return a tuple of two values: + +- A list of nodes which will be inserted into the document tree at the + point where the interpreted role was encountered (can be an empty + list). + +- A list of system messages, which will be inserted into the document tree + immediately after the end of the current inline block (can also be empty). +""" + +docformat = 'reStructuredText' + +from docutils import nodes, utils +from docutils.parsers.rst import directives +from docutils.parsers.rst.languages import en as _fallback_language_module + +DEFAULT_INTERPRETED_ROLE = 'title-reference' +""" +The canonical name of the default interpreted role. This role is used +when no role is specified for a piece of interpreted text. +""" + +_role_registry = {} +"""Mapping of canonical role names to role functions. Language-dependent role +names are defined in the ``language`` subpackage.""" + +_roles = {} +"""Mapping of local or language-dependent interpreted text role names to role +functions.""" + +def role(role_name, language_module, lineno, reporter): + """ + Locate and return a role function from its language-dependent name, along + with a list of system messages. If the role is not found in the current + language, check English. Return a 2-tuple: role function (``None`` if the + named role cannot be found) and a list of system messages. + """ + normname = role_name.lower() + messages = [] + msg_text = [] + + if _roles.has_key(normname): + return _roles[normname], messages + + if role_name: + canonicalname = None + try: + canonicalname = language_module.roles[normname] + except AttributeError, error: + msg_text.append('Problem retrieving role entry from language ' + 'module %r: %s.' % (language_module, error)) + except KeyError: + msg_text.append('No role entry for "%s" in module "%s".' + % (role_name, language_module.name)) + else: + canonicalname = DEFAULT_INTERPRETED_ROLE + + # If we didn't find it, try English as a fallback. + if not canonicalname: + try: + canonicalname = _fallback_language_module.roles[normname] + msg_text.append('Using English fallback for role "%s".' + % role_name) + except KeyError: + msg_text.append('Trying "%s" as canonical role name.' + % role_name) + # The canonical name should be an English name, but just in case: + canonicalname = normname + + # Collect any messages that we generated. + if msg_text: + message = reporter.info('\n'.join(msg_text), line=lineno) + messages.append(message) + + # Look the role up in the registry, and return it. + if _role_registry.has_key(canonicalname): + role_fn = _role_registry[canonicalname] + register_local_role(normname, role_fn) + return role_fn, messages + else: + return None, messages # Error message will be generated by caller. + +def register_canonical_role(name, role_fn): + """ + Register an interpreted text role by its canonical name. + + :Parameters: + - `name`: The canonical name of the interpreted role. + - `role_fn`: The role function. See the module docstring. + """ + set_implicit_options(role_fn) + _role_registry[name] = role_fn + +def register_local_role(name, role_fn): + """ + Register an interpreted text role by its local or language-dependent name. + + :Parameters: + - `name`: The local or language-dependent name of the interpreted role. + - `role_fn`: The role function. See the module docstring. + """ + set_implicit_options(role_fn) + _roles[name] = role_fn + +def set_implicit_options(role_fn): + """ + Add customization options to role functions, unless explicitly set or + disabled. + """ + if not hasattr(role_fn, 'options') or role_fn.options is None: + role_fn.options = {'class': directives.class_option} + elif not role_fn.options.has_key('class'): + role_fn.options['class'] = directives.class_option + +def register_generic_role(canonical_name, node_class): + """For roles which simply wrap a given `node_class` around the text.""" + role = GenericRole(canonical_name, node_class) + register_canonical_role(canonical_name, role) + + +class GenericRole: + + """ + Generic interpreted text role, where the interpreted text is simply + wrapped with the provided node class. + """ + + def init(self, role_name, node_class): + self.name = role_name + self.node_class = node_class + + def call(self, role, rawtext, text, lineno, inliner, + options={}, content=[]): + set_classes(options) + return [self.node_class(rawtext, utils.unescape(text), options)], [] + + +class CustomRole: + + """ + Wrapper for custom interpreted text roles. + """ + + def init(self, role_name, base_role, options={}, content=[]): + self.name = role_name + self.base_role = base_role + self.options = None + if hasattr(base_role, 'options'): + self.options = base_role.options + self.content = None + if hasattr(base_role, 'content'): + self.content = base_role.content + self.supplied_options = options + self.supplied_content = content + + def call(self, role, rawtext, text, lineno, inliner, + options={}, content=[]): + opts = self.supplied_options.copy() + opts.update(options) + cont = list(self.supplied_content) + if cont and content: + cont += '\n' + cont.extend(content) + return self.base_role(role, rawtext, text, lineno, inliner, + options=opts, content=cont) + + +def generic_custom_role(role, rawtext, text, lineno, inliner, + options={}, content=[]): + """""" + # Once nested inline markup is implemented, this and other methods should + # recursively call inliner.nested_parse(). + set_classes(options) + return [nodes.inline(rawtext, utils.unescape(text), options)], [] + +generic_custom_role.options = {'class': directives.class_option} + + +###################################################################### +# Define and register the standard roles: +###################################################################### + +register_generic_role('abbreviation', nodes.abbreviation) +register_generic_role('acronym', nodes.acronym) +register_generic_role('emphasis', nodes.emphasis) +register_generic_role('literal', nodes.literal) +register_generic_role('strong', nodes.strong) +register_generic_role('subscript', nodes.subscript) +register_generic_role('superscript', nodes.superscript) +register_generic_role('title-reference', nodes.title_reference) + +def pep_reference_role(role, rawtext, text, lineno, inliner, + options={}, content=[]): + try: + pepnum = int(text) + if pepnum < 0 or pepnum > 9999: + raise ValueError + except ValueError: + msg = inliner.reporter.error( + 'PEP number must be a number from 0 to 9999; "%s" is invalid.' + % text, line=lineno) + prb = inliner.problematic(rawtext, rawtext, msg) + return [prb], [msg] + # Base URL mainly used by inliner.pep_reference; so this is correct: + ref = (inliner.document.settings.pep_base_url + + inliner.document.settings.pep_file_url_template % pepnum) + set_classes(options) + return [nodes.reference(rawtext, 'PEP ' + utils.unescape(text), refuri=ref, + options)], [] + +register_canonical_role('pep-reference', pep_reference_role) + +def rfc_reference_role(role, rawtext, text, lineno, inliner, + options={}, content=[]): + try: + rfcnum = int(text) + if rfcnum <= 0: + raise ValueError + except ValueError: + msg = inliner.reporter.error( + 'RFC number must be a number greater than or equal to 1; ' + '"%s" is invalid.' % text, line=lineno) + prb = inliner.problematic(rawtext, rawtext, msg) + return [prb], [msg] + # Base URL mainly used by inliner.rfc_reference, so this is correct: + ref = inliner.document.settings.rfc_base_url + inliner.rfc_url % rfcnum + set_classes(options) + node = nodes.reference(rawtext, 'RFC ' + utils.unescape(text), refuri=ref, + options) + return [node], [] + +register_canonical_role('rfc-reference', rfc_reference_role) + +def raw_role(role, rawtext, text, lineno, inliner, options={}, content=[]): + if not options.has_key('format'): + msg = inliner.reporter.error( + 'No format (Writer name) is associated with this role: "%s".\n' + 'The "raw" role cannot be used directly.\n' + 'Instead, use the "role" directive to create a new role with ' + 'an associated format.' % role, line=lineno) + prb = inliner.problematic(rawtext, rawtext, msg) + return [prb], [msg] + set_classes(options) + node = nodes.raw(rawtext, utils.unescape(text, 1), options) + return [node], [] + +raw_role.options = {'format': directives.unchanged} + +register_canonical_role('raw', raw_role) + + +###################################################################### +# Register roles that are currently unimplemented. +###################################################################### + +def unimplemented_role(role, rawtext, text, lineno, inliner, attributes={}): + msg = inliner.reporter.error( + 'Interpreted text role "%s" not implemented.' % role, line=lineno) + prb = inliner.problematic(rawtext, rawtext, msg) + return [prb], [msg] + +register_canonical_role('index', unimplemented_role) +register_canonical_role('named-reference', unimplemented_role) +register_canonical_role('anonymous-reference', unimplemented_role) +register_canonical_role('uri-reference', unimplemented_role) +register_canonical_role('footnote-reference', unimplemented_role) +register_canonical_role('citation-reference', unimplemented_role) +register_canonical_role('substitution-reference', unimplemented_role) +register_canonical_role('target', unimplemented_role) + +# This should remain unimplemented, for testing purposes: +register_canonical_role('restructuredtext-unimplemented-role', + unimplemented_role) + + +def set_classes(options): + """ + Auxiliary function to set options['classes'] and delete + options['class']. + """ + if options.has_key('class'): + assert not options.has_key('classes') + options['classes'] = options['class'] + del options['class'] diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/states.py --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/states.py Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,2988 @@ +# $Id: states.py 4824 2006-12-09 00:59:23Z goodger $ +# Author: David Goodger +# Copyright: This module has been placed in the public domain. + +""" +This is the ``docutils.parsers.restructuredtext.states`` module, the core of +the reStructuredText parser. It defines the following: + +:Classes: + - `RSTStateMachine`: reStructuredText parser's entry point. + - `NestedStateMachine`: recursive StateMachine. + - `RSTState`: reStructuredText State superclass. + - `Inliner`: For parsing inline markup. + - `Body`: Generic classifier of the first line of a block. + - `SpecializedBody`: Superclass for compound element members. + - `BulletList`: Second and subsequent bullet_list list_items + - `DefinitionList`: Second+ definition_list_items. + - `EnumeratedList`: Second+ enumerated_list list_items. + - `FieldList`: Second+ fields. + - `OptionList`: Second+ option_list_items. + - `RFC2822List`: Second+ RFC2822-style fields. + - `ExtensionOptions`: Parses directive option fields. + - `Explicit`: Second+ explicit markup constructs. + - `SubstitutionDef`: For embedded directives in substitution definitions. + - `Text`: Classifier of second line of a text block. + - `SpecializedText`: Superclass for continuation lines of Text-variants. + - `Definition`: Second line of potential definition_list_item. + - `Line`: Second line of overlined section title or transition marker. + - `Struct`: An auxiliary collection class. + +:Exception classes: + - `MarkupError` + - `ParserError` + - `MarkupMismatch` + +:Functions: + - `escape2null()`: Return a string, escape-backslashes converted to nulls. + - `unescape()`: Return a string, nulls removed or restored to backslashes. + +:Attributes: + - `state_classes`: set of State classes used with `RSTStateMachine`. + +Parser Overview +=============== + +The reStructuredText parser is implemented as a recursive state machine, +examining its input one line at a time. To understand how the parser works, +please first become familiar with the `docutils.statemachine` module. In the +description below, references are made to classes defined in this module; +please see the individual classes for details. + +Parsing proceeds as follows: + +1. The state machine examines each line of input, checking each of the + transition patterns of the state `Body`, in order, looking for a match. + The implicit transitions (blank lines and indentation) are checked before + any others. The 'text' transition is a catch-all (matches anything). + +2. The method associated with the matched transition pattern is called. + + A. Some transition methods are self-contained, appending elements to the + document tree (`Body.doctest` parses a doctest block). The parser's + current line index is advanced to the end of the element, and parsing + continues with step 1. + + B. Other transition methods trigger the creation of a nested state machine, + whose job is to parse a compound construct ('indent' does a block quote, + 'bullet' does a bullet list, 'overline' does a section [first checking + for a valid section header], etc.). + + - In the case of lists and explicit markup, a one-off state machine is + created and run to parse contents of the first item. + + - A new state machine is created and its initial state is set to the + appropriate specialized state (`BulletList` in the case of the + 'bullet' transition; see `SpecializedBody` for more detail). This + state machine is run to parse the compound element (or series of + explicit markup elements), and returns as soon as a non-member element + is encountered. For example, the `BulletList` state machine ends as + soon as it encounters an element which is not a list item of that + bullet list. The optional omission of inter-element blank lines is + enabled by this nested state machine. + + - The current line index is advanced to the end of the elements parsed, + and parsing continues with step 1. + + C. The result of the 'text' transition depends on the next line of text. + The current state is changed to `Text`, under which the second line is + examined. If the second line is: + + - Indented: The element is a definition list item, and parsing proceeds + similarly to step 2.B, using the `DefinitionList` state. + + - A line of uniform punctuation characters: The element is a section + header; again, parsing proceeds as in step 2.B, and `Body` is still + used. + + - Anything else: The element is a paragraph, which is examined for + inline markup and appended to the parent element. Processing + continues with step 1. +""" + +docformat = 'reStructuredText' + + +import sys +import re +import roman +from types import TupleType, FunctionType, MethodType +from docutils import nodes, statemachine, utils, urischemes +from docutils import ApplicationError, DataError +from docutils.statemachine import StateMachineWS, StateWS +from docutils.nodes import fully_normalize_name as normalize_name +from docutils.nodes import whitespace_normalize_name +from docutils.utils import escape2null, unescape, column_width +import docutils.parsers.rst +from docutils.parsers.rst import directives, languages, tableparser, roles +from docutils.parsers.rst.languages import en as _fallback_language_module + + +class MarkupError(DataError): pass +class UnknownInterpretedRoleError(DataError): pass +class InterpretedRoleNotImplementedError(DataError): pass +class ParserError(ApplicationError): pass +class MarkupMismatch(Exception): pass + + +class Struct: + + """Stores data attributes for dotted-attribute access.""" + + def init(self, keywordargs): + self.dict.update(keywordargs) + + +class RSTStateMachine(StateMachineWS): + + """ + reStructuredText's master StateMachine. + + The entry point to reStructuredText parsing is the `run()` method. + """ + + def run(self, input_lines, document, input_offset=0, match_titles=1, + inliner=None): + """ + Parse `input_lines` and modify the `document` node in place. + + Extend `StateMachineWS.run()`: set up parse-global data and + run the StateMachine. + """ + self.language = languages.get_language( + document.settings.language_code) + self.match_titles = match_titles + if inliner is None: + inliner = Inliner() + inliner.init_customizations(document.settings) + self.memo = Struct(document=document, + reporter=document.reporter, + language=self.language, + title_styles=[], + section_level=0, + section_bubble_up_kludge=0, + inliner=inliner) + self.document = document + self.attach_observer(document.note_source) + self.reporter = self.memo.reporter + self.node = document + results = StateMachineWS.run(self, input_lines, input_offset, + input_source=document['source']) + assert results == [], 'RSTStateMachine.run() results should be empty!' + self.node = self.memo = None # remove unneeded references + + +class NestedStateMachine(StateMachineWS): + + """ + StateMachine run from within other StateMachine runs, to parse nested + document structures. + """ + + def run(self, input_lines, input_offset, memo, node, match_titles=1): + """ + Parse `input_lines` and populate a `docutils.nodes.document` instance. + + Extend `StateMachineWS.run()`: set up document-wide data. + """ + self.match_titles = match_titles + self.memo = memo + self.document = memo.document + self.attach_observer(self.document.note_source) + self.reporter = memo.reporter + self.language = memo.language + self.node = node + results = StateMachineWS.run(self, input_lines, input_offset) + assert results == [], ('NestedStateMachine.run() results should be ' + 'empty!') + return results + + +class RSTState(StateWS): + + """ + reStructuredText State superclass. + + Contains methods used by all State subclasses. + """ + + nested_sm = NestedStateMachine + + def init(self, state_machine, debug=0): + self.nested_sm_kwargs = {'state_classes': state_classes, + 'initial_state': 'Body'} + StateWS.init(self, state_machine, debug) + + def runtime_init(self): + StateWS.runtime_init(self) + memo = self.state_machine.memo + self.memo = memo + self.reporter = memo.reporter + self.inliner = memo.inliner + self.document = memo.document + self.parent = self.state_machine.node + + def goto_line(self, abs_line_offset): + """ + Jump to input line `abs_line_offset`, ignoring jumps past the end. + """ + try: + self.state_machine.goto_line(abs_line_offset) + except EOFError: + pass + + def no_match(self, context, transitions): + """ + Override `StateWS.no_match` to generate a system message. + + This code should never be run. + """ + self.reporter.severe( + 'Internal error: no transition pattern match. State: "%s"; ' + 'transitions: %s; context: %s; current line: %r.' + % (self.class.name, transitions, context, + self.state_machine.line), + line=self.state_machine.abs_line_number()) + return context, None, [] + + def bof(self, context): + """Called at beginning of file.""" + return [], [] + + def nested_parse(self, block, input_offset, node, match_titles=0, + state_machine_class=None, state_machine_kwargs=None): + """ + Create a new StateMachine rooted at `node` and run it over the input + `block`. + """ + if state_machine_class is None: + state_machine_class = self.nested_sm + if state_machine_kwargs is None: + state_machine_kwargs = self.nested_sm_kwargs + block_length = len(block) + state_machine = state_machine_class(debug=self.debug, + state_machine_kwargs) + state_machine.run(block, input_offset, memo=self.memo, + node=node, match_titles=match_titles) + state_machine.unlink() + new_offset = state_machine.abs_line_offset() + # No `block.parent` implies disconnected -- lines aren't in sync: + if block.parent and (len(block) - block_length) != 0: + # Adjustment for block if modified in nested parse: + self.state_machine.next_line(len(block) - block_length) + return new_offset + + def nested_list_parse(self, block, input_offset, node, initial_state, + blank_finish, + blank_finish_state=None, + extra_settings={}, + match_titles=0, + state_machine_class=None, + state_machine_kwargs=None): + """ + Create a new StateMachine rooted at `node` and run it over the input + `block`. Also keep track of optional intermediate blank lines and the + required final one. + """ + if state_machine_class is None: + state_machine_class = self.nested_sm + if state_machine_kwargs is None: + state_machine_kwargs = self.nested_sm_kwargs.copy() + state_machine_kwargs['initial_state'] = initial_state + state_machine = state_machine_class(debug=self.debug, + state_machine_kwargs) + if blank_finish_state is None: + blank_finish_state = initial_state + state_machine.states[blank_finish_state].blank_finish = blank_finish + for key, value in extra_settings.items(): + setattr(state_machine.states[initial_state], key, value) + state_machine.run(block, input_offset, memo=self.memo, + node=node, match_titles=match_titles) + blank_finish = state_machine.states[blank_finish_state].blank_finish + state_machine.unlink() + return state_machine.abs_line_offset(), blank_finish + + def section(self, title, source, style, lineno, messages): + """Check for a valid subsection and create one if it checks out.""" + if self.check_subsection(source, style, lineno): + self.new_subsection(title, lineno, messages) + + def check_subsection(self, source, style, lineno): + """ + Check for a valid subsection header. Return 1 (true) or None (false). + + When a new section is reached that isn't a subsection of the current + section, back up the line count (use ``previous_line(-x)``), then + ``raise EOFError``. The current StateMachine will finish, then the + calling StateMachine can re-examine the title. This will work its way + back up the calling chain until the correct section level isreached. + + @@@ Alternative: Evaluate the title, store the title info & level, and + back up the chain until that level is reached. Store in memo? Or + return in results? + + :Exception: `EOFError` when a sibling or supersection encountered. + """ + memo = self.memo + title_styles = memo.title_styles + mylevel = memo.section_level + try: # check for existing title style + level = title_styles.index(style) + 1 + except ValueError: # new title style + if len(title_styles) == memo.section_level: # new subsection + title_styles.append(style) + return 1 + else: # not at lowest level + self.parent += self.title_inconsistent(source, lineno) + return None + if level <= mylevel: # sibling or supersection + memo.section_level = level # bubble up to parent section + if len(style) == 2: + memo.section_bubble_up_kludge = 1 + # back up 2 lines for underline title, 3 for overline title + self.state_machine.previous_line(len(style) + 1) + raise EOFError # let parent section re-evaluate + if level == mylevel + 1: # immediate subsection + return 1 + else: # invalid subsection + self.parent += self.title_inconsistent(source, lineno) + return None + + def title_inconsistent(self, sourcetext, lineno): + error = self.reporter.severe( + 'Title level inconsistent:', nodes.literal_block('', sourcetext), + line=lineno) + return error + + def new_subsection(self, title, lineno, messages): + """Append new subsection to document tree. On return, check level.""" + memo = self.memo + mylevel = memo.section_level + memo.section_level += 1 + section_node = nodes.section() + self.parent += section_node + textnodes, title_messages = self.inline_text(title, lineno) + titlenode = nodes.title(title, '', textnodes) + name = normalize_name(titlenode.astext()) + section_node['names'].append(name) + section_node += titlenode + section_node += messages + section_node += title_messages + self.document.note_implicit_target(section_node, section_node) + offset = self.state_machine.line_offset + 1 + absoffset = self.state_machine.abs_line_offset() + 1 + newabsoffset = self.nested_parse( + self.state_machine.input_lines[offset:], input_offset=absoffset, + node=section_node, match_titles=1) + self.goto_line(newabsoffset) + if memo.section_level <= mylevel: # can't handle next section? + raise EOFError # bubble up to supersection + # reset section_level; next pass will detect it properly + memo.section_level = mylevel + + def paragraph(self, lines, lineno): + """ + Return a list (paragraph & messages) & a boolean: literal_block next? + """ + data = '\n'.join(lines).rstrip() + if re.search(r'(?%(or_group)s)%(suffix)s' % locals() + if compile: + return re.compile(regexp, re.UNICODE) + else: + return regexp + + +class Inliner: + + """ + Parse inline markup; call the `parse()` method. + """ + + def init(self): + self.implicit_dispatch = [(self.patterns.uri, self.standalone_uri),] + """List of (pattern, bound method) tuples, used by + `self.implicit_inline`.""" + + def init_customizations(self, settings): + """Setting-based customizations; run when parsing begins.""" + if settings.pep_references: + self.implicit_dispatch.append((self.patterns.pep, + self.pep_reference)) + if settings.rfc_references: + self.implicit_dispatch.append((self.patterns.rfc, + self.rfc_reference)) + + def parse(self, text, lineno, memo, parent): + # Needs to be refactored for nested inline markup. + # Add nested_parse() method? + """ + Return 2 lists: nodes (text and inline elements), and system_messages. + + Using `self.patterns.initial`, a pattern which matches start-strings + (emphasis, strong, interpreted, phrase reference, literal, + substitution reference, and inline target) and complete constructs + (simple reference, footnote reference), search for a candidate. When + one is found, check for validity (e.g., not a quoted '' character). + If valid, search for the corresponding end string if applicable, and + check it for validity. If not found or invalid, generate a warning + and ignore the start-string. Implicit inline markup (e.g. standalone + URIs) is found last. + """ + self.reporter = memo.reporter + self.document = memo.document + self.language = memo.language + self.parent = parent + pattern_search = self.patterns.initial.search + dispatch = self.dispatch + remaining = escape2null(text) + processed = [] + unprocessed = [] + messages = [] + while remaining: + match = pattern_search(remaining) + if match: + groups = match.groupdict() + method = dispatch[groups['start'] or groups['backquote'] + or groups['refend'] or groups['fnend']] + before, inlines, remaining, sysmessages = method(self, match, + lineno) + unprocessed.append(before) + messages += sysmessages + if inlines: + processed += self.implicit_inline(''.join(unprocessed), + lineno) + processed += inlines + unprocessed = [] + else: + break + remaining = ''.join(unprocessed) + remaining + if remaining: + processed += self.implicit_inline(remaining, lineno) + return processed, messages + + openers = '\'"([{<' + closers = '\'")]}>' + start_string_prefix = (r'((?<=^)|(?<=[-/: \n%s]))' % re.escape(openers)) + end_string_suffix = (r'((?=$)|(?=[-/:.,;!? \n\x00%s]))' + % re.escape(closers)) + non_whitespace_before = r'(?]""" + # Last URI character; same as uric but no punctuation: + urilast = r"""[_~/=+a-zA-Z0-9]""" + # End of a URI (either 'urilast' or 'uric followed by a + # uri_end_delim'): + uri_end = r"""(?:%(urilast)s|%(uric)s(?=%(uri_end_delim)s))""" % locals() + emailc = r"""[-_!~'{|}/#?^`&=+$%a-zA-Z0-9\x00]""" + email_pattern = r""" + %(emailc)s+(?:\.%(emailc)s+)* # name + (?%s)(?P__?)' % simplename, + ('footnotelabel', r'\[', r'(?P\]_)', + [r'[0-9]+', # manually numbered + r'\#(%s)?' % simplename, # auto-numbered (w/ label?) + r'\', # auto-symbol + r'(?P%s)' % simplename] # citation reference + ) + ] + ), + ('backquote', # interpreted text or phrase reference + '(?P(:%s:)?)' % simplename, # optional role + non_whitespace_after, + ['`(?!`)'] # but not literal + ) + ] + ) + patterns = Struct( + initial=build_regexp(parts), + emphasis=re.compile(non_whitespace_escape_before + + r'(\)' + end_string_suffix), + strong=re.compile(non_whitespace_escape_before + + r'(\\)' + end_string_suffix), + interpreted_or_phrase_ref=re.compile( + r""" + %(non_whitespace_escape_before)s + ( + ` + (?P + (?P:%(simplename)s:)? + (?P__?)? + ) + ) + %(end_string_suffix)s + """ % locals(), re.VERBOSE | re.UNICODE), + embedded_uri=re.compile( + r""" + ( + (?:[ \n]+|^) # spaces or beginning of line/string + < # open bracket + %(non_whitespace_after)s + ([^<>\x00]+) # anything but angle brackets & nulls + %(non_whitespace_before)s + > # close bracket w/o whitespace before + ) + $ # end of string + """ % locals(), re.VERBOSE), + literal=re.compile(non_whitespace_before + '(``)' + + end_string_suffix), + target=re.compile(non_whitespace_escape_before + + r'(`)' + end_string_suffix), + substitution_ref=re.compile(non_whitespace_escape_before + + r'(\|_{0,2})' + + end_string_suffix), + email=re.compile(email_pattern % locals() + '$', re.VERBOSE), + uri=re.compile( + (r""" + %(start_string_prefix)s + (?P + (?P # absolute URI + (?P # scheme (http, ftp, mailto) + [a-zA-Z][a-zA-Z0-9.+-]* + ) + : + ( + ( # either: + (//?)? # hierarchical URI + %(uric)s* # URI characters + %(uri_end)s # final URI char + ) + ( # optional query + \?%(uric)s* + %(uri_end)s + )? + ( # optional fragment + \#%(uric)s* + %(uri_end)s + )? + ) + ) + | # OR + (?P # email address + """ + email_pattern + r""" + ) + ) + %(end_string_suffix)s + """) % locals(), re.VERBOSE), + pep=re.compile( + r""" + %(start_string_prefix)s + ( + (pep-(?P\d+)(.txt)?) # reference to source file + | + (PEP\s+(?P\d+)) # reference by name + ) + %(end_string_suffix)s""" % locals(), re.VERBOSE), + rfc=re.compile( + r""" + %(start_string_prefix)s + (RFC(-|\s+)?(?P\d+)) + %(end_string_suffix)s""" % locals(), re.VERBOSE)) + + def quoted_start(self, match): + """Return 1 if inline markup start-string is 'quoted', 0 if not.""" + string = match.string + start = match.start() + end = match.end() + if start == 0: # start-string at beginning of text + return 0 + prestart = string[start - 1] + try: + poststart = string[end] + if self.openers.index(prestart) \ + == self.closers.index(poststart): # quoted + return 1 + except IndexError: # start-string at end of text + return 1 + except ValueError: # not quoted + pass + return 0 + + def inline_obj(self, match, lineno, end_pattern, nodeclass, + restore_backslashes=0): + string = match.string + matchstart = match.start('start') + matchend = match.end('start') + if self.quoted_start(match): + return (string[:matchend], [], string[matchend:], [], '') + endmatch = end_pattern.search(string[matchend:]) + if endmatch and endmatch.start(1): # 1 or more chars + text = unescape(endmatch.string[:endmatch.start(1)], + restore_backslashes) + textend = matchend + endmatch.end(1) + rawsource = unescape(string[matchstart:textend], 1) + return (string[:matchstart], [nodeclass(rawsource, text)], + string[textend:], [], endmatch.group(1)) + msg = self.reporter.warning( + 'Inline %s start-string without end-string.' + % nodeclass.name, line=lineno) + text = unescape(string[matchstart:matchend], 1) + rawsource = unescape(string[matchstart:matchend], 1) + prb = self.problematic(text, rawsource, msg) + return string[:matchstart], [prb], string[matchend:], [msg], '' + + def problematic(self, text, rawsource, message): + msgid = self.document.set_id(message, self.parent) + problematic = nodes.problematic(rawsource, text, refid=msgid) + prbid = self.document.set_id(problematic) + message.add_backref(prbid) + return problematic + + def emphasis(self, match, lineno): + before, inlines, remaining, sysmessages, endstring = self.inline_obj( + match, lineno, self.patterns.emphasis, nodes.emphasis) + return before, inlines, remaining, sysmessages + + def strong(self, match, lineno): + before, inlines, remaining, sysmessages, endstring = self.inline_obj( + match, lineno, self.patterns.strong, nodes.strong) + return before, inlines, remaining, sysmessages + + def interpreted_or_phrase_ref(self, match, lineno): + end_pattern = self.patterns.interpreted_or_phrase_ref + string = match.string + matchstart = match.start('backquote') + matchend = match.end('backquote') + rolestart = match.start('role') + role = match.group('role') + position = '' + if role: + role = role[1:-1] + position = 'prefix' + elif self.quoted_start(match): + return (string[:matchend], [], string[matchend:], []) + endmatch = end_pattern.search(string[matchend:]) + if endmatch and endmatch.start(1): # 1 or more chars + textend = matchend + endmatch.end() + if endmatch.group('role'): + if role: + msg = self.reporter.warning( + 'Multiple roles in interpreted text (both ' + 'prefix and suffix present; only one allowed).', + line=lineno) + text = unescape(string[rolestart:textend], 1) + prb = self.problematic(text, text, msg) + return string[:rolestart], [prb], string[textend:], [msg] + role = endmatch.group('suffix')[1:-1] + position = 'suffix' + escaped = endmatch.string[:endmatch.start(1)] + rawsource = unescape(string[matchstart:textend], 1) + if rawsource[-1:] == '_': + if role: + msg = self.reporter.warning( + 'Mismatch: both interpreted text role %s and ' + 'reference suffix.' % position, line=lineno) + text = unescape(string[rolestart:textend], 1) + prb = self.problematic(text, text, msg) + return string[:rolestart], [prb], string[textend:], [msg] + return self.phrase_ref(string[:matchstart], string[textend:], + rawsource, escaped, unescape(escaped)) + else: + rawsource = unescape(string[rolestart:textend], 1) + nodelist, messages = self.interpreted(rawsource, escaped, role, + lineno) + return (string[:rolestart], nodelist, + string[textend:], messages) + msg = self.reporter.warning( + 'Inline interpreted text or phrase reference start-string ' + 'without end-string.', line=lineno) + text = unescape(string[matchstart:matchend], 1) + prb = self.problematic(text, text, msg) + return string[:matchstart], [prb], string[matchend:], [msg] + + def phrase_ref(self, before, after, rawsource, escaped, text): + match = self.patterns.embedded_uri.search(escaped) + if match: + text = unescape(escaped[:match.start(0)]) + uri_text = match.group(2) + uri = ''.join(uri_text.split()) + uri = self.adjust_uri(uri) + if uri: + target = nodes.target(match.group(1), refuri=uri) + else: + raise ApplicationError('problem with URI: %r' % uri_text) + if not text: + text = uri + else: + target = None + refname = normalize_name(text) + reference = nodes.reference(rawsource, text, + name=whitespace_normalize_name(text)) + node_list = [reference] + if rawsource[-2:] == '__': + if target: + reference['refuri'] = uri + else: + reference['anonymous'] = 1 + else: + if target: + reference['refuri'] = uri + target['names'].append(refname) + self.document.note_explicit_target(target, self.parent) + node_list.append(target) + else: + reference['refname'] = refname + self.document.note_refname(reference) + return before, node_list, after, [] + + def adjust_uri(self, uri): + match = self.patterns.email.match(uri) + if match: + return 'mailto:' + uri + else: + return uri + + def interpreted(self, rawsource, text, role, lineno): + role_fn, messages = roles.role(role, self.language, lineno, + self.reporter) + if role_fn: + nodes, messages2 = role_fn(role, rawsource, text, lineno, self) + return nodes, messages + messages2 + else: + msg = self.reporter.error( + 'Unknown interpreted text role "%s".' % role, + line=lineno) + return ([self.problematic(rawsource, rawsource, msg)], + messages + [msg]) + + def literal(self, match, lineno): + before, inlines, remaining, sysmessages, endstring = self.inline_obj( + match, lineno, self.patterns.literal, nodes.literal, + restore_backslashes=1) + return before, inlines, remaining, sysmessages + + def inline_internal_target(self, match, lineno): + before, inlines, remaining, sysmessages, endstring = self.inline_obj( + match, lineno, self.patterns.target, nodes.target) + if inlines and isinstance(inlines[0], nodes.target): + assert len(inlines) == 1 + target = inlines[0] + name = normalize_name(target.astext()) + target['names'].append(name) + self.document.note_explicit_target(target, self.parent) + return before, inlines, remaining, sysmessages + + def substitution_reference(self, match, lineno): + before, inlines, remaining, sysmessages, endstring = self.inline_obj( + match, lineno, self.patterns.substitution_ref, + nodes.substitution_reference) + if len(inlines) == 1: + subref_node = inlines[0] + if isinstance(subref_node, nodes.substitution_reference): + subref_text = subref_node.astext() + self.document.note_substitution_ref(subref_node, subref_text) + if endstring[-1:] == '_': + reference_node = nodes.reference( + '|%s%s' % (subref_text, endstring), '') + if endstring[-2:] == '__': + reference_node['anonymous'] = 1 + else: + reference_node['refname'] = normalize_name(subref_text) + self.document.note_refname(reference_node) + reference_node += subref_node + inlines = [reference_node] + return before, inlines, remaining, sysmessages + + def footnote_reference(self, match, lineno): + """ + Handles `nodes.footnote_reference` and `nodes.citation_reference` + elements. + """ + label = match.group('footnotelabel') + refname = normalize_name(label) + string = match.string + before = string[:match.start('whole')] + remaining = string[match.end('whole'):] + if match.group('citationlabel'): + refnode = nodes.citation_reference('[%s]_' % label, + refname=refname) + refnode += nodes.Text(label) + self.document.note_citation_ref(refnode) + else: + refnode = nodes.footnote_reference('[%s]_' % label) + if refname[0] == '#': + refname = refname[1:] + refnode['auto'] = 1 + self.document.note_autofootnote_ref(refnode) + elif refname == '': + refname = '' + refnode['auto'] = '' + self.document.note_symbol_footnote_ref( + refnode) + else: + refnode += nodes.Text(label) + if refname: + refnode['refname'] = refname + self.document.note_footnote_ref(refnode) + if utils.get_trim_footnote_ref_space(self.document.settings): + before = before.rstrip() + return (before, [refnode], remaining, []) + + def reference(self, match, lineno, anonymous=None): + referencename = match.group('refname') + refname = normalize_name(referencename) + referencenode = nodes.reference( + referencename + match.group('refend'), referencename, + name=whitespace_normalize_name(referencename)) + if anonymous: + referencenode['anonymous'] = 1 + else: + referencenode['refname'] = refname + self.document.note_refname(referencenode) + string = match.string + matchstart = match.start('whole') + matchend = match.end('whole') + return (string[:matchstart], [referencenode], string[matchend:], []) + + def anonymous_reference(self, match, lineno): + return self.reference(match, lineno, anonymous=1) + + def standalone_uri(self, match, lineno): + if not match.group('scheme') or urischemes.schemes.has_key( + match.group('scheme').lower()): + if match.group('email'): + addscheme = 'mailto:' + else: + addscheme = '' + text = match.group('whole') + unescaped = unescape(text, 0) + return [nodes.reference(unescape(text, 1), unescaped, + refuri=addscheme + unescaped)] + else: # not a valid scheme + raise MarkupMismatch + + def pep_reference(self, match, lineno): + text = match.group(0) + if text.startswith('pep-'): + pepnum = int(match.group('pepnum1')) + elif text.startswith('PEP'): + pepnum = int(match.group('pepnum2')) + else: + raise MarkupMismatch + ref = (self.document.settings.pep_base_url + + self.document.settings.pep_file_url_template % pepnum) + unescaped = unescape(text, 0) + return [nodes.reference(unescape(text, 1), unescaped, refuri=ref)] + + rfc_url = 'rfc%d.html' + + def rfc_reference(self, match, lineno): + text = match.group(0) + if text.startswith('RFC'): + rfcnum = int(match.group('rfcnum')) + ref = self.document.settings.rfc_base_url + self.rfc_url % rfcnum + else: + raise MarkupMismatch + unescaped = unescape(text, 0) + return [nodes.reference(unescape(text, 1), unescaped, refuri=ref)] + + def implicit_inline(self, text, lineno): + """ + Check each of the patterns in `self.implicit_dispatch` for a match, + and dispatch to the stored method for the pattern. Recursively check + the text before and after the match. Return a list of `nodes.Text` + and inline element nodes. + """ + if not text: + return [] + for pattern, method in self.implicit_dispatch: + match = pattern.search(text) + if match: + try: + # Must recurse on strings before and after the match; + # there may be multiple patterns. + return (self.implicit_inline(text[:match.start()], lineno) + + method(match, lineno) + + self.implicit_inline(text[match.end():], lineno)) + except MarkupMismatch: + pass + return [nodes.Text(unescape(text), rawsource=unescape(text, 1))] + + dispatch = {'*': emphasis, + '**': strong, + '`': interpreted_or_phrase_ref, + '``': literal, + '_`': inline_internal_target, + ']_': footnote_reference, + '|': substitution_reference, + '_': reference, + '__': anonymous_reference} + + +def _loweralpha_to_int(s, _zero=(ord('a')-1)): + return ord(s) - _zero + +def _upperalpha_to_int(s, _zero=(ord('A')-1)): + return ord(s) - _zero + +def _lowerroman_to_int(s): + return roman.fromRoman(s.upper()) + + +class Body(RSTState): + + """ + Generic classifier of the first line of a block. + """ + + double_width_pad_char = tableparser.TableParser.double_width_pad_char + """Padding character for East Asian double-width text.""" + + enum = Struct() + """Enumerated list parsing information.""" + + enum.formatinfo = { + 'parens': Struct(prefix='(', suffix=')', start=1, end=-1), + 'rparen': Struct(prefix='', suffix=')', start=0, end=-1), + 'period': Struct(prefix='', suffix='.', start=0, end=-1)} + enum.formats = enum.formatinfo.keys() + enum.sequences = ['arabic', 'loweralpha', 'upperalpha', + 'lowerroman', 'upperroman'] # ORDERED! + enum.sequencepats = {'arabic': '[0-9]+', + 'loweralpha': '[a-z]', + 'upperalpha': '[A-Z]', + 'lowerroman': '[ivxlcdm]+', + 'upperroman': '[IVXLCDM]+',} + enum.converters = {'arabic': int, + 'loweralpha': _loweralpha_to_int, + 'upperalpha': _upperalpha_to_int, + 'lowerroman': _lowerroman_to_int, + 'upperroman': roman.fromRoman} + + enum.sequenceregexps = {} + for sequence in enum.sequences: + enum.sequenceregexps[sequence] = re.compile( + enum.sequencepats[sequence] + '$') + + grid_table_top_pat = re.compile(r'\+-[-+]+-\+ $') + """Matches the top (& bottom) of a full table).""" + + simple_table_top_pat = re.compile('=+( +=+)+ $') + """Matches the top of a simple table.""" + + simple_table_border_pat = re.compile('=+[ =]$') + """Matches the bottom & header bottom of a simple table.""" + + pats = {} + """Fragments of patterns used by transitions.""" + + pats['nonalphanum7bit'] = '[!-/:-@[-`{-~]' + pats['alpha'] = '[a-zA-Z]' + pats['alphanum'] = '[a-zA-Z0-9]' + pats['alphanumplus'] = '[a-zA-Z0-9_-]' + pats['enum'] = ('(%(arabic)s|%(loweralpha)s|%(upperalpha)s|%(lowerroman)s' + '|%(upperroman)s|#)' % enum.sequencepats) + pats['optname'] = '%(alphanum)s%(alphanumplus)s' % pats + # @@@ Loosen up the pattern? Allow Unicode? + pats['optarg'] = '(%(alpha)s%(alphanumplus)s|<[^<>]+>)' % pats + pats['shortopt'] = r'(-|\+)%(alphanum)s( ?%(optarg)s)?' % pats + pats['longopt'] = r'(--|/)%(optname)s([ =]%(optarg)s)?' % pats + pats['option'] = r'(%(shortopt)s|%(longopt)s)' % pats + + for format in enum.formats: + pats[format] = '(?P<%s>%s%s%s)' % ( + format, re.escape(enum.formatinfo[format].prefix), + pats['enum'], re.escape(enum.formatinfo[format].suffix)) + + patterns = { + 'bullet': ur'[-+\u2022\u2023\u2043]( +|$)', + 'enumerator': r'(%(parens)s|%(rparen)s|%(period)s)( +|$)' % pats, + 'field_marker': r':(?![: ])([^:\\]|\\.)(?>>( +|$)', + 'line_block': r'\|( +|$)', + 'grid_table_top': grid_table_top_pat, + 'simple_table_top': simple_table_top_pat, + 'explicit_markup': r'\.\.( +|$)', + 'anonymous': r'__( +|$)', + 'line': r'(%(nonalphanum7bit)s)\1 $' % pats, + 'text': r''} + initial_transitions = ( + 'bullet', + 'enumerator', + 'field_marker', + 'option_marker', + 'doctest', + 'line_block', + 'grid_table_top', + 'simple_table_top', + 'explicit_markup', + 'anonymous', + 'line', + 'text') + + def indent(self, match, context, next_state): + """Block quote.""" + indented, indent, line_offset, blank_finish = \ + self.state_machine.get_indented() + elements = self.block_quote(indented, line_offset) + self.parent += elements + if not blank_finish: + self.parent += self.unindent_warning('Block quote') + return context, next_state, [] + + def block_quote(self, indented, line_offset): + elements = [] + while indented: + (blockquote_lines, + attribution_lines, + attribution_offset, + indented, + new_line_offset) = self.split_attribution(indented, line_offset) + blockquote = nodes.block_quote() + self.nested_parse(blockquote_lines, line_offset, blockquote) + elements.append(blockquote) + if attribution_lines: + attribution, messages = self.parse_attribution( + attribution_lines, attribution_offset) + blockquote += attribution + elements += messages + line_offset = new_line_offset + while indented and not indented[0]: + indented = indented[1:] + line_offset += 1 + return elements + + # U+2014 is an em-dash: + attribution_pattern = re.compile(ur'(---?(?!-)|\u2014) (?=[^ \n])') + + def split_attribution(self, indented, line_offset): + """ + Check for a block quote attribution and split it off: + + First line after a blank line must begin with a dash ("--", "---", + em-dash; matches `self.attribution_pattern`). + Every line after that must have consistent indentation. + * Attributions must be preceded by block quote content. + + Return a tuple of: (block quote content lines, content offset, + attribution lines, attribution offset, remaining indented lines). + """ + blank = None + nonblank_seen = False + for i in range(len(indented)): + line = indented[i].rstrip() + if line: + if nonblank_seen and blank == i - 1: # last line blank + match = self.attribution_pattern.match(line) + if match: + attribution_end, indent = self.check_attribution( + indented, i) + if attribution_end: + a_lines = indented[i:attribution_end] + a_lines.trim_left(match.end(), end=1) + a_lines.trim_left(indent, start=1) + return (indented[:i], a_lines, + i, indented[attribution_end:], + line_offset + attribution_end) + nonblank_seen = True + else: + blank = i + else: + return (indented, None, None, None, None) + + def check_attribution(self, indented, attribution_start): + """ + Check attribution shape. + Return the index past the end of the attribution, and the indent. + """ + indent = None + i = attribution_start + 1 + for i in range(attribution_start + 1, len(indented)): + line = indented[i].rstrip() + if not line: + break + if indent is None: + indent = len(line) - len(line.lstrip()) + elif len(line) - len(line.lstrip()) != indent: + return None, None # bad shape; not an attribution + else: + # return index of line after last attribution line: + i += 1 + return i, (indent or 0) + + def parse_attribution(self, indented, line_offset): + text = '\n'.join(indented).rstrip() + lineno = self.state_machine.abs_line_number() + line_offset + textnodes, messages = self.inline_text(text, lineno) + node = nodes.attribution(text, '', textnodes) + node.line = lineno + return node, messages + + def bullet(self, match, context, next_state): + """Bullet list item.""" + bulletlist = nodes.bullet_list() + self.parent += bulletlist + bulletlist['bullet'] = match.string[0] + i, blank_finish = self.list_item(match.end()) + bulletlist += i + offset = self.state_machine.line_offset + 1 # next line + new_line_offset, blank_finish = self.nested_list_parse( + self.state_machine.input_lines[offset:], + input_offset=self.state_machine.abs_line_offset() + 1, + node=bulletlist, initial_state='BulletList', + blank_finish=blank_finish) + self.goto_line(new_line_offset) + if not blank_finish: + self.parent += self.unindent_warning('Bullet list') + return [], next_state, [] + + def list_item(self, indent): + if self.state_machine.line[indent:]: + indented, line_offset, blank_finish = ( + self.state_machine.get_known_indented(indent)) + else: + indented, indent, line_offset, blank_finish = ( + self.state_machine.get_first_known_indented(indent)) + listitem = nodes.list_item('\n'.join(indented)) + if indented: + self.nested_parse(indented, input_offset=line_offset, + node=listitem) + return listitem, blank_finish + + def enumerator(self, match, context, next_state): + """Enumerated List Item""" + format, sequence, text, ordinal = self.parse_enumerator(match) + if not self.is_enumerated_list_item(ordinal, sequence, format): + raise statemachine.TransitionCorrection('text') + enumlist = nodes.enumerated_list() + self.parent += enumlist + if sequence == '#': + enumlist['enumtype'] = 'arabic' + else: + enumlist['enumtype'] = sequence + enumlist['prefix'] = self.enum.formatinfo[format].prefix + enumlist['suffix'] = self.enum.formatinfo[format].suffix + if ordinal != 1: + enumlist['start'] = ordinal + msg = self.reporter.info( + 'Enumerated list start value not ordinal-1: "%s" (ordinal %s)' + % (text, ordinal), line=self.state_machine.abs_line_number()) + self.parent += msg + listitem, blank_finish = self.list_item(match.end()) + enumlist += listitem + offset = self.state_machine.line_offset + 1 # next line + newline_offset, blank_finish = self.nested_list_parse( + self.state_machine.input_lines[offset:], + input_offset=self.state_machine.abs_line_offset() + 1, + node=enumlist, initial_state='EnumeratedList', + blank_finish=blank_finish, + extra_settings={'lastordinal': ordinal, + 'format': format, + 'auto': sequence == '#'}) + self.goto_line(newline_offset) + if not blank_finish: + self.parent += self.unindent_warning('Enumerated list') + return [], next_state, [] + + def parse_enumerator(self, match, expected_sequence=None): + """ + Analyze an enumerator and return the results. + + :Return: + - the enumerator format ('period', 'parens', or 'rparen'), + - the sequence used ('arabic', 'loweralpha', 'upperroman', etc.), + - the text of the enumerator, stripped of formatting, and + - the ordinal value of the enumerator ('a' -> 1, 'ii' -> 2, etc.; + ``None`` is returned for invalid enumerator text). + + The enumerator format has already been determined by the regular + expression match. If `expected_sequence` is given, that sequence is + tried first. If not, we check for Roman numeral 1. This way, + single-character Roman numerals (which are also alphabetical) can be + matched. If no sequence has been matched, all sequences are checked in + order. + """ + groupdict = match.groupdict() + sequence = '' + for format in self.enum.formats: + if groupdict[format]: # was this the format matched? + break # yes; keep `format` + else: # shouldn't happen + raise ParserError('enumerator format not matched') + text = groupdict[format][self.enum.formatinfo[format].start + :self.enum.formatinfo[format].end] + if text == '#': + sequence = '#' + elif expected_sequence: + try: + if self.enum.sequenceregexps[expected_sequence].match(text): + sequence = expected_sequence + except KeyError: # shouldn't happen + raise ParserError('unknown enumerator sequence: %s' + % sequence) + elif text == 'i': + sequence = 'lowerroman' + elif text == 'I': + sequence = 'upperroman' + if not sequence: + for sequence in self.enum.sequences: + if self.enum.sequenceregexps[sequence].match(text): + break + else: # shouldn't happen + raise ParserError('enumerator sequence not matched') + if sequence == '#': + ordinal = 1 + else: + try: + ordinal = self.enum.converters[sequence](text) + except roman.InvalidRomanNumeralError: + ordinal = None + return format, sequence, text, ordinal + + def is_enumerated_list_item(self, ordinal, sequence, format): + """ + Check validity based on the ordinal value and the second line. + + Return true iff the ordinal is valid and the second line is blank, + indented, or starts with the next enumerator or an auto-enumerator. + """ + if ordinal is None: + return None + try: + next_line = self.state_machine.next_line() + except EOFError: # end of input lines + self.state_machine.previous_line() + return 1 + else: + self.state_machine.previous_line() + if not next_line[:1].strip(): # blank or indented + return 1 + result = self.make_enumerator(ordinal + 1, sequence, format) + if result: + next_enumerator, auto_enumerator = result + try: + if ( next_line.startswith(next_enumerator) or + next_line.startswith(auto_enumerator) ): + return 1 + except TypeError: + pass + return None + + def make_enumerator(self, ordinal, sequence, format): + """ + Construct and return the next enumerated list item marker, and an + auto-enumerator ("#" instead of the regular enumerator). + + Return ``None`` for invalid (out of range) ordinals. + """ #" + if sequence == '#': + enumerator = '#' + elif sequence == 'arabic': + enumerator = str(ordinal) + else: + if sequence.endswith('alpha'): + if ordinal > 26: + return None + enumerator = chr(ordinal + ord('a') - 1) + elif sequence.endswith('roman'): + try: + enumerator = roman.toRoman(ordinal) + except roman.RomanError: + return None + else: # shouldn't happen + raise ParserError('unknown enumerator sequence: "%s"' + % sequence) + if sequence.startswith('lower'): + enumerator = enumerator.lower() + elif sequence.startswith('upper'): + enumerator = enumerator.upper() + else: # shouldn't happen + raise ParserError('unknown enumerator sequence: "%s"' + % sequence) + formatinfo = self.enum.formatinfo[format] + next_enumerator = (formatinfo.prefix + enumerator + formatinfo.suffix + + ' ') + auto_enumerator = formatinfo.prefix + '#' + formatinfo.suffix + ' ' + return next_enumerator, auto_enumerator + + def field_marker(self, match, context, next_state): + """Field list item.""" + field_list = nodes.field_list() + self.parent += field_list + field, blank_finish = self.field(match) + field_list += field + offset = self.state_machine.line_offset + 1 # next line + newline_offset, blank_finish = self.nested_list_parse( + self.state_machine.input_lines[offset:], + input_offset=self.state_machine.abs_line_offset() + 1, + node=field_list, initial_state='FieldList', + blank_finish=blank_finish) + self.goto_line(newline_offset) + if not blank_finish: + self.parent += self.unindent_warning('Field list') + return [], next_state, [] + + def field(self, match): + name = self.parse_field_marker(match) + lineno = self.state_machine.abs_line_number() + indented, indent, line_offset, blank_finish = \ + self.state_machine.get_first_known_indented(match.end()) + field_node = nodes.field() + field_node.line = lineno + name_nodes, name_messages = self.inline_text(name, lineno) + field_node += nodes.field_name(name, '', name_nodes) + field_body = nodes.field_body('\n'.join(indented), name_messages) + field_node += field_body + if indented: + self.parse_field_body(indented, line_offset, field_body) + return field_node, blank_finish + + def parse_field_marker(self, match): + """Extract & return field name from a field marker match.""" + field = match.group()[1:] # strip off leading ':' + field = field[:field.rfind(':')] # strip off trailing ':' etc. + return field + + def parse_field_body(self, indented, offset, node): + self.nested_parse(indented, input_offset=offset, node=node) + + def option_marker(self, match, context, next_state): + """Option list item.""" + optionlist = nodes.option_list() + try: + listitem, blank_finish = self.option_list_item(match) + except MarkupError, (message, lineno): + # This shouldn't happen; pattern won't match. + msg = self.reporter.error( + 'Invalid option list marker: %s' % message, line=lineno) + self.parent += msg + indented, indent, line_offset, blank_finish = \ + self.state_machine.get_first_known_indented(match.end()) + elements = self.block_quote(indented, line_offset) + self.parent += elements + if not blank_finish: + self.parent += self.unindent_warning('Option list') + return [], next_state, [] + self.parent += optionlist + optionlist += listitem + offset = self.state_machine.line_offset + 1 # next line + newline_offset, blank_finish = self.nested_list_parse( + self.state_machine.input_lines[offset:], + input_offset=self.state_machine.abs_line_offset() + 1, + node=optionlist, initial_state='OptionList', + blank_finish=blank_finish) + self.goto_line(newline_offset) + if not blank_finish: + self.parent += self.unindent_warning('Option list') + return [], next_state, [] + + def option_list_item(self, match): + offset = self.state_machine.abs_line_offset() + options = self.parse_option_marker(match) + indented, indent, line_offset, blank_finish = \ + self.state_machine.get_first_known_indented(match.end()) + if not indented: # not an option list item + self.goto_line(offset) + raise statemachine.TransitionCorrection('text') + option_group = nodes.option_group('', options) + description = nodes.description('\n'.join(indented)) + option_list_item = nodes.option_list_item('', option_group, + description) + if indented: + self.nested_parse(indented, input_offset=line_offset, + node=description) + return option_list_item, blank_finish + + def parse_option_marker(self, match): + """ + Return a list of `node.option` and `node.option_argument` objects, + parsed from an option marker match. + + :Exception: `MarkupError` for invalid option markers. + """ + optlist = [] + optionstrings = match.group().rstrip().split(', ') + for optionstring in optionstrings: + tokens = optionstring.split() + delimiter = ' ' + firstopt = tokens[0].split('=') + if len(firstopt) > 1: + # "--opt=value" form + tokens[:1] = firstopt + delimiter = '=' + elif (len(tokens[0]) > 2 + and ((tokens[0].startswith('-') + and not tokens[0].startswith('--')) + or tokens[0].startswith('+'))): + # "-ovalue" form + tokens[:1] = [tokens[0][:2], tokens[0][2:]] + delimiter = '' + if len(tokens) > 1 and (tokens[1].startswith('<') + and tokens[-1].endswith('>')): + # "-o " form; join all values into one token + tokens[1:] = [' '.join(tokens[1:])] + if 0 < len(tokens) <= 2: + option = nodes.option(optionstring) + option += nodes.option_string(tokens[0], tokens[0]) + if len(tokens) > 1: + option += nodes.option_argument(tokens[1], tokens[1], + delimiter=delimiter) + optlist.append(option) + else: + raise MarkupError( + 'wrong number of option tokens (=%s), should be 1 or 2: ' + '"%s"' % (len(tokens), optionstring), + self.state_machine.abs_line_number() + 1) + return optlist + + def doctest(self, match, context, next_state): + data = '\n'.join(self.state_machine.get_text_block()) + self.parent += nodes.doctest_block(data, data) + return [], next_state, [] + + def line_block(self, match, context, next_state): + """First line of a line block.""" + block = nodes.line_block() + self.parent += block + lineno = self.state_machine.abs_line_number() + line, messages, blank_finish = self.line_block_line(match, lineno) + block += line + self.parent += messages + if not blank_finish: + offset = self.state_machine.line_offset + 1 # next line + new_line_offset, blank_finish = self.nested_list_parse( + self.state_machine.input_lines[offset:], + input_offset=self.state_machine.abs_line_offset() + 1, + node=block, initial_state='LineBlock', + blank_finish=0) + self.goto_line(new_line_offset) + if not blank_finish: + self.parent += self.reporter.warning( + 'Line block ends without a blank line.', + line=(self.state_machine.abs_line_number() + 1)) + if len(block): + if block[0].indent is None: + block[0].indent = 0 + self.nest_line_block_lines(block) + return [], next_state, [] + + def line_block_line(self, match, lineno): + """Return one line element of a line_block.""" + indented, indent, line_offset, blank_finish = \ + self.state_machine.get_first_known_indented(match.end(), + until_blank=1) + text = u'\n'.join(indented) + text_nodes, messages = self.inline_text(text, lineno) + line = nodes.line(text, '', *text_nodes) + if match.string.rstrip() != '|': # not empty + line.indent = len(match.group(1)) - 1 + return line, messages, blank_finish + + def nest_line_block_lines(self, block): + for index in range(1, len(block)): + if block[index].indent is None: + block[index].indent = block[index - 1].indent + self.nest_line_block_segment(block) + + def nest_line_block_segment(self, block): + indents = [item.indent for item in block] + least = min(indents) + new_items = [] + new_block = nodes.line_block() + for item in block: + if item.indent > least: + new_block.append(item) + else: + if len(new_block): + self.nest_line_block_segment(new_block) + new_items.append(new_block) + new_block = nodes.line_block() + new_items.append(item) + if len(new_block): + self.nest_line_block_segment(new_block) + new_items.append(new_block) + block[:] = new_items + + def grid_table_top(self, match, context, next_state): + """Top border of a full table.""" + return self.table_top(match, context, next_state, + self.isolate_grid_table, + tableparser.GridTableParser) + + def simple_table_top(self, match, context, next_state): + """Top border of a simple table.""" + return self.table_top(match, context, next_state, + self.isolate_simple_table, + tableparser.SimpleTableParser) + + def table_top(self, match, context, next_state, + isolate_function, parser_class): + """Top border of a generic table.""" + nodelist, blank_finish = self.table(isolate_function, parser_class) + self.parent += nodelist + if not blank_finish: + msg = self.reporter.warning( + 'Blank line required after table.', + line=self.state_machine.abs_line_number() + 1) + self.parent += msg + return [], next_state, [] + + def table(self, isolate_function, parser_class): + """Parse a table.""" + block, messages, blank_finish = isolate_function() + if block: + try: + parser = parser_class() + tabledata = parser.parse(block) + tableline = (self.state_machine.abs_line_number() - len(block) + + 1) + table = self.build_table(tabledata, tableline) + nodelist = [table] + messages + except tableparser.TableMarkupError, detail: + nodelist = self.malformed_table( + block, ' '.join(detail.args)) + messages + else: + nodelist = messages + return nodelist, blank_finish + + def isolate_grid_table(self): + messages = [] + blank_finish = 1 + try: + block = self.state_machine.get_text_block(flush_left=1) + except statemachine.UnexpectedIndentationError, instance: + block, source, lineno = instance.args + messages.append(self.reporter.error('Unexpected indentation.', + source=source, line=lineno)) + blank_finish = 0 + block.disconnect() + # for East Asian chars: + block.pad_double_width(self.double_width_pad_char) + width = len(block[0].strip()) + for i in range(len(block)): + block[i] = block[i].strip() + if block[i][0] not in '+|': # check left edge + blank_finish = 0 + self.state_machine.previous_line(len(block) - i) + del block[i:] + break + if not self.grid_table_top_pat.match(block[-1]): # find bottom + blank_finish = 0 + # from second-last to third line of table: + for i in range(len(block) - 2, 1, -1): + if self.grid_table_top_pat.match(block[i]): + self.state_machine.previous_line(len(block) - i + 1) + del block[i+1:] + break + else: + messages.extend(self.malformed_table(block)) + return [], messages, blank_finish + for i in range(len(block)): # check right edge + if len(block[i]) != width or block[i][-1] not in '+|': + messages.extend(self.malformed_table(block)) + return [], messages, blank_finish + return block, messages, blank_finish + + def isolate_simple_table(self): + start = self.state_machine.line_offset + lines = self.state_machine.input_lines + limit = len(lines) - 1 + toplen = len(lines[start].strip()) + pattern_match = self.simple_table_border_pat.match + found = 0 + found_at = None + i = start + 1 + while i <= limit: + line = lines[i] + match = pattern_match(line) + if match: + if len(line.strip()) != toplen: + self.state_machine.next_line(i - start) + messages = self.malformed_table( + lines[start:i+1], 'Bottom/header table border does ' + 'not match top border.') + return [], messages, i == limit or not lines[i+1].strip() + found += 1 + found_at = i + if found == 2 or i == limit or not lines[i+1].strip(): + end = i + break + i += 1 + else: # reached end of input_lines + if found: + extra = ' or no blank line after table bottom' + self.state_machine.next_line(found_at - start) + block = lines[start:found_at+1] + else: + extra = '' + self.state_machine.next_line(i - start - 1) + block = lines[start:] + messages = self.malformed_table( + block, 'No bottom table border found%s.' % extra) + return [], messages, not extra + self.state_machine.next_line(end - start) + block = lines[start:end+1] + # for East Asian chars: + block.pad_double_width(self.double_width_pad_char) + return block, [], end == limit or not lines[end+1].strip() + + def malformed_table(self, block, detail=''): + block.replace(self.double_width_pad_char, '') + data = '\n'.join(block) + message = 'Malformed table.' + lineno = self.state_machine.abs_line_number() - len(block) + 1 + if detail: + message += '\n' + detail + error = self.reporter.error(message, nodes.literal_block(data, data), + line=lineno) + return [error] + + def build_table(self, tabledata, tableline, stub_columns=0): + colwidths, headrows, bodyrows = tabledata + table = nodes.table() + tgroup = nodes.tgroup(cols=len(colwidths)) + table += tgroup + for colwidth in colwidths: + colspec = nodes.colspec(colwidth=colwidth) + if stub_columns: + colspec.attributes['stub'] = 1 + stub_columns -= 1 + tgroup += colspec + if headrows: + thead = nodes.thead() + tgroup += thead + for row in headrows: + thead += self.build_table_row(row, tableline) + tbody = nodes.tbody() + tgroup += tbody + for row in bodyrows: + tbody += self.build_table_row(row, tableline) + return table + + def build_table_row(self, rowdata, tableline): + row = nodes.row() + for cell in rowdata: + if cell is None: + continue + morerows, morecols, offset, cellblock = cell + attributes = {} + if morerows: + attributes['morerows'] = morerows + if morecols: + attributes['morecols'] = morecols + entry = nodes.entry(**attributes) + row += entry + if ''.join(cellblock): + self.nested_parse(cellblock, input_offset=tableline+offset, + node=entry) + return row + + + explicit = Struct() + """Patterns and constants used for explicit markup recognition.""" + + explicit.patterns = Struct( + target=re.compile(r""" + ( + _ # anonymous target + | # OR + (?!_) # no underscore at the beginning + (?P`?) # optional open quote + (?![ `]) # first char. not space or + # backquote + (?P # reference name + .+? + ) + %(non_whitespace_escape_before)s + (?P=quote) # close quote if open quote used + ) + (?%(simplename)s)_ + | # OR + ` # open backquote + (?![ ]) # not space + (?P.+?) # hyperlink phrase + %(non_whitespace_escape_before)s + `_ # close backquote, + # reference mark + ) + $ # end of string + """ % vars(Inliner), re.VERBOSE | re.UNICODE), + substitution=re.compile(r""" + ( + (?![ ]) # first char. not space + (?P.+?) # substitution text + %(non_whitespace_escape_before)s + \| # close delimiter + ) + ([ ]+|$) # followed by whitespace + """ % vars(Inliner), re.VERBOSE),) + + def footnote(self, match): + lineno = self.state_machine.abs_line_number() + indented, indent, offset, blank_finish = \ + self.state_machine.get_first_known_indented(match.end()) + label = match.group(1) + name = normalize_name(label) + footnote = nodes.footnote('\n'.join(indented)) + footnote.line = lineno + if name[0] == '#': # auto-numbered + name = name[1:] # autonumber label + footnote['auto'] = 1 + if name: + footnote['names'].append(name) + self.document.note_autofootnote(footnote) + elif name == '': # auto-symbol + name = '' + footnote['auto'] = '' + self.document.note_symbol_footnote(footnote) + else: # manually numbered + footnote += nodes.label('', label) + footnote['names'].append(name) + self.document.note_footnote(footnote) + if name: + self.document.note_explicit_target(footnote, footnote) + else: + self.document.set_id(footnote, footnote) + if indented: + self.nested_parse(indented, input_offset=offset, node=footnote) + return [footnote], blank_finish + + def citation(self, match): + lineno = self.state_machine.abs_line_number() + indented, indent, offset, blank_finish = \ + self.state_machine.get_first_known_indented(match.end()) + label = match.group(1) + name = normalize_name(label) + citation = nodes.citation('\n'.join(indented)) + citation.line = lineno + citation += nodes.label('', label) + citation['names'].append(name) + self.document.note_citation(citation) + self.document.note_explicit_target(citation, citation) + if indented: + self.nested_parse(indented, input_offset=offset, node=citation) + return [citation], blank_finish + + def hyperlink_target(self, match): + pattern = self.explicit.patterns.target + lineno = self.state_machine.abs_line_number() + block, indent, offset, blank_finish = \ + self.state_machine.get_first_known_indented( + match.end(), until_blank=1, strip_indent=0) + blocktext = match.string[:match.end()] + '\n'.join(block) + block = [escape2null(line) for line in block] + escaped = block[0] + blockindex = 0 + while 1: + targetmatch = pattern.match(escaped) + if targetmatch: + break + blockindex += 1 + try: + escaped += block[blockindex] + except IndexError: + raise MarkupError('malformed hyperlink target.', lineno) + del block[:blockindex] + block[0] = (block[0] + ' ')[targetmatch.end()-len(escaped)-1:].strip() + target = self.make_target(block, blocktext, lineno, + targetmatch.group('name')) + return [target], blank_finish + + def make_target(self, block, block_text, lineno, target_name): + target_type, data = self.parse_target(block, block_text, lineno) + if target_type == 'refname': + target = nodes.target(block_text, '', refname=normalize_name(data)) + target.indirect_reference_name = data + self.add_target(target_name, '', target, lineno) + self.document.note_indirect_target(target) + return target + elif target_type == 'refuri': + target = nodes.target(block_text, '') + self.add_target(target_name, data, target, lineno) + return target + else: + return data + + def parse_target(self, block, block_text, lineno): + """ + Determine the type of reference of a target. + + :Return: A 2-tuple, one of: + + - 'refname' and the indirect reference name + - 'refuri' and the URI + - 'malformed' and a system_message node + """ + if block and block[-1].strip()[-1:] == '_': # possible indirect target + reference = ' '.join([line.strip() for line in block]) + refname = self.is_reference(reference) + if refname: + return 'refname', refname + reference = ''.join([''.join(line.split()) for line in block]) + return 'refuri', unescape(reference) + + def is_reference(self, reference): + match = self.explicit.patterns.reference.match( + whitespace_normalize_name(reference)) + if not match: + return None + return unescape(match.group('simple') or match.group('phrase')) + + def add_target(self, targetname, refuri, target, lineno): + target.line = lineno + if targetname: + name = normalize_name(unescape(targetname)) + target['names'].append(name) + if refuri: + uri = self.inliner.adjust_uri(refuri) + if uri: + target['refuri'] = uri + else: + raise ApplicationError('problem with URI: %r' % refuri) + self.document.note_explicit_target(target, self.parent) + else: # anonymous target + if refuri: + target['refuri'] = refuri + target['anonymous'] = 1 + self.document.note_anonymous_target(target) + + def substitution_def(self, match): + pattern = self.explicit.patterns.substitution + lineno = self.state_machine.abs_line_number() + block, indent, offset, blank_finish = \ + self.state_machine.get_first_known_indented(match.end(), + strip_indent=0) + blocktext = (match.string[:match.end()] + '\n'.join(block)) + block.disconnect() + escaped = escape2null(block[0].rstrip()) + blockindex = 0 + while 1: + subdefmatch = pattern.match(escaped) + if subdefmatch: + break + blockindex += 1 + try: + escaped = escaped + ' ' + escape2null(block[blockindex].strip()) + except IndexError: + raise MarkupError('malformed substitution definition.', + lineno) + del block[:blockindex] # strip out the substitution marker + block[0] = (block[0].strip() + ' ')[subdefmatch.end()-len(escaped)-1:-1] + if not block[0]: + del block[0] + offset += 1 + while block and not block[-1].strip(): + block.pop() + subname = subdefmatch.group('name') + substitution_node = nodes.substitution_definition(blocktext) + substitution_node.line = lineno + if not block: + msg = self.reporter.warning( + 'Substitution definition "%s" missing contents.' % subname, + nodes.literal_block(blocktext, blocktext), line=lineno) + return [msg], blank_finish + block[0] = block[0].strip() + substitution_node['names'].append( + nodes.whitespace_normalize_name(subname)) + new_abs_offset, blank_finish = self.nested_list_parse( + block, input_offset=offset, node=substitution_node, + initial_state='SubstitutionDef', blank_finish=blank_finish) + i = 0 + for node in substitution_node[:]: + if not (isinstance(node, nodes.Inline) or + isinstance(node, nodes.Text)): + self.parent += substitution_node[i] + del substitution_node[i] + else: + i += 1 + for node in substitution_node.traverse(nodes.Element): + if self.disallowed_inside_substitution_definitions(node): + pformat = nodes.literal_block('', node.pformat().rstrip()) + msg = self.reporter.error( + 'Substitution definition contains illegal element:', + pformat, nodes.literal_block(blocktext, blocktext), + line=lineno) + return [msg], blank_finish + if len(substitution_node) == 0: + msg = self.reporter.warning( + 'Substitution definition "%s" empty or invalid.' + % subname, + nodes.literal_block(blocktext, blocktext), line=lineno) + return [msg], blank_finish + self.document.note_substitution_def( + substitution_node, subname, self.parent) + return [substitution_node], blank_finish + + def disallowed_inside_substitution_definitions(self, node): + if (node['ids'] or + isinstance(node, nodes.reference) and node.get('anonymous') or + isinstance(node, nodes.footnote_reference) and node.get('auto')): + return 1 + else: + return 0 + + def directive(self, match, **option_presets): + """Returns a 2-tuple: list of nodes, and a "blank finish" boolean.""" + type_name = match.group(1) + directive_class, messages = directives.directive( + type_name, self.memo.language, self.document) + self.parent += messages + if directive_class: + return self.run_directive( + directive_class, match, type_name, option_presets) + else: + return self.unknown_directive(type_name) + + def run_directive(self, directive, match, type_name, option_presets): + """ + Parse a directive then run its directive function. + + Parameters: + + - `directive`: The class implementing the directive. Must be + a subclass of `rst.Directive`. + + - `match`: A regular expression match object which matched the first + line of the directive. + + - `type_name`: The directive name, as used in the source text. + + - `option_presets`: A dictionary of preset options, defaults for the + directive options. Currently, only an "alt" option is passed by + substitution definitions (value: the substitution name), which may + be used by an embedded image directive. + + Returns a 2-tuple: list of nodes, and a "blank finish" boolean. + """ + if isinstance(directive, (FunctionType, MethodType)): + from docutils.parsers.rst import convert_directive_function + directive = convert_directive_function(directive) + lineno = self.state_machine.abs_line_number() + initial_line_offset = self.state_machine.line_offset + indented, indent, line_offset, blank_finish \ + = self.state_machine.get_first_known_indented(match.end(), + strip_top=0) + block_text = '\n'.join(self.state_machine.input_lines[ + initial_line_offset : self.state_machine.line_offset + 1]) + try: + arguments, options, content, content_offset = ( + self.parse_directive_block(indented, line_offset, + directive, option_presets)) + except MarkupError, detail: + error = self.reporter.error( + 'Error in "%s" directive:\n%s.' % (type_name, + ' '.join(detail.args)), + nodes.literal_block(block_text, block_text), line=lineno) + return [error], blank_finish + directive_instance = directive( + type_name, arguments, options, content, lineno, + content_offset, block_text, self, self.state_machine) + try: + result = directive_instance.run() + except docutils.parsers.rst.DirectiveError, directive_error: + msg_node = self.reporter.system_message(directive_error.level, + directive_error.message) + msg_node += nodes.literal_block(block_text, block_text) + msg_node['line'] = lineno + result = [msg_node] + assert isinstance(result, list), \ + 'Directive "%s" must return a list of nodes.' % type_name + for i in range(len(result)): + assert isinstance(result[i], nodes.Node), \ + ('Directive "%s" returned non-Node object (index %s): %r' + % (type_name, i, result[i])) + return (result, + blank_finish or self.state_machine.is_next_line_blank()) + + def parse_directive_block(self, indented, line_offset, directive, + option_presets): + option_spec = directive.option_spec + has_content = directive.has_content + if indented and not indented[0].strip(): + indented.trim_start() + line_offset += 1 + while indented and not indented[-1].strip(): + indented.trim_end() + if indented and (directive.required_arguments + or directive.optional_arguments + or option_spec): + for i in range(len(indented)): + if not indented[i].strip(): + break + else: + i += 1 + arg_block = indented[:i] + content = indented[i+1:] + content_offset = line_offset + i + 1 + else: + content = indented + content_offset = line_offset + arg_block = [] + while content and not content[0].strip(): + content.trim_start() + content_offset += 1 + if option_spec: + options, arg_block = self.parse_directive_options( + option_presets, option_spec, arg_block) + if arg_block and not (directive.required_arguments + or directive.optional_arguments): + raise MarkupError('no arguments permitted; blank line ' + 'required before content block') + else: + options = {} + if directive.required_arguments or directive.optional_arguments: + arguments = self.parse_directive_arguments( + directive, arg_block) + else: + arguments = [] + if content and not has_content: + raise MarkupError('no content permitted') + return (arguments, options, content, content_offset) + + def parse_directive_options(self, option_presets, option_spec, arg_block): + options = option_presets.copy() + for i in range(len(arg_block)): + if arg_block[i][:1] == ':': + opt_block = arg_block[i:] + arg_block = arg_block[:i] + break + else: + opt_block = [] + if opt_block: + success, data = self.parse_extension_options(option_spec, + opt_block) + if success: # data is a dict of options + options.update(data) + else: # data is an error string + raise MarkupError(data) + return options, arg_block + + def parse_directive_arguments(self, directive, arg_block): + required = directive.required_arguments + optional = directive.optional_arguments + arg_text = '\n'.join(arg_block) + arguments = arg_text.split() + if len(arguments) < required: + raise MarkupError('%s argument(s) required, %s supplied' + % (required, len(arguments))) + elif len(arguments) > required + optional: + if directive.final_argument_whitespace: + arguments = arg_text.split(None, required + optional - 1) + else: + raise MarkupError( + 'maximum %s argument(s) allowed, %s supplied' + % (required + optional, len(arguments))) + return arguments + + def parse_extension_options(self, option_spec, datalines): + """ + Parse `datalines` for a field list containing extension options + matching `option_spec`. + + :Parameters: + - `option_spec`: a mapping of option name to conversion + function, which should raise an exception on bad input. + - `datalines`: a list of input strings. + + :Return: + - Success value, 1 or 0. + - An option dictionary on success, an error string on failure. + """ + node = nodes.field_list() + newline_offset, blank_finish = self.nested_list_parse( + datalines, 0, node, initial_state='ExtensionOptions', + blank_finish=1) + if newline_offset != len(datalines): # incomplete parse of block + return 0, 'invalid option block' + try: + options = utils.extract_extension_options(node, option_spec) + except KeyError, detail: + return 0, ('unknown option: "%s"' % detail.args[0]) + except (ValueError, TypeError), detail: + return 0, ('invalid option value: %s' % ' '.join(detail.args)) + except utils.ExtensionOptionError, detail: + return 0, ('invalid option data: %s' % ' '.join(detail.args)) + if blank_finish: + return 1, options + else: + return 0, 'option data incompletely parsed' + + def unknown_directive(self, type_name): + lineno = self.state_machine.abs_line_number() + indented, indent, offset, blank_finish = \ + self.state_machine.get_first_known_indented(0, strip_indent=0) + text = '\n'.join(indented) + error = self.reporter.error( + 'Unknown directive type "%s".' % type_name, + nodes.literal_block(text, text), line=lineno) + return [error], blank_finish + + def comment(self, match): + if not match.string[match.end():].strip() \ + and self.state_machine.is_next_line_blank(): # an empty comment? + return [nodes.comment()], 1 # "A tiny but practical wart." + indented, indent, offset, blank_finish = \ + self.state_machine.get_first_known_indented(match.end()) + while indented and not indented[-1].strip(): + indented.trim_end() + text = '\n'.join(indented) + return [nodes.comment(text, text)], blank_finish + + explicit.constructs = [ + (footnote, + re.compile(r""" + \.\.[ ]+ # explicit markup start + \[ + ( # footnote label: + [0-9]+ # manually numbered footnote + | # OR + \# # anonymous auto-numbered footnote + | # OR + \#%s # auto-number ed?) footnote label + | # OR + \* # auto-symbol footnote + ) + \] + ([ ]+|$) # whitespace or end of line + """ % Inliner.simplename, re.VERBOSE | re.UNICODE)), + (citation, + re.compile(r""" + \.\.[ ]+ # explicit markup start + \[(%s)\] # citation label + ([ ]+|$) # whitespace or end of line + """ % Inliner.simplename, re.VERBOSE | re.UNICODE)), + (hyperlink_target, + re.compile(r""" + \.\.[ ]+ # explicit markup start + _ # target indicator + (?![ ]|$) # first char. not space or EOL + """, re.VERBOSE)), + (substitution_def, + re.compile(r""" + \.\.[ ]+ # explicit markup start + \| # substitution indicator + (?![ ]|$) # first char. not space or EOL + """, re.VERBOSE)), + (directive, + re.compile(r""" + \.\.[ ]+ # explicit markup start + (%s) # directive name + [ ]? # optional space + :: # directive delimiter + ([ ]+|$) # whitespace or end of line + """ % Inliner.simplename, re.VERBOSE | re.UNICODE))] + + def explicit_markup(self, match, context, next_state): + """Footnotes, hyperlink targets, directives, comments.""" + nodelist, blank_finish = self.explicit_construct(match) + self.parent += nodelist + self.explicit_list(blank_finish) + return [], next_state, [] + + def explicit_construct(self, match): + """Determine which explicit construct this is, parse & return it.""" + errors = [] + for method, pattern in self.explicit.constructs: + expmatch = pattern.match(match.string) + if expmatch: + try: + return method(self, expmatch) + except MarkupError, (message, lineno): # never reached? + errors.append(self.reporter.warning(message, line=lineno)) + break + nodelist, blank_finish = self.comment(match) + return nodelist + errors, blank_finish + + def explicit_list(self, blank_finish): + """ + Create a nested state machine for a series of explicit markup + constructs (including anonymous hyperlink targets). + """ + offset = self.state_machine.line_offset + 1 # next line + newline_offset, blank_finish = self.nested_list_parse( + self.state_machine.input_lines[offset:], + input_offset=self.state_machine.abs_line_offset() + 1, + node=self.parent, initial_state='Explicit', + blank_finish=blank_finish, + match_titles=self.state_machine.match_titles) + self.goto_line(newline_offset) + if not blank_finish: + self.parent += self.unindent_warning('Explicit markup') + + def anonymous(self, match, context, next_state): + """Anonymous hyperlink targets.""" + nodelist, blank_finish = self.anonymous_target(match) + self.parent += nodelist + self.explicit_list(blank_finish) + return [], next_state, [] + + def anonymous_target(self, match): + lineno = self.state_machine.abs_line_number() + block, indent, offset, blank_finish \ + = self.state_machine.get_first_known_indented(match.end(), + until_blank=1) + blocktext = match.string[:match.end()] + '\n'.join(block) + block = [escape2null(line) for line in block] + target = self.make_target(block, blocktext, lineno, '') + return [target], blank_finish + + def line(self, match, context, next_state): + """Section title overline or transition marker.""" + if self.state_machine.match_titles: + return [match.string], 'Line', [] + elif match.string.strip() == '::': + raise statemachine.TransitionCorrection('text') + elif len(match.string.strip()) < 4: + msg = self.reporter.info( + 'Unexpected possible title overline or transition.\n' + "Treating it as ordinary text because it's so short.", + line=self.state_machine.abs_line_number()) + self.parent += msg + raise statemachine.TransitionCorrection('text') + else: + blocktext = self.state_machine.line + msg = self.reporter.severe( + 'Unexpected section title or transition.', + nodes.literal_block(blocktext, blocktext), + line=self.state_machine.abs_line_number()) + self.parent += msg + return [], next_state, [] + + def text(self, match, context, next_state): + """Titles, definition lists, paragraphs.""" + return [match.string], 'Text', [] + + +class RFC2822Body(Body): + + """ + RFC2822 headers are only valid as the first constructs in documents. As + soon as anything else appears, the `Body` state should take over. + """ + + patterns = Body.patterns.copy() # can't modify the original + patterns['rfc2822'] = r'[!-9;-~]+:( +|$)' + initial_transitions = [(name, 'Body') + for name in Body.initial_transitions] + initial_transitions.insert(-1, ('rfc2822', 'Body')) # just before 'text' + + def rfc2822(self, match, context, next_state): + """RFC2822-style field list item.""" + fieldlist = nodes.field_list(classes=['rfc2822']) + self.parent += fieldlist + field, blank_finish = self.rfc2822_field(match) + fieldlist += field + offset = self.state_machine.line_offset + 1 # next line + newline_offset, blank_finish = self.nested_list_parse( + self.state_machine.input_lines[offset:], + input_offset=self.state_machine.abs_line_offset() + 1, + node=fieldlist, initial_state='RFC2822List', + blank_finish=blank_finish) + self.goto_line(newline_offset) + if not blank_finish: + self.parent += self.unindent_warning( + 'RFC2822-style field list') + return [], next_state, [] + + def rfc2822_field(self, match): + name = match.string[:match.string.find(':')] + indented, indent, line_offset, blank_finish = \ + self.state_machine.get_first_known_indented(match.end(), + until_blank=1) + fieldnode = nodes.field() + fieldnode += nodes.field_name(name, name) + fieldbody = nodes.field_body('\n'.join(indented)) + fieldnode += fieldbody + if indented: + self.nested_parse(indented, input_offset=line_offset, + node=fieldbody) + return fieldnode, blank_finish + + +class SpecializedBody(Body): + + """ + Superclass for second and subsequent compound element members. Compound + elements are lists and list-like constructs. + + All transition methods are disabled (redefined as `invalid_input`). + Override individual methods in subclasses to re-enable. + + For example, once an initial bullet list item, say, is recognized, the + `BulletList` subclass takes over, with a "bullet_list" node as its + container. Upon encountering the initial bullet list item, `Body.bullet` + calls its ``self.nested_list_parse`` (`RSTState.nested_list_parse`), which + starts up a nested parsing session with `BulletList` as the initial state. + Only the ``bullet`` transition method is enabled in `BulletList`; as long + as only bullet list items are encountered, they are parsed and inserted + into the container. The first construct which is not a bullet list item + triggers the `invalid_input` method, which ends the nested parse and + closes the container. `BulletList` needs to recognize input that is + invalid in the context of a bullet list, which means everything other + than bullet list items, so it inherits the transition list created in + `Body`. + """ + + def invalid_input(self, match=None, context=None, next_state=None): + """Not a compound element member. Abort this state machine.""" + self.state_machine.previous_line() # back up so parent SM can reassess + raise EOFError + + indent = invalid_input + bullet = invalid_input + enumerator = invalid_input + field_marker = invalid_input + option_marker = invalid_input + doctest = invalid_input + line_block = invalid_input + grid_table_top = invalid_input + simple_table_top = invalid_input + explicit_markup = invalid_input + anonymous = invalid_input + line = invalid_input + text = invalid_input + + +class BulletList(SpecializedBody): + + """Second and subsequent bullet_list list_items.""" + + def bullet(self, match, context, next_state): + """Bullet list item.""" + if match.string[0] != self.parent['bullet']: + # different bullet: new list + self.invalid_input() + listitem, blank_finish = self.list_item(match.end()) + self.parent += listitem + self.blank_finish = blank_finish + return [], next_state, [] + + +class DefinitionList(SpecializedBody): + + """Second and subsequent definition_list_items.""" + + def text(self, match, context, next_state): + """Definition lists.""" + return [match.string], 'Definition', [] + + +class EnumeratedList(SpecializedBody): + + """Second and subsequent enumerated_list list_items.""" + + def enumerator(self, match, context, next_state): + """Enumerated list item.""" + format, sequence, text, ordinal = self.parse_enumerator( + match, self.parent['enumtype']) + if ( format != self.format + or (sequence != '#' and (sequence != self.parent['enumtype'] + or self.auto + or ordinal != (self.lastordinal + 1))) + or not self.is_enumerated_list_item(ordinal, sequence, format)): + # different enumeration: new list + self.invalid_input() + if sequence == '#': + self.auto = 1 + listitem, blank_finish = self.list_item(match.end()) + self.parent += listitem + self.blank_finish = blank_finish + self.lastordinal = ordinal + return [], next_state, [] + + +class FieldList(SpecializedBody): + + """Second and subsequent field_list fields.""" + + def field_marker(self, match, context, next_state): + """Field list field.""" + field, blank_finish = self.field(match) + self.parent += field + self.blank_finish = blank_finish + return [], next_state, [] + + +class OptionList(SpecializedBody): + + """Second and subsequent option_list option_list_items.""" + + def option_marker(self, match, context, next_state): + """Option list item.""" + try: + option_list_item, blank_finish = self.option_list_item(match) + except MarkupError, (message, lineno): + self.invalid_input() + self.parent += option_list_item + self.blank_finish = blank_finish + return [], next_state, [] + + +class RFC2822List(SpecializedBody, RFC2822Body): + + """Second and subsequent RFC2822-style field_list fields.""" + + patterns = RFC2822Body.patterns + initial_transitions = RFC2822Body.initial_transitions + + def rfc2822(self, match, context, next_state): + """RFC2822-style field list item.""" + field, blank_finish = self.rfc2822_field(match) + self.parent += field + self.blank_finish = blank_finish + return [], 'RFC2822List', [] + + blank = SpecializedBody.invalid_input + + +class ExtensionOptions(FieldList): + + """ + Parse field_list fields for extension options. + + No nested parsing is done (including inline markup parsing). + """ + + def parse_field_body(self, indented, offset, node): + """Override `Body.parse_field_body` for simpler parsing.""" + lines = [] + for line in list(indented) + ['']: + if line.strip(): + lines.append(line) + elif lines: + text = '\n'.join(lines) + node += nodes.paragraph(text, text) + lines = [] + + +class LineBlock(SpecializedBody): + + """Second and subsequent lines of a line_block.""" + + blank = SpecializedBody.invalid_input + + def line_block(self, match, context, next_state): + """New line of line block.""" + lineno = self.state_machine.abs_line_number() + line, messages, blank_finish = self.line_block_line(match, lineno) + self.parent += line + self.parent.parent += messages + self.blank_finish = blank_finish + return [], next_state, [] + + +class Explicit(SpecializedBody): + + """Second and subsequent explicit markup construct.""" + + def explicit_markup(self, match, context, next_state): + """Footnotes, hyperlink targets, directives, comments.""" + nodelist, blank_finish = self.explicit_construct(match) + self.parent += nodelist + self.blank_finish = blank_finish + return [], next_state, [] + + def anonymous(self, match, context, next_state): + """Anonymous hyperlink targets.""" + nodelist, blank_finish = self.anonymous_target(match) + self.parent += nodelist + self.blank_finish = blank_finish + return [], next_state, [] + + blank = SpecializedBody.invalid_input + + +class SubstitutionDef(Body): + + """ + Parser for the contents of a substitution_definition element. + """ + + patterns = { + 'embedded_directive': re.compile(r'(%s)::( +|$)' + % Inliner.simplename, re.UNICODE), + 'text': r''} + initial_transitions = ['embedded_directive', 'text'] + + def embedded_directive(self, match, context, next_state): + nodelist, blank_finish = self.directive(match, + alt=self.parent['names'][0]) + self.parent += nodelist + if not self.state_machine.at_eof(): + self.blank_finish = blank_finish + raise EOFError + + def text(self, match, context, next_state): + if not self.state_machine.at_eof(): + self.blank_finish = self.state_machine.is_next_line_blank() + raise EOFError + + +class Text(RSTState): + + """ + Classifier of second line of a text block. + + Could be a paragraph, a definition list item, or a title. + """ + + patterns = {'underline': Body.patterns['line'], + 'text': r''} + initial_transitions = [('underline', 'Body'), ('text', 'Body')] + + def blank(self, match, context, next_state): + """End of paragraph.""" + paragraph, literalnext = self.paragraph( + context, self.state_machine.abs_line_number() - 1) + self.parent += paragraph + if literalnext: + self.parent += self.literal_block() + return [], 'Body', [] + + def eof(self, context): + if context: + self.blank(None, context, None) + return [] + + def indent(self, match, context, next_state): + """Definition list item.""" + definitionlist = nodes.definition_list() + definitionlistitem, blank_finish = self.definition_list_item(context) + definitionlist += definitionlistitem + self.parent += definitionlist + offset = self.state_machine.line_offset + 1 # next line + newline_offset, blank_finish = self.nested_list_parse( + self.state_machine.input_lines[offset:], + input_offset=self.state_machine.abs_line_offset() + 1, + node=definitionlist, initial_state='DefinitionList', + blank_finish=blank_finish, blank_finish_state='Definition') + self.goto_line(newline_offset) + if not blank_finish: + self.parent += self.unindent_warning('Definition list') + return [], 'Body', [] + + def underline(self, match, context, next_state): + """Section title.""" + lineno = self.state_machine.abs_line_number() + title = context[0].rstrip() + underline = match.string.rstrip() + source = title + '\n' + underline + messages = [] + if column_width(title) > len(underline): + if len(underline) < 4: + if self.state_machine.match_titles: + msg = self.reporter.info( + 'Possible title underline, too short for the title.\n' + "Treating it as ordinary text because it's so short.", + line=lineno) + self.parent += msg + raise statemachine.TransitionCorrection('text') + else: + blocktext = context[0] + '\n' + self.state_machine.line + msg = self.reporter.warning( + 'Title underline too short.', + nodes.literal_block(blocktext, blocktext), line=lineno) + messages.append(msg) + if not self.state_machine.match_titles: + blocktext = context[0] + '\n' + self.state_machine.line + msg = self.reporter.severe( + 'Unexpected section title.', + nodes.literal_block(blocktext, blocktext), line=lineno) + self.parent += messages + self.parent += msg + return [], next_state, [] + style = underline[0] + context[:] = [] + self.section(title, source, style, lineno - 1, messages) + return [], next_state, [] + + def text(self, match, context, next_state): + """Paragraph.""" + startline = self.state_machine.abs_line_number() - 1 + msg = None + try: + block = self.state_machine.get_text_block(flush_left=1) + except statemachine.UnexpectedIndentationError, instance: + block, source, lineno = instance.args + msg = self.reporter.error('Unexpected indentation.', + source=source, line=lineno) + lines = context + list(block) + paragraph, literalnext = self.paragraph(lines, startline) + self.parent += paragraph + self.parent += msg + if literalnext: + try: + self.state_machine.next_line() + except EOFError: + pass + self.parent += self.literal_block() + return [], next_state, [] + + def literal_block(self): + """Return a list of nodes.""" + indented, indent, offset, blank_finish = \ + self.state_machine.get_indented() + while indented and not indented[-1].strip(): + indented.trim_end() + if not indented: + return self.quoted_literal_block() + data = '\n'.join(indented) + literal_block = nodes.literal_block(data, data) + literal_block.line = offset + 1 + nodelist = [literal_block] + if not blank_finish: + nodelist.append(self.unindent_warning('Literal block')) + return nodelist + + def quoted_literal_block(self): + abs_line_offset = self.state_machine.abs_line_offset() + offset = self.state_machine.line_offset + parent_node = nodes.Element() + new_abs_offset = self.nested_parse( + self.state_machine.input_lines[offset:], + input_offset=abs_line_offset, node=parent_node, match_titles=0, + state_machine_kwargs={'state_classes': (QuotedLiteralBlock,), + 'initial_state': 'QuotedLiteralBlock'}) + self.goto_line(new_abs_offset) + return parent_node.children + + def definition_list_item(self, termline): + indented, indent, line_offset, blank_finish = \ + self.state_machine.get_indented() + definitionlistitem = nodes.definition_list_item( + '\n'.join(termline + list(indented))) + lineno = self.state_machine.abs_line_number() - 1 + definitionlistitem.line = lineno + termlist, messages = self.term(termline, lineno) + definitionlistitem += termlist + definition = nodes.definition('', messages) + definitionlistitem += definition + if termline[0][-2:] == '::': + definition += self.reporter.info( + 'Blank line missing before literal block (after the "::")? ' + 'Interpreted as a definition list item.', line=line_offset+1) + self.nested_parse(indented, input_offset=line_offset, node=definition) + return definitionlistitem, blank_finish + + classifier_delimiter = re.compile(' +: +') + + def term(self, lines, lineno): + """Return a definition_list's term and optional classifiers.""" + assert len(lines) == 1 + text_nodes, messages = self.inline_text(lines[0], lineno) + term_node = nodes.term() + node_list = [term_node] + for i in range(len(text_nodes)): + node = text_nodes[i] + if isinstance(node, nodes.Text): + parts = self.classifier_delimiter.split(node.rawsource) + if len(parts) == 1: + node_list[-1] += node + else: + + node_list[-1] += nodes.Text(parts[0].rstrip()) + for part in parts[1:]: + classifier_node = nodes.classifier('', part) + node_list.append(classifier_node) + else: + node_list[-1] += node + return node_list, messages + + +class SpecializedText(Text): + + """ + Superclass for second and subsequent lines of Text-variants. + + All transition methods are disabled. Override individual methods in + subclasses to re-enable. + """ + + def eof(self, context): + """Incomplete construct.""" + return [] + + def invalid_input(self, match=None, context=None, next_state=None): + """Not a compound element member. Abort this state machine.""" + raise EOFError + + blank = invalid_input + indent = invalid_input + underline = invalid_input + text = invalid_input + + +class Definition(SpecializedText): + + """Second line of potential definition_list_item.""" + + def eof(self, context): + """Not a definition.""" + self.state_machine.previous_line(2) # so parent SM can reassess + return [] + + def indent(self, match, context, next_state): + """Definition list item.""" + definitionlistitem, blank_finish = self.definition_list_item(context) + self.parent += definitionlistitem + self.blank_finish = blank_finish + return [], 'DefinitionList', [] + + +class Line(SpecializedText): + + """ + Second line of over- & underlined section title or transition marker. + """ + + eofcheck = 1 # @@@ ??? + """Set to 0 while parsing sections, so that we don't catch the EOF.""" + + def eof(self, context): + """Transition marker at end of section or document.""" + marker = context[0].strip() + if self.memo.section_bubble_up_kludge: + self.memo.section_bubble_up_kludge = 0 + elif len(marker) < 4: + self.state_correction(context) + if self.eofcheck: # ignore EOFError with sections + lineno = self.state_machine.abs_line_number() - 1 + transition = nodes.transition(rawsource=context[0]) + transition.line = lineno + self.parent += transition + self.eofcheck = 1 + return [] + + def blank(self, match, context, next_state): + """Transition marker.""" + lineno = self.state_machine.abs_line_number() - 1 + marker = context[0].strip() + if len(marker) < 4: + self.state_correction(context) + transition = nodes.transition(rawsource=marker) + transition.line = lineno + self.parent += transition + return [], 'Body', [] + + def text(self, match, context, next_state): + """Potential over- & underlined title.""" + lineno = self.state_machine.abs_line_number() - 1 + overline = context[0] + title = match.string + underline = '' + try: + underline = self.state_machine.next_line() + except EOFError: + blocktext = overline + '\n' + title + if len(overline.rstrip()) < 4: + self.short_overline(context, blocktext, lineno, 2) + else: + msg = self.reporter.severe( + 'Incomplete section title.', + nodes.literal_block(blocktext, blocktext), line=lineno) + self.parent += msg + return [], 'Body', [] + source = '%s\n%s\n%s' % (overline, title, underline) + overline = overline.rstrip() + underline = underline.rstrip() + if not self.transitions['underline'][0].match(underline): + blocktext = overline + '\n' + title + '\n' + underline + if len(overline.rstrip()) < 4: + self.short_overline(context, blocktext, lineno, 2) + else: + msg = self.reporter.severe( + 'Missing matching underline for section title overline.', + nodes.literal_block(source, source), line=lineno) + self.parent += msg + return [], 'Body', [] + elif overline != underline: + blocktext = overline + '\n' + title + '\n' + underline + if len(overline.rstrip()) < 4: + self.short_overline(context, blocktext, lineno, 2) + else: + msg = self.reporter.severe( + 'Title overline & underline mismatch.', + nodes.literal_block(source, source), line=lineno) + self.parent += msg + return [], 'Body', [] + title = title.rstrip() + messages = [] + if column_width(title) > len(overline): + blocktext = overline + '\n' + title + '\n' + underline + if len(overline.rstrip()) < 4: + self.short_overline(context, blocktext, lineno, 2) + else: + msg = self.reporter.warning( + 'Title overline too short.', + nodes.literal_block(source, source), line=lineno) + messages.append(msg) + style = (overline[0], underline[0]) + self.eofcheck = 0 # @@@ not sure this is correct + self.section(title.lstrip(), source, style, lineno + 1, messages) + self.eofcheck = 1 + return [], 'Body', [] + + indent = text # indented title + + def underline(self, match, context, next_state): + overline = context[0] + blocktext = overline + '\n' + self.state_machine.line + lineno = self.state_machine.abs_line_number() - 1 + if len(overline.rstrip()) < 4: + self.short_overline(context, blocktext, lineno, 1) + msg = self.reporter.error( + 'Invalid section title or transition marker.', + nodes.literal_block(blocktext, blocktext), line=lineno) + self.parent += msg + return [], 'Body', [] + + def short_overline(self, context, blocktext, lineno, lines=1): + msg = self.reporter.info( + 'Possible incomplete section title.\nTreating the overline as ' + "ordinary text because it's so short.", line=lineno) + self.parent += msg + self.state_correction(context, lines) + + def state_correction(self, context, lines=1): + self.state_machine.previous_line(lines) + context[:] = [] + raise statemachine.StateCorrection('Body', 'text') + + +class QuotedLiteralBlock(RSTState): + + """ + Nested parse handler for quoted (unindented) literal blocks. + + Special-purpose. Not for inclusion in `state_classes`. + """ + + patterns = {'initial_quoted': r'(%(nonalphanum7bit)s)' % Body.pats, + 'text': r''} + initial_transitions = ('initial_quoted', 'text') + + def init(self, state_machine, debug=0): + RSTState.init(self, state_machine, debug) + self.messages = [] + self.initial_lineno = None + + def blank(self, match, context, next_state): + if context: + raise EOFError + else: + return context, next_state, [] + + def eof(self, context): + if context: + text = '\n'.join(context) + literal_block = nodes.literal_block(text, text) + literal_block.line = self.initial_lineno + self.parent += literal_block + else: + self.parent += self.reporter.warning( + 'Literal block expected; none found.', + line=self.state_machine.abs_line_number()) + self.state_machine.previous_line() + self.parent += self.messages + return [] + + def indent(self, match, context, next_state): + assert context, ('QuotedLiteralBlock.indent: context should not ' + 'be empty!') + self.messages.append( + self.reporter.error('Unexpected indentation.', + line=self.state_machine.abs_line_number())) + self.state_machine.previous_line() + raise EOFError + + def initial_quoted(self, match, context, next_state): + """Match arbitrary quote character on the first line only.""" + self.remove_transition('initial_quoted') + quote = match.string[0] + pattern = re.compile(re.escape(quote)) + # New transition matches consistent quotes only: + self.add_transition('quoted', + (pattern, self.quoted, self.class.name)) + self.initial_lineno = self.state_machine.abs_line_number() + return [match.string], next_state, [] + + def quoted(self, match, context, next_state): + """Match consistent quotes on subsequent lines.""" + context.append(match.string) + return context, next_state, [] + + def text(self, match, context, next_state): + if context: + self.messages.append( + self.reporter.error('Inconsistent literal block quoting.', + line=self.state_machine.abs_line_number())) + self.state_machine.previous_line() + raise EOFError + + +state_classes = (Body, BulletList, DefinitionList, EnumeratedList, FieldList, + OptionList, LineBlock, ExtensionOptions, Explicit, Text, + Definition, Line, SubstitutionDef, RFC2822Body, RFC2822List) +"""Standard set of State classes used to start `RSTStateMachine`.""" diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/tableparser.py --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/parsers/rst/tableparser.py Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,525 @@ +# $Id: tableparser.py 4564 2006-05-21 20:44:42Z wiemann $ +# Author: David Goodger +# Copyright: This module has been placed in the public domain. + +""" +This module defines table parser classes,which parse plaintext-graphic tables +and produce a well-formed data structure suitable for building a CALS table. + +:Classes: + - `GridTableParser`: Parse fully-formed tables represented with a grid. + - `SimpleTableParser`: Parse simple tables, delimited by top & bottom + borders. + +:Exception class: `TableMarkupError` + +:Function: + `update_dict_of_lists()`: Merge two dictionaries containing list values. +""" + +docformat = 'reStructuredText' + + +import re +import sys +from docutils import DataError + + +class TableMarkupError(DataError): pass + + +class TableParser: + + """ + Abstract superclass for the common parts of the syntax-specific parsers. + """ + + head_body_separator_pat = None + """Matches the row separator between head rows and body rows.""" + + double_width_pad_char = '\x00' + """Padding character for East Asian double-width text.""" + + def parse(self, block): + """ + Analyze the text `block` and return a table data structure. + + Given a plaintext-graphic table in `block` (list of lines of text; no + whitespace padding), parse the table, construct and return the data + necessary to construct a CALS table or equivalent. + + Raise `TableMarkupError` if there is any problem with the markup. + """ + self.setup(block) + self.find_head_body_sep() + self.parse_table() + structure = self.structure_from_cells() + return structure + + def find_head_body_sep(self): + """Look for a head/body row separator line; store the line index.""" + for i in range(len(self.block)): + line = self.block[i] + if self.head_body_separator_pat.match(line): + if self.head_body_sep: + raise TableMarkupError( + 'Multiple head/body row separators in table (at line ' + 'offset %s and %s); only one allowed.' + % (self.head_body_sep, i)) + else: + self.head_body_sep = i + self.block[i] = line.replace('=', '-') + if self.head_body_sep == 0 or self.head_body_sep == (len(self.block) + - 1): + raise TableMarkupError('The head/body row separator may not be ' + 'the first or last line of the table.') + + +class GridTableParser(TableParser): + + """ + Parse a grid table using `parse()`. + + Here's an example of a grid table:: + + +------------------------+------------+----------+----------+ + | Header row, column 1 | Header 2 | Header 3 | Header 4 | + +========================+============+==========+==========+ + | body row 1, column 1 | column 2 | column 3 | column 4 | + +------------------------+------------+----------+----------+ + | body row 2 | Cells may span columns. | + +------------------------+------------+---------------------+ + | body row 3 | Cells may | - Table cells | + +------------------------+ span rows. | - contain | + | body row 4 | | - body elements. | + +------------------------+------------+---------------------+ + + Intersections use '+', row separators use '-' (except for one optional + head/body row separator, which uses '='), and column separators use '|'. + + Passing the above table to the `parse()` method will result in the + following data structure:: + + ([24, 12, 10, 10], + [[(0, 0, 1, ['Header row, column 1']), + (0, 0, 1, ['Header 2']), + (0, 0, 1, ['Header 3']), + (0, 0, 1, ['Header 4'])]], + [[(0, 0, 3, ['body row 1, column 1']), + (0, 0, 3, ['column 2']), + (0, 0, 3, ['column 3']), + (0, 0, 3, ['column 4'])], + [(0, 0, 5, ['body row 2']), + (0, 2, 5, ['Cells may span columns.']), + None, + None], + [(0, 0, 7, ['body row 3']), + (1, 0, 7, ['Cells may', 'span rows.', '']), + (1, 1, 7, ['- Table cells', '- contain', '- body elements.']), + None], + [(0, 0, 9, ['body row 4']), None, None, None]]) + + The first item is a list containing column widths (colspecs). The second + item is a list of head rows, and the third is a list of body rows. Each + row contains a list of cells. Each cell is either None (for a cell unused + because of another cell's span), or a tuple. A cell tuple contains four + items: the number of extra rows used by the cell in a vertical span + (morerows); the number of extra columns used by the cell in a horizontal + span (morecols); the line offset of the first line of the cell contents; + and the cell contents, a list of lines of text. + """ + + head_body_separator_pat = re.compile(r'\+=[=+]+=\+ $') + + def setup(self, block): + self.block = block[:] # make a copy; it may be modified + self.block.disconnect() # don't propagate changes to parent + self.bottom = len(block) - 1 + self.right = len(block[0]) - 1 + self.head_body_sep = None + self.done = [-1] * len(block[0]) + self.cells = [] + self.rowseps = {0: [0]} + self.colseps = {0: [0]} + + def parse_table(self): + """ + Start with a queue of upper-left corners, containing the upper-left + corner of the table itself. Trace out one rectangular cell, remember + it, and add its upper-right and lower-left corners to the queue of + potential upper-left corners of further cells. Process the queue in + top-to-bottom order, keeping track of how much of each text column has + been seen. + + We'll end up knowing all the row and column boundaries, cell positions + and their dimensions. + """ + corners = [(0, 0)] + while corners: + top, left = corners.pop(0) + if top == self.bottom or left == self.right \ + or top <= self.done[left]: + continue + result = self.scan_cell(top, left) + if not result: + continue + bottom, right, rowseps, colseps = result + update_dict_of_lists(self.rowseps, rowseps) + update_dict_of_lists(self.colseps, colseps) + self.mark_done(top, left, bottom, right) + cellblock = self.block.get_2D_block(top + 1, left + 1, + bottom, right) + cellblock.disconnect() # lines in cell can't sync with parent + cellblock.replace(self.double_width_pad_char, '') + self.cells.append((top, left, bottom, right, cellblock)) + corners.extend([(top, right), (bottom, left)]) + corners.sort() + if not self.check_parse_complete(): + raise TableMarkupError('Malformed table; parse incomplete.') + + def mark_done(self, top, left, bottom, right): + """For keeping track of how much of each text column has been seen.""" + before = top - 1 + after = bottom - 1 + for col in range(left, right): + assert self.done[col] == before + self.done[col] = after + + def check_parse_complete(self): + """Each text column should have been completely seen.""" + last = self.bottom - 1 + for col in range(self.right): + if self.done[col] != last: + return None + return 1 + + def scan_cell(self, top, left): + """Starting at the top-left corner, start tracing out a cell.""" + assert self.block[top][left] == '+' + result = self.scan_right(top, left) + return result + + def scan_right(self, top, left): + """ + Look for the top-right corner of the cell, and make note of all column + boundaries ('+'). + """ + colseps = {} + line = self.block[top] + for i in range(left + 1, self.right + 1): + if line[i] == '+': + colseps[i] = [top] + result = self.scan_down(top, left, i) + if result: + bottom, rowseps, newcolseps = result + update_dict_of_lists(colseps, newcolseps) + return bottom, i, rowseps, colseps + elif line[i] != '-': + return None + return None + + def scan_down(self, top, left, right): + """ + Look for the bottom-right corner of the cell, making note of all row + boundaries. + """ + rowseps = {} + for i in range(top + 1, self.bottom + 1): + if self.block[i][right] == '+': + rowseps[i] = [right] + result = self.scan_left(top, left, i, right) + if result: + newrowseps, colseps = result + update_dict_of_lists(rowseps, newrowseps) + return i, rowseps, colseps + elif self.block[i][right] != '|': + return None + return None + + def scan_left(self, top, left, bottom, right): + """ + Noting column boundaries, look for the bottom-left corner of the cell. + It must line up with the starting point. + """ + colseps = {} + line = self.block[bottom] + for i in range(right - 1, left, -1): + if line[i] == '+': + colseps[i] = [bottom] + elif line[i] != '-': + return None + if line[left] != '+': + return None + result = self.scan_up(top, left, bottom, right) + if result is not None: + rowseps = result + return rowseps, colseps + return None + + def scan_up(self, top, left, bottom, right): + """ + Noting row boundaries, see if we can return to the starting point. + """ + rowseps = {} + for i in range(bottom - 1, top, -1): + if self.block[i][left] == '+': + rowseps[i] = [left] + elif self.block[i][left] != '|': + return None + return rowseps + + def structure_from_cells(self): + """ + From the data collected by `scan_cell()`, convert to the final data + structure. + """ + rowseps = self.rowseps.keys() # list of row boundaries + rowseps.sort() + rowindex = {} + for i in range(len(rowseps)): + rowindex[rowseps[i]] = i # row boundary -> row number mapping + colseps = self.colseps.keys() # list of column boundaries + colseps.sort() + colindex = {} + for i in range(len(colseps)): + colindex[colseps[i]] = i # column boundary -> col number map + colspecs = [(colseps[i] - colseps[i - 1] - 1) + for i in range(1, len(colseps))] # list of column widths + # prepare an empty table with the correct number of rows & columns + onerow = [None for i in range(len(colseps) - 1)] + rows = [onerow[:] for i in range(len(rowseps) - 1)] + # keep track of # of cells remaining; should reduce to zero + remaining = (len(rowseps) - 1) * (len(colseps) - 1) + for top, left, bottom, right, block in self.cells: + rownum = rowindex[top] + colnum = colindex[left] + assert rows[rownum][colnum] is None, ( + 'Cell (row %s, column %s) already used.' + % (rownum + 1, colnum + 1)) + morerows = rowindex[bottom] - rownum - 1 + morecols = colindex[right] - colnum - 1 + remaining -= (morerows + 1) * (morecols + 1) + # write the cell into the table + rows[rownum][colnum] = (morerows, morecols, top + 1, block) + assert remaining == 0, 'Unused cells remaining.' + if self.head_body_sep: # separate head rows from body rows + numheadrows = rowindex[self.head_body_sep] + headrows = rows[:numheadrows] + bodyrows = rows[numheadrows:] + else: + headrows = [] + bodyrows = rows + return (colspecs, headrows, bodyrows) + + +class SimpleTableParser(TableParser): + + """ + Parse a simple table using `parse()`. + + Here's an example of a simple table:: + + ===== ===== + col 1 col 2 + ===== ===== + 1 Second column of row 1. + 2 Second column of row 2. + Second line of paragraph. + 3 - Second column of row 3. + + - Second item in bullet + list (row 3, column 2). + 4 is a span + ------------ + 5 + ===== ===== + + Top and bottom borders use '=', column span underlines use '-', column + separation is indicated with spaces. + + Passing the above table to the `parse()` method will result in the + following data structure, whose interpretation is the same as for + `GridTableParser`:: + + ([5, 25], + [[(0, 0, 1, ['col 1']), + (0, 0, 1, ['col 2'])]], + [[(0, 0, 3, ['1']), + (0, 0, 3, ['Second column of row 1.'])], + [(0, 0, 4, ['2']), + (0, 0, 4, ['Second column of row 2.', + 'Second line of paragraph.'])], + [(0, 0, 6, ['3']), + (0, 0, 6, ['- Second column of row 3.', + '', + '- Second item in bullet', + ' list (row 3, column 2).'])], + [(0, 1, 10, ['4 is a span'])], + [(0, 0, 12, ['5']), + (0, 0, 12, [''])]]) + """ + + head_body_separator_pat = re.compile('=[ =]$') + span_pat = re.compile('-[ -]$') + + def setup(self, block): + self.block = block[:] # make a copy; it will be modified + self.block.disconnect() # don't propagate changes to parent + # Convert top & bottom borders to column span underlines: + self.block[0] = self.block[0].replace('=', '-') + self.block[-1] = self.block[-1].replace('=', '-') + self.head_body_sep = None + self.columns = [] + self.border_end = None + self.table = [] + self.done = [-1] * len(block[0]) + self.rowseps = {0: [0]} + self.colseps = {0: [0]} + + def parse_table(self): + """ + First determine the column boundaries from the top border, then + process rows. Each row may consist of multiple lines; accumulate + lines until a row is complete. Call `self.parse_row` to finish the + job. + """ + # Top border must fully describe all table columns. + self.columns = self.parse_columns(self.block[0], 0) + self.border_end = self.columns[-1][1] + firststart, firstend = self.columns[0] + offset = 1 # skip top border + start = 1 + text_found = None + while offset < len(self.block): + line = self.block[offset] + if self.span_pat.match(line): + # Column span underline or border; row is complete. + self.parse_row(self.block[start:offset], start, + (line.rstrip(), offset)) + start = offset + 1 + text_found = None + elif line[firststart:firstend].strip(): + # First column not blank, therefore it's a new row. + if text_found and offset != start: + self.parse_row(self.block[start:offset], start) + start = offset + text_found = 1 + elif not text_found: + start = offset + 1 + offset += 1 + + def parse_columns(self, line, offset): + """ + Given a column span underline, return a list of (begin, end) pairs. + """ + cols = [] + end = 0 + while 1: + begin = line.find('-', end) + end = line.find(' ', begin) + if begin < 0: + break + if end < 0: + end = len(line) + cols.append((begin, end)) + if self.columns: + if cols[-1][1] != self.border_end: + raise TableMarkupError('Column span incomplete at line ' + 'offset %s.' % offset) + # Allow for an unbounded rightmost column: + cols[-1] = (cols[-1][0], self.columns[-1][1]) + return cols + + def init_row(self, colspec, offset): + i = 0 + cells = [] + for start, end in colspec: + morecols = 0 + try: + assert start == self.columns[i][0] + while end != self.columns[i][1]: + i += 1 + morecols += 1 + except (AssertionError, IndexError): + raise TableMarkupError('Column span alignment problem at ' + 'line offset %s.' % (offset + 1)) + cells.append([0, morecols, offset, []]) + i += 1 + return cells + + def parse_row(self, lines, start, spanline=None): + """ + Given the text `lines` of a row, parse it and append to `self.table`. + + The row is parsed according to the current column spec (either + `spanline` if provided or `self.columns`). For each column, extract + text from each line, and check for text in column margins. Finally, + adjust for insigificant whitespace. + """ + if not (lines or spanline): + # No new row, just blank lines. + return + if spanline: + columns = self.parse_columns(spanline) + span_offset = spanline[1] + else: + columns = self.columns[:] + span_offset = start + self.check_columns(lines, start, columns) + row = self.init_row(columns, start) + for i in range(len(columns)): + start, end = columns[i] + cellblock = lines.get_2D_block(0, start, len(lines), end) + cellblock.disconnect() # lines in cell can't sync with parent + cellblock.replace(self.double_width_pad_char, '') + row[i][3] = cellblock + self.table.append(row) + + def check_columns(self, lines, first_line, columns): + """ + Check for text in column margins and text overflow in the last column. + Raise TableMarkupError if anything but whitespace is in column margins. + Adjust the end value for the last column if there is text overflow. + """ + # "Infinite" value for a dummy last column's beginning, used to + # check for text overflow: + columns.append((sys.maxint, None)) + lastcol = len(columns) - 2 + for i in range(len(columns) - 1): + start, end = columns[i] + nextstart = columns[i+1][0] + offset = 0 + for line in lines: + if i == lastcol and line[end:].strip(): + text = line[start:].rstrip() + new_end = start + len(text) + columns[i] = (start, new_end) + main_start, main_end = self.columns[-1] + if new_end > main_end: + self.columns[-1] = (main_start, new_end) + elif line[end:nextstart].strip(): + raise TableMarkupError('Text in column margin at line ' + 'offset %s.' % (first_line + offset)) + offset += 1 + columns.pop() + + def structure_from_cells(self): + colspecs = [end - start for start, end in self.columns] + first_body_row = 0 + if self.head_body_sep: + for i in range(len(self.table)): + if self.table[i][0][2] > self.head_body_sep: + first_body_row = i + break + return (colspecs, self.table[:first_body_row], + self.table[first_body_row:]) + + +def update_dict_of_lists(master, newdata): + """ + Extend the list values of `master` with those from `newdata`. + + Both parameters must be dictionaries containing list values. + """ + for key, values in newdata.items(): + master.setdefault(key, []).extend(values) diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/readers/init.py --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/readers/init.py Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,107 @@ +# $Id: init.py 4974 2007-03-01 18:06:52Z wiemann $ +# Authors: David Goodger ; Ueli Schlaepfer +# Copyright: This module has been placed in the public domain. + +""" +This package contains Docutils Reader modules. +""" + +docformat = 'reStructuredText' + + +from docutils import utils, parsers, Component +from docutils.transforms import universal + + +class Reader(Component): + + """ + Abstract base class for docutils Readers. + + Each reader module or package must export a subclass also called 'Reader'. + + The two steps of a Reader's responsibility are `scan()` and + `parse()`. Call `read()` to process a document. + """ + + component_type = 'reader' + config_section = 'readers' + + def get_transforms(self): + return Component.get_transforms(self) + [ + universal.Decorations, + universal.ExposeInternals, + universal.StripComments,] + + def init(self, parser=None, parser_name=None): + """ + Initialize the Reader instance. + + Several instance attributes are defined with dummy initial values. + Subclasses may use these attributes as they wish. + """ + + self.parser = parser + """A `parsers.Parser` instance shared by all doctrees. May be left + unspecified if the document source determines the parser.""" + + if parser is None and parser_name: + self.set_parser(parser_name) + + self.source = None + """`docutils.io` IO object, source of input data.""" + + self.input = None + """Raw text input; either a single string or, for more complex cases, + a collection of strings.""" + + def set_parser(self, parser_name): + """Set `self.parser` by name.""" + parser_class = parsers.get_parser_class(parser_name) + self.parser = parser_class() + + def read(self, source, parser, settings): + self.source = source + if not self.parser: + self.parser = parser + self.settings = settings + self.input = self.source.read() + self.parse() + return self.document + + def parse(self): + """Parse `self.input` into a document tree.""" + self.document = document = self.new_document() + self.parser.parse(self.input, document) + document.current_source = document.current_line = None + + def new_document(self): + """Create and return a new empty document tree (root node).""" + document = utils.new_document(self.source.source_path, self.settings) + return document + + +class ReReader(Reader): + + """ + A reader which rereads an existing document tree (e.g. a + deserializer). + + Often used in conjunction with `writers.UnfilteredWriter`. + """ + + def get_transforms(self): + # Do not add any transforms. They have already been applied + # by the reader which originally created the document. + return Component.get_transforms(self) + + +_reader_aliases = {} + +def get_reader_class(reader_name): + """Return the Reader class from the `reader_name` module.""" + reader_name = reader_name.lower() + if _reader_aliases.has_key(reader_name): + reader_name = _reader_aliases[reader_name] + module = import(reader_name, globals(), locals()) + return module.Reader diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/readers/doctree.py --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/readers/doctree.py Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,46 @@ +# $Id: doctree.py 4564 2006-05-21 20:44:42Z wiemann $ +# Author: Martin Blais +# Copyright: This module has been placed in the public domain. + +"""Reader for existing document trees.""" + +from docutils import readers, utils, transforms + + +class Reader(readers.ReReader): + + """ + Adapt the Reader API for an existing document tree. + + The existing document tree must be passed as the ``source`` parameter to + the `docutils.core.Publisher` initializer, wrapped in a + `docutils.io.DocTreeInput` object:: + + pub = docutils.core.Publisher( + ..., source=docutils.io.DocTreeInput(document), ...) + + The original document settings are overridden; if you want to use the + settings of the original document, pass ``settings=document.settings`` to + the Publisher call above. + """ + + supported = ('doctree',) + + config_section = 'doctree reader' + config_section_dependencies = ('readers',) + + def parse(self): + """ + No parsing to do; refurbish the document tree instead. + Overrides the inherited method. + """ + self.document = self.input + # Create fresh Transformer object, to be populated from Writer + # component. + self.document.transformer = transforms.Transformer(self.document) + # Replace existing settings object with new one. + self.document.settings = self.settings + # Create fresh Reporter object because it is dependent on + # (new) settings. + self.document.reporter = utils.new_reporter( + self.document.get('source', ''), self.document.settings) diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/readers/pep.py --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/readers/pep.py Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,48 @@ +# $Id: pep.py 4564 2006-05-21 20:44:42Z wiemann $ +# Author: David Goodger +# Copyright: This module has been placed in the public domain. + +""" +Python Enhancement Proposal (PEP) Reader. +""" + +docformat = 'reStructuredText' + + +from docutils.readers import standalone +from docutils.transforms import peps, references, misc, frontmatter +from docutils.parsers import rst + + +class Reader(standalone.Reader): + + supported = ('pep',) + """Contexts this reader supports.""" + + settings_spec = ( + 'PEP Reader Option Defaults', + 'The --pep-references and --rfc-references options (for the ' + 'reStructuredText parser) are on by default.', + ()) + + config_section = 'pep reader' + config_section_dependencies = ('readers', 'standalone reader') + + def get_transforms(self): + transforms = standalone.Reader.get_transforms(self) + # We have PEP-specific frontmatter handling. + transforms.remove(frontmatter.DocTitle) + transforms.remove(frontmatter.SectionSubTitle) + transforms.remove(frontmatter.DocInfo) + transforms.extend([peps.Headers, peps.Contents, peps.TargetNotes]) + return transforms + + settings_default_overrides = {'pep_references': 1, 'rfc_references': 1} + + inliner_class = rst.states.Inliner + + def init(self, parser=None, parser_name=None): + """`parser` should be ``None``.""" + if parser is None: + parser = rst.Parser(rfc2822=1, inliner=self.inliner_class()) + standalone.Reader.init(self, parser, '') diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/readers/python/init.py --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/readers/python/init.py Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,127 @@ +# $Id: init.py 4813 2006-11-13 03:41:08Z wiemann $ +# Author: David Goodger +# Copyright: This module has been placed in the public domain. + +""" +This package contains the Python Source Reader modules. +""" + +docformat = 'reStructuredText' + + +import sys +import docutils.readers +from docutils.readers.python import moduleparser +from docutils import parsers +from docutils import nodes +from docutils.readers.python import pynodes +from docutils import readers + +class Reader(docutils.readers.Reader): + + config_section = 'python reader' + config_section_dependencies = ('readers',) + + default_parser = 'restructuredtext' + + def parse(self): + """Parse `self.input` into a document tree.""" + self.document = document = self.new_document() + module_section = moduleparser.parse_module(self.input, + self.source.source_path) + module_section.walk(DocformatVisitor(self.document)) + visitor = DocstringFormattingVisitor( + document=document, + default_parser=self.default_parser) + module_section.walk(visitor) + self.document.append(module_section) + + +class DocformatVisitor(nodes.SparseNodeVisitor): + + """ + This sets docformat attributes in a module. Wherever an assignment + to docformat is found, we look for the enclosing scope -- a class, + a module, or a function -- and set the docformat attribute there. + + We can't do this during the DocstringFormattingVisitor walking, + because docformat may appear below a docstring in that format + (typically below the module docstring). + """ + + def visit_attribute(self, node): + assert isinstance(node[0], pynodes.object_name) + name = node[0][0].data + if name != 'docformat': + return + value = None + for child in children: + if isinstance(child, pynodes.expression_value): + value = child[0].data + break + assert value.startswith("'") or value.startswith('"'), "docformat must be assigned a string literal (not %s); line: %s" % (value, node['lineno']) + name = name[1:-1] + looking_in = node.parent + while not isinstance(looking_in, (pynodes.module_section, + pynodes.function_section, + pynodes.class_section)): + looking_in = looking_in.parent + looking_in['docformat'] = name + + +class DocstringFormattingVisitor(nodes.SparseNodeVisitor): + + def init(self, document, default_parser): + self.document = document + self.default_parser = default_parser + self.parsers = {} + + def visit_docstring(self, node): + text = node[0].data + docformat = self.find_docformat(node) + del node[0] + node['docformat'] = docformat + parser = self.get_parser(docformat) + parser.parse(text, self.document) + for child in self.document.children: + node.append(child) + self.document.current_source = self.document.current_line = None + del self.document[:] + + def get_parser(self, parser_name): + """ + Get a parser based on its name. We reuse parsers during this + visitation, so parser instances are cached. + """ + parser_name = parsers._parser_aliases.get(parser_name, parser_name) + if not self.parsers.has_key(parser_name): + cls = parsers.get_parser_class(parser_name) + self.parsers[parser_name] = cls() + return self.parsers[parser_name] + + def find_docformat(self, node): + """ + Find the docformat closest to this node (i.e., look in the + class or module) + """ + while node: + if node.get('docformat'): + return node['docformat'] + node = node.parent + return self.default_parser + + +if name == 'main': + try: + import locale + locale.setlocale(locale.LC_ALL, '') + except: + pass + + from docutils.core import publish_cmdline, default_description + + description = ('Generates pseudo-XML from Python modules ' + '(for testing purposes). ' + default_description) + + publish_cmdline(description=description, + reader=Reader()) diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/readers/python/moduleparser.py --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/readers/python/moduleparser.py Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,758 @@ +# $Id: moduleparser.py 4813 2006-11-13 03:41:08Z wiemann $ +# Author: David Goodger +# Copyright: This module has been placed in the public domain. + +""" +Parser for Python modules. + +The `parse_module()` function takes a module's text and file name, +runs it through the module parser (using compiler.py and tokenize.py) +and produces a parse tree of the source code, using the nodes as found +in pynodes.py. For example, given this module (x.py):: + + # comment + + '''Docstring''' + + '''Additional docstring''' + + docformat = 'reStructuredText' + + a = 1 + '''Attribute docstring''' + + class C(Super): + + '''C's docstring''' + + class_attribute = 1 + '''class_attribute's docstring''' + + def init(self, text=None): + '''init's docstring''' + + self.instance_attribute = (text 7 + + ' whaddyaknow') + '''instance_attribute's docstring''' + + + def f(x, # parameter x + y=a5, # parameter y + args): # parameter args + '''f's docstring''' + return [x + item for item in args] + + f.function_attribute = 1 + '''f.function_attribute's docstring''' + +The module parser will produce this module documentation tree:: + + + + Docstring + + Additional docstring + + + docformat + + 'reStructuredText' + + + a + + 1 + + Attribute docstring + + + C + + Super + + C's docstring + + + class_attribute + + 1 + + class_attribute's docstring + + + init + + init's docstring + + + + self + + + text + + None + + + self.instance_attribute + + (text * 7 + ' whaddyaknow') + + instance_attribute's docstring + + + f + + f's docstring + + + + x + + # parameter x + + + y + + a * 5 + + # parameter y + + + args + + # parameter args + + + f.function_attribute + + 1 + + f.function_attribute's docstring + +(Comments are not implemented yet.) + +compiler.parse() provides most of what's needed for this doctree, and +"tokenize" can be used to get the rest. We can determine the line +number from the compiler.parse() AST, and the TokenParser.rhs(lineno) +method provides the rest. + +The Docutils Python reader component will transform this module doctree into a +Python-specific Docutils doctree, and then a "stylist transform" will +further transform it into a generic doctree. Namespaces will have to be +compiled for each of the scopes, but I'm not certain at what stage of +processing. + +It's very important to keep all docstring processing out of this, so that it's +a completely generic and not tool-specific. + +:: + +> Why perform all of those transformations? Why not go from the AST to a +> generic doctree? Or, even from the AST to the final output? + +I want the docutils.readers.python.moduleparser.parse_module() function to +produce a standard documentation-oriented tree that can be used by any tool. +We can develop it together without having to compromise on the rest of our +design (i.e., HappyDoc doesn't have to be made to work like Docutils, and +vice-versa). It would be a higher-level version of what compiler.py provides. + +The Python reader component transforms this generic AST into a Python-specific +doctree (it knows about modules, classes, functions, etc.), but this is +specific to Docutils and cannot be used by HappyDoc or others. The stylist +transform does the final layout, converting Python-specific structures +("class" sections, etc.) into a generic doctree using primitives (tables, +sections, lists, etc.). This generic doctree does not know about Python +structures any more. The advantage is that this doctree can be handed off to +any of the output writers to create any output format we like. + +The latter two transforms are separate because I want to be able to have +multiple independent layout styles (multiple runtime-selectable "stylist +transforms"). Each of the existing tools (HappyDoc, pydoc, epydoc, Crystal, +etc.) has its own fixed format. I personally don't like the tables-based +format produced by these tools, and I'd like to be able to customize the +format easily. That's the goal of stylist transforms, which are independent +from the Reader component itself. One stylist transform could produce +HappyDoc-like output, another could produce output similar to module docs in +the Python library reference manual, and so on. + +It's for exactly this reason:: + +>> It's very important to keep all docstring processing out of this, so that +>> it's a completely generic and not tool-specific. + +... but it goes past docstring processing. It's also important to keep style +decisions and tool-specific data transforms out of this module parser. + + +Issues +====== + +* At what point should namespaces be computed? Should they be part of the + basic AST produced by the ASTVisitor walk, or generated by another tree + traversal? + +* At what point should a distinction be made between local variables & + instance attributes in init methods? + +* Docstrings are getting their lineno from their parents. Should the + TokenParser find the real line no's? + +* Comments: include them? How and when? Only full-line comments, or + parameter comments too? (See function "f" above for an example.) + +* Module could use more docstrings & refactoring in places. + +""" + +docformat = 'reStructuredText' + +import sys +import compiler +import compiler.ast +import tokenize +import token +from compiler.consts import OP_ASSIGN +from compiler.visitor import ASTVisitor +from types import StringType, UnicodeType, TupleType +from docutils.readers.python import pynodes +from docutils.nodes import Text + + +def parse_module(module_text, filename): + """Return a module documentation tree from `module_text`.""" + ast = compiler.parse(module_text) + token_parser = TokenParser(module_text) + visitor = ModuleVisitor(filename, token_parser) + compiler.walk(ast, visitor, walker=visitor) + return visitor.module + +class BaseVisitor(ASTVisitor): + + def init(self, token_parser): + ASTVisitor.init(self) + self.token_parser = token_parser + self.context = [] + self.documentable = None + + def default(self, node, args): + self.documentable = None + #print 'in default (%s)' % node.class.name + #ASTVisitor.default(self, node, args) + + def default_visit(self, node, args): + #print 'in default_visit (%s)' % node.class.name + ASTVisitor.default(self, node, args) + + +class DocstringVisitor(BaseVisitor): + + def visitDiscard(self, node): + if self.documentable: + self.visit(node.expr) + + def visitConst(self, node): + if self.documentable: + if type(node.value) in (StringType, UnicodeType): + self.documentable.append(make_docstring(node.value, node.lineno)) + else: + self.documentable = None + + def visitStmt(self, node): + self.default_visit(node) + + +class AssignmentVisitor(DocstringVisitor): + + def visitAssign(self, node): + visitor = AttributeVisitor(self.token_parser) + compiler.walk(node, visitor, walker=visitor) + if visitor.attributes: + self.context[-1].extend(visitor.attributes) + if len(visitor.attributes) == 1: + self.documentable = visitor.attributes[0] + else: + self.documentable = None + + +class ModuleVisitor(AssignmentVisitor): + + def init(self, filename, token_parser): + AssignmentVisitor.init(self, token_parser) + self.filename = filename + self.module = None + + def visitModule(self, node): + self.module = module = pynodes.module_section() + module['filename'] = self.filename + append_docstring(module, node.doc, node.lineno) + self.context.append(module) + self.documentable = module + self.visit(node.node) + self.context.pop() + + def visitImport(self, node): + self.context[-1] += make_import_group(names=node.names, + lineno=node.lineno) + self.documentable = None + + def visitFrom(self, node): + self.context[-1].append( + make_import_group(names=node.names, from_name=node.modname, + lineno=node.lineno)) + self.documentable = None + + def visitFunction(self, node): + visitor = FunctionVisitor(self.token_parser, + function_class=pynodes.function_section) + compiler.walk(node, visitor, walker=visitor) + self.context[-1].append(visitor.function) + + def visitClass(self, node): + visitor = ClassVisitor(self.token_parser) + compiler.walk(node, visitor, walker=visitor) + self.context[-1].append(visitor.klass) + + +class AttributeVisitor(BaseVisitor): + + def init(self, token_parser): + BaseVisitor.init(self, token_parser) + self.attributes = pynodes.class_attribute_section() + + def visitAssign(self, node): + # Don't visit the expression itself, just the attribute nodes: + for child in node.nodes: + self.dispatch(child) + expression_text = self.token_parser.rhs(node.lineno) + expression = pynodes.expression_value() + expression.append(Text(expression_text)) + for attribute in self.attributes: + attribute.append(expression) + + def visitAssName(self, node): + self.attributes.append(make_attribute(node.name, + lineno=node.lineno)) + + def visitAssTuple(self, node): + attributes = self.attributes + self.attributes = [] + self.default_visit(node) + n = pynodes.attribute_tuple() + n.extend(self.attributes) + n['lineno'] = self.attributes[0]['lineno'] + attributes.append(n) + self.attributes = attributes + #self.attributes.append(att_tuple) + + def visitAssAttr(self, node): + self.default_visit(node, node.attrname) + + def visitGetattr(self, node, suffix): + self.default_visit(node, node.attrname + '.' + suffix) + + def visitName(self, node, suffix): + self.attributes.append(make_attribute(node.name + '.' + suffix, + lineno=node.lineno)) + + +class FunctionVisitor(DocstringVisitor): + + in_function = 0 + + def init(self, token_parser, function_class): + DocstringVisitor.init(self, token_parser) + self.function_class = function_class + + def visitFunction(self, node): + if self.in_function: + self.documentable = None + # Don't bother with nested function definitions. + return + self.in_function = 1 + self.function = function = make_function_like_section( + name=node.name, + lineno=node.lineno, + doc=node.doc, + function_class=self.function_class) + self.context.append(function) + self.documentable = function + self.parse_parameter_list(node) + self.visit(node.code) + self.context.pop() + + def parse_parameter_list(self, node): + parameters = [] + special = [] + argnames = list(node.argnames) + if node.kwargs: + special.append(make_parameter(argnames[-1], excess_keyword=1)) + argnames.pop() + if node.varargs: + special.append(make_parameter(argnames[-1], + excess_positional=1)) + argnames.pop() + defaults = list(node.defaults) + defaults = [None] * (len(argnames) - len(defaults)) + defaults + function_parameters = self.token_parser.function_parameters( + node.lineno) + #print >>sys.stderr, function_parameters + for argname, default in zip(argnames, defaults): + if type(argname) is TupleType: + parameter = pynodes.parameter_tuple() + for tuplearg in argname: + parameter.append(make_parameter(tuplearg)) + argname = normalize_parameter_name(argname) + else: + parameter = make_parameter(argname) + if default: + n_default = pynodes.parameter_default() + n_default.append(Text(function_parameters[argname])) + parameter.append(n_default) + parameters.append(parameter) + if parameters or special: + special.reverse() + parameters.extend(special) + parameter_list = pynodes.parameter_list() + parameter_list.extend(parameters) + self.function.append(parameter_list) + + +class ClassVisitor(AssignmentVisitor): + + in_class = 0 + + def init(self, token_parser): + AssignmentVisitor.init(self, token_parser) + self.bases = [] + + def visitClass(self, node): + if self.in_class: + self.documentable = None + # Don't bother with nested class definitions. + return + self.in_class = 1 + #import mypdb as pdb + #pdb.set_trace() + for base in node.bases: + self.visit(base) + self.klass = klass = make_class_section(node.name, self.bases, + doc=node.doc, + lineno=node.lineno) + self.context.append(klass) + self.documentable = klass + self.visit(node.code) + self.context.pop() + + def visitGetattr(self, node, suffix=None): + if suffix: + name = node.attrname + '.' + suffix + else: + name = node.attrname + self.default_visit(node, name) + + def visitName(self, node, suffix=None): + if suffix: + name = node.name + '.' + suffix + else: + name = node.name + self.bases.append(name) + + def visitFunction(self, node): + if node.name == 'init': + visitor = InitMethodVisitor(self.token_parser, + function_class=pynodes.method_section) + compiler.walk(node, visitor, walker=visitor) + else: + visitor = FunctionVisitor(self.token_parser, + function_class=pynodes.method_section) + compiler.walk(node, visitor, walker=visitor) + self.context[-1].append(visitor.function) + + +class InitMethodVisitor(FunctionVisitor, AssignmentVisitor): pass + + +class TokenParser: + + def init(self, text): + self.text = text + '\n\n' + self.lines = self.text.splitlines(1) + self.generator = tokenize.generate_tokens(iter(self.lines).next) + self.next() + + def iter(self): + return self + + def next(self): + self.token = self.generator.next() + self.type, self.string, self.start, self.end, self.line = self.token + return self.token + + def goto_line(self, lineno): + while self.start[0] < lineno: + self.next() + return token + + def rhs(self, lineno): + """ + Return a whitespace-normalized expression string from the right-hand + side of an assignment at line `lineno`. + """ + self.goto_line(lineno) + while self.string != '=': + self.next() + self.stack = None + while self.type != token.NEWLINE and self.string != ';': + if self.string == '=' and not self.stack: + self.tokens = [] + self.stack = [] + self._type = None + self._string = None + self._backquote = 0 + else: + self.note_token() + self.next() + self.next() + text = ''.join(self.tokens) + return text.strip() + + closers = {')': '(', ']': '[', '}': '{'} + openers = {'(': 1, '[': 1, '{': 1} + del_ws_prefix = {'.': 1, '=': 1, ')': 1, ']': 1, '}': 1, ':': 1, ',': 1} + no_ws_suffix = {'.': 1, '=': 1, '(': 1, '[': 1, '{': 1} + + def note_token(self): + if self.type == tokenize.NL: + return + del_ws = self.del_ws_prefix.has_key(self.string) + append_ws = not self.no_ws_suffix.has_key(self.string) + if self.openers.has_key(self.string): + self.stack.append(self.string) + if (self._type == token.NAME + or self.closers.has_key(self._string)): + del_ws = 1 + elif self.closers.has_key(self.string): + assert self.stack[-1] == self.closers[self.string] + self.stack.pop() + elif self.string == '`': + if self._backquote: + del_ws = 1 + assert self.stack[-1] == '`' + self.stack.pop() + else: + append_ws = 0 + self.stack.append('`') + self._backquote = not self._backquote + if del_ws and self.tokens and self.tokens[-1] == ' ': + del self.tokens[-1] + self.tokens.append(self.string) + self._type = self.type + self._string = self.string + if append_ws: + self.tokens.append(' ') + + def function_parameters(self, lineno): + """ + Return a dictionary mapping parameters to defaults + (whitespace-normalized strings). + """ + self.goto_line(lineno) + while self.string != 'def': + self.next() + while self.string != '(': + self.next() + name = None + default = None + parameter_tuple = None + self.tokens = [] + parameters = {} + self.stack = [self.string] + self.next() + while 1: + if len(self.stack) == 1: + if parameter_tuple: + # Just encountered ")". + #print >>sys.stderr, 'parameter_tuple: %r' % self.tokens + name = ''.join(self.tokens).strip() + self.tokens = [] + parameter_tuple = None + if self.string in (')', ','): + if name: + if self.tokens: + default_text = ''.join(self.tokens).strip() + else: + default_text = None + parameters[name] = default_text + self.tokens = [] + name = None + default = None + if self.string == ')': + break + elif self.type == token.NAME: + if name and default: + self.note_token() + else: + assert name is None, ( + 'token=%r name=%r parameters=%r stack=%r' + % (self.token, name, parameters, self.stack)) + name = self.string + #print >>sys.stderr, 'name=%r' % name + elif self.string == '=': + assert name is not None, 'token=%r' % (self.token,) + assert default is None, 'token=%r' % (self.token,) + assert self.tokens == [], 'token=%r' % (self.token,) + default = 1 + self._type = None + self._string = None + self._backquote = 0 + elif name: + self.note_token() + elif self.string == '(': + parameter_tuple = 1 + self._type = None + self._string = None + self._backquote = 0 + self.note_token() + else: # ignore these tokens: + assert (self.string in ('*', '**', '\n') + or self.type == tokenize.COMMENT), ( + 'token=%r' % (self.token,)) + else: + self.note_token() + self.next() + return parameters + + +def make_docstring(doc, lineno): + n = pynodes.docstring() + if lineno: + # Really, only module docstrings don't have a line + # (@@: but maybe they should) + n['lineno'] = lineno + n.append(Text(doc)) + return n + +def append_docstring(node, doc, lineno): + if doc: + node.append(make_docstring(doc, lineno)) + +def make_class_section(name, bases, lineno, doc): + n = pynodes.class_section() + n['lineno'] = lineno + n.append(make_object_name(name)) + for base in bases: + b = pynodes.class_base() + b.append(make_object_name(base)) + n.append(b) + append_docstring(n, doc, lineno) + return n + +def make_object_name(name): + n = pynodes.object_name() + n.append(Text(name)) + return n + +def make_function_like_section(name, lineno, doc, function_class): + n = function_class() + n['lineno'] = lineno + n.append(make_object_name(name)) + append_docstring(n, doc, lineno) + return n + +def make_import_group(names, lineno, from_name=None): + n = pynodes.import_group() + n['lineno'] = lineno + if from_name: + n_from = pynodes.import_from() + n_from.append(Text(from_name)) + n.append(n_from) + for name, alias in names: + n_name = pynodes.import_name() + n_name.append(Text(name)) + if alias: + n_alias = pynodes.import_alias() + n_alias.append(Text(alias)) + n_name.append(n_alias) + n.append(n_name) + return n + +def make_class_attribute(name, lineno): + n = pynodes.class_attribute() + n['lineno'] = lineno + n.append(Text(name)) + return n + +def make_attribute(name, lineno): + n = pynodes.attribute() + n['lineno'] = lineno + n.append(make_object_name(name)) + return n + +def make_parameter(name, excess_keyword=0, excess_positional=0): + """ + excess_keyword and excess_positional must be either 1 or 0, and + not both of them can be 1. + """ + n = pynodes.parameter() + n.append(make_object_name(name)) + assert not excess_keyword or not excess_positional + if excess_keyword: + n['excess_keyword'] = 1 + if excess_positional: + n['excess_positional'] = 1 + return n + +def trim_docstring(text): + """ + Trim indentation and blank lines from docstring text & return it. + + See PEP 257. + """ + if not text: + return text + # Convert tabs to spaces (following the normal Python rules) + # and split into a list of lines: + lines = text.expandtabs().splitlines() + # Determine minimum indentation (first line doesn't count): + indent = sys.maxint + for line in lines[1:]: + stripped = line.lstrip() + if stripped: + indent = min(indent, len(line) - len(stripped)) + # Remove indentation (first line is special): + trimmed = [lines[0].strip()] + if indent < sys.maxint: + for line in lines[1:]: + trimmed.append(line[indent:].rstrip()) + # Strip off trailing and leading blank lines: + while trimmed and not trimmed[-1]: + trimmed.pop() + while trimmed and not trimmed[0]: + trimmed.pop(0) + # Return a single string: + return '\n'.join(trimmed) + +def normalize_parameter_name(name): + """ + Converts a tuple like ``('a', ('b', 'c'), 'd')`` into ``'(a, (b, c), d)'`` + """ + if type(name) is TupleType: + return '(%s)' % ', '.join([normalize_parameter_name(n) for n in name]) + else: + return name + +if name == 'main': + import sys + args = sys.argv[1:] + if args[0] == '-v': + filename = args[1] + module_text = open(filename).read() + ast = compiler.parse(module_text) + visitor = compiler.visitor.ExampleASTVisitor() + compiler.walk(ast, visitor, walker=visitor, verbose=1) + else: + filename = args[0] + content = open(filename).read() + print parse_module(content, filename).pformat() + diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/readers/python/pynodes.py --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/readers/python/pynodes.py Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,81 @@ +#! /usr/bin/env python +# $Id: pynodes.py 4564 2006-05-21 20:44:42Z wiemann $ +# Author: David Goodger +# Copyright: This module has been placed in the public domain. + +from docutils import nodes +from docutils.nodes import Element, TextElement, Structural, Inline, Part, \ + Text +import types + +# This is the parent class of all the other pynode classes: +class PythonStructural(Structural): pass + +# ===================== +# Structural Elements +# ===================== + +class module_section(PythonStructural, Element): pass +class class_section(PythonStructural, Element): pass +class class_base(PythonStructural, Element): pass +class method_section(PythonStructural, Element): pass +class attribute(PythonStructural, Element): pass +class function_section(PythonStructural, Element): pass +class class_attribute_section(PythonStructural, Element): pass +class class_attribute(PythonStructural, Element): pass +class expression_value(PythonStructural, Element): pass +class attribute(PythonStructural, Element): pass + +# Structural Support Elements +# --------------------------- + +class parameter_list(PythonStructural, Element): pass +class parameter_tuple(PythonStructural, Element): pass +class parameter_default(PythonStructural, TextElement): pass +class import_group(PythonStructural, TextElement): pass +class import_from(PythonStructural, TextElement): pass +class import_name(PythonStructural, TextElement): pass +class import_alias(PythonStructural, TextElement): pass +class docstring(PythonStructural, Element): pass + +# ================= +# Inline Elements +# ================= + +# These elements cannot become references until the second +# pass. Initially, we'll use "reference" or "name". + +class object_name(PythonStructural, TextElement): pass +class parameter_list(PythonStructural, TextElement): pass +class parameter(PythonStructural, TextElement): pass +class parameter_default(PythonStructural, TextElement): pass +class class_attribute(PythonStructural, TextElement): pass +class attribute_tuple(PythonStructural, TextElement): pass + +# ================= +# Unused Elements +# ================= + +# These were part of the model, and maybe should be in the future, but +# aren't now. +#class package_section(PythonStructural, Element): pass +#class module_attribute_section(PythonStructural, Element): pass +#class instance_attribute_section(PythonStructural, Element): pass +#class module_attribute(PythonStructural, TextElement): pass +#class instance_attribute(PythonStructural, TextElement): pass +#class exception_class(PythonStructural, TextElement): pass +#class warning_class(PythonStructural, TextElement): pass + + +# Collect all the classes we've written above +def install_node_class_names(): + node_class_names = [] + for name, var in globals().items(): + if (type(var) is types.ClassType + and issubclass(var, PythonStructural) \ + and name.lower() == name): + node_class_names.append(var.tagname or name) + # Register the new node names with GenericNodeVisitor and + # SpecificNodeVisitor: + nodes._add_node_class_names(node_class_names) +install_node_class_names() diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/readers/standalone.py --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/readers/standalone.py Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,66 @@ +# $Id: standalone.py 4802 2006-11-12 18:02:17Z goodger $ +# Author: David Goodger +# Copyright: This module has been placed in the public domain. + +""" +Standalone file Reader for the reStructuredText markup syntax. +""" + +docformat = 'reStructuredText' + + +import sys +from docutils import frontend, readers +from docutils.transforms import frontmatter, references, misc + + +class Reader(readers.Reader): + + supported = ('standalone',) + """Contexts this reader supports.""" + + document = None + """A single document tree.""" + + settings_spec = ( + 'Standalone Reader', + None, + (('Disable the promotion of a lone top-level section title to ' + 'document title (and subsequent section title to document ' + 'subtitle promotion; enabled by default).', + ['--no-doc-title'], + {'dest': 'doctitle_xform', 'action': 'store_false', 'default': 1, + 'validator': frontend.validate_boolean}), + ('Disable the bibliographic field list transform (enabled by ' + 'default).', + ['--no-doc-info'], + {'dest': 'docinfo_xform', 'action': 'store_false', 'default': 1, + 'validator': frontend.validate_boolean}), + ('Activate the promotion of lone subsection titles to ' + 'section subtitles (disabled by default).', + ['--section-subtitles'], + {'dest': 'sectsubtitle_xform', 'action': 'store_true', 'default': 0, + 'validator': frontend.validate_boolean}), + ('Deactivate the promotion of lone subsection titles.', + ['--no-section-subtitles'], + {'dest': 'sectsubtitle_xform', 'action': 'store_false'}), + )) + + config_section = 'standalone reader' + config_section_dependencies = ('readers',) + + def get_transforms(self): + return readers.Reader.get_transforms(self) + [ + references.Substitutions, + references.PropagateTargets, + frontmatter.DocTitle, + frontmatter.SectionSubTitle, + frontmatter.DocInfo, + references.AnonymousHyperlinks, + references.IndirectHyperlinks, + references.Footnotes, + references.ExternalTargets, + references.InternalTargets, + references.DanglingReferences, + misc.Transitions, + ] diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/statemachine.py --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/statemachine.py Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,1490 @@ +# $Id: statemachine.py 4564 2006-05-21 20:44:42Z wiemann $ +# Author: David Goodger +# Copyright: This module has been placed in the public domain. + +""" +A finite state machine specialized for regular-expression-based text filters, +this module defines the following classes: + +- `StateMachine`, a state machine +- `State`, a state superclass +- `StateMachineWS`, a whitespace-sensitive version of `StateMachine` +- `StateWS`, a state superclass for use with `StateMachineWS` +- `SearchStateMachine`, uses `re.search()` instead of `re.match()` +- `SearchStateMachineWS`, uses `re.search()` instead of `re.match()` +- `ViewList`, extends standard Python lists. +- `StringList`, string-specific ViewList. + +Exception classes: + +- `StateMachineError` +- `UnknownStateError` +- `DuplicateStateError` +- `UnknownTransitionError` +- `DuplicateTransitionError` +- `TransitionPatternNotFound` +- `TransitionMethodNotFound` +- `UnexpectedIndentationError` +- `TransitionCorrection`: Raised to switch to another transition. +- `StateCorrection`: Raised to switch to another state & transition. + +Functions: + +- `string2lines()`: split a multi-line string into a list of one-line strings + + +How To Use This Module +====================== +(See the individual classes, methods, and attributes for details.) + +1. Import it: ``import statemachine`` or ``from statemachine import ...``. + You will also need to ``import re``. + +2. Derive a subclass of `State` (or `StateWS`) for each state in your state + machine:: + + class MyState(statemachine.State): + + Within the state's class definition: + + a) Include a pattern for each transition, in `State.patterns`:: + + patterns = {'atransition': r'pattern', ...} + + b) Include a list of initial transitions to be set up automatically, in + `State.initial_transitions`:: + + initial_transitions = ['atransition', ...] + + c) Define a method for each transition, with the same name as the + transition pattern:: + + def atransition(self, match, context, next_state): + # do something + result = [...] # a list + return context, next_state, result + # context, next_state may be altered + + Transition methods may raise an `EOFError` to cut processing short. + + d) You may wish to override the `State.bof()` and/or `State.eof()` implicit + transition methods, which handle the beginning- and end-of-file. + + e) In order to handle nested processing, you may wish to override the + attributes `State.nested_sm` and/or `State.nested_sm_kwargs`. + + If you are using `StateWS` as a base class, in order to handle nested + indented blocks, you may wish to: + + - override the attributes `StateWS.indent_sm`, + `StateWS.indent_sm_kwargs`, `StateWS.known_indent_sm`, and/or + `StateWS.known_indent_sm_kwargs`; + - override the `StateWS.blank()` method; and/or + - override or extend the `StateWS.indent()`, `StateWS.known_indent()`, + and/or `StateWS.firstknown_indent()` methods. + +3. Create a state machine object:: + + sm = StateMachine(state_classes=[MyState, ...], + initial_state='MyState') + +4. Obtain the input text, which needs to be converted into a tab-free list of + one-line strings. For example, to read text from a file called + 'inputfile':: + + input_string = open('inputfile').read() + input_lines = statemachine.string2lines(input_string) + +5. Run the state machine on the input text and collect the results, a list:: + + results = sm.run(input_lines) + +6. Remove any lingering circular references:: + + sm.unlink() +""" + +docformat = 'restructuredtext' + +import sys +import re +import types +import unicodedata + + +class StateMachine: + + """ + A finite state machine for text filters using regular expressions. + + The input is provided in the form of a list of one-line strings (no + newlines). States are subclasses of the `State` class. Transitions consist + of regular expression patterns and transition methods, and are defined in + each state. + + The state machine is started with the `run()` method, which returns the + results of processing in a list. + """ + + def init(self, state_classes, initial_state, debug=0): + """ + Initialize a `StateMachine` object; add state objects. + + Parameters: + + - `state_classes`: a list of `State` (sub)classes. + - `initial_state`: a string, the class name of the initial state. + - `debug`: a boolean; produce verbose output if true (nonzero). + """ + + self.input_lines = None + """`StringList` of input lines (without newlines). + Filled by `self.run()`.""" + + self.input_offset = 0 + """Offset of `self.input_lines` from the beginning of the file.""" + + self.line = None + """Current input line.""" + + self.line_offset = -1 + """Current input line offset from beginning of `self.input_lines`.""" + + self.debug = debug + """Debugging mode on/off.""" + + self.initial_state = initial_state + """The name of the initial state (key to `self.states`).""" + + self.current_state = initial_state + """The name of the current state (key to `self.states`).""" + + self.states = {} + """Mapping of {state_name: State_object}.""" + + self.add_states(state_classes) + + self.observers = [] + """List of bound methods or functions to call whenever the current + line changes. Observers are called with one argument, ``self``. + Cleared at the end of `run()`.""" + + def unlink(self): + """Remove circular references to objects no longer required.""" + for state in self.states.values(): + state.unlink() + self.states = None + + def run(self, input_lines, input_offset=0, context=None, + input_source=None): + """ + Run the state machine on `input_lines`. Return results (a list). + + Reset `self.line_offset` and `self.current_state`. Run the + beginning-of-file transition. Input one line at a time and check for a + matching transition. If a match is found, call the transition method + and possibly change the state. Store the context returned by the + transition method to be passed on to the next transition matched. + Accumulate the results returned by the transition methods in a list. + Run the end-of-file transition. Finally, return the accumulated + results. + + Parameters: + + - `input_lines`: a list of strings without newlines, or `StringList`. + - `input_offset`: the line offset of `input_lines` from the beginning + of the file. + - `context`: application-specific storage. + - `input_source`: name or path of source of `input_lines`. + """ + self.runtime_init() + if isinstance(input_lines, StringList): + self.input_lines = input_lines + else: + self.input_lines = StringList(input_lines, source=input_source) + self.input_offset = input_offset + self.line_offset = -1 + self.current_state = self.initial_state + if self.debug: + print >>sys.stderr, ( + '\nStateMachine.run: input_lines (line_offset=%s):\n| %s' + % (self.line_offset, '\n| '.join(self.input_lines))) + transitions = None + results = [] + state = self.get_state() + try: + if self.debug: + print >>sys.stderr, ('\nStateMachine.run: bof transition') + context, result = state.bof(context) + results.extend(result) + while 1: + try: + try: + self.next_line() + if self.debug: + source, offset = self.input_lines.info( + self.line_offset) + print >>sys.stderr, ( + '\nStateMachine.run: line (source=%r, ' + 'offset=%r):\n| %s' + % (source, offset, self.line)) + context, next_state, result = self.check_line( + context, state, transitions) + except EOFError: + if self.debug: + print >>sys.stderr, ( + '\nStateMachine.run: %s.eof transition' + % state.class.name) + result = state.eof(context) + results.extend(result) + break + else: + results.extend(result) + except TransitionCorrection, exception: + self.previous_line() # back up for another try + transitions = (exception.args[0],) + if self.debug: + print >>sys.stderr, ( + '\nStateMachine.run: TransitionCorrection to ' + 'state "%s", transition %s.' + % (state.class.name, transitions[0])) + continue + except StateCorrection, exception: + self.previous_line() # back up for another try + next_state = exception.args[0] + if len(exception.args) == 1: + transitions = None + else: + transitions = (exception.args[1],) + if self.debug: + print >>sys.stderr, ( + '\nStateMachine.run: StateCorrection to state ' + '"%s", transition %s.' + % (next_state, transitions[0])) + else: + transitions = None + state = self.get_state(next_state) + except: + if self.debug: + self.error() + raise + self.observers = [] + return results + + def get_state(self, next_state=None): + """ + Return current state object; set it first if `next_state` given. + + Parameter `next_state`: a string, the name of the next state. + + Exception: `UnknownStateError` raised if `next_state` unknown. + """ + if next_state: + if self.debug and next_state != self.current_state: + print >>sys.stderr, \ + ('\nStateMachine.get_state: Changing state from ' + '"%s" to "%s" (input line %s).' + % (self.current_state, next_state, + self.abs_line_number())) + self.current_state = next_state + try: + return self.states[self.current_state] + except KeyError: + raise UnknownStateError(self.current_state) + + def next_line(self, n=1): + """Load `self.line` with the `n`'th next line and return it.""" + try: + try: + self.line_offset += n + self.line = self.input_lines[self.line_offset] + except IndexError: + self.line = None + raise EOFError + return self.line + finally: + self.notify_observers() + + def is_next_line_blank(self): + """Return 1 if the next line is blank or non-existant.""" + try: + return not self.input_lines[self.line_offset + 1].strip() + except IndexError: + return 1 + + def at_eof(self): + """Return 1 if the input is at or past end-of-file.""" + return self.line_offset >= len(self.input_lines) - 1 + + def at_bof(self): + """Return 1 if the input is at or before beginning-of-file.""" + return self.line_offset <= 0 + + def previous_line(self, n=1): + """Load `self.line` with the `n`'th previous line and return it.""" + self.line_offset -= n + if self.line_offset < 0: + self.line = None + else: + self.line = self.input_lines[self.line_offset] + self.notify_observers() + return self.line + + def goto_line(self, line_offset): + """Jump to absolute line offset `line_offset`, load and return it.""" + try: + try: + self.line_offset = line_offset - self.input_offset + self.line = self.input_lines[self.line_offset] + except IndexError: + self.line = None + raise EOFError + return self.line + finally: + self.notify_observers() + + def get_source(self, line_offset): + """Return source of line at absolute line offset `line_offset`.""" + return self.input_lines.source(line_offset - self.input_offset) + + def abs_line_offset(self): + """Return line offset of current line, from beginning of file.""" + return self.line_offset + self.input_offset + + def abs_line_number(self): + """Return line number of current line (counting from 1).""" + return self.line_offset + self.input_offset + 1 + + def insert_input(self, input_lines, source): + self.input_lines.insert(self.line_offset + 1, '', + source='internal padding') + self.input_lines.insert(self.line_offset + 1, '', + source='internal padding') + self.input_lines.insert(self.line_offset + 2, + StringList(input_lines, source)) + + def get_text_block(self, flush_left=0): + """ + Return a contiguous block of text. + + If `flush_left` is true, raise `UnexpectedIndentationError` if an + indented line is encountered before the text block ends (with a blank + line). + """ + try: + block = self.input_lines.get_text_block(self.line_offset, + flush_left) + self.next_line(len(block) - 1) + return block + except UnexpectedIndentationError, error: + block, source, lineno = error + self.next_line(len(block) - 1) # advance to last line of block + raise + + def check_line(self, context, state, transitions=None): + """ + Examine one line of input for a transition match & execute its method. + + Parameters: + + - `context`: application-dependent storage. + - `state`: a `State` object, the current state. + - `transitions`: an optional ordered list of transition names to try, + instead of ``state.transition_order``. + + Return the values returned by the transition method: + + - context: possibly modified from the parameter `context`; + - next state name (`State` subclass name); + - the result output of the transition, a list. + + When there is no match, ``state.no_match()`` is called and its return + value is returned. + """ + if transitions is None: + transitions = state.transition_order + state_correction = None + if self.debug: + print >>sys.stderr, ( + '\nStateMachine.check_line: state="%s", transitions=%r.' + % (state.class.name, transitions)) + for name in transitions: + pattern, method, next_state = state.transitions[name] + match = self.match(pattern) + if match: + if self.debug: + print >>sys.stderr, ( + '\nStateMachine.check_line: Matched transition ' + '"%s" in state "%s".' + % (name, state.class.name)) + return method(match, context, next_state) + else: + if self.debug: + print >>sys.stderr, ( + '\nStateMachine.check_line: No match in state "%s".' + % state.class.name) + return state.no_match(context, transitions) + + def match(self, pattern): + """ + Return the result of a regular expression match. + + Parameter `pattern`: an `re` compiled regular expression. + """ + return pattern.match(self.line) + + def add_state(self, state_class): + """ + Initialize & add a `state_class` (`State` subclass) object. + + Exception: `DuplicateStateError` raised if `state_class` was already + added. + """ + statename = state_class.name + if self.states.has_key(statename): + raise DuplicateStateError(statename) + self.states[statename] = state_class(self, self.debug) + + def add_states(self, state_classes): + """ + Add `state_classes` (a list of `State` subclasses). + """ + for state_class in state_classes: + self.add_state(state_class) + + def runtime_init(self): + """ + Initialize `self.states`. + """ + for state in self.states.values(): + state.runtime_init() + + def error(self): + """Report error details.""" + type, value, module, line, function = _exception_data() + print >>sys.stderr, '%s: %s' % (type, value) + print >>sys.stderr, 'input line %s' % (self.abs_line_number()) + print >>sys.stderr, ('module %s, line %s, function %s' + % (module, line, function)) + + def attach_observer(self, observer): + """ + The `observer` parameter is a function or bound method which takes two + arguments, the source and offset of the current line. + """ + self.observers.append(observer) + + def detach_observer(self, observer): + self.observers.remove(observer) + + def notify_observers(self): + for observer in self.observers: + try: + info = self.input_lines.info(self.line_offset) + except IndexError: + info = (None, None) + observer(info) + + +class State: + + """ + State superclass. Contains a list of transitions, and transition methods. + + Transition methods all have the same signature. They take 3 parameters: + + - An `re` match object. ``match.string`` contains the matched input line, + ``match.start()`` gives the start index of the match, and + ``match.end()`` gives the end index. + - A context object, whose meaning is application-defined (initial value + ``None``). It can be used to store any information required by the state + machine, and the retured context is passed on to the next transition + method unchanged. + - The name of the next state, a string, taken from the transitions list; + normally it is returned unchanged, but it may be altered by the + transition method if necessary. + + Transition methods all return a 3-tuple: + + - A context object, as (potentially) modified by the transition method. + - The next state name (a return value of ``None`` means no state change). + - The processing result, a list, which is accumulated by the state + machine. + + Transition methods may raise an `EOFError` to cut processing short. + + There are two implicit transitions, and corresponding transition methods + are defined: `bof()` handles the beginning-of-file, and `eof()` handles + the end-of-file. These methods have non-standard signatures and return + values. `bof()` returns the initial context and results, and may be used + to return a header string, or do any other processing needed. `eof()` + should handle any remaining context and wrap things up; it returns the + final processing result. + + Typical applications need only subclass `State` (or a subclass), set the + `patterns` and `initial_transitions` class attributes, and provide + corresponding transition methods. The default object initialization will + take care of constructing the list of transitions. + """ + + patterns = None + """ + {Name: pattern} mapping, used by `make_transition()`. Each pattern may + be a string or a compiled `re` pattern. Override in subclasses. + """ + + initial_transitions = None + """ + A list of transitions to initialize when a `State` is instantiated. + Each entry is either a transition name string, or a (transition name, next + state name) pair. See `make_transitions()`. Override in subclasses. + """ + + nested_sm = None + """ + The `StateMachine` class for handling nested processing. + + If left as ``None``, `nested_sm` defaults to the class of the state's + controlling state machine. Override it in subclasses to avoid the default. + """ + + nested_sm_kwargs = None + """ + Keyword arguments dictionary, passed to the `nested_sm` constructor. + + Two keys must have entries in the dictionary: + + - Key 'state_classes' must be set to a list of `State` classes. + - Key 'initial_state' must be set to the name of the initial state class. + + If `nested_sm_kwargs` is left as ``None``, 'state_classes' defaults to the + class of the current state, and 'initial_state' defaults to the name of + the class of the current state. Override in subclasses to avoid the + defaults. + """ + + def init(self, state_machine, debug=0): + """ + Initialize a `State` object; make & add initial transitions. + + Parameters: + + - `statemachine`: the controlling `StateMachine` object. + - `debug`: a boolean; produce verbose output if true (nonzero). + """ + + self.transition_order = [] + """A list of transition names in search order.""" + + self.transitions = {} + """ + A mapping of transition names to 3-tuples containing + (compiled_pattern, transition_method, next_state_name). Initialized as + an instance attribute dynamically (instead of as a class attribute) + because it may make forward references to patterns and methods in this + or other classes. + """ + + self.add_initial_transitions() + + self.state_machine = state_machine + """A reference to the controlling `StateMachine` object.""" + + self.debug = debug + """Debugging mode on/off.""" + + if self.nested_sm is None: + self.nested_sm = self.state_machine.class + if self.nested_sm_kwargs is None: + self.nested_sm_kwargs = {'state_classes': [self.class], + 'initial_state': self.class.name} + + def runtime_init(self): + """ + Initialize this `State` before running the state machine; called from + `self.state_machine.run()`. + """ + pass + + def unlink(self): + """Remove circular references to objects no longer required.""" + self.state_machine = None + + def add_initial_transitions(self): + """Make and add transitions listed in `self.initial_transitions`.""" + if self.initial_transitions: + names, transitions = self.make_transitions( + self.initial_transitions) + self.add_transitions(names, transitions) + + def add_transitions(self, names, transitions): + """ + Add a list of transitions to the start of the transition list. + + Parameters: + + - `names`: a list of transition names. + - `transitions`: a mapping of names to transition tuples. + + Exceptions: `DuplicateTransitionError`, `UnknownTransitionError`. + """ + for name in names: + if self.transitions.has_key(name): + raise DuplicateTransitionError(name) + if not transitions.has_key(name): + raise UnknownTransitionError(name) + self.transition_order[:0] = names + self.transitions.update(transitions) + + def add_transition(self, name, transition): + """ + Add a transition to the start of the transition list. + + Parameter `transition`: a ready-made transition 3-tuple. + + Exception: `DuplicateTransitionError`. + """ + if self.transitions.has_key(name): + raise DuplicateTransitionError(name) + self.transition_order[:0] = [name] + self.transitions[name] = transition + + def remove_transition(self, name): + """ + Remove a transition by `name`. + + Exception: `UnknownTransitionError`. + """ + try: + del self.transitions[name] + self.transition_order.remove(name) + except: + raise UnknownTransitionError(name) + + def make_transition(self, name, next_state=None): + """ + Make & return a transition tuple based on `name`. + + This is a convenience function to simplify transition creation. + + Parameters: + + - `name`: a string, the name of the transition pattern & method. This + `State` object must have a method called '`name`', and a dictionary + `self.patterns` containing a key '`name`'. + - `next_state`: a string, the name of the next `State` object for this + transition. A value of ``None`` (or absent) implies no state change + (i.e., continue with the same state). + + Exceptions: `TransitionPatternNotFound`, `TransitionMethodNotFound`. + """ + if next_state is None: + next_state = self.class.name + try: + pattern = self.patterns[name] + if not hasattr(pattern, 'match'): + pattern = re.compile(pattern) + except KeyError: + raise TransitionPatternNotFound( + '%s.patterns[%r]' % (self.class.name, name)) + try: + method = getattr(self, name) + except AttributeError: + raise TransitionMethodNotFound( + '%s.%s' % (self.class.name, name)) + return (pattern, method, next_state) + + def make_transitions(self, name_list): + """ + Return a list of transition names and a transition mapping. + + Parameter `name_list`: a list, where each entry is either a transition + name string, or a 1- or 2-tuple (transition name, optional next state + name). + """ + stringtype = type('') + names = [] + transitions = {} + for namestate in name_list: + if type(namestate) is stringtype: + transitions[namestate] = self.make_transition(namestate) + names.append(namestate) + else: + transitions[namestate[0]] = self.make_transition(namestate) + names.append(namestate[0]) + return names, transitions + + def no_match(self, context, transitions): + """ + Called when there is no match from `StateMachine.check_line()`. + + Return the same values returned by transition methods: + + - context: unchanged; + - next state name: ``None``; + - empty result list. + + Override in subclasses to catch this event. + """ + return context, None, [] + + def bof(self, context): + """ + Handle beginning-of-file. Return unchanged `context`, empty result. + + Override in subclasses. + + Parameter `context`: application-defined storage. + """ + return context, [] + + def eof(self, context): + """ + Handle end-of-file. Return empty result. + + Override in subclasses. + + Parameter `context`: application-defined storage. + """ + return [] + + def nop(self, match, context, next_state): + """ + A "do nothing" transition method. + + Return unchanged `context` & `next_state`, empty result. Useful for + simple state changes (actionless transitions). + """ + return context, next_state, [] + + +class StateMachineWS(StateMachine): + + """ + `StateMachine` subclass specialized for whitespace recognition. + + There are three methods provided for extracting indented text blocks: + + - `get_indented()`: use when the indent is unknown. + - `get_known_indented()`: use when the indent is known for all lines. + - `get_first_known_indented()`: use when only the first line's indent is + known. + """ + + def get_indented(self, until_blank=0, strip_indent=1): + """ + Return a block of indented lines of text, and info. + + Extract an indented block where the indent is unknown for all lines. + + :Parameters: + - `until_blank`: Stop collecting at the first blank line if true + (1). + - `strip_indent`: Strip common leading indent if true (1, + default). + + :Return: + - the indented block (a list of lines of text), + - its indent, + - its first line offset from BOF, and + - whether or not it finished with a blank line. + """ + offset = self.abs_line_offset() + indented, indent, blank_finish = self.input_lines.get_indented( + self.line_offset, until_blank, strip_indent) + if indented: + self.next_line(len(indented) - 1) # advance to last indented line + while indented and not indented[0].strip(): + indented.trim_start() + offset += 1 + return indented, indent, offset, blank_finish + + def get_known_indented(self, indent, until_blank=0, strip_indent=1): + """ + Return an indented block and info. + + Extract an indented block where the indent is known for all lines. + Starting with the current line, extract the entire text block with at + least `indent` indentation (which must be whitespace, except for the + first line). + + :Parameters: + - `indent`: The number of indent columns/characters. + - `until_blank`: Stop collecting at the first blank line if true + (1). + - `strip_indent`: Strip `indent` characters of indentation if true + (1, default). + + :Return: + - the indented block, + - its first line offset from BOF, and + - whether or not it finished with a blank line. + """ + offset = self.abs_line_offset() + indented, indent, blank_finish = self.input_lines.get_indented( + self.line_offset, until_blank, strip_indent, + block_indent=indent) + self.next_line(len(indented) - 1) # advance to last indented line + while indented and not indented[0].strip(): + indented.trim_start() + offset += 1 + return indented, offset, blank_finish + + def get_first_known_indented(self, indent, until_blank=0, strip_indent=1, + strip_top=1): + """ + Return an indented block and info. + + Extract an indented block where the indent is known for the first line + and unknown for all other lines. + + :Parameters: + - `indent`: The first line's indent (# of columns/characters). + - `until_blank`: Stop collecting at the first blank line if true + (1). + - `strip_indent`: Strip `indent` characters of indentation if true + (1, default). + - `strip_top`: Strip blank lines from the beginning of the block. + + :Return: + - the indented block, + - its indent, + - its first line offset from BOF, and + - whether or not it finished with a blank line. + """ + offset = self.abs_line_offset() + indented, indent, blank_finish = self.input_lines.get_indented( + self.line_offset, until_blank, strip_indent, + first_indent=indent) + self.next_line(len(indented) - 1) # advance to last indented line + if strip_top: + while indented and not indented[0].strip(): + indented.trim_start() + offset += 1 + return indented, indent, offset, blank_finish + + +class StateWS(State): + + """ + State superclass specialized for whitespace (blank lines & indents). + + Use this class with `StateMachineWS`. The transitions 'blank' (for blank + lines) and 'indent' (for indented text blocks) are added automatically, + before any other transitions. The transition method `blank()` handles + blank lines and `indent()` handles nested indented blocks. Indented + blocks trigger a new state machine to be created by `indent()` and run. + The class of the state machine to be created is in `indent_sm`, and the + constructor keyword arguments are in the dictionary `indent_sm_kwargs`. + + The methods `known_indent()` and `firstknown_indent()` are provided for + indented blocks where the indent (all lines' and first line's only, + respectively) is known to the transition method, along with the attributes + `known_indent_sm` and `known_indent_sm_kwargs`. Neither transition method + is triggered automatically. + """ + + indent_sm = None + """ + The `StateMachine` class handling indented text blocks. + + If left as ``None``, `indent_sm` defaults to the value of + `State.nested_sm`. Override it in subclasses to avoid the default. + """ + + indent_sm_kwargs = None + """ + Keyword arguments dictionary, passed to the `indent_sm` constructor. + + If left as ``None``, `indent_sm_kwargs` defaults to the value of + `State.nested_sm_kwargs`. Override it in subclasses to avoid the default. + """ + + known_indent_sm = None + """ + The `StateMachine` class handling known-indented text blocks. + + If left as ``None``, `known_indent_sm` defaults to the value of + `indent_sm`. Override it in subclasses to avoid the default. + """ + + known_indent_sm_kwargs = None + """ + Keyword arguments dictionary, passed to the `known_indent_sm` constructor. + + If left as ``None``, `known_indent_sm_kwargs` defaults to the value of + `indent_sm_kwargs`. Override it in subclasses to avoid the default. + """ + + ws_patterns = {'blank': ' *$', + 'indent': ' +'} + """Patterns for default whitespace transitions. May be overridden in + subclasses.""" + + ws_initial_transitions = ('blank', 'indent') + """Default initial whitespace transitions, added before those listed in + `State.initial_transitions`. May be overridden in subclasses.""" + + def init(self, state_machine, debug=0): + """ + Initialize a `StateSM` object; extends `State.init()`. + + Check for indent state machine attributes, set defaults if not set. + """ + State.init(self, state_machine, debug) + if self.indent_sm is None: + self.indent_sm = self.nested_sm + if self.indent_sm_kwargs is None: + self.indent_sm_kwargs = self.nested_sm_kwargs + if self.known_indent_sm is None: + self.known_indent_sm = self.indent_sm + if self.known_indent_sm_kwargs is None: + self.known_indent_sm_kwargs = self.indent_sm_kwargs + + def add_initial_transitions(self): + """ + Add whitespace-specific transitions before those defined in subclass. + + Extends `State.add_initial_transitions()`. + """ + State.add_initial_transitions(self) + if self.patterns is None: + self.patterns = {} + self.patterns.update(self.ws_patterns) + names, transitions = self.make_transitions( + self.ws_initial_transitions) + self.add_transitions(names, transitions) + + def blank(self, match, context, next_state): + """Handle blank lines. Does nothing. Override in subclasses.""" + return self.nop(match, context, next_state) + + def indent(self, match, context, next_state): + """ + Handle an indented text block. Extend or override in subclasses. + + Recursively run the registered state machine for indented blocks + (`self.indent_sm`). + """ + indented, indent, line_offset, blank_finish = \ + self.state_machine.get_indented() + sm = self.indent_sm(debug=self.debug, self.indent_sm_kwargs) + results = sm.run(indented, input_offset=line_offset) + return context, next_state, results + + def known_indent(self, match, context, next_state): + """ + Handle a known-indent text block. Extend or override in subclasses. + + Recursively run the registered state machine for known-indent indented + blocks (`self.known_indent_sm`). The indent is the length of the + match, ``match.end()``. + """ + indented, line_offset, blank_finish = \ + self.state_machine.get_known_indented(match.end()) + sm = self.known_indent_sm(debug=self.debug, + self.known_indent_sm_kwargs) + results = sm.run(indented, input_offset=line_offset) + return context, next_state, results + + def first_known_indent(self, match, context, next_state): + """ + Handle an indented text block (first line's indent known). + + Extend or override in subclasses. + + Recursively run the registered state machine for known-indent indented + blocks (`self.known_indent_sm`). The indent is the length of the + match, ``match.end()``. + """ + indented, line_offset, blank_finish = \ + self.state_machine.get_first_known_indented(match.end()) + sm = self.known_indent_sm(debug=self.debug, + self.known_indent_sm_kwargs) + results = sm.run(indented, input_offset=line_offset) + return context, next_state, results + + +class _SearchOverride: + + """ + Mix-in class to override `StateMachine` regular expression behavior. + + Changes regular expression matching, from the default `re.match()` + (succeeds only if the pattern matches at the start of `self.line`) to + `re.search()` (succeeds if the pattern matches anywhere in `self.line`). + When subclassing a `StateMachine`, list this class first** in the + inheritance list of the class definition. + """ + + def match(self, pattern): + """ + Return the result of a regular expression search. + + Overrides `StateMachine.match()`. + + Parameter `pattern`: `re` compiled regular expression. + """ + return pattern.search(self.line) + + +class SearchStateMachine(_SearchOverride, StateMachine): + """`StateMachine` which uses `re.search()` instead of `re.match()`.""" + pass + + +class SearchStateMachineWS(_SearchOverride, StateMachineWS): + """`StateMachineWS` which uses `re.search()` instead of `re.match()`.""" + pass + + +class ViewList: + + """ + List with extended functionality: slices of ViewList objects are child + lists, linked to their parents. Changes made to a child list also affect + the parent list. A child list is effectively a "view" (in the SQL sense) + of the parent list. Changes to parent lists, however, do not affect + active child lists. If a parent list is changed, any active child lists + should be recreated. + + The start and end of the slice can be trimmed using the `trim_start()` and + `trim_end()` methods, without affecting the parent list. The link between + child and parent lists can be broken by calling `disconnect()` on the + child list. + + Also, ViewList objects keep track of the source & offset of each item. + This information is accessible via the `source()`, `offset()`, and + `info()` methods. + """ + + def init(self, initlist=None, source=None, items=None, + parent=None, parent_offset=None): + self.data = [] + """The actual list of data, flattened from various sources.""" + + self.items = [] + """A list of (source, offset) pairs, same length as `self.data`: the + source of each line and the offset of each line from the beginning of + its source.""" + + self.parent = parent + """The parent list.""" + + self.parent_offset = parent_offset + """Offset of this list from the beginning of the parent list.""" + + if isinstance(initlist, ViewList): + self.data = initlist.data[:] + self.items = initlist.items[:] + elif initlist is not None: + self.data = list(initlist) + if items: + self.items = items + else: + self.items = [(source, i) for i in range(len(initlist))] + assert len(self.data) == len(self.items), 'data mismatch' + + def str(self): + return str(self.data) + + def repr(self): + return '%s(%s, items=%s)' % (self.class.name, + self.data, self.items) + + def lt(self, other): return self.data < self.cast(other) + def le(self, other): return self.data <= self.cast(other) + def eq(self, other): return self.data == self.cast(other) + def ne(self, other): return self.data != self.cast(other) + def gt(self, other): return self.data > self.cast(other) + def ge(self, other): return self.data >= self.cast(other) + def cmp(self, other): return cmp(self.data, self.cast(other)) + + def cast(self, other): + if isinstance(other, ViewList): + return other.data + else: + return other + + def contains(self, item): return item in self.data + def len(self): return len(self.data) + + # The getitem()/setitem() methods check whether the index + # is a slice first, since native list objects start supporting + # them directly in Python 2.3 (no exception is raised when + # indexing a list with a slice object; they just work). + + def getitem(self, i): + if isinstance(i, types.SliceType): + assert i.step in (None, 1), 'cannot handle slice with stride' + return self.class(self.data[i.start:i.stop], + items=self.items[i.start:i.stop], + parent=self, parent_offset=i.start) + else: + return self.data[i] + + def setitem(self, i, item): + if isinstance(i, types.SliceType): + assert i.step in (None, 1), 'cannot handle slice with stride' + if not isinstance(item, ViewList): + raise TypeError('assigning non-ViewList to ViewList slice') + self.data[i.start:i.stop] = item.data + self.items[i.start:i.stop] = item.items + assert len(self.data) == len(self.items), 'data mismatch' + if self.parent: + self.parent[i.start + self.parent_offset + : i.stop + self.parent_offset] = item + else: + self.data[i] = item + if self.parent: + self.parent[i + self.parent_offset] = item + + def delitem(self, i): + try: + del self.data[i] + del self.items[i] + if self.parent: + del self.parent[i + self.parent_offset] + except TypeError: + assert i.step is None, 'cannot handle slice with stride' + del self.data[i.start:i.stop] + del self.items[i.start:i.stop] + if self.parent: + del self.parent[i.start + self.parent_offset + : i.stop + self.parent_offset] + + def add(self, other): + if isinstance(other, ViewList): + return self.class(self.data + other.data, + items=(self.items + other.items)) + else: + raise TypeError('adding non-ViewList to a ViewList') + + def radd(self, other): + if isinstance(other, ViewList): + return self.class(other.data + self.data, + items=(other.items + self.items)) + else: + raise TypeError('adding ViewList to a non-ViewList') + + def iadd(self, other): + if isinstance(other, ViewList): + self.data += other.data + else: + raise TypeError('argument to += must be a ViewList') + return self + + def mul(self, n): + return self.class(self.data * n, items=(self.items * n)) + + rmul = mul + + def imul(self, n): + self.data = n + self.items = n + return self + + def extend(self, other): + if not isinstance(other, ViewList): + raise TypeError('extending a ViewList with a non-ViewList') + if self.parent: + self.parent.insert(len(self.data) + self.parent_offset, other) + self.data.extend(other.data) + self.items.extend(other.items) + + def append(self, item, source=None, offset=0): + if source is None: + self.extend(item) + else: + if self.parent: + self.parent.insert(len(self.data) + self.parent_offset, item, + source, offset) + self.data.append(item) + self.items.append((source, offset)) + + def insert(self, i, item, source=None, offset=0): + if source is None: + if not isinstance(item, ViewList): + raise TypeError('inserting non-ViewList with no source given') + self.data[i:i] = item.data + self.items[i:i] = item.items + if self.parent: + index = (len(self.data) + i) % len(self.data) + self.parent.insert(index + self.parent_offset, item) + else: + self.data.insert(i, item) + self.items.insert(i, (source, offset)) + if self.parent: + index = (len(self.data) + i) % len(self.data) + self.parent.insert(index + self.parent_offset, item, + source, offset) + + def pop(self, i=-1): + if self.parent: + index = (len(self.data) + i) % len(self.data) + self.parent.pop(index + self.parent_offset) + self.items.pop(i) + return self.data.pop(i) + + def trim_start(self, n=1): + """ + Remove items from the start of the list, without touching the parent. + """ + if n > len(self.data): + raise IndexError("Size of trim too large; can't trim %s items " + "from a list of size %s." % (n, len(self.data))) + elif n < 0: + raise IndexError('Trim size must be >= 0.') + del self.data[:n] + del self.items[:n] + if self.parent: + self.parent_offset += n + + def trim_end(self, n=1): + """ + Remove items from the end of the list, without touching the parent. + """ + if n > len(self.data): + raise IndexError("Size of trim too large; can't trim %s items " + "from a list of size %s." % (n, len(self.data))) + elif n < 0: + raise IndexError('Trim size must be >= 0.') + del self.data[-n:] + del self.items[-n:] + + def remove(self, item): + index = self.index(item) + del self[index] + + def count(self, item): return self.data.count(item) + def index(self, item): return self.data.index(item) + + def reverse(self): + self.data.reverse() + self.items.reverse() + self.parent = None + + def sort(self, args): + tmp = zip(self.data, self.items) + tmp.sort(args) + self.data = [entry[0] for entry in tmp] + self.items = [entry[1] for entry in tmp] + self.parent = None + + def info(self, i): + """Return source & offset for index `i`.""" + try: + return self.items[i] + except IndexError: + if i == len(self.data): # Just past the end + return self.items[i - 1][0], None + else: + raise + + def source(self, i): + """Return source for index `i`.""" + return self.info(i)[0] + + def offset(self, i): + """Return offset for index `i`.""" + return self.info(i)[1] + + def disconnect(self): + """Break link between this list and parent list.""" + self.parent = None + + +class StringList(ViewList): + + """A `ViewList` with string-specific methods.""" + + def trim_left(self, length, start=0, end=sys.maxint): + """ + Trim `length` characters off the beginning of each item, in-place, + from index `start` to `end`. No whitespace-checking is done on the + trimmed text. Does not affect slice parent. + """ + self.data[start:end] = [line[length:] + for line in self.data[start:end]] + + def get_text_block(self, start, flush_left=0): + """ + Return a contiguous block of text. + + If `flush_left` is true, raise `UnexpectedIndentationError` if an + indented line is encountered before the text block ends (with a blank + line). + """ + end = start + last = len(self.data) + while end < last: + line = self.data[end] + if not line.strip(): + break + if flush_left and (line[0] == ' '): + source, offset = self.info(end) + raise UnexpectedIndentationError(self[start:end], source, + offset + 1) + end += 1 + return self[start:end] + + def get_indented(self, start=0, until_blank=0, strip_indent=1, + block_indent=None, first_indent=None): + """ + Extract and return a StringList of indented lines of text. + + Collect all lines with indentation, determine the minimum indentation, + remove the minimum indentation from all indented lines (unless + `strip_indent` is false), and return them. All lines up to but not + including the first unindented line will be returned. + + :Parameters: + - `start`: The index of the first line to examine. + - `until_blank`: Stop collecting at the first blank line if true. + - `strip_indent`: Strip common leading indent if true (default). + - `block_indent`: The indent of the entire block, if known. + - `first_indent`: The indent of the first line, if known. + + :Return: + - a StringList of indented lines with mininum indent removed; + - the amount of the indent; + - a boolean: did the indented block finish with a blank line or EOF? + """ + indent = block_indent # start with None if unknown + end = start + if block_indent is not None and first_indent is None: + first_indent = block_indent + if first_indent is not None: + end += 1 + last = len(self.data) + while end < last: + line = self.data[end] + if line and (line[0] != ' ' + or (block_indent is not None + and line[:block_indent].strip())): + # Line not indented or insufficiently indented. + # Block finished properly iff the last indented line blank: + blank_finish = ((end > start) + and not self.data[end - 1].strip()) + break + stripped = line.lstrip() + if not stripped: # blank line + if until_blank: + blank_finish = 1 + break + elif block_indent is None: + line_indent = len(line) - len(stripped) + if indent is None: + indent = line_indent + else: + indent = min(indent, line_indent) + end += 1 + else: + blank_finish = 1 # block ends at end of lines + block = self[start:end] + if first_indent is not None and block: + block.data[0] = block.data[0][first_indent:] + if indent and strip_indent: + block.trim_left(indent, start=(first_indent is not None)) + return block, indent or 0, blank_finish + + def get_2D_block(self, top, left, bottom, right, strip_indent=1): + block = self[top:bottom] + indent = right + for i in range(len(block.data)): + block.data[i] = line = block.data[i][left:right].rstrip() + if line: + indent = min(indent, len(line) - len(line.lstrip())) + if strip_indent and 0 < indent < right: + block.data = [line[indent:] for line in block.data] + return block + + def pad_double_width(self, pad_char): + """ + Pad all double-width characters in self by appending `pad_char` to each. + For East Asian language support. + """ + if hasattr(unicodedata, 'east_asian_width'): + east_asian_width = unicodedata.east_asian_width + else: + return # new in Python 2.4 + for i in range(len(self.data)): + line = self.data[i] + if isinstance(line, types.UnicodeType): + new = [] + for char in line: + new.append(char) + if east_asian_width(char) in 'WF': # 'W'ide & 'F'ull-width + new.append(pad_char) + self.data[i] = ''.join(new) + + def replace(self, old, new): + """Replace all occurrences of substring `old` with `new`.""" + for i in range(len(self.data)): + self.data[i] = self.data[i].replace(old, new) + + +class StateMachineError(Exception): pass +class UnknownStateError(StateMachineError): pass +class DuplicateStateError(StateMachineError): pass +class UnknownTransitionError(StateMachineError): pass +class DuplicateTransitionError(StateMachineError): pass +class TransitionPatternNotFound(StateMachineError): pass +class TransitionMethodNotFound(StateMachineError): pass +class UnexpectedIndentationError(StateMachineError): pass + + +class TransitionCorrection(Exception): + + """ + Raise from within a transition method to switch to another transition. + + Raise with one argument, the new transition name. + """ + + +class StateCorrection(Exception): + + """ + Raise from within a transition method to switch to another state. + + Raise with one or two arguments: new state name, and an optional new + transition name. + """ + + +def string2lines(astring, tab_width=8, convert_whitespace=0, + whitespace=re.compile('[\v\f]')): + """ + Return a list of one-line strings with tabs expanded, no newlines, and + trailing whitespace stripped. + + Each tab is expanded with between 1 and `tab_width` spaces, so that the + next character's index becomes a multiple of `tab_width` (8 by default). + + Parameters: + + - `astring`: a multi-line string. + - `tab_width`: the number of columns between tab stops. + - `convert_whitespace`: convert form feeds and vertical tabs to spaces? + """ + if convert_whitespace: + astring = whitespace.sub(' ', astring) + return [s.expandtabs(tab_width).rstrip() for s in astring.splitlines()] + +def _exception_data(): + """ + Return exception information: + + - the exception's class name; + - the exception object; + - the name of the file containing the offending code; + - the line number of the offending code; + - the function name of the offending code. + """ + type, value, traceback = sys.exc_info() + while traceback.tb_next: + traceback = traceback.tb_next + code = traceback.tb_frame.f_code + return (type.name, value, code.co_filename, traceback.tb_lineno, + code.co_name) diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/transforms/init.py --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/transforms/init.py Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,172 @@ +# $Id: init.py 4975 2007-03-01 18:08:32Z wiemann $ +# Authors: David Goodger ; Ueli Schlaepfer +# Copyright: This module has been placed in the public domain. + +""" +This package contains modules for standard tree transforms available +to Docutils components. Tree transforms serve a variety of purposes: + +- To tie up certain syntax-specific "loose ends" that remain after the + initial parsing of the input plaintext. These transforms are used to + supplement a limited syntax. + +- To automate the internal linking of the document tree (hyperlink + references, footnote references, etc.). + +- To extract useful information from the document tree. These + transforms may be used to construct (for example) indexes and tables + of contents. + +Each transform is an optional step that a Docutils component may +choose to perform on the parsed document. +""" + +docformat = 'reStructuredText' + + +from docutils import languages, ApplicationError, TransformSpec + + +class TransformError(ApplicationError): pass + + +class Transform: + + """ + Docutils transform component abstract base class. + """ + + default_priority = None + """Numerical priority of this transform, 0 through 999 (override).""" + + def init(self, document, startnode=None): + """ + Initial setup for in-place document transforms. + """ + + self.document = document + """The document tree to transform.""" + + self.startnode = startnode + """Node from which to begin the transform. For many transforms which + apply to the document as a whole, `startnode` is not set (i.e. its + value is `None`).""" + + self.language = languages.get_language( + document.settings.language_code) + """Language module local to this document.""" + + def apply(self, kwargs): + """Override to apply the transform to the document tree.""" + raise NotImplementedError('subclass must override this method') + + +class Transformer(TransformSpec): + + """ + Stores transforms (`Transform` classes) and applies them to document + trees. Also keeps track of components by component type name. + """ + + def init(self, document): + self.transforms = [] + """List of transforms to apply. Each item is a 3-tuple: + ``(priority string, transform class, pending node or None)``.""" + + self.unknown_reference_resolvers = [] + """List of hook functions which assist in resolving references""" + + self.document = document + """The `nodes.document` object this Transformer is attached to.""" + + self.applied = [] + """Transforms already applied, in order.""" + + self.sorted = 0 + """Boolean: is `self.tranforms` sorted?""" + + self.components = {} + """Mapping of component type name to component object. Set by + `self.populate_from_components()`.""" + + self.serialno = 0 + """Internal serial number to keep track of the add order of + transforms.""" + + def add_transform(self, transform_class, priority=None, kwargs): + """ + Store a single transform. Use `priority` to override the default. + `kwargs` is a dictionary whose contents are passed as keyword + arguments to the `apply` method of the transform. This can be used to + pass application-specific data to the transform instance. + """ + if priority is None: + priority = transform_class.default_priority + priority_string = self.get_priority_string(priority) + self.transforms.append( + (priority_string, transform_class, None, kwargs)) + self.sorted = 0 + + def add_transforms(self, transform_list): + """Store multiple transforms, with default priorities.""" + for transform_class in transform_list: + priority_string = self.get_priority_string( + transform_class.default_priority) + self.transforms.append( + (priority_string, transform_class, None, {})) + self.sorted = 0 + + def add_pending(self, pending, priority=None): + """Store a transform with an associated `pending` node.""" + transform_class = pending.transform + if priority is None: + priority = transform_class.default_priority + priority_string = self.get_priority_string(priority) + self.transforms.append( + (priority_string, transform_class, pending, {})) + self.sorted = 0 + + def get_priority_string(self, priority): + """ + Return a string, `priority` combined with `self.serialno`. + + This ensures FIFO order on transforms with identical priority. + """ + self.serialno += 1 + return '%03d-%03d' % (priority, self.serialno) + + def populate_from_components(self, components): + """ + Store each component's default transforms, with default priorities. + Also, store components by type name in a mapping for later lookup. + """ + for component in components: + if component is None: + continue + self.add_transforms(component.get_transforms()) + self.components[component.component_type] = component + self.sorted = 0 + # Set up all of the reference resolvers for this transformer. Each + # component of this transformer is able to register its own helper + # functions to help resolve references. + unknown_reference_resolvers = [] + for i in components: + unknown_reference_resolvers.extend(i.unknown_reference_resolvers) + decorated_list = [(f.priority, f) for f in unknown_reference_resolvers] + decorated_list.sort() + self.unknown_reference_resolvers.extend([f[1] for f in decorated_list]) + + def apply_transforms(self): + """Apply all of the stored transforms, in priority order.""" + self.document.reporter.attach_observer( + self.document.note_transform_message) + while self.transforms: + if not self.sorted: + # Unsorted initially, and whenever a transform is added. + self.transforms.sort() + self.transforms.reverse() + self.sorted = 1 + priority, transform_class, pending, kwargs = self.transforms.pop() + transform = transform_class(self.document, startnode=pending) + transform.apply(**kwargs) + self.applied.append((priority, transform_class, pending, kwargs)) diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/transforms/components.py --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/transforms/components.py Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,52 @@ +# $Id: components.py 4564 2006-05-21 20:44:42Z wiemann $ +# Author: David Goodger +# Copyright: This module has been placed in the public domain. + +""" +Docutils component-related transforms. +""" + +docformat = 'reStructuredText' + +import sys +import os +import re +import time +from docutils import nodes, utils +from docutils import ApplicationError, DataError +from docutils.transforms import Transform, TransformError + + +class Filter(Transform): + + """ + Include or exclude elements which depend on a specific Docutils component. + + For use with `nodes.pending` elements. A "pending" element's dictionary + attribute ``details`` must contain the keys "component" and "format". The + value of ``details['component']`` must match the type name of the + component the elements depend on (e.g. "writer"). The value of + ``details['format']`` is the name of a specific format or context of that + component (e.g. "html"). If the matching Docutils component supports that + format or context, the "pending" element is replaced by the contents of + ``details['nodes']`` (a list of nodes); otherwise, the "pending" element + is removed. + + For example, the reStructuredText "meta" directive creates a "pending" + element containing a "meta" element (in ``pending.details['nodes']``). + Only writers (``pending.details['component'] == 'writer'``) supporting the + "html" format (``pending.details['format'] == 'html'``) will include the + "meta" element; it will be deleted from the output of all other writers. + """ + + default_priority = 780 + + def apply(self): + pending = self.startnode + component_type = pending.details['component'] # 'reader' or 'writer' + format = pending.details['format'] + component = self.document.transformer.components[component_type] + if component.supports(format): + pending.replace_self(pending.details['nodes']) + else: + pending.parent.remove(pending) diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/transforms/frontmatter.py --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/transforms/frontmatter.py Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,512 @@ +# $Id: frontmatter.py 4564 2006-05-21 20:44:42Z wiemann $ +# Author: David Goodger, Ueli Schlaepfer +# Copyright: This module has been placed in the public domain. + +""" +Transforms related to the front matter of a document or a section +(information found before the main text): + +- `DocTitle`: Used to transform a lone top level section's title to + the document title, promote a remaining lone top-level section's + title to the document subtitle, and determine the document's title + metadata (document['title']) based on the document title and/or the + "title" setting. + +- `SectionSubTitle`: Used to transform a lone subsection into a + subtitle. + +- `DocInfo`: Used to transform a bibliographic field list into docinfo + elements. +""" + +docformat = 'reStructuredText' + +import re +from docutils import nodes, utils +from docutils.transforms import TransformError, Transform + + +class TitlePromoter(Transform): + + """ + Abstract base class for DocTitle and SectionSubTitle transforms. + """ + + def promote_title(self, node): + """ + Transform the following tree:: + + +
+ + ... + + into :: + + <node> + <title> + ... + + `node` is normally a document. + """ + # `node` must not have a title yet. + assert not (len(node) and isinstance(node[0], nodes.title)) + section, index = self.candidate_index(node) + if index is None: + return None + # Transfer the section's attributes to the node: + node.attributes.update(section.attributes) + # setup_child is called automatically for all nodes. + node[:] = (section[:1] # section title + + node[:index] # everything that was in the + # node before the section + + section[1:]) # everything that was in the section + assert isinstance(node[0], nodes.title) + return 1 + + def promote_subtitle(self, node): + """ + Transform the following node tree:: + + <node> + <title> + <section> + <title> + ... + + into :: + + <node> + <title> + <subtitle> + ... + """ + subsection, index = self.candidate_index(node) + if index is None: + return None + subtitle = nodes.subtitle() + # Transfer the subsection's attributes to the new subtitle: + # This causes trouble with list attributes! To do: Write a + # test case which catches direct access to the `attributes` + # dictionary and/or write a test case which shows problems in + # this particular case. + subtitle.attributes.update(subsection.attributes) + # We're losing the subtitle's attributes here! To do: Write a + # test case which shows this behavior. + # Transfer the contents of the subsection's title to the + # subtitle: + subtitle[:] = subsection[0][:] + node[:] = (node[:1] # title + + [subtitle] + # everything that was before the section: + + node[1:index] + # everything that was in the subsection: + + subsection[1:]) + return 1 + + def candidate_index(self, node): + """ + Find and return the promotion candidate and its index. + + Return (None, None) if no valid candidate was found. + """ + index = node.first_child_not_matching_class( + nodes.PreBibliographic) + if index is None or len(node) > (index + 1) or \ + not isinstance(node[index], nodes.section): + return None, None + else: + return node[index], index + + +class DocTitle(TitlePromoter): + + """ + In reStructuredText_, there is no way to specify a document title + and subtitle explicitly. Instead, we can supply the document title + (and possibly the subtitle as well) implicitly, and use this + two-step transform to "raise" or "promote" the title(s) (and their + corresponding section contents) to the document level. + + 1. If the document contains a single top-level section as its + first non-comment element, the top-level section's title + becomes the document's title, and the top-level section's + contents become the document's immediate contents. The lone + top-level section header must be the first non-comment element + in the document. + + For example, take this input text:: + + ================= + Top-Level Title + ================= + + A paragraph. + + Once parsed, it looks like this:: + + <document> + <section names="top-level title"> + <title> + Top-Level Title + <paragraph> + A paragraph. + + After running the DocTitle transform, we have:: + + <document names="top-level title"> + <title> + Top-Level Title + <paragraph> + A paragraph. + + 2. If step 1 successfully determines the document title, we + continue by checking for a subtitle. + + If the lone top-level section itself contains a single + second-level section as its first non-comment element, that + section's title is promoted to the document's subtitle, and + that section's contents become the document's immediate + contents. Given this input text:: + + ================= + Top-Level Title + ================= + + Second-Level Title + ~~~~~~~~~~~~~~~~~~ + + A paragraph. + + After parsing and running the Section Promotion transform, the + result is:: + + <document names="top-level title"> + <title> + Top-Level Title + <subtitle names="second-level title"> + Second-Level Title + <paragraph> + A paragraph. + + (Note that the implicit hyperlink target generated by the + "Second-Level Title" is preserved on the "subtitle" element + itself.) + + Any comment elements occurring before the document title or + subtitle are accumulated and inserted as the first body elements + after the title(s). + + This transform also sets the document's metadata title + (document['title']). + + .. _reStructuredText: http://docutils.sf.net/rst.html + """ + + default_priority = 320 + + def set_metadata(self): + """ + Set document['title'] metadata title from the following + sources, listed in order of priority: + + * Existing document['title'] attribute. + * "title" setting. + * Document title node (as promoted by promote_title). + """ + if not self.document.hasattr('title'): + if self.document.settings.title is not None: + self.document['title'] = self.document.settings.title + elif len(self.document) and isinstance(self.document[0], nodes.title): + self.document['title'] = self.document[0].astext() + + def apply(self): + if getattr(self.document.settings, 'doctitle_xform', 1): + # promote_(sub)title defined in TitlePromoter base class. + if self.promote_title(self.document): + # If a title has been promoted, also try to promote a + # subtitle. + self.promote_subtitle(self.document) + # Set document['title']. + self.set_metadata() + + +class SectionSubTitle(TitlePromoter): + + """ + This works like document subtitles, but for sections. For example, :: + + <section> + <title> + Title + <section> + <title> + Subtitle + ... + + is transformed into :: + + <section> + <title> + Title + <subtitle> + Subtitle + ... + + For details refer to the docstring of DocTitle. + """ + + default_priority = 350 + + def apply(self): + if not getattr(self.document.settings, 'sectsubtitle_xform', 1): + return + for section in self.document.traverse(nodes.section): + # On our way through the node tree, we are deleting + # sections, but we call self.promote_subtitle for those + # sections nonetheless. To do: Write a test case which + # shows the problem and discuss on Docutils-develop. + self.promote_subtitle(section) + + +class DocInfo(Transform): + + """ + This transform is specific to the reStructuredText_ markup syntax; + see "Bibliographic Fields" in the `reStructuredText Markup + Specification`_ for a high-level description. This transform + should be run after the `DocTitle` transform. + + Given a field list as the first non-comment element after the + document title and subtitle (if present), registered bibliographic + field names are transformed to the corresponding DTD elements, + becoming child elements of the "docinfo" element (except for a + dedication and/or an abstract, which become "topic" elements after + "docinfo"). + + For example, given this document fragment after parsing:: + + <document> + <title> + Document Title + <field_list> + <field> + <field_name> + Author + <field_body> + <paragraph> + A. Name + <field> + <field_name> + Status + <field_body> + <paragraph> + $RCSfile$ + ... + + After running the bibliographic field list transform, the + resulting document tree would look like this:: + + <document> + <title> + Document Title + <docinfo> + <author> + A. Name + <status> + frontmatter.py + ... + + The "Status" field contained an expanded RCS keyword, which is + normally (but optionally) cleaned up by the transform. The sole + contents of the field body must be a paragraph containing an + expanded RCS keyword of the form "$keyword: expansion text $". Any + RCS keyword can be processed in any bibliographic field. The + dollar signs and leading RCS keyword name are removed. Extra + processing is done for the following RCS keywords: + + - "RCSfile" expands to the name of the file in the RCS or CVS + repository, which is the name of the source file with a ",v" + suffix appended. The transform will remove the ",v" suffix. + + - "Date" expands to the format "YYYY/MM/DD hh:mm:ss" (in the UTC + time zone). The RCS Keywords transform will extract just the + date itself and transform it to an ISO 8601 format date, as in + "2000-12-31". + + (Since the source file for this text is itself stored under CVS, + we can't show an example of the "Date" RCS keyword because we + can't prevent any RCS keywords used in this explanation from + being expanded. Only the "RCSfile" keyword is stable; its + expansion text changes only if the file name changes.) + + .. _reStructuredText: http://docutils.sf.net/rst.html + .. _reStructuredText Markup Specification: + http://docutils.sf.net/docs/ref/rst/restructuredtext.html + """ + + default_priority = 340 + + biblio_nodes = { + 'author': nodes.author, + 'authors': nodes.authors, + 'organization': nodes.organization, + 'address': nodes.address, + 'contact': nodes.contact, + 'version': nodes.version, + 'revision': nodes.revision, + 'status': nodes.status, + 'date': nodes.date, + 'copyright': nodes.copyright, + 'dedication': nodes.topic, + 'abstract': nodes.topic} + """Canonical field name (lowcased) to node class name mapping for + bibliographic fields (field_list).""" + + def apply(self): + if not getattr(self.document.settings, 'docinfo_xform', 1): + return + document = self.document + index = document.first_child_not_matching_class( + nodes.PreBibliographic) + if index is None: + return + candidate = document[index] + if isinstance(candidate, nodes.field_list): + biblioindex = document.first_child_not_matching_class( + (nodes.Titular, nodes.Decorative)) + nodelist = self.extract_bibliographic(candidate) + del document[index] # untransformed field list (candidate) + document[biblioindex:biblioindex] = nodelist + + def extract_bibliographic(self, field_list): + docinfo = nodes.docinfo() + bibliofields = self.language.bibliographic_fields + labels = self.language.labels + topics = {'dedication': None, 'abstract': None} + for field in field_list: + try: + name = field[0][0].astext() + normedname = nodes.fully_normalize_name(name) + if not (len(field) == 2 and bibliofields.has_key(normedname) + and self.check_empty_biblio_field(field, name)): + raise TransformError + canonical = bibliofields[normedname] + biblioclass = self.biblio_nodes[canonical] + if issubclass(biblioclass, nodes.TextElement): + if not self.check_compound_biblio_field(field, name): + raise TransformError + utils.clean_rcs_keywords( + field[1][0], self.rcs_keyword_substitutions) + docinfo.append(biblioclass('', '', field[1][0])) + elif issubclass(biblioclass, nodes.authors): + self.extract_authors(field, name, docinfo) + elif issubclass(biblioclass, nodes.topic): + if topics[canonical]: + field[-1] += self.document.reporter.warning( + 'There can only be one "%s" field.' % name, + base_node=field) + raise TransformError + title = nodes.title(name, labels[canonical]) + topics[canonical] = biblioclass( + '', title, classes=[canonical], field[1].children) + else: + docinfo.append(biblioclass('', field[1].children)) + except TransformError: + if len(field[-1]) == 1 \ + and isinstance(field[-1][0], nodes.paragraph): + utils.clean_rcs_keywords( + field[-1][0], self.rcs_keyword_substitutions) + docinfo.append(field) + nodelist = [] + if len(docinfo) != 0: + nodelist.append(docinfo) + for name in ('dedication', 'abstract'): + if topics[name]: + nodelist.append(topics[name]) + return nodelist + + def check_empty_biblio_field(self, field, name): + if len(field[-1]) < 1: + field[-1] += self.document.reporter.warning( + 'Cannot extract empty bibliographic field "%s".' % name, + base_node=field) + return None + return 1 + + def check_compound_biblio_field(self, field, name): + if len(field[-1]) > 1: + field[-1] += self.document.reporter.warning( + 'Cannot extract compound bibliographic field "%s".' % name, + base_node=field) + return None + if not isinstance(field[-1][0], nodes.paragraph): + field[-1] += self.document.reporter.warning( + 'Cannot extract bibliographic field "%s" containing ' + 'anything other than a single paragraph.' % name, + base_node=field) + return None + return 1 + + rcs_keyword_substitutions = [ + (re.compile(r'\$' r'Date: (\d\d\d\d)[-/](\d\d)[-/](\d\d)[ T][\d:]+' + r'[^$] \$', re.IGNORECASE), r'\1-\2-\3'), + (re.compile(r'\$' r'RCSfile: (.+),v \$', re.IGNORECASE), r'\1'), + (re.compile(r'\$[a-zA-Z]+: (.+) \$'), r'\1'),] + + def extract_authors(self, field, name, docinfo): + try: + if len(field[1]) == 1: + if isinstance(field[1][0], nodes.paragraph): + authors = self.authors_from_one_paragraph(field) + elif isinstance(field[1][0], nodes.bullet_list): + authors = self.authors_from_bullet_list(field) + else: + raise TransformError + else: + authors = self.authors_from_paragraphs(field) + authornodes = [nodes.author('', '', author) + for author in authors if author] + if len(authornodes) >= 1: + docinfo.append(nodes.authors('', authornodes)) + else: + raise TransformError + except TransformError: + field[-1] += self.document.reporter.warning( + 'Bibliographic field "%s" incompatible with extraction: ' + 'it must contain either a single paragraph (with authors ' + 'separated by one of "%s"), multiple paragraphs (one per ' + 'author), or a bullet list with one paragraph (one author) ' + 'per item.' + % (name, ''.join(self.language.author_separators)), + base_node=field) + raise + + def authors_from_one_paragraph(self, field): + text = field[1][0].astext().strip() + if not text: + raise TransformError + for authorsep in self.language.author_separators: + authornames = text.split(authorsep) + if len(authornames) > 1: + break + authornames = [author.strip() for author in authornames] + authors = [[nodes.Text(author)] for author in authornames if author] + return authors + + def authors_from_bullet_list(self, field): + authors = [] + for item in field[1][0]: + if len(item) != 1 or not isinstance(item[0], nodes.paragraph): + raise TransformError + authors.append(item[0].children) + if not authors: + raise TransformError + return authors + + def authors_from_paragraphs(self, field): + for item in field[1]: + if not isinstance(item, nodes.paragraph): + raise TransformError + authors = [item.children for item in field[1]] + return authors diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/transforms/misc.py --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/transforms/misc.py Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,143 @@ +# $Id: misc.py 4564 2006-05-21 20:44:42Z wiemann $ +# Author: David Goodger <goodger@python.org> +# Copyright: This module has been placed in the public domain. + +""" +Miscellaneous transforms. +""" + +docformat = 'reStructuredText' + +from docutils import nodes +from docutils.transforms import Transform, TransformError + + +class CallBack(Transform): + + """ + Inserts a callback into a document. The callback is called when the + transform is applied, which is determined by its priority. + + For use with `nodes.pending` elements. Requires a ``details['callback']`` + entry, a bound method or function which takes one parameter: the pending + node. Other data can be stored in the ``details`` attribute or in the + object hosting the callback method. + """ + + default_priority = 990 + + def apply(self): + pending = self.startnode + pending.details['callback'](pending) + pending.parent.remove(pending) + + +class ClassAttribute(Transform): + + """ + Move the "class" attribute specified in the "pending" node into the + immediately following non-comment element. + """ + + default_priority = 210 + + def apply(self): + pending = self.startnode + parent = pending.parent + child = pending + while parent: + # Check for appropriate following siblings: + for index in range(parent.index(child) + 1, len(parent)): + element = parent[index] + if (isinstance(element, nodes.Invisible) or + isinstance(element, nodes.system_message)): + continue + element['classes'] += pending.details['class'] + pending.parent.remove(pending) + return + else: + # At end of section or container; apply to sibling + child = parent + parent = parent.parent + error = self.document.reporter.error( + 'No suitable element following "%s" directive' + % pending.details['directive'], + nodes.literal_block(pending.rawsource, pending.rawsource), + line=pending.line) + pending.replace_self(error) + + +class Transitions(Transform): + + """ + Move transitions at the end of sections up the tree. Complain + on transitions after a title, at the beginning or end of the + document, and after another transition. + + For example, transform this:: + + <section> + ... + <transition> + <section> + ... + + into this:: + + <section> + ... + <transition> + <section> + ... + """ + + default_priority = 830 + + def apply(self): + for node in self.document.traverse(nodes.transition): + self.visit_transition(node) + + def visit_transition(self, node): + index = node.parent.index(node) + error = None + if (index == 0 or + isinstance(node.parent[0], nodes.title) and + (index == 1 or + isinstance(node.parent[1], nodes.subtitle) and + index == 2)): + assert (isinstance(node.parent, nodes.document) or + isinstance(node.parent, nodes.section)) + error = self.document.reporter.error( + 'Document or section may not begin with a transition.', + line=node.line) + elif isinstance(node.parent[index - 1], nodes.transition): + error = self.document.reporter.error( + 'At least one body element must separate transitions; ' + 'adjacent transitions are not allowed.', line=node.line) + if error: + # Insert before node and update index. + node.parent.insert(index, error) + index += 1 + assert index < len(node.parent) + if index != len(node.parent) - 1: + # No need to move the node. + return + # Node behind which the transition is to be moved. + sibling = node + # While sibling is the last node of its parent. + while index == len(sibling.parent) - 1: + sibling = sibling.parent + # If sibling is the whole document (i.e. it has no parent). + if sibling.parent is None: + # Transition at the end of document. Do not move the + # transition up, and place an error behind. + error = self.document.reporter.error( + 'Document may not end with a transition.', + line=node.line) + node.parent.insert(node.parent.index(node) + 1, error) + return + index = sibling.parent.index(sibling) + # Remove the original transition node. + node.parent.remove(node) + # Insert the transition after the sibling. + sibling.parent.insert(index + 1, node) diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/transforms/parts.py --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/transforms/parts.py Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,164 @@ +# $Id: parts.py 4891 2007-01-22 08:35:57Z wiemann $ +# Authors: David Goodger <goodger@python.org>; Ueli Schlaepfer; Dmitry Jemerov +# Copyright: This module has been placed in the public domain. + +""" +Transforms related to document parts. +""" + +docformat = 'reStructuredText' + + +import re +import sys +from docutils import nodes, utils +from docutils.transforms import TransformError, Transform + + +class SectNum(Transform): + + """ + Automatically assigns numbers to the titles of document sections. + + It is possible to limit the maximum section level for which the numbers + are added. For those sections that are auto-numbered, the "autonum" + attribute is set, informing the contents table generator that a different + form of the TOC should be used. + """ + + default_priority = 710 + """Should be applied before `Contents`.""" + + def apply(self): + self.maxdepth = self.startnode.details.get('depth', sys.maxint) + self.startvalue = self.startnode.details.get('start', 1) + self.prefix = self.startnode.details.get('prefix', '') + self.suffix = self.startnode.details.get('suffix', '') + self.startnode.parent.remove(self.startnode) + if self.document.settings.sectnum_xform: + self.update_section_numbers(self.document) + + def update_section_numbers(self, node, prefix=(), depth=0): + depth += 1 + if prefix: + sectnum = 1 + else: + sectnum = self.startvalue + for child in node: + if isinstance(child, nodes.section): + numbers = prefix + (str(sectnum),) + title = child[0] + # Use for spacing: + generated = nodes.generated( + '', (self.prefix + '.'.join(numbers) + self.suffix + + u'\u00a0' * 3), + classes=['sectnum']) + title.insert(0, generated) + title['auto'] = 1 + if depth < self.maxdepth: + self.update_section_numbers(child, numbers, depth) + sectnum += 1 + + +class Contents(Transform): + + """ + This transform generates a table of contents from the entire document tree + or from a single branch. It locates "section" elements and builds them + into a nested bullet list, which is placed within a "topic" created by the + contents directive. A title is either explicitly specified, taken from + the appropriate language module, or omitted (local table of contents). + The depth may be specified. Two-way references between the table of + contents and section titles are generated (requires Writer support). + + This transform requires a startnode, which which contains generation + options and provides the location for the generated table of contents (the + startnode is replaced by the table of contents "topic"). + """ + + default_priority = 720 + + def apply(self): + details = self.startnode.details + if details.has_key('local'): + startnode = self.startnode.parent.parent + while not (isinstance(startnode, nodes.section) + or isinstance(startnode, nodes.document)): + # find the ToC root: a direct ancestor of startnode + startnode = startnode.parent + else: + startnode = self.document + self.toc_id = self.startnode.parent['ids'][0] + if details.has_key('backlinks'): + self.backlinks = details['backlinks'] + else: + self.backlinks = self.document.settings.toc_backlinks + contents = self.build_contents(startnode) + if len(contents): + self.startnode.replace_self(contents) + else: + self.startnode.parent.parent.remove(self.startnode.parent) + + def build_contents(self, node, level=0): + level += 1 + sections = [sect for sect in node if isinstance(sect, nodes.section)] + entries = [] + autonum = 0 + depth = self.startnode.details.get('depth', sys.maxint) + for section in sections: + title = section[0] + auto = title.get('auto') # May be set by SectNum. + entrytext = self.copy_and_filter(title) + reference = nodes.reference('', '', refid=section['ids'][0], + entrytext) + ref_id = self.document.set_id(reference) + entry = nodes.paragraph('', '', reference) + item = nodes.list_item('', entry) + if ( self.backlinks in ('entry', 'top') + and title.next_node(nodes.reference) is None): + if self.backlinks == 'entry': + title['refid'] = ref_id + elif self.backlinks == 'top': + title['refid'] = self.toc_id + if level < depth: + subsects = self.build_contents(section, level) + item += subsects + entries.append(item) + if entries: + contents = nodes.bullet_list('', entries) + if auto: + contents['classes'].append('auto-toc') + return contents + else: + return [] + + def copy_and_filter(self, node): + """Return a copy of a title, with references, images, etc. removed.""" + visitor = ContentsFilter(self.document) + node.walkabout(visitor) + return visitor.get_entry_text() + + +class ContentsFilter(nodes.TreeCopyVisitor): + + def get_entry_text(self): + return self.get_tree_copy().children + + def visit_citation_reference(self, node): + raise nodes.SkipNode + + def visit_footnote_reference(self, node): + raise nodes.SkipNode + + def visit_image(self, node): + if node.hasattr('alt'): + self.parent.append(nodes.Text(node['alt'])) + raise nodes.SkipNode + + def ignore_node_but_process_children(self, node): + raise nodes.SkipDeparture + + visit_interpreted = ignore_node_but_process_children + visit_problematic = ignore_node_but_process_children + visit_reference = ignore_node_but_process_children + visit_target = ignore_node_but_process_children diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/transforms/peps.py --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/transforms/peps.py Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,304 @@ +# $Id: peps.py 4564 2006-05-21 20:44:42Z wiemann $ +# Author: David Goodger <goodger@python.org> +# Copyright: This module has been placed in the public domain. + +""" +Transforms for PEP processing. + +- `Headers`: Used to transform a PEP's initial RFC-2822 header. It remains a + field list, but some entries get processed. +- `Contents`: Auto-inserts a table of contents. +- `PEPZero`: Special processing for PEP 0. +""" + +docformat = 'reStructuredText' + +import sys +import os +import re +import time +from docutils import nodes, utils, languages +from docutils import ApplicationError, DataError +from docutils.transforms import Transform, TransformError +from docutils.transforms import parts, references, misc + + +class Headers(Transform): + + """ + Process fields in a PEP's initial RFC-2822 header. + """ + + default_priority = 360 + + pep_url = 'pep-%04d' + pep_cvs_url = ('http://svn.python.org/view/checkout' + '/peps/trunk/pep-%04d.txt') + rcs_keyword_substitutions = ( + (re.compile(r'\$' r'RCSfile: (.+),v \$$', re.IGNORECASE), r'\1'), + (re.compile(r'\$[a-zA-Z]+: (.+) \$$'), r'\1'),) + + def apply(self): + if not len(self.document): + # @@@ replace these DataErrors with proper system messages + raise DataError('Document tree is empty.') + header = self.document[0] + if not isinstance(header, nodes.field_list) or \ + 'rfc2822' not in header['classes']: + raise DataError('Document does not begin with an RFC-2822 ' + 'header; it is not a PEP.') + pep = None + for field in header: + if field[0].astext().lower() == 'pep': # should be the first field + value = field[1].astext() + try: + pep = int(value) + cvs_url = self.pep_cvs_url % pep + except ValueError: + pep = value + cvs_url = None + msg = self.document.reporter.warning( + '"PEP" header must contain an integer; "%s" is an ' + 'invalid value.' % pep, base_node=field) + msgid = self.document.set_id(msg) + prb = nodes.problematic(value, value or '(none)', + refid=msgid) + prbid = self.document.set_id(prb) + msg.add_backref(prbid) + if len(field[1]): + field[1][0][:] = [prb] + else: + field[1] += nodes.paragraph('', '', prb) + break + if pep is None: + raise DataError('Document does not contain an RFC-2822 "PEP" ' + 'header.') + if pep == 0: + # Special processing for PEP 0. + pending = nodes.pending(PEPZero) + self.document.insert(1, pending) + self.document.note_pending(pending) + if len(header) < 2 or header[1][0].astext().lower() != 'title': + raise DataError('No title!') + for field in header: + name = field[0].astext().lower() + body = field[1] + if len(body) > 1: + raise DataError('PEP header field body contains multiple ' + 'elements:\n%s' % field.pformat(level=1)) + elif len(body) == 1: + if not isinstance(body[0], nodes.paragraph): + raise DataError('PEP header field body may only contain ' + 'a single paragraph:\n%s' + % field.pformat(level=1)) + elif name == 'last-modified': + date = time.strftime( + '%d-%b-%Y', + time.localtime(os.stat(self.document['source'])[8])) + if cvs_url: + body += nodes.paragraph( + '', '', nodes.reference('', date, refuri=cvs_url)) + else: + # empty + continue + para = body[0] + if name == 'author': + for node in para: + if isinstance(node, nodes.reference): + node.replace_self(mask_email(node)) + elif name == 'discussions-to': + for node in para: + if isinstance(node, nodes.reference): + node.replace_self(mask_email(node, pep)) + elif name in ('replaces', 'replaced-by', 'requires'): + newbody = [] + space = nodes.Text(' ') + for refpep in re.split(',?\s+', body.astext()): + pepno = int(refpep) + newbody.append(nodes.reference( + refpep, refpep, + refuri=(self.document.settings.pep_base_url + + self.pep_url % pepno))) + newbody.append(space) + para[:] = newbody[:-1] # drop trailing space + elif name == 'last-modified': + utils.clean_rcs_keywords(para, self.rcs_keyword_substitutions) + if cvs_url: + date = para.astext() + para[:] = [nodes.reference('', date, refuri=cvs_url)] + elif name == 'content-type': + pep_type = para.astext() + uri = self.document.settings.pep_base_url + self.pep_url % 12 + para[:] = [nodes.reference('', pep_type, refuri=uri)] + elif name == 'version' and len(body): + utils.clean_rcs_keywords(para, self.rcs_keyword_substitutions) + + +class Contents(Transform): + + """ + Insert an empty table of contents topic and a transform placeholder into + the document after the RFC 2822 header. + """ + + default_priority = 380 + + def apply(self): + language = languages.get_language(self.document.settings.language_code) + name = language.labels['contents'] + title = nodes.title('', name) + topic = nodes.topic('', title, classes=['contents']) + name = nodes.fully_normalize_name(name) + if not self.document.has_name(name): + topic['names'].append(name) + self.document.note_implicit_target(topic) + pending = nodes.pending(parts.Contents) + topic += pending + self.document.insert(1, topic) + self.document.note_pending(pending) + + +class TargetNotes(Transform): + + """ + Locate the "References" section, insert a placeholder for an external + target footnote insertion transform at the end, and schedule the + transform to run immediately. + """ + + default_priority = 520 + + def apply(self): + doc = self.document + i = len(doc) - 1 + refsect = copyright = None + while i >= 0 and isinstance(doc[i], nodes.section): + title_words = doc[i][0].astext().lower().split() + if 'references' in title_words: + refsect = doc[i] + break + elif 'copyright' in title_words: + copyright = i + i -= 1 + if not refsect: + refsect = nodes.section() + refsect += nodes.title('', 'References') + doc.set_id(refsect) + if copyright: + # Put the new "References" section before "Copyright": + doc.insert(copyright, refsect) + else: + # Put the new "References" section at end of doc: + doc.append(refsect) + pending = nodes.pending(references.TargetNotes) + refsect.append(pending) + self.document.note_pending(pending, 0) + pending = nodes.pending(misc.CallBack, + details={'callback': self.cleanup_callback}) + refsect.append(pending) + self.document.note_pending(pending, 1) + + def cleanup_callback(self, pending): + """ + Remove an empty "References" section. + + Called after the `references.TargetNotes` transform is complete. + """ + if len(pending.parent) == 2: # <title> and <pending> + pending.parent.parent.remove(pending.parent) + + +class PEPZero(Transform): + + """ + Special processing for PEP 0. + """ + + default_priority =760 + + def apply(self): + visitor = PEPZeroSpecial(self.document) + self.document.walk(visitor) + self.startnode.parent.remove(self.startnode) + + +class PEPZeroSpecial(nodes.SparseNodeVisitor): + + """ + Perform the special processing needed by PEP 0: + + - Mask email addresses. + + - Link PEP numbers in the second column of 4-column tables to the PEPs + themselves. + """ + + pep_url = Headers.pep_url + + def unknown_visit(self, node): + pass + + def visit_reference(self, node): + node.replace_self(mask_email(node)) + + def visit_field_list(self, node): + if 'rfc2822' in node['classes']: + raise nodes.SkipNode + + def visit_tgroup(self, node): + self.pep_table = node['cols'] == 4 + self.entry = 0 + + def visit_colspec(self, node): + self.entry += 1 + if self.pep_table and self.entry == 2: + node['classes'].append('num') + + def visit_row(self, node): + self.entry = 0 + + def visit_entry(self, node): + self.entry += 1 + if self.pep_table and self.entry == 2 and len(node) == 1: + node['classes'].append('num') + p = node[0] + if isinstance(p, nodes.paragraph) and len(p) == 1: + text = p.astext() + try: + pep = int(text) + ref = (self.document.settings.pep_base_url + + self.pep_url % pep) + p[0] = nodes.reference(text, text, refuri=ref) + except ValueError: + pass + + +non_masked_addresses = ('peps@python.org', + 'python-list@python.org', + 'python-dev@python.org') + +def mask_email(ref, pepno=None): + """ + Mask the email address in `ref` and return a replacement node. + + `ref` is returned unchanged if it contains no email address. + + For email addresses such as "user@host", mask the address as "user at + host" (text) to thwart simple email address harvesters (except for those + listed in `non_masked_addresses`). If a PEP number (`pepno`) is given, + return a reference including a default email subject. + """ + if ref.hasattr('refuri') and ref['refuri'].startswith('mailto:'): + if ref['refuri'][8:] in non_masked_addresses: + replacement = ref[0] + else: + replacement_text = ref.astext().replace('@', ' at ') + replacement = nodes.raw('', replacement_text, format='html') + if pepno is None: + return replacement + else: + ref['refuri'] += '?subject=PEP%%20%s' % pepno + ref[:] = [replacement] + return ref + else: + return ref diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/transforms/references.py --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/transforms/references.py Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,896 @@ +# $Id: references.py 5018 2007-03-12 21:39:31Z wiemann $ +# Author: David Goodger <goodger@python.org> +# Copyright: This module has been placed in the public domain. + +""" +Transforms for resolving references. +""" + +docformat = 'reStructuredText' + +import sys +import re +from docutils import nodes, utils +from docutils.transforms import TransformError, Transform + + +class PropagateTargets(Transform): + + """ + Propagate empty internal targets to the next element. + + Given the following nodes:: + + <target ids="internal1" names="internal1"> + <target anonymous="1" ids="id1"> + <target ids="internal2" names="internal2"> + <paragraph> + This is a test. + + PropagateTargets propagates the ids and names of the internal + targets preceding the paragraph to the paragraph itself:: + + <target refid="internal1"> + <target anonymous="1" refid="id1"> + <target refid="internal2"> + <paragraph ids="internal2 id1 internal1" names="internal2 internal1"> + This is a test. + """ + + default_priority = 260 + + def apply(self): + for target in self.document.traverse(nodes.target): + # Only block-level targets without reference (like ".. target:"): + if (isinstance(target.parent, nodes.TextElement) or + (target.hasattr('refid') or target.hasattr('refuri') or + target.hasattr('refname'))): + continue + assert len(target) == 0, 'error: block-level target has children' + next_node = target.next_node(ascend=1) + # Do not move names and ids into Invisibles (we'd lose the + # attributes) or different Targetables (e.g. footnotes). + if (next_node is not None and + ((not isinstance(next_node, nodes.Invisible) and + not isinstance(next_node, nodes.Targetable)) or + isinstance(next_node, nodes.target))): + next_node['ids'].extend(target['ids']) + next_node['names'].extend(target['names']) + # Set defaults for next_node.expect_referenced_by_name/id. + if not hasattr(next_node, 'expect_referenced_by_name'): + next_node.expect_referenced_by_name = {} + if not hasattr(next_node, 'expect_referenced_by_id'): + next_node.expect_referenced_by_id = {} + for id in target['ids']: + # Update IDs to node mapping. + self.document.ids[id] = next_node + # If next_node is referenced by id ``id``, this + # target shall be marked as referenced. + next_node.expect_referenced_by_id[id] = target + for name in target['names']: + next_node.expect_referenced_by_name[name] = target + # If there are any expect_referenced_by_... attributes + # in target set, copy them to next_node. + next_node.expect_referenced_by_name.update( + getattr(target, 'expect_referenced_by_name', {})) + next_node.expect_referenced_by_id.update( + getattr(target, 'expect_referenced_by_id', {})) + # Set refid to point to the first former ID of target + # which is now an ID of next_node. + target['refid'] = target['ids'][0] + # Clear ids and names; they have been moved to + # next_node. + target['ids'] = [] + target['names'] = [] + self.document.note_refid(target) + + +class AnonymousHyperlinks(Transform): + + """ + Link anonymous references to targets. Given:: + + <paragraph> + <reference anonymous="1"> + internal + <reference anonymous="1"> + external + <target anonymous="1" ids="id1"> + <target anonymous="1" ids="id2" refuri="http://external"> + + Corresponding references are linked via "refid" or resolved via "refuri":: + + <paragraph> + <reference anonymous="1" refid="id1"> + text + <reference anonymous="1" refuri="http://external"> + external + <target anonymous="1" ids="id1"> + <target anonymous="1" ids="id2" refuri="http://external"> + """ + + default_priority = 440 + + def apply(self): + anonymous_refs = [] + anonymous_targets = [] + for node in self.document.traverse(nodes.reference): + if node.get('anonymous'): + anonymous_refs.append(node) + for node in self.document.traverse(nodes.target): + if node.get('anonymous'): + anonymous_targets.append(node) + if len(anonymous_refs) \ + != len(anonymous_targets): + msg = self.document.reporter.error( + 'Anonymous hyperlink mismatch: %s references but %s ' + 'targets.\nSee "backrefs" attribute for IDs.' + % (len(anonymous_refs), len(anonymous_targets))) + msgid = self.document.set_id(msg) + for ref in anonymous_refs: + prb = nodes.problematic( + ref.rawsource, ref.rawsource, refid=msgid) + prbid = self.document.set_id(prb) + msg.add_backref(prbid) + ref.replace_self(prb) + return + for ref, target in zip(anonymous_refs, anonymous_targets): + target.referenced = 1 + while 1: + if target.hasattr('refuri'): + ref['refuri'] = target['refuri'] + ref.resolved = 1 + break + else: + if not target['ids']: + # Propagated target. + target = self.document.ids[target['refid']] + continue + ref['refid'] = target['ids'][0] + self.document.note_refid(ref) + break + + +class IndirectHyperlinks(Transform): + + """ + a) Indirect external references:: + + <paragraph> + <reference refname="indirect external"> + indirect external + <target id="id1" name="direct external" + refuri="http://indirect"> + <target id="id2" name="indirect external" + refname="direct external"> + + The "refuri" attribute is migrated back to all indirect targets + from the final direct target (i.e. a target not referring to + another indirect target):: + + <paragraph> + <reference refname="indirect external"> + indirect external + <target id="id1" name="direct external" + refuri="http://indirect"> + <target id="id2" name="indirect external" + refuri="http://indirect"> + + Once the attribute is migrated, the preexisting "refname" attribute + is dropped. + + b) Indirect internal references:: + + <target id="id1" name="final target"> + <paragraph> + <reference refname="indirect internal"> + indirect internal + <target id="id2" name="indirect internal 2" + refname="final target"> + <target id="id3" name="indirect internal" + refname="indirect internal 2"> + + Targets which indirectly refer to an internal target become one-hop + indirect (their "refid" attributes are directly set to the internal + target's "id"). References which indirectly refer to an internal + target become direct internal references:: + + <target id="id1" name="final target"> + <paragraph> + <reference refid="id1"> + indirect internal + <target id="id2" name="indirect internal 2" refid="id1"> + <target id="id3" name="indirect internal" refid="id1"> + """ + + default_priority = 460 + + def apply(self): + for target in self.document.indirect_targets: + if not target.resolved: + self.resolve_indirect_target(target) + self.resolve_indirect_references(target) + + def resolve_indirect_target(self, target): + refname = target.get('refname') + if refname is None: + reftarget_id = target['refid'] + else: + reftarget_id = self.document.nameids.get(refname) + if not reftarget_id: + # Check the unknown_reference_resolvers + for resolver_function in \ + self.document.transformer.unknown_reference_resolvers: + if resolver_function(target): + break + else: + self.nonexistent_indirect_target(target) + return + reftarget = self.document.ids[reftarget_id] + reftarget.note_referenced_by(id=reftarget_id) + if isinstance(reftarget, nodes.target) \ + and not reftarget.resolved and reftarget.hasattr('refname'): + if hasattr(target, 'multiply_indirect'): + #and target.multiply_indirect): + #del target.multiply_indirect + self.circular_indirect_reference(target) + return + target.multiply_indirect = 1 + self.resolve_indirect_target(reftarget) # multiply indirect + del target.multiply_indirect + if reftarget.hasattr('refuri'): + target['refuri'] = reftarget['refuri'] + if target.has_key('refid'): + del target['refid'] + elif reftarget.hasattr('refid'): + target['refid'] = reftarget['refid'] + self.document.note_refid(target) + else: + if reftarget['ids']: + target['refid'] = reftarget_id + self.document.note_refid(target) + else: + self.nonexistent_indirect_target(target) + return + if refname is not None: + del target['refname'] + target.resolved = 1 + + def nonexistent_indirect_target(self, target): + if self.document.nameids.has_key(target['refname']): + self.indirect_target_error(target, 'which is a duplicate, and ' + 'cannot be used as a unique reference') + else: + self.indirect_target_error(target, 'which does not exist') + + def circular_indirect_reference(self, target): + self.indirect_target_error(target, 'forming a circular reference') + + def indirect_target_error(self, target, explanation): + naming = '' + reflist = [] + if target['names']: + naming = '"%s" ' % target['names'][0] + for name in target['names']: + reflist.extend(self.document.refnames.get(name, [])) + for id in target['ids']: + reflist.extend(self.document.refids.get(id, [])) + naming += '(id="%s")' % target['ids'][0] + msg = self.document.reporter.error( + 'Indirect hyperlink target %s refers to target "%s", %s.' + % (naming, target['refname'], explanation), base_node=target) + msgid = self.document.set_id(msg) + for ref in utils.uniq(reflist): + prb = nodes.problematic( + ref.rawsource, ref.rawsource, refid=msgid) + prbid = self.document.set_id(prb) + msg.add_backref(prbid) + ref.replace_self(prb) + target.resolved = 1 + + def resolve_indirect_references(self, target): + if target.hasattr('refid'): + attname = 'refid' + call_method = self.document.note_refid + elif target.hasattr('refuri'): + attname = 'refuri' + call_method = None + else: + return + attval = target[attname] + for name in target['names']: + reflist = self.document.refnames.get(name, []) + if reflist: + target.note_referenced_by(name=name) + for ref in reflist: + if ref.resolved: + continue + del ref['refname'] + ref[attname] = attval + if call_method: + call_method(ref) + ref.resolved = 1 + if isinstance(ref, nodes.target): + self.resolve_indirect_references(ref) + for id in target['ids']: + reflist = self.document.refids.get(id, []) + if reflist: + target.note_referenced_by(id=id) + for ref in reflist: + if ref.resolved: + continue + del ref['refid'] + ref[attname] = attval + if call_method: + call_method(ref) + ref.resolved = 1 + if isinstance(ref, nodes.target): + self.resolve_indirect_references(ref) + + +class ExternalTargets(Transform): + + """ + Given:: + + <paragraph> + <reference refname="direct external"> + direct external + <target id="id1" name="direct external" refuri="http://direct"> + + The "refname" attribute is replaced by the direct "refuri" attribute:: + + <paragraph> + <reference refuri="http://direct"> + direct external + <target id="id1" name="direct external" refuri="http://direct"> + """ + + default_priority = 640 + + def apply(self): + for target in self.document.traverse(nodes.target): + if target.hasattr('refuri'): + refuri = target['refuri'] + for name in target['names']: + reflist = self.document.refnames.get(name, []) + if reflist: + target.note_referenced_by(name=name) + for ref in reflist: + if ref.resolved: + continue + del ref['refname'] + ref['refuri'] = refuri + ref.resolved = 1 + + +class InternalTargets(Transform): + + default_priority = 660 + + def apply(self): + for target in self.document.traverse(nodes.target): + if not target.hasattr('refuri') and not target.hasattr('refid'): + self.resolve_reference_ids(target) + + def resolve_reference_ids(self, target): + """ + Given:: + + <paragraph> + <reference refname="direct internal"> + direct internal + <target id="id1" name="direct internal"> + + The "refname" attribute is replaced by "refid" linking to the target's + "id":: + + <paragraph> + <reference refid="id1"> + direct internal + <target id="id1" name="direct internal"> + """ + for name in target['names']: + refid = self.document.nameids[name] + reflist = self.document.refnames.get(name, []) + if reflist: + target.note_referenced_by(name=name) + for ref in reflist: + if ref.resolved: + continue + del ref['refname'] + ref['refid'] = refid + ref.resolved = 1 + + +class Footnotes(Transform): + + """ + Assign numbers to autonumbered footnotes, and resolve links to footnotes, + citations, and their references. + + Given the following ``document`` as input:: + + <document> + <paragraph> + A labeled autonumbered footnote referece: + <footnote_reference auto="1" id="id1" refname="footnote"> + <paragraph> + An unlabeled autonumbered footnote referece: + <footnote_reference auto="1" id="id2"> + <footnote auto="1" id="id3"> + <paragraph> + Unlabeled autonumbered footnote. + <footnote auto="1" id="footnote" name="footnote"> + <paragraph> + Labeled autonumbered footnote. + + Auto-numbered footnotes have attribute ``auto="1"`` and no label. + Auto-numbered footnote_references have no reference text (they're + empty elements). When resolving the numbering, a ``label`` element + is added to the beginning of the ``footnote``, and reference text + to the ``footnote_reference``. + + The transformed result will be:: + + <document> + <paragraph> + A labeled autonumbered footnote referece: + <footnote_reference auto="1" id="id1" refid="footnote"> + 2 + <paragraph> + An unlabeled autonumbered footnote referece: + <footnote_reference auto="1" id="id2" refid="id3"> + 1 + <footnote auto="1" id="id3" backrefs="id2"> + <label> + 1 + <paragraph> + Unlabeled autonumbered footnote. + <footnote auto="1" id="footnote" name="footnote" backrefs="id1"> + <label> + 2 + <paragraph> + Labeled autonumbered footnote. + + Note that the footnotes are not in the same order as the references. + + The labels and reference text are added to the auto-numbered ``footnote`` + and ``footnote_reference`` elements. Footnote elements are backlinked to + their references via "refids" attributes. References are assigned "id" + and "refid" attributes. + + After adding labels and reference text, the "auto" attributes can be + ignored. + """ + + default_priority = 620 + + autofootnote_labels = None + """Keep track of unlabeled autonumbered footnotes.""" + + symbols = [ + # Entries 1-4 and 6 below are from section 12.51 of + # The Chicago Manual of Style, 14th edition. + '', # asterisk/star + u'\u2020', # dagger † + u'\u2021', # double dagger ‡ + u'\u00A7', # section mark § + u'\u00B6', # paragraph mark (pilcrow) ¶ + # (parallels ['||'] in CMoS) + '#', # number sign + # The entries below were chosen arbitrarily. + u'\u2660', # spade suit ♠ + u'\u2665', # heart suit ♥ + u'\u2666', # diamond suit ♦ + u'\u2663', # club suit ♣ + ] + + def apply(self): + self.autofootnote_labels = [] + startnum = self.document.autofootnote_start + self.document.autofootnote_start = self.number_footnotes(startnum) + self.number_footnote_references(startnum) + self.symbolize_footnotes() + self.resolve_footnotes_and_citations() + + def number_footnotes(self, startnum): + """ + Assign numbers to autonumbered footnotes. + + For labeled autonumbered footnotes, copy the number over to + corresponding footnote references. + """ + for footnote in self.document.autofootnotes: + while 1: + label = str(startnum) + startnum += 1 + if not self.document.nameids.has_key(label): + break + footnote.insert(0, nodes.label('', label)) + for name in footnote['names']: + for ref in self.document.footnote_refs.get(name, []): + ref += nodes.Text(label) + ref.delattr('refname') + assert len(footnote['ids']) == len(ref['ids']) == 1 + ref['refid'] = footnote['ids'][0] + footnote.add_backref(ref['ids'][0]) + self.document.note_refid(ref) + ref.resolved = 1 + if not footnote['names'] and not footnote['dupnames']: + footnote['names'].append(label) + self.document.note_explicit_target(footnote, footnote) + self.autofootnote_labels.append(label) + return startnum + + def number_footnote_references(self, startnum): + """Assign numbers to autonumbered footnote references.""" + i = 0 + for ref in self.document.autofootnote_refs: + if ref.resolved or ref.hasattr('refid'): + continue + try: + label = self.autofootnote_labels[i] + except IndexError: + msg = self.document.reporter.error( + 'Too many autonumbered footnote references: only %s ' + 'corresponding footnotes available.' + % len(self.autofootnote_labels), base_node=ref) + msgid = self.document.set_id(msg) + for ref in self.document.autofootnote_refs[i:]: + if ref.resolved or ref.hasattr('refname'): + continue + prb = nodes.problematic( + ref.rawsource, ref.rawsource, refid=msgid) + prbid = self.document.set_id(prb) + msg.add_backref(prbid) + ref.replace_self(prb) + break + ref += nodes.Text(label) + id = self.document.nameids[label] + footnote = self.document.ids[id] + ref['refid'] = id + self.document.note_refid(ref) + assert len(ref['ids']) == 1 + footnote.add_backref(ref['ids'][0]) + ref.resolved = 1 + i += 1 + + def symbolize_footnotes(self): + """Add symbols indexes to "[]"-style footnotes and references.""" + labels = [] + for footnote in self.document.symbol_footnotes: + reps, index = divmod(self.document.symbol_footnote_start, + len(self.symbols)) + labeltext = self.symbols[index] * (reps + 1) + labels.append(labeltext) + footnote.insert(0, nodes.label('', labeltext)) + self.document.symbol_footnote_start += 1 + self.document.set_id(footnote) + i = 0 + for ref in self.document.symbol_footnote_refs: + try: + ref += nodes.Text(labels[i]) + except IndexError: + msg = self.document.reporter.error( + 'Too many symbol footnote references: only %s ' + 'corresponding footnotes available.' % len(labels), + base_node=ref) + msgid = self.document.set_id(msg) + for ref in self.document.symbol_footnote_refs[i:]: + if ref.resolved or ref.hasattr('refid'): + continue + prb = nodes.problematic( + ref.rawsource, ref.rawsource, refid=msgid) + prbid = self.document.set_id(prb) + msg.add_backref(prbid) + ref.replace_self(prb) + break + footnote = self.document.symbol_footnotes[i] + assert len(footnote['ids']) == 1 + ref['refid'] = footnote['ids'][0] + self.document.note_refid(ref) + footnote.add_backref(ref['ids'][0]) + i += 1 + + def resolve_footnotes_and_citations(self): + """ + Link manually-labeled footnotes and citations to/from their + references. + """ + for footnote in self.document.footnotes: + for label in footnote['names']: + if self.document.footnote_refs.has_key(label): + reflist = self.document.footnote_refs[label] + self.resolve_references(footnote, reflist) + for citation in self.document.citations: + for label in citation['names']: + if self.document.citation_refs.has_key(label): + reflist = self.document.citation_refs[label] + self.resolve_references(citation, reflist) + + def resolve_references(self, note, reflist): + assert len(note['ids']) == 1 + id = note['ids'][0] + for ref in reflist: + if ref.resolved: + continue + ref.delattr('refname') + ref['refid'] = id + assert len(ref['ids']) == 1 + note.add_backref(ref['ids'][0]) + ref.resolved = 1 + note.resolved = 1 + + +class CircularSubstitutionDefinitionError(Exception): pass + + +class Substitutions(Transform): + + """ + Given the following ``document`` as input:: + + <document> + <paragraph> + The + <substitution_reference refname="biohazard"> + biohazard + symbol is deservedly scary-looking. + <substitution_definition name="biohazard"> + <image alt="biohazard" uri="biohazard.png"> + + The ``substitution_reference`` will simply be replaced by the + contents of the corresponding ``substitution_definition``. + + The transformed result will be:: + + <document> + <paragraph> + The + <image alt="biohazard" uri="biohazard.png"> + symbol is deservedly scary-looking. + <substitution_definition name="biohazard"> + <image alt="biohazard" uri="biohazard.png"> + """ + + default_priority = 220 + """The Substitutions transform has to be applied very early, before + `docutils.tranforms.frontmatter.DocTitle` and others.""" + + def apply(self): + defs = self.document.substitution_defs + normed = self.document.substitution_names + subreflist = self.document.traverse(nodes.substitution_reference) + nested = {} + for ref in subreflist: + refname = ref['refname'] + key = None + if defs.has_key(refname): + key = refname + else: + normed_name = refname.lower() + if normed.has_key(normed_name): + key = normed[normed_name] + if key is None: + msg = self.document.reporter.error( + 'Undefined substitution referenced: "%s".' + % refname, base_node=ref) + msgid = self.document.set_id(msg) + prb = nodes.problematic( + ref.rawsource, ref.rawsource, refid=msgid) + prbid = self.document.set_id(prb) + msg.add_backref(prbid) + ref.replace_self(prb) + else: + subdef = defs[key] + parent = ref.parent + index = parent.index(ref) + if (subdef.attributes.has_key('ltrim') + or subdef.attributes.has_key('trim')): + if index > 0 and isinstance(parent[index - 1], + nodes.Text): + parent.replace(parent[index - 1], + parent[index - 1].rstrip()) + if (subdef.attributes.has_key('rtrim') + or subdef.attributes.has_key('trim')): + if (len(parent) > index + 1 + and isinstance(parent[index + 1], nodes.Text)): + parent.replace(parent[index + 1], + parent[index + 1].lstrip()) + subdef_copy = subdef.deepcopy() + try: + # Take care of nested substitution references: + for nested_ref in subdef_copy.traverse( + nodes.substitution_reference): + nested_name = normed[nested_ref['refname'].lower()] + if nested_name in nested.setdefault(nested_name, []): + raise CircularSubstitutionDefinitionError + else: + nested[nested_name].append(key) + subreflist.append(nested_ref) + except CircularSubstitutionDefinitionError: + parent = ref.parent + if isinstance(parent, nodes.substitution_definition): + msg = self.document.reporter.error( + 'Circular substitution definition detected:', + nodes.literal_block(parent.rawsource, + parent.rawsource), + line=parent.line, base_node=parent) + parent.replace_self(msg) + else: + msg = self.document.reporter.error( + 'Circular substitution definition referenced: "%s".' + % refname, base_node=ref) + msgid = self.document.set_id(msg) + prb = nodes.problematic( + ref.rawsource, ref.rawsource, refid=msgid) + prbid = self.document.set_id(prb) + msg.add_backref(prbid) + ref.replace_self(prb) + else: + ref.replace_self(subdef_copy.children) + + +class TargetNotes(Transform): + + """ + Creates a footnote for each external target in the text, and corresponding + footnote references after each reference. + """ + + default_priority = 540 + """The TargetNotes transform has to be applied after `IndirectHyperlinks` + but before `Footnotes`.""" + + + def init(self, document, startnode): + Transform.init(self, document, startnode=startnode) + + self.classes = startnode.details.get('class', []) + + def apply(self): + notes = {} + nodelist = [] + for target in self.document.traverse(nodes.target): + # Only external targets. + if not target.hasattr('refuri'): + continue + names = target['names'] + refs = [] + for name in names: + refs.extend(self.document.refnames.get(name, [])) + if not refs: + continue + footnote = self.make_target_footnote(target['refuri'], refs, + notes) + if not notes.has_key(target['refuri']): + notes[target['refuri']] = footnote + nodelist.append(footnote) + # Take care of anonymous references. + for ref in self.document.traverse(nodes.reference): + if not ref.get('anonymous'): + continue + if ref.hasattr('refuri'): + footnote = self.make_target_footnote(ref['refuri'], [ref], + notes) + if not notes.has_key(ref['refuri']): + notes[ref['refuri']] = footnote + nodelist.append(footnote) + self.startnode.replace_self(nodelist) + + def make_target_footnote(self, refuri, refs, notes): + if notes.has_key(refuri): # duplicate? + footnote = notes[refuri] + assert len(footnote['names']) == 1 + footnote_name = footnote['names'][0] + else: # original + footnote = nodes.footnote() + footnote_id = self.document.set_id(footnote) + # Use uppercase letters and a colon; they can't be + # produced inside names by the parser. + footnote_name = 'TARGET_NOTE: ' + footnote_id + footnote['auto'] = 1 + footnote['names'] = [footnote_name] + footnote_paragraph = nodes.paragraph() + footnote_paragraph += nodes.reference('', refuri, refuri=refuri) + footnote += footnote_paragraph + self.document.note_autofootnote(footnote) + self.document.note_explicit_target(footnote, footnote) + for ref in refs: + if isinstance(ref, nodes.target): + continue + refnode = nodes.footnote_reference( + refname=footnote_name, auto=1) + refnode['classes'] += self.classes + self.document.note_autofootnote_ref(refnode) + self.document.note_footnote_ref(refnode) + index = ref.parent.index(ref) + 1 + reflist = [refnode] + if not utils.get_trim_footnote_ref_space(self.document.settings): + if self.classes: + reflist.insert(0, nodes.inline(text=' ', Classes=self.classes)) + else: + reflist.insert(0, nodes.Text(' ')) + ref.parent.insert(index, reflist) + return footnote + + +class DanglingReferences(Transform): + + """ + Check for dangling references (incl. footnote & citation) and for + unreferenced targets. + """ + + default_priority = 850 + + def apply(self): + visitor = DanglingReferencesVisitor( + self.document, + self.document.transformer.unknown_reference_resolvers) + self.document.walk(visitor) + # After resolving all references, check for unreferenced + # targets: + for target in self.document.traverse(nodes.target): + if not target.referenced: + if target.get('anonymous'): + # If we have unreferenced anonymous targets, there + # is already an error message about anonymous + # hyperlink mismatch; no need to generate another + # message. + continue + if target['names']: + naming = target['names'][0] + elif target['ids']: + naming = target['ids'][0] + else: + # Hack: Propagated targets always have their refid + # attribute set. + naming = target['refid'] + self.document.reporter.info( + 'Hyperlink target "%s" is not referenced.' + % naming, base_node=target) + + +class DanglingReferencesVisitor(nodes.SparseNodeVisitor): + + def init(self, document, unknown_reference_resolvers): + nodes.SparseNodeVisitor.init(self, document) + self.document = document + self.unknown_reference_resolvers = unknown_reference_resolvers + + def unknown_visit(self, node): + pass + + def visit_reference(self, node): + if node.resolved or not node.hasattr('refname'): + return + refname = node['refname'] + id = self.document.nameids.get(refname) + if id is None: + for resolver_function in self.unknown_reference_resolvers: + if resolver_function(node): + break + else: + if self.document.nameids.has_key(refname): + msg = self.document.reporter.error( + 'Duplicate target name, cannot be used as a unique ' + 'reference: "%s".' % (node['refname']), base_node=node) + else: + msg = self.document.reporter.error( + 'Unknown target name: "%s".' % (node['refname']), + base_node=node) + msgid = self.document.set_id(msg) + prb = nodes.problematic( + node.rawsource, node.rawsource, refid=msgid) + prbid = self.document.set_id(prb) + msg.add_backref(prbid) + node.replace_self(prb) + else: + del node['refname'] + node['refid'] = id + self.document.ids[id].note_referenced_by(id=id) + node.resolved = 1 + + visit_footnote_reference = visit_citation_reference = visit_reference diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/transforms/universal.py --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/transforms/universal.py Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,203 @@ +# $Id: universal.py 4913 2007-02-12 04:05:20Z goodger $ +# Authors: David Goodger <goodger@python.org>; Ueli Schlaepfer +# Copyright: This module has been placed in the public domain. + +""" +Transforms needed by most or all documents: + +- `Decorations`: Generate a document's header & footer. +- `Messages`: Placement of system messages stored in + `nodes.document.transform_messages`. +- `TestMessages`: Like `Messages`, used on test runs. +- `FinalReferences`: Resolve remaining references. +""" + +docformat = 'reStructuredText' + +import re +import sys +import time +from docutils import nodes, utils +from docutils.transforms import TransformError, Transform + + +class Decorations(Transform): + + """ + Populate a document's decoration element (header, footer). + """ + + default_priority = 820 + + def apply(self): + header_nodes = self.generate_header() + if header_nodes: + decoration = self.document.get_decoration() + header = decoration.get_header() + header.extend(header_nodes) + footer_nodes = self.generate_footer() + if footer_nodes: + decoration = self.document.get_decoration() + footer = decoration.get_footer() + footer.extend(footer_nodes) + + def generate_header(self): + return None + + def generate_footer(self): + # @@@ Text is hard-coded for now. + # Should be made dynamic (language-dependent). + settings = self.document.settings + if settings.generator or settings.datestamp or settings.source_link \ + or settings.source_url: + text = [] + if settings.source_link and settings._source \ + or settings.source_url: + if settings.source_url: + source = settings.source_url + else: + source = utils.relative_path(settings._destination, + settings._source) + text.extend([ + nodes.reference('', 'View document source', + refuri=source), + nodes.Text('.\n')]) + if settings.datestamp: + datestamp = time.strftime(settings.datestamp, time.gmtime()) + text.append(nodes.Text('Generated on: ' + datestamp + '.\n')) + if settings.generator: + text.extend([ + nodes.Text('Generated by '), + nodes.reference('', 'Docutils', refuri= + 'http://docutils.sourceforge.net/'), + nodes.Text(' from '), + nodes.reference('', 'reStructuredText', refuri='http://' + 'docutils.sourceforge.net/rst.html'), + nodes.Text(' source.\n')]) + return [nodes.paragraph('', '', text)] + else: + return None + + +class ExposeInternals(Transform): + + """ + Expose internal attributes if ``expose_internals`` setting is set. + """ + + default_priority = 840 + + def not_Text(self, node): + return not isinstance(node, nodes.Text) + + def apply(self): + if self.document.settings.expose_internals: + for node in self.document.traverse(self.not_Text): + for att in self.document.settings.expose_internals: + value = getattr(node, att, None) + if value is not None: + node['internal:' + att] = value + + +class Messages(Transform): + + """ + Place any system messages generated after parsing into a dedicated section + of the document. + """ + + default_priority = 860 + + def apply(self): + unfiltered = self.document.transform_messages + threshold = self.document.reporter.report_level + messages = [] + for msg in unfiltered: + if msg['level'] >= threshold and not msg.parent: + messages.append(msg) + if messages: + section = nodes.section(classes=['system-messages']) + # @@@ get this from the language module? + section += nodes.title('', 'Docutils System Messages') + section += messages + self.document.transform_messages[:] = [] + self.document += section + + +class FilterMessages(Transform): + + """ + Remove system messages below verbosity threshold. + """ + + default_priority = 870 + + def apply(self): + for node in self.document.traverse(nodes.system_message): + if node['level'] < self.document.reporter.report_level: + node.parent.remove(node) + + +class TestMessages(Transform): + + """ + Append all post-parse system messages to the end of the document. + + Used for testing purposes. + """ + + default_priority = 880 + + def apply(self): + for msg in self.document.transform_messages: + if not msg.parent: + self.document += msg + + +class StripComments(Transform): + + """ + Remove comment elements from the document tree (only if the + ``strip_comments`` setting is enabled). + """ + + default_priority = 740 + + def apply(self): + if self.document.settings.strip_comments: + for node in self.document.traverse(nodes.comment): + node.parent.remove(node) + + +class StripClassesAndElements(Transform): + + """ + Remove from the document tree all elements with classes in + `self.document.settings.strip_elements_with_classes` and all "classes" + attribute values in `self.document.settings.strip_classes`. + """ + + default_priority = 750 + + def apply(self): + if not (self.document.settings.strip_elements_with_classes + or self.document.settings.strip_classes): + return + # prepare dicts for lookup (not sets, for Python 2.2 compatibility): + self.strip_elements = dict( + [(key, None) + for key in (self.document.settings.strip_elements_with_classes + or [])]) + self.strip_classes = dict( + [(key, None) for key in (self.document.settings.strip_classes + or [])]) + for node in self.document.traverse(self.check_classes): + node.parent.remove(node) + + def check_classes(self, node): + if isinstance(node, nodes.Element): + for class_value in node['classes'][:]: + if class_value in self.strip_classes: + node['classes'].remove(class_value) + if class_value in self.strip_elements: + return 1 diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/transforms/writer_aux.py --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/transforms/writer_aux.py Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,88 @@ +# $Id: writer_aux.py 5174 2007-05-31 00:01:52Z wiemann $ +# Author: Lea Wiemann <LeWiemann@gmail.com> +# Copyright: This module has been placed in the public domain. + +""" +Auxiliary transforms mainly to be used by Writer components. + +This module is called "writer_aux" because otherwise there would be +conflicting imports like this one:: + + from docutils import writers + from docutils.transforms import writers +""" + +docformat = 'reStructuredText' + +from docutils import nodes, utils, languages +from docutils.transforms import Transform + + +class Compound(Transform): + + """ + Flatten all compound paragraphs. For example, transform :: + + <compound> + <paragraph> + <literal_block> + <paragraph> + + into :: + + <paragraph> + <literal_block classes="continued"> + <paragraph classes="continued"> + """ + + default_priority = 910 + + def apply(self): + for compound in self.document.traverse(nodes.compound): + first_child = 1 + for child in compound: + if first_child: + if not isinstance(child, nodes.Invisible): + first_child = 0 + else: + child['classes'].append('continued') + # Substitute children for compound. + compound.replace_self(compound[:]) + + +class Admonitions(Transform): + + """ + Transform specific admonitions, like this: + + <note> + <paragraph> + Note contents ... + + into generic admonitions, like this:: + + <admonition classes="note"> + <title> + Note + <paragraph> + Note contents ... + + The admonition title is localized. + """ + + default_priority = 920 + + def apply(self): + lcode = self.document.settings.language_code + language = languages.get_language(lcode) + for node in self.document.traverse(nodes.Admonition): + node_name = node.class.name + # Set class, so that we know what node this admonition came from. + node['classes'].append(node_name) + if not isinstance(node, nodes.admonition): + # Specific admonition. Transform into a generic admonition. + admonition = nodes.admonition(node.rawsource, node.children, + **node.attributes) + title = nodes.title('', language.labels[node_name]) + admonition.insert(0, title) + node.replace_self(admonition) diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/urischemes.py --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/urischemes.py Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,136 @@ +# $Id: urischemes.py 4564 2006-05-21 20:44:42Z wiemann $ +# Author: David Goodger <goodger@python.org> +# Copyright: This module has been placed in the public domain. + +""" +`schemes` is a dictionary with lowercase URI addressing schemes as +keys and descriptions as values. It was compiled from the index at +http://www.iana.org/assignments/uri-schemes (revised 2005-11-28) +and an older list at http://www.w3.org/Addressing/schemes.html. +""" + +# Many values are blank and should be filled in with useful descriptions. + +schemes = { + 'about': 'provides information on Navigator', + 'acap': 'Application Configuration Access Protocol; RFC 2244', + 'addbook': "To add vCard entries to Communicator's Address Book", + 'afp': 'Apple Filing Protocol', + 'afs': 'Andrew File System global file names', + 'aim': 'AOL Instant Messenger', + 'callto': 'for NetMeeting links', + 'castanet': 'Castanet Tuner URLs for Netcaster', + 'chttp': 'cached HTTP supported by RealPlayer', + 'cid': 'content identifier; RFC 2392', + 'crid': 'TV-Anytime Content Reference Identifier; RFC 4078', + 'data': ('allows inclusion of small data items as "immediate" data; ' + 'RFC 2397'), + 'dav': 'Distributed Authoring and Versioning Protocol; RFC 2518', + 'dict': 'dictionary service protocol; RFC 2229', + 'dns': 'Domain Name System resources', + 'eid': ('External ID; non-URL data; general escape mechanism to allow ' + 'access to information for applications that are too ' + 'specialized to justify their own schemes'), + 'fax': ('a connection to a terminal that can handle telefaxes ' + '(facsimiles); RFC 2806'), + 'feed' : 'NetNewsWire feed', + 'file': 'Host-specific file names; RFC 1738', + 'finger': '', + 'freenet': '', + 'ftp': 'File Transfer Protocol; RFC 1738', + 'go': 'go; RFC 3368', + 'gopher': 'The Gopher Protocol', + 'gsm-sms': ('Global System for Mobile Communications Short Message ' + 'Service'), + 'h323': ('video (audiovisual) communication on local area networks; ' + 'RFC 3508'), + 'h324': ('video and audio communications over low bitrate connections ' + 'such as POTS modem connections'), + 'hdl': 'CNRI handle system', + 'hnews': 'an HTTP-tunneling variant of the NNTP news protocol', + 'http': 'Hypertext Transfer Protocol; RFC 2616', + 'https': 'HTTP over SSL; RFC 2818', + 'hydra': 'SubEthaEdit URI. See http://www.codingmonkeys.de/subethaedit.', + 'iioploc': 'Internet Inter-ORB Protocol Location?', + 'ilu': 'Inter-Language Unification', + 'im': 'Instant Messaging; RFC 3860', + 'imap': 'Internet Message Access Protocol; RFC 2192', + 'info': 'Information Assets with Identifiers in Public Namespaces', + 'ior': 'CORBA interoperable object reference', + 'ipp': 'Internet Printing Protocol; RFC 3510', + 'irc': 'Internet Relay Chat', + 'iris.beep': 'iris.beep; RFC 3983', + 'iseek' : 'See www.ambrosiasw.com; a little util for OS X.', + 'jar': 'Java archive', + 'javascript': ('JavaScript code; evaluates the expression after the ' + 'colon'), + 'jdbc': 'JDBC connection URI.', + 'ldap': 'Lightweight Directory Access Protocol', + 'lifn': '', + 'livescript': '', + 'lrq': '', + 'mailbox': 'Mail folder access', + 'mailserver': 'Access to data available from mail servers', + 'mailto': 'Electronic mail address; RFC 2368', + 'md5': '', + 'mid': 'message identifier; RFC 2392', + 'mocha': '', + 'modem': ('a connection to a terminal that can handle incoming data ' + 'calls; RFC 2806'), + 'mtqp': 'Message Tracking Query Protocol; RFC 3887', + 'mupdate': 'Mailbox Update (MUPDATE) Protocol; RFC 3656', + 'news': 'USENET news; RFC 1738', + 'nfs': 'Network File System protocol; RFC 2224', + 'nntp': 'USENET news using NNTP access; RFC 1738', + 'opaquelocktoken': 'RFC 2518', + 'phone': '', + 'pop': 'Post Office Protocol; RFC 2384', + 'pop3': 'Post Office Protocol v3', + 'pres': 'Presence; RFC 3859', + 'printer': '', + 'prospero': 'Prospero Directory Service; RFC 4157', + 'rdar' : ('URLs found in Darwin source ' + '(http://www.opensource.apple.com/darwinsource/).'), + 'res': '', + 'rtsp': 'real time streaming protocol; RFC 2326', + 'rvp': '', + 'rwhois': '', + 'rx': 'Remote Execution', + 'sdp': '', + 'service': 'service location; RFC 2609', + 'shttp': 'secure hypertext transfer protocol', + 'sip': 'Session Initiation Protocol; RFC 3261', + 'sips': 'secure session intitiaion protocol; RFC 3261', + 'smb': 'SAMBA filesystems.', + 'snews': 'For NNTP postings via SSL', + 'snmp': 'Simple Network Management Protocol; RFC 4088', + 'soap.beep': 'RFC 3288', + 'soap.beeps': 'RFC 3288', + 'ssh': 'Reference to interactive sessions via ssh.', + 't120': 'real time data conferencing (audiographics)', + 'tag': 'RFC 4151', + 'tcp': '', + 'tel': ('a connection to a terminal that handles normal voice ' + 'telephone calls, a voice mailbox or another voice messaging ' + 'system or a service that can be operated using DTMF tones; ' + 'RFC 2806.'), + 'telephone': 'telephone', + 'telnet': 'Reference to interactive sessions; RFC 4248', + 'tftp': 'Trivial File Transfer Protocol; RFC 3617', + 'tip': 'Transaction Internet Protocol; RFC 2371', + 'tn3270': 'Interactive 3270 emulation sessions', + 'tv': '', + 'urn': 'Uniform Resource Name; RFC 2141', + 'uuid': '', + 'vemmi': 'versatile multimedia interface; RFC 2122', + 'videotex': '', + 'view-source': 'displays HTML code that was generated with JavaScript', + 'wais': 'Wide Area Information Servers; RFC 4156', + 'whodp': '', + 'whois++': 'Distributed directory service.', + 'x-man-page': ('Opens man page in Terminal.app on OS X ' + '(see macosxhints.com)'), + 'xmlrpc.beep': 'RFC 3529', + 'xmlrpc.beeps': 'RFC 3529', + 'z39.50r': 'Z39.50 Retrieval; RFC 2056', + 'z39.50s': 'Z39.50 Session; RFC 2056',} diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/utils.py --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/utils.py Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,593 @@ +# $Id: utils.py 5040 2007-04-03 17:41:59Z goodger $ +# Author: David Goodger <goodger@python.org> +# Copyright: This module has been placed in the public domain. + +""" +Miscellaneous utilities for the documentation utilities. +""" + +docformat = 'reStructuredText' + +import sys +import os +import os.path +import types +import warnings +import unicodedata +from types import StringType, UnicodeType +from docutils import ApplicationError, DataError +from docutils import nodes + + +class SystemMessage(ApplicationError): + + def init(self, system_message, level): + Exception.init(self, system_message.astext()) + self.level = level + + +class SystemMessagePropagation(ApplicationError): pass + + +class Reporter: + + """ + Info/warning/error reporter and ``system_message`` element generator. + + Five levels of system messages are defined, along with corresponding + methods: `debug()`, `info()`, `warning()`, `error()`, and `severe()`. + + There is typically one Reporter object per process. A Reporter object is + instantiated with thresholds for reporting (generating warnings) and + halting processing (raising exceptions), a switch to turn debug output on + or off, and an I/O stream for warnings. These are stored as instance + attributes. + + When a system message is generated, its level is compared to the stored + thresholds, and a warning or error is generated as appropriate. Debug + messages are produced iff the stored debug switch is on, independently of + other thresholds. Message output is sent to the stored warning stream if + not set to ''. + + The Reporter class also employs a modified form of the "Observer" pattern + [GoF95]_ to track system messages generated. The `attach_observer` method + should be called before parsing, with a bound method or function which + accepts system messages. The observer can be removed with + `detach_observer`, and another added in its place. + + .. [GoF95] Gamma, Helm, Johnson, Vlissides. Design Patterns: Elements of + Reusable Object-Oriented Software. Addison-Wesley, Reading, MA, USA, + 1995. + """ + + levels = 'DEBUG INFO WARNING ERROR SEVERE'.split() + """List of names for system message levels, indexed by level.""" + + # system message level constants: + (DEBUG_LEVEL, + INFO_LEVEL, + WARNING_LEVEL, + ERROR_LEVEL, + SEVERE_LEVEL) = range(5) + + def init(self, source, report_level, halt_level, stream=None, + debug=0, encoding='ascii', error_handler='replace'): + """ + :Parameters: + - `source`: The path to or description of the source data. + - `report_level`: The level at or above which warning output will + be sent to `stream`. + - `halt_level`: The level at or above which `SystemMessage` + exceptions will be raised, halting execution. + - `debug`: Show debug (level=0) system messages? + - `stream`: Where warning output is sent. Can be file-like (has a + ``.write`` method), a string (file name, opened for writing), + '' (empty string, for discarding all stream messages) or + `None` (implies `sys.stderr`; default). + - `encoding`: The encoding for stderr output. + - `error_handler`: The error handler for stderr output encoding. + """ + + self.source = source + """The path to or description of the source data.""" + + self.encoding = encoding + """The character encoding for the stderr output.""" + + self.error_handler = error_handler + """The character encoding error handler.""" + + self.debug_flag = debug + """Show debug (level=0) system messages?""" + + self.report_level = report_level + """The level at or above which warning output will be sent + to `self.stream`.""" + + self.halt_level = halt_level + """The level at or above which `SystemMessage` exceptions + will be raised, halting execution.""" + + if stream is None: + stream = sys.stderr + elif type(stream) in (StringType, UnicodeType): + # Leave stream untouched if it's ''. + if stream != '': + if type(stream) == StringType: + stream = open(stream, 'w') + elif type(stream) == UnicodeType: + stream = open(stream.encode(), 'w') + + self.stream = stream + """Where warning output is sent.""" + + self.observers = [] + """List of bound methods or functions to call with each system_message + created.""" + + self.max_level = -1 + """The highest level system message generated so far.""" + + def set_conditions(self, category, report_level, halt_level, + stream=None, debug=0): + warnings.warn('docutils.utils.Reporter.set_conditions deprecated; ' + 'set attributes via configuration settings or directly', + DeprecationWarning, stacklevel=2) + self.report_level = report_level + self.halt_level = halt_level + if stream is None: + stream = sys.stderr + self.stream = stream + self.debug_flag = debug + + def attach_observer(self, observer): + """ + The `observer` parameter is a function or bound method which takes one + argument, a `nodes.system_message` instance. + """ + self.observers.append(observer) + + def detach_observer(self, observer): + self.observers.remove(observer) + + def notify_observers(self, message): + for observer in self.observers: + observer(message) + + def system_message(self, level, message, *children, **kwargs): + """ + Return a system_message object. + + Raise an exception or generate a warning if appropriate. + """ + attributes = kwargs.copy() + if kwargs.has_key('base_node'): + source, line = get_source_line(kwargs['base_node']) + del attributes['base_node'] + if source is not None: + attributes.setdefault('source', source) + if line is not None: + attributes.setdefault('line', line) + attributes.setdefault('source', self.source) + msg = nodes.system_message(message, level=level, + type=self.levels[level], + *children, **attributes) + if self.stream and (level >= self.report_level + or self.debug_flag and level == self.DEBUG_LEVEL): + msgtext = msg.astext().encode(self.encoding, self.error_handler) + print >>self.stream, msgtext + if level >= self.halt_level: + raise SystemMessage(msg, level) + if level > self.DEBUG_LEVEL or self.debug_flag: + self.notify_observers(msg) + self.max_level = max(level, self.max_level) + return msg + + def debug(self, *args, **kwargs): + """ + Level-0, "DEBUG": an internal reporting issue. Typically, there is no + effect on the processing. Level-0 system messages are handled + separately from the others. + """ + if self.debug_flag: + return self.system_message(self.DEBUG_LEVEL, *args, **kwargs) + + def info(self, *args, **kwargs): + """ + Level-1, "INFO": a minor issue that can be ignored. Typically there is + no effect on processing, and level-1 system messages are not reported. + """ + return self.system_message(self.INFO_LEVEL, *args, **kwargs) + + def warning(self, *args, **kwargs): + """ + Level-2, "WARNING": an issue that should be addressed. If ignored, + there may be unpredictable problems with the output. + """ + return self.system_message(self.WARNING_LEVEL, *args, **kwargs) + + def error(self, *args, **kwargs): + """ + Level-3, "ERROR": an error that should be addressed. If ignored, the + output will contain errors. + """ + return self.system_message(self.ERROR_LEVEL, *args, **kwargs) + + def severe(self, *args, **kwargs): + """ + Level-4, "SEVERE": a severe error that must be addressed. If ignored, + the output will contain severe errors. Typically level-4 system + messages are turned into exceptions which halt processing. + """ + return self.system_message(self.SEVERE_LEVEL, *args, **kwargs) + + +class ExtensionOptionError(DataError): pass +class BadOptionError(ExtensionOptionError): pass +class BadOptionDataError(ExtensionOptionError): pass +class DuplicateOptionError(ExtensionOptionError): pass + + +def extract_extension_options(field_list, options_spec): + """ + Return a dictionary mapping extension option names to converted values. + + :Parameters: + - `field_list`: A flat field list without field arguments, where each + field body consists of a single paragraph only. + - `options_spec`: Dictionary mapping known option names to a + conversion function such as `int` or `float`. + + :Exceptions: + - `KeyError` for unknown option names. + - `ValueError` for invalid option values (raised by the conversion + function). + - `TypeError` for invalid option value types (raised by conversion + function). + - `DuplicateOptionError` for duplicate options. + - `BadOptionError` for invalid fields. + - `BadOptionDataError` for invalid option data (missing name, + missing data, bad quotes, etc.). + """ + option_list = extract_options(field_list) + option_dict = assemble_option_dict(option_list, options_spec) + return option_dict + +def extract_options(field_list): + """ + Return a list of option (name, value) pairs from field names & bodies. + + :Parameter: + `field_list`: A flat field list, where each field name is a single + word and each field body consists of a single paragraph only. + + :Exceptions: + - `BadOptionError` for invalid fields. + - `BadOptionDataError` for invalid option data (missing name, + missing data, bad quotes, etc.). + """ + option_list = [] + for field in field_list: + if len(field[0].astext().split()) != 1: + raise BadOptionError( + 'extension option field name may not contain multiple words') + name = str(field[0].astext().lower()) + body = field[1] + if len(body) == 0: + data = None + elif len(body) > 1 or not isinstance(body[0], nodes.paragraph) \ + or len(body[0]) != 1 or not isinstance(body[0][0], nodes.Text): + raise BadOptionDataError( + 'extension option field body may contain\n' + 'a single paragraph only (option "%s")' % name) + else: + data = body[0][0].astext() + option_list.append((name, data)) + return option_list + +def assemble_option_dict(option_list, options_spec): + """ + Return a mapping of option names to values. + + :Parameters: + - `option_list`: A list of (name, value) pairs (the output of + `extract_options()`). + - `options_spec`: Dictionary mapping known option names to a + conversion function such as `int` or `float`. + + :Exceptions: + - `KeyError` for unknown option names. + - `DuplicateOptionError` for duplicate options. + - `ValueError` for invalid option values (raised by conversion + function). + - `TypeError` for invalid option value types (raised by conversion + function). + """ + options = {} + for name, value in option_list: + convertor = options_spec[name] # raises KeyError if unknown + if convertor is None: + raise KeyError(name) # or if explicitly disabled + if options.has_key(name): + raise DuplicateOptionError('duplicate option "%s"' % name) + try: + options[name] = convertor(value) + except (ValueError, TypeError), detail: + raise detail.class('(option: "%s"; value: %r)\n%s' + % (name, value, ' '.join(detail.args))) + return options + + +class NameValueError(DataError): pass + + +def extract_name_value(line): + """ + Return a list of (name, value) from a line of the form "name=value ...". + + :Exception: + `NameValueError` for invalid input (missing name, missing data, bad + quotes, etc.). + """ + attlist = [] + while line: + equals = line.find('=') + if equals == -1: + raise NameValueError('missing "="') + attname = line[:equals].strip() + if equals == 0 or not attname: + raise NameValueError( + 'missing attribute name before "="') + line = line[equals+1:].lstrip() + if not line: + raise NameValueError( + 'missing value after "%s="' % attname) + if line[0] in '\'"': + endquote = line.find(line[0], 1) + if endquote == -1: + raise NameValueError( + 'attribute "%s" missing end quote (%s)' + % (attname, line[0])) + if len(line) > endquote + 1 and line[endquote + 1].strip(): + raise NameValueError( + 'attribute "%s" end quote (%s) not followed by ' + 'whitespace' % (attname, line[0])) + data = line[1:endquote] + line = line[endquote+1:].lstrip() + else: + space = line.find(' ') + if space == -1: + data = line + line = '' + else: + data = line[:space] + line = line[space+1:].lstrip() + attlist.append((attname.lower(), data)) + return attlist + +def new_reporter(source_path, settings): + """ + Return a new Reporter object. + + :Parameters: + `source` : string + The path to or description of the source text of the document. + `settings` : optparse.Values object + Runtime settings. + """ + reporter = Reporter( + source_path, settings.report_level, settings.halt_level, + stream=settings.warning_stream, debug=settings.debug, + encoding=settings.error_encoding, + error_handler=settings.error_encoding_error_handler) + return reporter + +def new_document(source_path, settings=None): + """ + Return a new empty document object. + + :Parameters: + `source_path` : string + The path to or description of the source text of the document. + `settings` : optparse.Values object + Runtime settings. If none provided, a default set will be used. + """ + from docutils import frontend + if settings is None: + settings = frontend.OptionParser().get_default_values() + reporter = new_reporter(source_path, settings) + document = nodes.document(settings, reporter, source=source_path) + document.note_source(source_path, -1) + return document + +def clean_rcs_keywords(paragraph, keyword_substitutions): + if len(paragraph) == 1 and isinstance(paragraph[0], nodes.Text): + textnode = paragraph[0] + for pattern, substitution in keyword_substitutions: + match = pattern.search(textnode.data) + if match: + textnode.data = pattern.sub(substitution, textnode.data) + return + +def relative_path(source, target): + """ + Build and return a path to `target`, relative to `source` (both files). + + If there is no common prefix, return the absolute path to `target`. + """ + source_parts = os.path.abspath(source or 'dummy_file').split(os.sep) + target_parts = os.path.abspath(target).split(os.sep) + # Check first 2 parts because '/dir'.split('/') == ['', 'dir']: + if source_parts[:2] != target_parts[:2]: + # Nothing in common between paths. + # Return absolute path, using '/' for URLs: + return '/'.join(target_parts) + source_parts.reverse() + target_parts.reverse() + while (source_parts and target_parts + and source_parts[-1] == target_parts[-1]): + # Remove path components in common: + source_parts.pop() + target_parts.pop() + target_parts.reverse() + parts = ['..'] * (len(source_parts) - 1) + target_parts + return '/'.join(parts) + +def get_stylesheet_reference(settings, relative_to=None): + """ + Retrieve a stylesheet reference from the settings object. + """ + if settings.stylesheet_path: + assert not settings.stylesheet, \ + 'stylesheet and stylesheet_path are mutually exclusive.' + if relative_to == None: + relative_to = settings._destination + return relative_path(relative_to, settings.stylesheet_path) + else: + return settings.stylesheet + +def get_trim_footnote_ref_space(settings): + """ + Return whether or not to trim footnote space. + + If trim_footnote_reference_space is not None, return it. + + If trim_footnote_reference_space is None, return False unless the + footnote reference style is 'superscript'. + """ + if settings.trim_footnote_reference_space is None: + return hasattr(settings, 'footnote_references') and \ + settings.footnote_references == 'superscript' + else: + return settings.trim_footnote_reference_space + +def get_source_line(node): + """ + Return the "source" and "line" attributes from the `node` given or from + its closest ancestor. + """ + while node: + if node.source or node.line: + return node.source, node.line + node = node.parent + return None, None + +def escape2null(text): + """Return a string with escape-backslashes converted to nulls.""" + parts = [] + start = 0 + while 1: + found = text.find('\\', start) + if found == -1: + parts.append(text[start:]) + return ''.join(parts) + parts.append(text[start:found]) + parts.append('\x00' + text[found+1:found+2]) + start = found + 2 # skip character after escape + +def unescape(text, restore_backslashes=0): + """ + Return a string with nulls removed or restored to backslashes. + Backslash-escaped spaces are also removed. + """ + if restore_backslashes: + return text.replace('\x00', '\\') + else: + for sep in ['\x00 ', '\x00\n', '\x00']: + text = ''.join(text.split(sep)) + return text + +east_asian_widths = {'W': 2, # Wide + 'F': 2, # Full-width (wide) + 'Na': 1, # Narrow + 'H': 1, # Half-width (narrow) + 'N': 1, # Neutral (not East Asian, treated as narrow) + 'A': 1} # Ambiguous (s/b wide in East Asian context, + # narrow otherwise, but that doesn't work) +"""Mapping of result codes from `unicodedata.east_asian_width()` to character +column widths.""" + +def east_asian_column_width(text): + if isinstance(text, types.UnicodeType): + total = 0 + for c in text: + total += east_asian_widths[unicodedata.east_asian_width(c)] + return total + else: + return len(text) + +if hasattr(unicodedata, 'east_asian_width'): + column_width = east_asian_column_width +else: + column_width = len + +def uniq(L): + r = [] + for item in L: + if not item in r: + r.append(item) + return r + + +class DependencyList: + + """ + List of dependencies, with file recording support. + + Note that the output file is not automatically closed. You have + to explicitly call the close() method. + """ + + def init(self, output_file=None, dependencies=[]): + """ + Initialize the dependency list, automatically setting the + output file to `output_file` (see `set_output()`) and adding + all supplied dependencies. + """ + self.set_output(output_file) + for i in dependencies: + self.add(i) + + def set_output(self, output_file): + """ + Set the output file and clear the list of already added + dependencies. + + `output_file` must be a string. The specified file is + immediately overwritten. + + If output_file is '-', the output will be written to stdout. + If it is None, no file output is done when calling add(). + """ + self.list = [] + if output_file == '-': + self.file = sys.stdout + elif output_file: + self.file = open(output_file, 'w') + else: + self.file = None + + def add(self, filename): + """ + If the dependency `filename` has not already been added, + append it to self.list and print it to self.file if self.file + is not None. + """ + if not filename in self.list: + self.list.append(filename) + if self.file is not None: + print >>self.file, filename + + def close(self): + """ + Close the output file. + """ + self.file.close() + self.file = None + + def repr(self): + if self.file: + output_file = self.file.name + else: + output_file = None + return '%s(%r, %s)' % (self.class.name, output_file, self.list) diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/writers/init.py --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/writers/init.py Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,133 @@ +# $Id: init.py 4913 2007-02-12 04:05:20Z goodger $ +# Author: David Goodger <goodger@python.org> +# Copyright: This module has been placed in the public domain. + +""" +This package contains Docutils Writer modules. +""" + +docformat = 'reStructuredText' + + +import os.path +import docutils +from docutils import languages, Component +from docutils.transforms import universal + + +class Writer(Component): + + """ + Abstract base class for docutils Writers. + + Each writer module or package must export a subclass also called 'Writer'. + Each writer must support all standard node types listed in + `docutils.nodes.node_class_names`. + + The `write()` method is the main entry point. + """ + + component_type = 'writer' + config_section = 'writers' + + def get_transforms(self): + return Component.get_transforms(self) + [ + universal.Messages, + universal.FilterMessages, + universal.StripClassesAndElements,] + + document = None + """The document to write (Docutils doctree); set by `write`.""" + + output = None + """Final translated form of `document` (Unicode string for text, binary + string for other forms); set by `translate`.""" + + language = None + """Language module for the document; set by `write`.""" + + destination = None + """`docutils.io` Output object; where to write the document. + Set by `write`.""" + + def init(self): + + # Currently only used by HTML writer for output fragments: + self.parts = {} + """Mapping of document part names to fragments of `self.output`. + Values are Unicode strings; encoding is up to the client. The 'whole' + key should contain the entire document output. + """ + + def write(self, document, destination): + """ + Process a document into its final form. + + Translate `document` (a Docutils document tree) into the Writer's + native format, and write it out to its `destination` (a + `docutils.io.Output` subclass object). + + Normally not overridden or extended in subclasses. + """ + self.document = document + self.language = languages.get_language( + document.settings.language_code) + self.destination = destination + self.translate() + output = self.destination.write(self.output) + return output + + def translate(self): + """ + Do final translation of `self.document` into `self.output`. Called + from `write`. Override in subclasses. + + Usually done with a `docutils.nodes.NodeVisitor` subclass, in + combination with a call to `docutils.nodes.Node.walk()` or + `docutils.nodes.Node.walkabout()`. The ``NodeVisitor`` subclass must + support all standard elements (listed in + `docutils.nodes.node_class_names`) and possibly non-standard elements + used by the current Reader as well. + """ + raise NotImplementedError('subclass must override this method') + + def assemble_parts(self): + """Assemble the `self.parts` dictionary. Extend in subclasses.""" + self.parts['whole'] = self.output + self.parts['encoding'] = self.document.settings.output_encoding + self.parts['version'] = docutils.version + + +class UnfilteredWriter(Writer): + + """ + A writer that passes the document tree on unchanged (e.g. a + serializer.) + + Documents written by UnfilteredWriters are typically reused at a + later date using a subclass of `readers.ReReader`. + """ + + def get_transforms(self): + # Do not add any transforms. When the document is reused + # later, the then-used writer will add the appropriate + # transforms. + return Component.get_transforms(self) + + +_writer_aliases = { + 'html': 'html4css1', + 'latex': 'latex2e', + 'pprint': 'pseudoxml', + 'pformat': 'pseudoxml', + 'pdf': 'rlpdf', + 'xml': 'docutils_xml', + 's5': 's5_html'} + +def get_writer_class(writer_name): + """Return the Writer class from the `writer_name` module.""" + writer_name = writer_name.lower() + if _writer_aliases.has_key(writer_name): + writer_name = _writer_aliases[writer_name] + module = import(writer_name, globals(), locals()) + return module.Writer diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/writers/docutils_xml.py --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/writers/docutils_xml.py Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,73 @@ +# $Id: docutils_xml.py 4564 2006-05-21 20:44:42Z wiemann $ +# Author: David Goodger <goodger@python.org> +# Copyright: This module has been placed in the public domain. + +""" +Simple internal document tree Writer, writes Docutils XML. +""" + +docformat = 'reStructuredText' + + +import docutils +from docutils import frontend, writers + + +class Writer(writers.Writer): + + supported = ('xml',) + """Formats this writer supports.""" + + settings_spec = ( + '"Docutils XML" Writer Options', + 'Warning: the --newlines and --indents options may adversely affect ' + 'whitespace; use them only for reading convenience.', + (('Generate XML with newlines before and after tags.', + ['--newlines'], + {'action': 'store_true', 'validator': frontend.validate_boolean}), + ('Generate XML with indents and newlines.', + ['--indents'], + {'action': 'store_true', 'validator': frontend.validate_boolean}), + ('Omit the XML declaration. Use with caution.', + ['--no-xml-declaration'], + {'dest': 'xml_declaration', 'default': 1, 'action': 'store_false', + 'validator': frontend.validate_boolean}), + ('Omit the DOCTYPE declaration.', + ['--no-doctype'], + {'dest': 'doctype_declaration', 'default': 1, + 'action': 'store_false', 'validator': frontend.validate_boolean}),)) + + settings_defaults = {'output_encoding_error_handler': 'xmlcharrefreplace'} + + config_section = 'docutils_xml writer' + config_section_dependencies = ('writers',) + + output = None + """Final translated form of `document`.""" + + xml_declaration = '<?xml version="1.0" encoding="%s"?>\n' + #xml_stylesheet = '<?xml-stylesheet type="text/xsl" href="%s"?>\n' + doctype = ( + '<!DOCTYPE document PUBLIC' + ' "+//IDN docutils.sourceforge.net//DTD Docutils Generic//EN//XML"' + ' "http://docutils.sourceforge.net/docs/ref/docutils.dtd">\n') + generator = '\n' + + def translate(self): + settings = self.document.settings + indent = newline = '' + if settings.newlines: + newline = '\n' + if settings.indents: + newline = '\n' + indent = ' ' + output_prefix = [] + if settings.xml_declaration: + output_prefix.append( + self.xml_declaration % settings.output_encoding) + if settings.doctype_declaration: + output_prefix.append(self.doctype) + output_prefix.append(self.generator % docutils.version) + docnode = self.document.asdom().childNodes[0] + self.output = (''.join(output_prefix) + + docnode.toprettyxml(indent, newline)) diff -r be27ed110b50 -r d8ac696cc51f buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/writers/html4css1/init.py --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/external/python/lib/common/docutils-0.5-py2.5.egg/docutils/writers/html4css1/init.py Wed Dec 23 19:29:07 2009 +0200 @@ -0,0 +1,1538 @@ +# $Id: init.py 5314 2007-07-05 12:45:43Z wiemann $ +# Author: David Goodger <goodger@python.org> +# Copyright: This module has been placed in the public domain. + +""" +Simple HyperText Markup Language document tree Writer. + +The output conforms to the XHTML version 1.0 Transitional DTD +(almost strict). The output contains a minimum of formatting +information. The cascading style sheet "html4css1.css" is required +for proper viewing with a modern graphical browser. +""" + +docformat = 'reStructuredText' + + +import sys +import os +import os.path +import time +import re +from types import ListType +try: + import Image # check for the Python Imaging Library +except ImportError: + Image = None +import docutils +from docutils import frontend, nodes, utils, writers, languages +from docutils.transforms import writer_aux + + +class Writer(writers.Writer): + + supported = ('html', 'html4css1', 'xhtml') + """Formats this writer supports.""" + + default_stylesheet = 'html4css1.css' + + default_stylesheet_path = utils.relative_path( + os.path.join(os.getcwd(), 'dummy'), + os.path.join(os.path.dirname(file), default_stylesheet)) + + default_template = 'template.txt' + + default_template_path = utils.relative_path( + os.path.join(os.getcwd(), 'dummy'), + os.path.join(os.path.dirname(file), default_template)) + + settings_spec = ( + 'HTML-Specific Options', + None, + (('Specify the template file (UTF-8 encoded). Default is "%s".' + % default_template_path, + ['--template'], + {'default': default_template_path, 'metavar': '<file>'}), + ('Specify a stylesheet URL, used verbatim. Overrides ' + '--stylesheet-path.', + ['--stylesheet'], + {'metavar': '<URL>', 'overrides': 'stylesheet_path'}), + ('Specify a stylesheet file, relative to the current working ' + 'directory. The path is adjusted relative to the output HTML ' + 'file. Overrides --stylesheet. Default: "%s"' + % default_stylesheet_path, + ['--stylesheet-path'], + {'metavar': '<file>', 'overrides': 'stylesheet', + 'default': default_stylesheet_path}), + ('Embed the stylesheet in the output HTML file. The stylesheet ' + 'file must be accessible during processing (--stylesheet-path is ' + 'recommended). This is the default.', + ['--embed-stylesheet'], + {'default': 1, 'action': 'store_true', + 'validator': frontend.validate_boolean}), + ('Link to the stylesheet in the output HTML file. Default: ' + 'embed the stylesheet, do not link to it.', + ['--link-stylesheet'], + {'dest': 'embed_stylesheet', 'action': 'store_false'}), + ('Specify the initial header level. Default is 1 for "<h1>". ' + 'Does not affect document title & subtitle (see --no-doc-title).', + ['--initial-header-level'], + {'choices': '1 2 3 4 5 6'.split(), 'default': '1', + 'metavar': '<level>'}), + ('Specify the maximum width (in characters) for one-column field ' + 'names. Longer field names will span an entire row of the table ' + 'used to render the field list. Default is 14 characters. ' + 'Use 0 for "no limit".', + ['--field-name-limit'], + {'default': 14, 'metavar': '<level>', + 'validator': frontend.validate_nonnegative_int}), + ('Specify the maximum width (in characters) for options in option ' + 'lists. Longer options will span an entire row of the table used ' + 'to render the option list. Default is 14 characters. ' + 'Use 0 for "no limit".', + ['--option-limit'], + {'default': 14, 'metavar': '<level>', + 'validator': frontend.validate_nonnegative_int}), + ('Format for footnote references: one of "superscript" or ' + '"brackets". Default is "brackets".', + ['--footnote-references'], + {'choices': ['superscript', 'brackets'], 'default': 'brackets', + 'metavar': '<format>', + 'overrides': 'trim_footnote_reference_space'}), + ('Format for block quote attributions: one of "dash" (em-dash ' + 'prefix), "parentheses"/"parens", or "none". Default is "dash".', + ['--attribution'], + {'choices': ['dash', 'parentheses', 'parens', 'none'], + 'default': 'dash', 'metavar': '<format>'}), + ('Remove extra vertical whitespace between items of "simple" bullet ' + 'lists and enumerated lists. Default: enabled.', + ['--compact-lists'], + {'default': 1, 'action': 'store_true', + 'validator': frontend.validate_boolean}), + ('Disable compact simple bullet and enumerated lists.', + ['--no-compact-lists'], + {'dest': 'compact_lists', 'action': 'store_false'}), + ('Remove extra vertical whitespace between items of simple field ' + 'lists. Default: enabled.', + ['--compact-field-lists'], + {'default': 1, 'action': 'store_true', + 'validator': frontend.validate_boolean}), + ('Disable compact simple field lists.', + ['--no-compact-field-lists'], + {'dest': 'compact_field_lists', 'action': 'store_false'}), + ('Omit the XML declaration. Use with caution.', + ['--no-xml-declaration'], + {'dest': 'xml_declaration', 'default': 1, 'action': 'store_false', + 'validator': frontend.validate_boolean}), + ('Obfuscate email addresses to confuse harvesters while still ' + 'keeping email links usable with standards-compliant browsers.', + ['--cloak-email-addresses'], + {'action': 'store_true', 'validator': frontend.validate_boolean}),)) + + settings_defaults = {'output_encoding_error_handler': 'xmlcharrefreplace'} + + relative_path_settings = ('stylesheet_path',) + + config_section = 'html4css1 writer' + config_section_dependencies = ('writers',) + + visitor_attributes = ( + 'head_prefix', 'head', 'stylesheet', 'body_prefix', + 'body_pre_docinfo', 'docinfo', 'body', 'body_suffix', + 'title', 'subtitle', 'header', 'footer', 'meta', 'fragment', + 'html_prolog', 'html_head', 'html_title', 'html_subtitle', + 'html_body') + + def get_transforms(self): + return writers.Writer.get_transforms(self) + [writer_aux.Admonitions] + + def init(self): + writers.Writer.init(self) + self.translator_class = HTMLTranslator + + def translate(self): + self.visitor = visitor = self.translator_class(self.document) + self.document.walkabout(visitor) + for attr in self.visitor_attributes: + setattr(self, attr, getattr(visitor, attr)) + self.output = self.apply_template() + + def apply_template(self): + template_file = open(self.document.settings.template) + template = unicode(template_file.read(), 'utf-8') + template_file.close() + subs = self.interpolation_dict() + return template % subs + + def interpolation_dict(self): + subs = {} + settings = self.document.settings + for attr in self.visitor_attributes: + subs[attr] = ''.join(getattr(self, attr)).rstrip('\n') + subs['encoding'] = settings.output_encoding + subs['version'] = docutils.version + return subs + + def assemble_parts(self): + writers.Writer.assemble_parts(self) + for part in self.visitor_attributes: + self.parts[part] = ''.join(getattr(self, part)) + + +class HTMLTranslator(nodes.NodeVisitor): + + """ + This HTML writer has been optimized to produce visually compact + lists (less vertical whitespace). HTML's mixed content models + allow list items to contain "<li><p>body elements</p></li>" or + "<li>just text</li>" or even "<li>text<p>and body + elements</p>combined</li>", each with different effects. It would + be best to stick with strict body elements in list items, but they + affect vertical spacing in browsers (although they really + shouldn't). + + Here is an outline of the optimization: + + - Check for and omit <p> tags in "simple" lists: list items + contain either a single paragraph, a nested simple list, or a + paragraph followed by a nested simple list. This means that + this list can be compact: + + - Item 1. + - Item 2. + + But this list cannot be compact: + + - Item 1. + + This second paragraph forces space between list items. + + - Item 2. + + - In non-list contexts, omit <p> tags on a paragraph if that + paragraph is the only child of its parent (footnotes & citations + are allowed a label first). + + - Regardless of the above, in definitions, table cells, field bodies, + option descriptions, and list items, mark the first child with + 'class="first"' and the last child with 'class="last"'. The stylesheet + sets the margins (top & bottom respectively) to 0 for these elements. + + The ``no_compact_lists`` setting (``--no-compact-lists`` command-line + option) disables list whitespace optimization. + """ + + xml_declaration = '<?xml version="1.0" encoding="%s" ?>\n' + doctype = ( + '<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"' + ' "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">\n') + head_prefix_template = ('<html xmlns="http://www.w3.org/1999/xhtml"' + ' xml:lang="%s" lang="%s">\n<head>\n') + content_type = ('<meta http-equiv="Content-Type"' + ' content="text/html; charset=%s" />\n') + generator = ('<meta name="generator" content="Docutils %s: ' + 'http://docutils.sourceforge.net/" />\n') + stylesheet_link = '<link rel="stylesheet" href="%s" type="text/css" />\n' + embedded_stylesheet = '<style type="text/css">\n\n%s\n</style>\n' + words_and_spaces = re.compile(r'\S+| +|\n') + + def init(self, document): + nodes.NodeVisitor.init(self, document) + self.settings = settings = document.settings + lcode = settings.language_code + self.language = languages.get_language(lcode) + self.meta = [self.content_type % settings.output_encoding, + self.generator % docutils.version] + self.head_prefix = [] + self.html_prolog = [] + if settings.xml_declaration: + self.head_prefix.append(self.xml_declaration + % settings.output_encoding) + # encoding not interpolated: + self.html_prolog.append(self.xml_declaration) + self.head_prefix.extend([self.doctype, + self.head_prefix_template % (lcode, lcode)]) + self.html_prolog.append(self.doctype) + self.head = self.meta[:] + stylesheet = utils.get_stylesheet_reference(settings) + self.stylesheet = [] + if stylesheet: + if settings.embed_stylesheet: + stylesheet = utils.get_stylesheet_reference( + settings, os.path.join(os.getcwd(), 'dummy')) + settings.record_dependencies.add(stylesheet) + stylesheet_text = open(stylesheet).read() + self.stylesheet = [self.embedded_stylesheet % stylesheet_text] + else: + self.stylesheet = [self.stylesheet_link + % self.encode(stylesheet)] + self.body_prefix = ['</head>\n<body>\n'] + # document title, subtitle display + self.body_pre_docinfo = [] + # author, date, etc. + self.docinfo = [] + self.body = [] + self.fragment = [] + self.body_suffix = ['</body>\n</html>\n'] + self.section_level = 0 + self.initial_header_level = int(settings.initial_header_level) + # A heterogenous stack used in conjunction with the tree traversal. + # Make sure that the pops correspond to the pushes: + self.context = [] + self.topic_classes = [] + self.colspecs = [] + self.compact_p = 1 + self.compact_simple = None + self.compact_field_list = None + self.in_docinfo = None + self.in_sidebar = None + self.title = [] + self.subtitle = [] + self.header = [] + self.footer = [] + self.html_head = [self.content_type] # charset not interpolated + self.html_title = [] + self.html_subtitle = [] + self.html_body = [] + self.in_document_title = 0 + self.in_mailto = 0 + self.author_in_authors = None + + def astext(self): + return ''.join(self.head_prefix + self.head + + self.stylesheet + self.body_prefix + + self.body_pre_docinfo + self.docinfo + + self.body + self.body_suffix) + + def encode(self, text): + """Encode special characters in `text` & return.""" + # @@@ A codec to do these and all other HTML entities would be nice. + text = text.replace("&", "&") + text = text.replace("<", "<") + text = text.replace('"', """) + text = text.replace(">", ">") + text = text.replace("@", "@") # may thwart some address harvesters + # Replace the non-breaking space character with the HTML entity: + text = text.replace(u'\u00a0', " ") + return text + + def cloak_mailto(self, uri): + """Try to hide a mailto: URL from harvesters.""" + # Encode "@" using a URL octet reference (see RFC 1738). + # Further cloaking with HTML entities will be done in the + # `attval` function. + return uri.replace('@', '%40') + + def cloak_email(self, addr): + """Try to hide the link text of a email link from harversters.""" + # Surround at-signs and periods with <span> tags. ("@" has + # already been encoded to "@" by the `encode` method.) + addr = addr.replace('@', '<span>@</span>') + addr = addr.replace('.', '<span>.</span>') + return addr + + def attval(self, text, + whitespace=re.compile('[\n\r\t\v\f]')): + """Cleanse, HTML encode, and return attribute value text.""" + encoded = self.encode(whitespace.sub(' ', text)) + if self.in_mailto and self.settings.cloak_email_addresses: + # Cloak at-signs ("%40") and periods with HTML entities. + encoded = encoded.replace('%40', '%40') + encoded = encoded.replace('.', '.') + return encoded + + def starttag(self, node, tagname, suffix='\n', empty=0, **attributes): + """ + Construct and return a start tag given a node (id & class attributes + are extracted), tag name, and optional attributes. + """ + tagname = tagname.lower() + prefix = [] + atts = {} + ids = [] + for (name, value) in attributes.items(): + atts[name.lower()] = value + classes = node.get('classes', []) + if atts.has_key('class'): + classes.append(atts['class']) + if classes: + atts['class'] = ' '.join(classes) + assert not atts.has_key('id') + ids.extend(node.get('ids', [])) + if atts.has_key('ids'): + ids.extend(atts['ids']) + del atts['ids'] + if ids: + atts['id'] = ids[0] + for id in ids[1:]: + # Add empty "span" elements for additional IDs. Note + # that we cannot use empty "a" elements because there + # may be targets inside of references, but nested "a" + # elements aren't allowed in XHTML (even if they do + # not all have a "href" attribute). + if empty: + # Empty tag. Insert target right in front of element. + prefix.append('<span id="%s"></span>' % id) + else: + # Non-empty tag. Place the auxiliary <span> tag + # inside the element, as the first child. + suffix += '<span id="%s"></span>' % id + attlist = atts.items() + attlist.sort() + parts = [tagname] + for name, value in attlist: + # value=None was used for boolean attributes without + # value, but this isn't supported by XHTML. + assert value is not None + if isinstance(value, ListType): + values = [unicode(v) for v in value] + parts.append('%s="%s"' % (name.lower(), + self.attval(' '.join(values)))) + else: + parts.append('%s="%s"' % (name.lower(), + self.attval(unicode(value)))) + if empty: + infix = ' /' + else: + infix = '' + return ''.join(prefix) + '<%s%s>' % (' '.join(parts), infix) + suffix + + def emptytag(self, node, tagname, suffix='\n', attributes): + """Construct and return an XML-compatible empty tag.""" + return self.starttag(node, tagname, suffix, empty=1, attributes) + + def set_class_on_child(self, node, class_, index=0): + """ + Set class `class_` on the visible child no. index of `node`. + Do nothing if node has fewer children than `index`. + """ + children = [n for n in node if not isinstance(n, nodes.Invisible)] + try: + child = children[index] + except IndexError: + return + child['classes'].append(class_) + + def set_first_last(self, node): + self.set_class_on_child(node, 'first', 0) + self.set_class_on_child(node, 'last', -1) + + def visit_Text(self, node): + text = node.astext() + encoded = self.encode(text) + if self.in_mailto and self.settings.cloak_email_addresses: + encoded = self.cloak_email(encoded) + self.body.append(encoded) + + def depart_Text(self, node): + pass + + def visit_abbreviation(self, node): + # @@@ implementation incomplete ("title" attribute) + self.body.append(self.starttag(node, 'abbr', '')) + + def depart_abbreviation(self, node): + self.body.append('</abbr>') + + def visit_acronym(self, node): + # @@@ implementation incomplete ("title" attribute) + self.body.append(self.starttag(node, 'acronym', '')) + + def depart_acronym(self, node): + self.body.append('</acronym>') + + def visit_address(self, node): + self.visit_docinfo_item(node, 'address', meta=None) + self.body.append(self.starttag(node, 'pre', CLASS='address')) + + def depart_address(self, node): + self.body.append('\n</pre>\n') + self.depart_docinfo_item() + + def visit_admonition(self, node): + self.body.append(self.starttag(node, 'div')) + self.set_first_last(node) + + def depart_admonition(self, node=None): + self.body.append('</div>\n') + + attribution_formats = {'dash': ('—', ''), + 'parentheses': ('(', ')'), + 'parens': ('(', ')'), + 'none': ('', '')} + + def visit_attribution(self, node): + prefix, suffix = self.attribution_formats[self.settings.attribution] + self.context.append(suffix) + self.body.append( + self.starttag(node, 'p', prefix, CLASS='attribution')) + + def depart_attribution(self, node): + self.body.append(self.context.pop() + '</p>\n') + + def visit_author(self, node): + if isinstance(node.parent, nodes.authors): + if self.author_in_authors: + self.body.append('\n<br />') + else: + self.visit_docinfo_item(node, 'author') + + def depart_author(self, node): + if isinstance(node.parent, nodes.authors): + self.author_in_authors += 1 + else: + self.depart_docinfo_item() + + def visit_authors(self, node): + self.visit_docinfo_item(node, 'authors') + self.author_in_authors = 0 # initialize counter + + def depart_authors(self, node): + self.depart_docinfo_item() + self.author_in_authors = None + + def visit_block_quote(self, node): + self.body.append(self.starttag(node, 'blockquote')) + + def depart_block_quote(self, node): + self.body.append('</blockquote>\n') + + def check_simple_list(self, node): + """Check for a simple list that can be rendered compactly.""" + visitor = SimpleListChecker(self.document) + try: + node.walk(visitor) + except nodes.NodeFound: + return None + else: + return 1 + + def is_compactable(self, node): + return ('compact' in node['classes'] + or (self.settings.compact_lists + and 'open' not in node['classes'] + and (self.compact_simple + or self.topic_classes == ['contents'] + or self.check_simple_list(node)))) + + def visit_bullet_list(self, node): + atts = {} + old_compact_simple = self.compact_simple + self.context.append((self.compact_simple, self.compact_p)) + self.compact_p = None + self.compact_simple = self.is_compactable(node) + if self.compact_simple and not old_compact_simple: + atts['class'] = 'simple' + self.body.append(self.starttag(node, 'ul', **atts)) + + def depart_bullet_list(self, node): + self.compact_simple, self.compact_p = self.context.pop() + self.body.append('</ul>\n') + + def visit_caption(self, node): + self.body.append(self.starttag(node, 'p', '', CLASS='caption')) + + def depart_caption(self, node): + self.body.append('</p>\n') + + def visit_citation(self, node): + self.body.append(self.starttag(node, 'table', + CLASS='docutils citation', + frame="void", rules="none")) + self.body.append('<colgroup><col class="label" /><col /></colgroup>\n' + '<tbody valign="top">\n' + '<tr>') + self.footnote_backrefs(node) + + def depart_citation(self, node): + self.body.append('</td></tr>\n' + '</tbody>\n</table>\n') + + def visit_citation_reference(self, node): + href = '#' + node['refid'] + self.body.append(self.starttag( + node, 'a', '[', CLASS='citation-reference', href=href)) + + def depart_citation_reference(self, node): + self.body.append(']</a>') + + def visit_classifier(self, node): + self.body.append(' <span class="classifier-delimiter">:</span> ') + self.body.append(self.starttag(node, 'span', '', CLASS='classifier')) + + def depart_classifier(self, node): + self.body.append('</span>') + + def visit_colspec(self, node): + self.colspecs.append(node) + # "stubs" list is an attribute of the tgroup element: + node.parent.stubs.append(node.attributes.get('stub')) + + def depart_colspec(self, node): + pass + + def write_colspecs(self): + width = 0 + for node in self.colspecs: + width += node['colwidth'] + for node in self.colspecs: + colwidth = int(node['colwidth'] * 100.0 / width + 0.5) + self.body.append(self.emptytag(node, 'col', + width='%i%%' % colwidth)) + self.colspecs = [] + + def visit_comment(self, node, + sub=re.compile('-(?=-)').sub): + """Escape double-dashes in comment text.""" + self.body.append('\n' % sub('- ', node.astext())) + # Content already processed: + raise nodes.SkipNode + + def visit_compound(self, node): + self.body.append(self.starttag(node, 'div', CLASS='compound')) + if len(node) > 1: + node[0]['classes'].append('compound-first') + node[-1]['classes'].append('compound-last') + for child in node[1:-1]: + child['classes'].append('compound-middle') + + def depart_compound(self, node): + self.body.append('</div>\n') + + def visit_container(self, node): + self.body.append(self.starttag(node, 'div', CLASS='container')) + + def depart_container(self, node): + self.body.append('</div>\n') + + def visit_contact(self, node): + self.visit_docinfo_item(node, 'contact', meta=None) + + def depart_contact(self, node): + self.depart_docinfo_item() + + def visit_copyright(self, node): + self.visit_docinfo_item(node, 'copyright') + + def depart_copyright(self, node): + self.depart_docinfo_item() + + def visit_date(self, node): + self.visit_docinfo_item(node, 'date') + + def depart_date(self, node): + self.depart_docinfo_item() + + def visit_decoration(self, node): + pass + + def depart_decoration(self, node): + pass + + def visit_definition(self, node): + self.body.append('</dt>\n') + self.body.append(self.starttag(node, 'dd', '')) + self.set_first_last(node) + + def depart_definition(self, node): + self.body.append('</dd>\n') + + def visit_definition_list(self, node): + self.body.append(self.starttag(node, 'dl', CLASS='docutils')) + + def depart_definition_list(self, node): + self.body.append('</dl>\n') + + def visit_definition_list_item(self, node): + pass + + def depart_definition_list_item(self, node): + pass + + def visit_description(self, node): + self.body.append(self.starttag(node, 'td', '')) + self.set_first_last(node) + + def depart_description(self, node): + self.body.append('</td>') + + def visit_docinfo(self, node): + self.context.append(len(self.body)) + self.body.append(self.starttag(node, 'table', + CLASS='docinfo', + frame="void", rules="none")) + self.body.append('<col class="docinfo-name" />\n' + '<col class="docinfo-content" />\n' + '<tbody valign="top">\n') + self.in_docinfo = 1 + + def depart_docinfo(self, node): + self.body.append('</tbody>\n</table>\n') + self.in_docinfo = None + start = self.context.pop() + self.docinfo = self.body[start:] + self.body = [] + + def visit_docinfo_item(self, node, name, meta=1): + if meta: + meta_tag = '<meta name="%s" content="%s" />\n' \ + % (name, self.attval(node.astext())) + self.add_meta(meta_tag) + self.body.append(self.starttag(node, 'tr', '')) + self.body.append('<th class="docinfo-name">%s:</th>\n<td>' + % self.language.labels[name]) + if len(node): + if isinstance(node[0], nodes.Element): + node[0]['classes'].append('first') + if isinstance(node[-1], nodes.Element): + node[-1]['classes'].append('last') + + def depart_docinfo_item(self): + self.body.append('</td></tr>\n') + + def visit_doctest_block(self, node): + self.body.append(self.starttag(node, 'pre', CLASS='doctest-block')) + + def depart_doctest_block(self, node): + self.body.append('\n</pre>\n') + + def visit_document(self, node): + self.head.append('<title>%s\n' + % self.encode(node.get('title', ''))) + + def depart_document(self, node): + self.fragment.extend(self.body) + self.body_prefix.append(self.starttag(node, 'div', CLASS='document')) + self.body_suffix.insert(0, '

\n') + # skip content-type meta tag with interpolated charset value: + self.html_head.extend(self.head[1:]) + self.html_body.extend(self.body_prefix[1:] + self.body_pre_docinfo + + self.docinfo + self.body + + self.body_suffix[:-1]) + assert not self.context, 'len(context) = %s' % len(self.context) + + def visit_emphasis(self, node): + self.body.append('') + + def depart_emphasis(self, node): + self.body.append('') + + def visit_entry(self, node): + atts = {'class': []} + if isinstance(node.parent.parent, nodes.thead): + atts['class'].append('head') + if node.parent.parent.parent.stubs[node.parent.column]: + # "stubs" list is an attribute of the tgroup element + atts['class'].append('stub') + if atts['class']: + tagname = 'th' + atts['class'] = ' '.join(atts['class']) + else: + tagname = 'td' + del atts['class'] + node.parent.column += 1 + if node.has_key('morerows'): + atts['rowspan'] = node['morerows'] + 1 + if node.has_key('morecols'): + atts['colspan'] = node['morecols'] + 1 + node.parent.column += node['morecols'] + self.body.append(self.starttag(node, tagname, '', **atts)) + self.context.append('\n' % tagname.lower()) + if len(node) == 0: # empty cell + self.body.append(' ') + self.set_first_last(node) + + def depart_entry(self, node): + self.body.append(self.context.pop()) + + def visit_enumerated_list(self, node): + """ + The 'start' attribute does not conform to HTML 4.01's strict.dtd, but + CSS1 doesn't help. CSS2 isn't widely enough supported yet to be + usable. + """ + atts = {} + if node.has_key('start'): + atts['start'] = node['start'] + if node.has_key('enumtype'): + atts['class'] = node['enumtype'] + # @@@ To do: prefix, suffix. How? Change prefix/suffix to a + # single "format" attribute? Use CSS2? + old_compact_simple = self.compact_simple + self.context.append((self.compact_simple, self.compact_p)) + self.compact_p = None + self.compact_simple = self.is_compactable(node) + if self.compact_simple and not old_compact_simple: + atts['class'] = (atts.get('class', '') + ' simple').strip() + self.body.append(self.starttag(node, 'ol', **atts)) + + def depart_enumerated_list(self, node): + self.compact_simple, self.compact_p = self.context.pop() + self.body.append('\n') + + def visit_field(self, node): + self.body.append(self.starttag(node, 'tr', '', CLASS='field')) + + def depart_field(self, node): + self.body.append('\n') + + def visit_field_body(self, node): + self.body.append(self.starttag(node, 'td', '', CLASS='field-body')) + self.set_class_on_child(node, 'first', 0) + field = node.parent + if (self.compact_field_list or + isinstance(field.parent, nodes.docinfo) or + field.parent.index(field) == len(field.parent) - 1): + # If we are in a compact list, the docinfo, or if this is + # the last field of the field list, do not add vertical + # space after last element. + self.set_class_on_child(node, 'last', -1) + + def depart_field_body(self, node): + self.body.append('\n') + + def visit_field_list(self, node): + self.context.append((self.compact_field_list, self.compact_p)) + self.compact_p = None + if 'compact' in node['classes']: + self.compact_field_list = 1 + elif (self.settings.compact_field_lists + and 'open' not in node['classes']): + self.compact_field_list = 1 + if self.compact_field_list: + for field in node: + field_body = field[-1] + assert isinstance(field_body, nodes.field_body) + children = [n for n in field_body + if not isinstance(n, nodes.Invisible)] + if not (len(children) == 0 or + len(children) == 1 and + isinstance(children[0], nodes.paragraph)): + self.compact_field_list = 0 + break + self.body.append(self.starttag(node, 'table', frame='void', + rules='none', + CLASS='docutils field-list')) + self.body.append('\n' + '\n' + '\n') + + def depart_field_list(self, node): + self.body.append('\n\n') + self.compact_field_list, self.compact_p = self.context.pop() + + def visit_field_name(self, node): + atts = {} + if self.in_docinfo: + atts['class'] = 'docinfo-name' + else: + atts['class'] = 'field-name' + if ( self.settings.field_name_limit + and len(node.astext()) > self.settings.field_name_limit): + atts['colspan'] = 2 + self.context.append('\n ') + else: + self.context.append('') + self.body.append(self.starttag(node, 'th', '', **atts)) + + def depart_field_name(self, node): + self.body.append(':') + self.body.append(self.context.pop()) + + def visit_figure(self, node): + atts = {'class': 'figure'} + if node.get('width'): + atts['style'] = 'width: %spx' % node['width'] + if node.get('align'): + atts['align'] = node['align'] + self.body.append(self.starttag(node, 'div', **atts)) + + def depart_figure(self, node): + self.body.append('

\n') + + def visit_footer(self, node): + self.context.append(len(self.body)) + + def depart_footer(self, node): + start = self.context.pop() + footer = [self.starttag(node, 'div', CLASS='footer'), + '
\n'] + footer.extend(self.body[start:]) + footer.append('\n

' + _('Searching') + '

{% trans version=version|e %}Automatically generated list of changes in version {{ version }}{% endtrans %}

{{ _('Library changes') }}

{{ modname }}

{{ _('C API changes') }}

{{ _('Other changes') }}

{{ title }} ({{ fn }})

{{ docstitle|e }}

{% trans key=key %}Index – {{ key }}{% endtrans %}

Index

{{ _('Index') }}

Index

{{ _('Index') }}

{{ key }}

{{ _('Index') }}

{{ _('Navigation') }}

{{ _('Table Of Contents') }}

{{ _('Previous topic') }}

{{ _('Next topic') }}

{{ _('This Page') }}

{% if builder == 'web' %}{{ _('Keyword search')}}{% else %}{{ _('Quick search') }}{% endif %}

{{ _('Global Module Index') }}

{{ _('Search') }}

{{ _('Search Results') }}

', '

') - self.s5_footer.extend(self.body[start:]) - self.s5_footer.append('

' + _('Searching') + '

{% trans version=version|e %}Automatically generated list of changes in version {{ version }}{% endtrans %}

{{ _('Library changes') }}

{{ modname }}

{{ _('C API changes') }}

{{ _('Other changes') }}

{{ title }} ({{ fn }})

{{ docstitle|e }}

{% trans key=key %}Index – {{ key }}{% endtrans %}

Index

{{ _('Index') }}

Index

{{ _('Index') }}

{{ key }}

{{ _('Index') }}

{{ _('Navigation') }}

{{ _('Table Of Contents') }}

{{ _('Previous topic') }}

{{ _('Next topic') }}

{{ _('This Page') }}

{% if builder == 'web' %}{{ _('Keyword search')}}{% else %}{{ _('Quick search') }}{% endif %}

{{ _('Global Module Index') }}

{{ _('Search') }}

{{ _('Search Results') }}

', '

') + self.s5_footer.extend(self.body[start:]) + self.s5_footer.append('