From 2692b503d4be56f8326d687b5f6f23375b9c393d Mon Sep 17 00:00:00 2001 From: Niels Thykier Date: Sun, 13 Aug 2017 17:13:08 +0000 Subject: [PATCH] Drop auto-generated doxygen documentation Signed-off-by: Niels Thykier --- doc/doxygen.conf | 1237 -------- doc/html/annotated.html | 28 - doc/html/britney_8py-source.html | 2658 ----------------- doc/html/classbritney_1_1Britney-members.html | 71 - doc/html/classbritney_1_1Britney.html | 1958 ------------ doc/html/classexcuse_1_1Excuse-members.html | 41 - doc/html/classexcuse_1_1Excuse.html | 561 ---- doc/html/doxygen.css | 358 --- doc/html/doxygen.png | Bin 1281 -> 0 bytes doc/html/excuse_8py-source.html | 163 - doc/html/files.html | 23 - doc/html/functions.html | 145 - doc/html/functions_func.html | 142 - doc/html/functions_vars.html | 38 - doc/html/hierarchy.html | 29 - doc/html/index.html | 21 - doc/html/namespacebritney.html | 27 - doc/html/namespaceexcuse.html | 27 - doc/html/namespaces.html | 23 - doc/html/tab_b.gif | Bin 35 -> 0 bytes doc/html/tab_l.gif | Bin 706 -> 0 bytes doc/html/tab_r.gif | Bin 2585 -> 0 bytes doc/html/tabs.css | 102 - doc/latex/FreeSans.ttf | Bin 22932 -> 0 bytes doc/latex/Helvetica.ttf | Bin 32760 -> 0 bytes doc/latex/Makefile | 39 - doc/latex/annotated.tex | 5 - doc/latex/classbritney_1_1Britney.tex | 906 ------ doc/latex/classexcuse_1_1Excuse.tex | 239 -- doc/latex/doxygen.sty | 78 - doc/latex/hierarchy.tex | 5 - doc/latex/namespacebritney.tex | 9 - doc/latex/namespaceexcuse.tex | 9 - doc/latex/namespaces.tex | 5 - doc/latex/refman.tex | 41 - 35 files changed, 8988 deletions(-) delete mode 100644 doc/doxygen.conf delete mode 100644 doc/html/annotated.html delete mode 100644 doc/html/britney_8py-source.html delete mode 100644 doc/html/classbritney_1_1Britney-members.html delete mode 100644 doc/html/classbritney_1_1Britney.html delete mode 100644 doc/html/classexcuse_1_1Excuse-members.html delete mode 100644 doc/html/classexcuse_1_1Excuse.html delete mode 100644 doc/html/doxygen.css delete mode 100644 doc/html/doxygen.png delete mode 100644 doc/html/excuse_8py-source.html delete mode 100644 doc/html/files.html delete mode 100644 doc/html/functions.html delete mode 100644 doc/html/functions_func.html delete mode 100644 doc/html/functions_vars.html delete mode 100644 doc/html/hierarchy.html delete mode 100644 doc/html/index.html delete mode 100644 doc/html/namespacebritney.html delete mode 100644 doc/html/namespaceexcuse.html delete mode 100644 doc/html/namespaces.html delete mode 100644 doc/html/tab_b.gif delete mode 100644 doc/html/tab_l.gif delete mode 100644 doc/html/tab_r.gif delete mode 100644 doc/html/tabs.css delete mode 100644 doc/latex/FreeSans.ttf delete mode 100644 doc/latex/Helvetica.ttf delete mode 100644 doc/latex/Makefile delete mode 100644 doc/latex/annotated.tex delete mode 100644 doc/latex/classbritney_1_1Britney.tex delete mode 100644 doc/latex/classexcuse_1_1Excuse.tex delete mode 100644 doc/latex/doxygen.sty delete mode 100644 doc/latex/hierarchy.tex delete mode 100644 doc/latex/namespacebritney.tex delete mode 100644 doc/latex/namespaceexcuse.tex delete mode 100644 doc/latex/namespaces.tex delete mode 100644 doc/latex/refman.tex diff --git a/doc/doxygen.conf b/doc/doxygen.conf deleted file mode 100644 index 132c8aa..0000000 --- a/doc/doxygen.conf +++ /dev/null @@ -1,1237 +0,0 @@ -# Doxyfile 1.4.6 - -# This file describes the settings to be used by the documentation system -# doxygen (www.doxygen.org) for a project -# -# All text after a hash (#) is considered a comment and will be ignored -# The format is: -# TAG = value [value, ...] -# For lists items can also be appended using: -# TAG += value [value, ...] -# Values that contain spaces should be placed between quotes (" ") - -#--------------------------------------------------------------------------- -# Project related configuration options -#--------------------------------------------------------------------------- - -# The PROJECT_NAME tag is a single word (or a sequence of words surrounded -# by quotes) that should identify the project. - -PROJECT_NAME = britney - -# The PROJECT_NUMBER tag can be used to enter a project or revision number. -# This could be handy for archiving the generated documentation or -# if some version control system is used. - -PROJECT_NUMBER = 2.0.alpha1 - -# The OUTPUT_DIRECTORY tag is used to specify the (relative or absolute) -# base path where the generated documentation will be put. -# If a relative path is entered, it will be relative to the location -# where doxygen was started. If left blank the current directory will be used. - -OUTPUT_DIRECTORY = doc/ - -# If the CREATE_SUBDIRS tag is set to YES, then doxygen will create -# 4096 sub-directories (in 2 levels) under the output directory of each output -# format and will distribute the generated files over these directories. -# Enabling this option can be useful when feeding doxygen a huge amount of -# source files, where putting all generated files in the same directory would -# otherwise cause performance problems for the file system. - -CREATE_SUBDIRS = NO - -# The OUTPUT_LANGUAGE tag is used to specify the language in which all -# documentation generated by doxygen is written. Doxygen will use this -# information to generate all constant output in the proper language. -# The default language is English, other supported languages are: -# Brazilian, Catalan, Chinese, Chinese-Traditional, Croatian, Czech, Danish, -# Dutch, Finnish, French, German, Greek, Hungarian, Italian, Japanese, -# Japanese-en (Japanese with English messages), Korean, Korean-en, Norwegian, -# Polish, Portuguese, Romanian, Russian, Serbian, Slovak, Slovene, Spanish, -# Swedish, and Ukrainian. - -OUTPUT_LANGUAGE = English - -# This tag can be used to specify the encoding used in the generated output. -# The encoding is not always determined by the language that is chosen, -# but also whether or not the output is meant for Windows or non-Windows users. -# In case there is a difference, setting the USE_WINDOWS_ENCODING tag to YES -# forces the Windows encoding (this is the default for the Windows binary), -# whereas setting the tag to NO uses a Unix-style encoding (the default for -# all platforms other than Windows). - -USE_WINDOWS_ENCODING = NO - -# If the BRIEF_MEMBER_DESC tag is set to YES (the default) Doxygen will -# include brief member descriptions after the members that are listed in -# the file and class documentation (similar to JavaDoc). -# Set to NO to disable this. - -BRIEF_MEMBER_DESC = YES - -# If the REPEAT_BRIEF tag is set to YES (the default) Doxygen will prepend -# the brief description of a member or function before the detailed description. -# Note: if both HIDE_UNDOC_MEMBERS and BRIEF_MEMBER_DESC are set to NO, the -# brief descriptions will be completely suppressed. - -REPEAT_BRIEF = YES - -# This tag implements a quasi-intelligent brief description abbreviator -# that is used to form the text in various listings. Each string -# in this list, if found as the leading text of the brief description, will be -# stripped from the text and the result after processing the whole list, is -# used as the annotated text. Otherwise, the brief description is used as-is. -# If left blank, the following values are used ("$name" is automatically -# replaced with the name of the entity): "The $name class" "The $name widget" -# "The $name file" "is" "provides" "specifies" "contains" -# "represents" "a" "an" "the" - -ABBREVIATE_BRIEF = - -# If the ALWAYS_DETAILED_SEC and REPEAT_BRIEF tags are both set to YES then -# Doxygen will generate a detailed section even if there is only a brief -# description. - -ALWAYS_DETAILED_SEC = NO - -# If the INLINE_INHERITED_MEMB tag is set to YES, doxygen will show all -# inherited members of a class in the documentation of that class as if those -# members were ordinary class members. Constructors, destructors and assignment -# operators of the base classes will not be shown. - -INLINE_INHERITED_MEMB = NO - -# If the FULL_PATH_NAMES tag is set to YES then Doxygen will prepend the full -# path before files name in the file list and in the header files. If set -# to NO the shortest path that makes the file name unique will be used. - -FULL_PATH_NAMES = YES - -# If the FULL_PATH_NAMES tag is set to YES then the STRIP_FROM_PATH tag -# can be used to strip a user-defined part of the path. Stripping is -# only done if one of the specified strings matches the left-hand part of -# the path. The tag can be used to show relative paths in the file list. -# If left blank the directory from which doxygen is run is used as the -# path to strip. - -STRIP_FROM_PATH = - -# The STRIP_FROM_INC_PATH tag can be used to strip a user-defined part of -# the path mentioned in the documentation of a class, which tells -# the reader which header file to include in order to use a class. -# If left blank only the name of the header file containing the class -# definition is used. Otherwise one should specify the include paths that -# are normally passed to the compiler using the -I flag. - -STRIP_FROM_INC_PATH = - -# If the SHORT_NAMES tag is set to YES, doxygen will generate much shorter -# (but less readable) file names. This can be useful is your file systems -# doesn't support long names like on DOS, Mac, or CD-ROM. - -SHORT_NAMES = NO - -# If the JAVADOC_AUTOBRIEF tag is set to YES then Doxygen -# will interpret the first line (until the first dot) of a JavaDoc-style -# comment as the brief description. If set to NO, the JavaDoc -# comments will behave just like the Qt-style comments (thus requiring an -# explicit @brief command for a brief description. - -JAVADOC_AUTOBRIEF = NO - -# The MULTILINE_CPP_IS_BRIEF tag can be set to YES to make Doxygen -# treat a multi-line C++ special comment block (i.e. a block of //! or /// -# comments) as a brief description. This used to be the default behaviour. -# The new default is to treat a multi-line C++ comment block as a detailed -# description. Set this tag to YES if you prefer the old behaviour instead. - -MULTILINE_CPP_IS_BRIEF = NO - -# If the DETAILS_AT_TOP tag is set to YES then Doxygen -# will output the detailed description near the top, like JavaDoc. -# If set to NO, the detailed description appears after the member -# documentation. - -DETAILS_AT_TOP = NO - -# If the INHERIT_DOCS tag is set to YES (the default) then an undocumented -# member inherits the documentation from any documented member that it -# re-implements. - -INHERIT_DOCS = YES - -# If the SEPARATE_MEMBER_PAGES tag is set to YES, then doxygen will produce -# a new page for each member. If set to NO, the documentation of a member will -# be part of the file/class/namespace that contains it. - -SEPARATE_MEMBER_PAGES = NO - -# The TAB_SIZE tag can be used to set the number of spaces in a tab. -# Doxygen uses this value to replace tabs by spaces in code fragments. - -TAB_SIZE = 8 - -# This tag can be used to specify a number of aliases that acts -# as commands in the documentation. An alias has the form "name=value". -# For example adding "sideeffect=\par Side Effects:\n" will allow you to -# put the command \sideeffect (or @sideeffect) in the documentation, which -# will result in a user-defined paragraph with heading "Side Effects:". -# You can put \n's in the value part of an alias to insert newlines. - -ALIASES = - -# Set the OPTIMIZE_OUTPUT_FOR_C tag to YES if your project consists of C -# sources only. Doxygen will then generate output that is more tailored for C. -# For instance, some of the names that are used will be different. The list -# of all members will be omitted, etc. - -OPTIMIZE_OUTPUT_FOR_C = NO - -# Set the OPTIMIZE_OUTPUT_JAVA tag to YES if your project consists of Java -# sources only. Doxygen will then generate output that is more tailored for Java. -# For instance, namespaces will be presented as packages, qualified scopes -# will look different, etc. - -OPTIMIZE_OUTPUT_JAVA = YES - -# If you use STL classes (i.e. std::string, std::vector, etc.) but do not want to -# include (a tag file for) the STL sources as input, then you should -# set this tag to YES in order to let doxygen match functions declarations and -# definitions whose arguments contain STL classes (e.g. func(std::string); v.s. -# func(std::string) {}). This also make the inheritance and collaboration -# diagrams that involve STL classes more complete and accurate. - -BUILTIN_STL_SUPPORT = NO - -# If member grouping is used in the documentation and the DISTRIBUTE_GROUP_DOC -# tag is set to YES, then doxygen will reuse the documentation of the first -# member in the group (if any) for the other members of the group. By default -# all members of a group must be documented explicitly. - -DISTRIBUTE_GROUP_DOC = NO - -# Set the SUBGROUPING tag to YES (the default) to allow class member groups of -# the same type (for instance a group of public functions) to be put as a -# subgroup of that type (e.g. under the Public Functions section). Set it to -# NO to prevent subgrouping. Alternatively, this can be done per class using -# the \nosubgrouping command. - -SUBGROUPING = YES - -#--------------------------------------------------------------------------- -# Build related configuration options -#--------------------------------------------------------------------------- - -# If the EXTRACT_ALL tag is set to YES doxygen will assume all entities in -# documentation are documented, even if no documentation was available. -# Private class members and static file members will be hidden unless -# the EXTRACT_PRIVATE and EXTRACT_STATIC tags are set to YES - -EXTRACT_ALL = NO - -# If the EXTRACT_PRIVATE tag is set to YES all private members of a class -# will be included in the documentation. - -EXTRACT_PRIVATE = NO - -# If the EXTRACT_STATIC tag is set to YES all static members of a file -# will be included in the documentation. - -EXTRACT_STATIC = NO - -# If the EXTRACT_LOCAL_CLASSES tag is set to YES classes (and structs) -# defined locally in source files will be included in the documentation. -# If set to NO only classes defined in header files are included. - -EXTRACT_LOCAL_CLASSES = YES - -# This flag is only useful for Objective-C code. When set to YES local -# methods, which are defined in the implementation section but not in -# the interface are included in the documentation. -# If set to NO (the default) only methods in the interface are included. - -EXTRACT_LOCAL_METHODS = NO - -# If the HIDE_UNDOC_MEMBERS tag is set to YES, Doxygen will hide all -# undocumented members of documented classes, files or namespaces. -# If set to NO (the default) these members will be included in the -# various overviews, but no documentation section is generated. -# This option has no effect if EXTRACT_ALL is enabled. - -HIDE_UNDOC_MEMBERS = NO - -# If the HIDE_UNDOC_CLASSES tag is set to YES, Doxygen will hide all -# undocumented classes that are normally visible in the class hierarchy. -# If set to NO (the default) these classes will be included in the various -# overviews. This option has no effect if EXTRACT_ALL is enabled. - -HIDE_UNDOC_CLASSES = NO - -# If the HIDE_FRIEND_COMPOUNDS tag is set to YES, Doxygen will hide all -# friend (class|struct|union) declarations. -# If set to NO (the default) these declarations will be included in the -# documentation. - -HIDE_FRIEND_COMPOUNDS = NO - -# If the HIDE_IN_BODY_DOCS tag is set to YES, Doxygen will hide any -# documentation blocks found inside the body of a function. -# If set to NO (the default) these blocks will be appended to the -# function's detailed documentation block. - -HIDE_IN_BODY_DOCS = NO - -# The INTERNAL_DOCS tag determines if documentation -# that is typed after a \internal command is included. If the tag is set -# to NO (the default) then the documentation will be excluded. -# Set it to YES to include the internal documentation. - -INTERNAL_DOCS = NO - -# If the CASE_SENSE_NAMES tag is set to NO then Doxygen will only generate -# file names in lower-case letters. If set to YES upper-case letters are also -# allowed. This is useful if you have classes or files whose names only differ -# in case and if your file system supports case sensitive file names. Windows -# and Mac users are advised to set this option to NO. - -CASE_SENSE_NAMES = YES - -# If the HIDE_SCOPE_NAMES tag is set to NO (the default) then Doxygen -# will show members with their full class and namespace scopes in the -# documentation. If set to YES the scope will be hidden. - -HIDE_SCOPE_NAMES = NO - -# If the SHOW_INCLUDE_FILES tag is set to YES (the default) then Doxygen -# will put a list of the files that are included by a file in the documentation -# of that file. - -SHOW_INCLUDE_FILES = YES - -# If the INLINE_INFO tag is set to YES (the default) then a tag [inline] -# is inserted in the documentation for inline members. - -INLINE_INFO = YES - -# If the SORT_MEMBER_DOCS tag is set to YES (the default) then doxygen -# will sort the (detailed) documentation of file and class members -# alphabetically by member name. If set to NO the members will appear in -# declaration order. - -SORT_MEMBER_DOCS = YES - -# If the SORT_BRIEF_DOCS tag is set to YES then doxygen will sort the -# brief documentation of file, namespace and class members alphabetically -# by member name. If set to NO (the default) the members will appear in -# declaration order. - -SORT_BRIEF_DOCS = NO - -# If the SORT_BY_SCOPE_NAME tag is set to YES, the class list will be -# sorted by fully-qualified names, including namespaces. If set to -# NO (the default), the class list will be sorted only by class name, -# not including the namespace part. -# Note: This option is not very useful if HIDE_SCOPE_NAMES is set to YES. -# Note: This option applies only to the class list, not to the -# alphabetical list. - -SORT_BY_SCOPE_NAME = NO - -# The GENERATE_TODOLIST tag can be used to enable (YES) or -# disable (NO) the todo list. This list is created by putting \todo -# commands in the documentation. - -GENERATE_TODOLIST = YES - -# The GENERATE_TESTLIST tag can be used to enable (YES) or -# disable (NO) the test list. This list is created by putting \test -# commands in the documentation. - -GENERATE_TESTLIST = YES - -# The GENERATE_BUGLIST tag can be used to enable (YES) or -# disable (NO) the bug list. This list is created by putting \bug -# commands in the documentation. - -GENERATE_BUGLIST = YES - -# The GENERATE_DEPRECATEDLIST tag can be used to enable (YES) or -# disable (NO) the deprecated list. This list is created by putting -# \deprecated commands in the documentation. - -GENERATE_DEPRECATEDLIST= YES - -# The ENABLED_SECTIONS tag can be used to enable conditional -# documentation sections, marked by \if sectionname ... \endif. - -ENABLED_SECTIONS = - -# The MAX_INITIALIZER_LINES tag determines the maximum number of lines -# the initial value of a variable or define consists of for it to appear in -# the documentation. If the initializer consists of more lines than specified -# here it will be hidden. Use a value of 0 to hide initializers completely. -# The appearance of the initializer of individual variables and defines in the -# documentation can be controlled using \showinitializer or \hideinitializer -# command in the documentation regardless of this setting. - -MAX_INITIALIZER_LINES = 30 - -# Set the SHOW_USED_FILES tag to NO to disable the list of files generated -# at the bottom of the documentation of classes and structs. If set to YES the -# list will mention the files that were used to generate the documentation. - -SHOW_USED_FILES = YES - -# If the sources in your project are distributed over multiple directories -# then setting the SHOW_DIRECTORIES tag to YES will show the directory hierarchy -# in the documentation. The default is NO. - -SHOW_DIRECTORIES = NO - -# The FILE_VERSION_FILTER tag can be used to specify a program or script that -# doxygen should invoke to get the current version for each file (typically from the -# version control system). Doxygen will invoke the program by executing (via -# popen()) the command , where is the value of -# the FILE_VERSION_FILTER tag, and is the name of an input file -# provided by doxygen. Whatever the program writes to standard output -# is used as the file version. See the manual for examples. - -FILE_VERSION_FILTER = - -#--------------------------------------------------------------------------- -# configuration options related to warning and progress messages -#--------------------------------------------------------------------------- - -# The QUIET tag can be used to turn on/off the messages that are generated -# by doxygen. Possible values are YES and NO. If left blank NO is used. - -QUIET = NO - -# The WARNINGS tag can be used to turn on/off the warning messages that are -# generated by doxygen. Possible values are YES and NO. If left blank -# NO is used. - -WARNINGS = YES - -# If WARN_IF_UNDOCUMENTED is set to YES, then doxygen will generate warnings -# for undocumented members. If EXTRACT_ALL is set to YES then this flag will -# automatically be disabled. - -WARN_IF_UNDOCUMENTED = YES - -# If WARN_IF_DOC_ERROR is set to YES, doxygen will generate warnings for -# potential errors in the documentation, such as not documenting some -# parameters in a documented function, or documenting parameters that -# don't exist or using markup commands wrongly. - -WARN_IF_DOC_ERROR = YES - -# This WARN_NO_PARAMDOC option can be abled to get warnings for -# functions that are documented, but have no documentation for their parameters -# or return value. If set to NO (the default) doxygen will only warn about -# wrong or incomplete parameter documentation, but not about the absence of -# documentation. - -WARN_NO_PARAMDOC = NO - -# The WARN_FORMAT tag determines the format of the warning messages that -# doxygen can produce. The string should contain the $file, $line, and $text -# tags, which will be replaced by the file and line number from which the -# warning originated and the warning text. Optionally the format may contain -# $version, which will be replaced by the version of the file (if it could -# be obtained via FILE_VERSION_FILTER) - -WARN_FORMAT = "$file:$line: $text" - -# The WARN_LOGFILE tag can be used to specify a file to which warning -# and error messages should be written. If left blank the output is written -# to stderr. - -WARN_LOGFILE = - -#--------------------------------------------------------------------------- -# configuration options related to the input files -#--------------------------------------------------------------------------- - -# The INPUT tag can be used to specify the files and/or directories that contain -# documented source files. You may enter file names like "myfile.cpp" or -# directories like "/usr/src/myproject". Separate the files or directories -# with spaces. - -INPUT = . - -# If the value of the INPUT tag contains directories, you can use the -# FILE_PATTERNS tag to specify one or more wildcard pattern (like *.cpp -# and *.h) to filter out the source-files in the directories. If left -# blank the following patterns are tested: -# *.c *.cc *.cxx *.cpp *.c++ *.java *.ii *.ixx *.ipp *.i++ *.inl *.h *.hh *.hxx -# *.hpp *.h++ *.idl *.odl *.cs *.php *.php3 *.inc *.m *.mm *.py - -FILE_PATTERNS = *.py - -# The RECURSIVE tag can be used to turn specify whether or not subdirectories -# should be searched for input files as well. Possible values are YES and NO. -# If left blank NO is used. - -RECURSIVE = YES - -# The EXCLUDE tag can be used to specify files and/or directories that should -# excluded from the INPUT source files. This way you can easily exclude a -# subdirectory from a directory tree whose root is specified with the INPUT tag. - -EXCLUDE = - -# The EXCLUDE_SYMLINKS tag can be used select whether or not files or -# directories that are symbolic links (a Unix filesystem feature) are excluded -# from the input. - -EXCLUDE_SYMLINKS = NO - -# If the value of the INPUT tag contains directories, you can use the -# EXCLUDE_PATTERNS tag to specify one or more wildcard patterns to exclude -# certain files from those directories. Note that the wildcards are matched -# against the file with absolute path, so to exclude all test directories -# for example use the pattern */test/* - -EXCLUDE_PATTERNS = - -# The EXAMPLE_PATH tag can be used to specify one or more files or -# directories that contain example code fragments that are included (see -# the \include command). - -EXAMPLE_PATH = - -# If the value of the EXAMPLE_PATH tag contains directories, you can use the -# EXAMPLE_PATTERNS tag to specify one or more wildcard pattern (like *.cpp -# and *.h) to filter out the source-files in the directories. If left -# blank all files are included. - -EXAMPLE_PATTERNS = - -# If the EXAMPLE_RECURSIVE tag is set to YES then subdirectories will be -# searched for input files to be used with the \include or \dontinclude -# commands irrespective of the value of the RECURSIVE tag. -# Possible values are YES and NO. If left blank NO is used. - -EXAMPLE_RECURSIVE = NO - -# The IMAGE_PATH tag can be used to specify one or more files or -# directories that contain image that are included in the documentation (see -# the \image command). - -IMAGE_PATH = - -# The INPUT_FILTER tag can be used to specify a program that doxygen should -# invoke to filter for each input file. Doxygen will invoke the filter program -# by executing (via popen()) the command , where -# is the value of the INPUT_FILTER tag, and is the name of an -# input file. Doxygen will then use the output that the filter program writes -# to standard output. If FILTER_PATTERNS is specified, this tag will be -# ignored. - -INPUT_FILTER = - -# The FILTER_PATTERNS tag can be used to specify filters on a per file pattern -# basis. Doxygen will compare the file name with each pattern and apply the -# filter if there is a match. The filters are a list of the form: -# pattern=filter (like *.cpp=my_cpp_filter). See INPUT_FILTER for further -# info on how filters are used. If FILTER_PATTERNS is empty, INPUT_FILTER -# is applied to all files. - -FILTER_PATTERNS = - -# If the FILTER_SOURCE_FILES tag is set to YES, the input filter (if set using -# INPUT_FILTER) will be used to filter the input files when producing source -# files to browse (i.e. when SOURCE_BROWSER is set to YES). - -FILTER_SOURCE_FILES = NO - -#--------------------------------------------------------------------------- -# configuration options related to source browsing -#--------------------------------------------------------------------------- - -# If the SOURCE_BROWSER tag is set to YES then a list of source files will -# be generated. Documented entities will be cross-referenced with these sources. -# Note: To get rid of all source code in the generated output, make sure also -# VERBATIM_HEADERS is set to NO. - -SOURCE_BROWSER = YES - -# Setting the INLINE_SOURCES tag to YES will include the body -# of functions and classes directly in the documentation. - -INLINE_SOURCES = NO - -# Setting the STRIP_CODE_COMMENTS tag to YES (the default) will instruct -# doxygen to hide any special comment blocks from generated source code -# fragments. Normal C and C++ comments will always remain visible. - -STRIP_CODE_COMMENTS = NO - -# If the REFERENCED_BY_RELATION tag is set to YES (the default) -# then for each documented function all documented -# functions referencing it will be listed. - -REFERENCED_BY_RELATION = YES - -# If the REFERENCES_RELATION tag is set to YES (the default) -# then for each documented function all documented entities -# called/used by that function will be listed. - -REFERENCES_RELATION = YES - -# If the USE_HTAGS tag is set to YES then the references to source code -# will point to the HTML generated by the htags(1) tool instead of doxygen -# built-in source browser. The htags tool is part of GNU's global source -# tagging system (see http://www.gnu.org/software/global/global.html). You -# will need version 4.8.6 or higher. - -USE_HTAGS = NO - -# If the VERBATIM_HEADERS tag is set to YES (the default) then Doxygen -# will generate a verbatim copy of the header file for each class for -# which an include is specified. Set to NO to disable this. - -VERBATIM_HEADERS = YES - -#--------------------------------------------------------------------------- -# configuration options related to the alphabetical class index -#--------------------------------------------------------------------------- - -# If the ALPHABETICAL_INDEX tag is set to YES, an alphabetical index -# of all compounds will be generated. Enable this if the project -# contains a lot of classes, structs, unions or interfaces. - -ALPHABETICAL_INDEX = NO - -# If the alphabetical index is enabled (see ALPHABETICAL_INDEX) then -# the COLS_IN_ALPHA_INDEX tag can be used to specify the number of columns -# in which this list will be split (can be a number in the range [1..20]) - -COLS_IN_ALPHA_INDEX = 5 - -# In case all classes in a project start with a common prefix, all -# classes will be put under the same header in the alphabetical index. -# The IGNORE_PREFIX tag can be used to specify one or more prefixes that -# should be ignored while generating the index headers. - -IGNORE_PREFIX = - -#--------------------------------------------------------------------------- -# configuration options related to the HTML output -#--------------------------------------------------------------------------- - -# If the GENERATE_HTML tag is set to YES (the default) Doxygen will -# generate HTML output. - -GENERATE_HTML = YES - -# The HTML_OUTPUT tag is used to specify where the HTML docs will be put. -# If a relative path is entered the value of OUTPUT_DIRECTORY will be -# put in front of it. If left blank `html' will be used as the default path. - -HTML_OUTPUT = html - -# The HTML_FILE_EXTENSION tag can be used to specify the file extension for -# each generated HTML page (for example: .htm,.php,.asp). If it is left blank -# doxygen will generate files with .html extension. - -HTML_FILE_EXTENSION = .html - -# The HTML_HEADER tag can be used to specify a personal HTML header for -# each generated HTML page. If it is left blank doxygen will generate a -# standard header. - -HTML_HEADER = - -# The HTML_FOOTER tag can be used to specify a personal HTML footer for -# each generated HTML page. If it is left blank doxygen will generate a -# standard footer. - -HTML_FOOTER = - -# The HTML_STYLESHEET tag can be used to specify a user-defined cascading -# style sheet that is used by each HTML page. It can be used to -# fine-tune the look of the HTML output. If the tag is left blank doxygen -# will generate a default style sheet. Note that doxygen will try to copy -# the style sheet file to the HTML output directory, so don't put your own -# stylesheet in the HTML output directory as well, or it will be erased! - -HTML_STYLESHEET = - -# If the HTML_ALIGN_MEMBERS tag is set to YES, the members of classes, -# files or namespaces will be aligned in HTML using tables. If set to -# NO a bullet list will be used. - -HTML_ALIGN_MEMBERS = YES - -# If the GENERATE_HTMLHELP tag is set to YES, additional index files -# will be generated that can be used as input for tools like the -# Microsoft HTML help workshop to generate a compressed HTML help file (.chm) -# of the generated HTML documentation. - -GENERATE_HTMLHELP = NO - -# If the GENERATE_HTMLHELP tag is set to YES, the CHM_FILE tag can -# be used to specify the file name of the resulting .chm file. You -# can add a path in front of the file if the result should not be -# written to the html output directory. - -CHM_FILE = - -# If the GENERATE_HTMLHELP tag is set to YES, the HHC_LOCATION tag can -# be used to specify the location (absolute path including file name) of -# the HTML help compiler (hhc.exe). If non-empty doxygen will try to run -# the HTML help compiler on the generated index.hhp. - -HHC_LOCATION = - -# If the GENERATE_HTMLHELP tag is set to YES, the GENERATE_CHI flag -# controls if a separate .chi index file is generated (YES) or that -# it should be included in the master .chm file (NO). - -GENERATE_CHI = NO - -# If the GENERATE_HTMLHELP tag is set to YES, the BINARY_TOC flag -# controls whether a binary table of contents is generated (YES) or a -# normal table of contents (NO) in the .chm file. - -BINARY_TOC = NO - -# The TOC_EXPAND flag can be set to YES to add extra items for group members -# to the contents of the HTML help documentation and to the tree view. - -TOC_EXPAND = NO - -# The DISABLE_INDEX tag can be used to turn on/off the condensed index at -# top of each HTML page. The value NO (the default) enables the index and -# the value YES disables it. - -DISABLE_INDEX = NO - -# This tag can be used to set the number of enum values (range [1..20]) -# that doxygen will group on one line in the generated HTML documentation. - -ENUM_VALUES_PER_LINE = 4 - -# If the GENERATE_TREEVIEW tag is set to YES, a side panel will be -# generated containing a tree-like index structure (just like the one that -# is generated for HTML Help). For this to work a browser that supports -# JavaScript, DHTML, CSS and frames is required (for instance Mozilla 1.0+, -# Netscape 6.0+, Internet explorer 5.0+, or Konqueror). Windows users are -# probably better off using the HTML help feature. - -GENERATE_TREEVIEW = NO - -# If the treeview is enabled (see GENERATE_TREEVIEW) then this tag can be -# used to set the initial width (in pixels) of the frame in which the tree -# is shown. - -TREEVIEW_WIDTH = 250 - -#--------------------------------------------------------------------------- -# configuration options related to the LaTeX output -#--------------------------------------------------------------------------- - -# If the GENERATE_LATEX tag is set to YES (the default) Doxygen will -# generate Latex output. - -GENERATE_LATEX = YES - -# The LATEX_OUTPUT tag is used to specify where the LaTeX docs will be put. -# If a relative path is entered the value of OUTPUT_DIRECTORY will be -# put in front of it. If left blank `latex' will be used as the default path. - -LATEX_OUTPUT = latex - -# The LATEX_CMD_NAME tag can be used to specify the LaTeX command name to be -# invoked. If left blank `latex' will be used as the default command name. - -LATEX_CMD_NAME = latex - -# The MAKEINDEX_CMD_NAME tag can be used to specify the command name to -# generate index for LaTeX. If left blank `makeindex' will be used as the -# default command name. - -MAKEINDEX_CMD_NAME = makeindex - -# If the COMPACT_LATEX tag is set to YES Doxygen generates more compact -# LaTeX documents. This may be useful for small projects and may help to -# save some trees in general. - -COMPACT_LATEX = NO - -# The PAPER_TYPE tag can be used to set the paper type that is used -# by the printer. Possible values are: a4, a4wide, letter, legal and -# executive. If left blank a4wide will be used. - -PAPER_TYPE = a4wide - -# The EXTRA_PACKAGES tag can be to specify one or more names of LaTeX -# packages that should be included in the LaTeX output. - -EXTRA_PACKAGES = - -# The LATEX_HEADER tag can be used to specify a personal LaTeX header for -# the generated latex document. The header should contain everything until -# the first chapter. If it is left blank doxygen will generate a -# standard header. Notice: only use this tag if you know what you are doing! - -LATEX_HEADER = - -# If the PDF_HYPERLINKS tag is set to YES, the LaTeX that is generated -# is prepared for conversion to pdf (using ps2pdf). The pdf file will -# contain links (just like the HTML output) instead of page references -# This makes the output suitable for online browsing using a pdf viewer. - -PDF_HYPERLINKS = NO - -# If the USE_PDFLATEX tag is set to YES, pdflatex will be used instead of -# plain latex in the generated Makefile. Set this option to YES to get a -# higher quality PDF documentation. - -USE_PDFLATEX = NO - -# If the LATEX_BATCHMODE tag is set to YES, doxygen will add the \\batchmode. -# command to the generated LaTeX files. This will instruct LaTeX to keep -# running if errors occur, instead of asking the user for help. -# This option is also used when generating formulas in HTML. - -LATEX_BATCHMODE = NO - -# If LATEX_HIDE_INDICES is set to YES then doxygen will not -# include the index chapters (such as File Index, Compound Index, etc.) -# in the output. - -LATEX_HIDE_INDICES = NO - -#--------------------------------------------------------------------------- -# configuration options related to the RTF output -#--------------------------------------------------------------------------- - -# If the GENERATE_RTF tag is set to YES Doxygen will generate RTF output -# The RTF output is optimized for Word 97 and may not look very pretty with -# other RTF readers or editors. - -GENERATE_RTF = NO - -# The RTF_OUTPUT tag is used to specify where the RTF docs will be put. -# If a relative path is entered the value of OUTPUT_DIRECTORY will be -# put in front of it. If left blank `rtf' will be used as the default path. - -RTF_OUTPUT = rtf - -# If the COMPACT_RTF tag is set to YES Doxygen generates more compact -# RTF documents. This may be useful for small projects and may help to -# save some trees in general. - -COMPACT_RTF = NO - -# If the RTF_HYPERLINKS tag is set to YES, the RTF that is generated -# will contain hyperlink fields. The RTF file will -# contain links (just like the HTML output) instead of page references. -# This makes the output suitable for online browsing using WORD or other -# programs which support those fields. -# Note: wordpad (write) and others do not support links. - -RTF_HYPERLINKS = NO - -# Load stylesheet definitions from file. Syntax is similar to doxygen's -# config file, i.e. a series of assignments. You only have to provide -# replacements, missing definitions are set to their default value. - -RTF_STYLESHEET_FILE = - -# Set optional variables used in the generation of an rtf document. -# Syntax is similar to doxygen's config file. - -RTF_EXTENSIONS_FILE = - -#--------------------------------------------------------------------------- -# configuration options related to the man page output -#--------------------------------------------------------------------------- - -# If the GENERATE_MAN tag is set to YES (the default) Doxygen will -# generate man pages - -GENERATE_MAN = NO - -# The MAN_OUTPUT tag is used to specify where the man pages will be put. -# If a relative path is entered the value of OUTPUT_DIRECTORY will be -# put in front of it. If left blank `man' will be used as the default path. - -MAN_OUTPUT = man - -# The MAN_EXTENSION tag determines the extension that is added to -# the generated man pages (default is the subroutine's section .3) - -MAN_EXTENSION = .3 - -# If the MAN_LINKS tag is set to YES and Doxygen generates man output, -# then it will generate one additional man file for each entity -# documented in the real man page(s). These additional files -# only source the real man page, but without them the man command -# would be unable to find the correct page. The default is NO. - -MAN_LINKS = NO - -#--------------------------------------------------------------------------- -# configuration options related to the XML output -#--------------------------------------------------------------------------- - -# If the GENERATE_XML tag is set to YES Doxygen will -# generate an XML file that captures the structure of -# the code including all documentation. - -GENERATE_XML = NO - -# The XML_OUTPUT tag is used to specify where the XML pages will be put. -# If a relative path is entered the value of OUTPUT_DIRECTORY will be -# put in front of it. If left blank `xml' will be used as the default path. - -XML_OUTPUT = xml - -# The XML_SCHEMA tag can be used to specify an XML schema, -# which can be used by a validating XML parser to check the -# syntax of the XML files. - -XML_SCHEMA = - -# The XML_DTD tag can be used to specify an XML DTD, -# which can be used by a validating XML parser to check the -# syntax of the XML files. - -XML_DTD = - -# If the XML_PROGRAMLISTING tag is set to YES Doxygen will -# dump the program listings (including syntax highlighting -# and cross-referencing information) to the XML output. Note that -# enabling this will significantly increase the size of the XML output. - -XML_PROGRAMLISTING = YES - -#--------------------------------------------------------------------------- -# configuration options for the AutoGen Definitions output -#--------------------------------------------------------------------------- - -# If the GENERATE_AUTOGEN_DEF tag is set to YES Doxygen will -# generate an AutoGen Definitions (see autogen.sf.net) file -# that captures the structure of the code including all -# documentation. Note that this feature is still experimental -# and incomplete at the moment. - -GENERATE_AUTOGEN_DEF = NO - -#--------------------------------------------------------------------------- -# configuration options related to the Perl module output -#--------------------------------------------------------------------------- - -# If the GENERATE_PERLMOD tag is set to YES Doxygen will -# generate a Perl module file that captures the structure of -# the code including all documentation. Note that this -# feature is still experimental and incomplete at the -# moment. - -GENERATE_PERLMOD = NO - -# If the PERLMOD_LATEX tag is set to YES Doxygen will generate -# the necessary Makefile rules, Perl scripts and LaTeX code to be able -# to generate PDF and DVI output from the Perl module output. - -PERLMOD_LATEX = NO - -# If the PERLMOD_PRETTY tag is set to YES the Perl module output will be -# nicely formatted so it can be parsed by a human reader. This is useful -# if you want to understand what is going on. On the other hand, if this -# tag is set to NO the size of the Perl module output will be much smaller -# and Perl will parse it just the same. - -PERLMOD_PRETTY = YES - -# The names of the make variables in the generated doxyrules.make file -# are prefixed with the string contained in PERLMOD_MAKEVAR_PREFIX. -# This is useful so different doxyrules.make files included by the same -# Makefile don't overwrite each other's variables. - -PERLMOD_MAKEVAR_PREFIX = - -#--------------------------------------------------------------------------- -# Configuration options related to the preprocessor -#--------------------------------------------------------------------------- - -# If the ENABLE_PREPROCESSING tag is set to YES (the default) Doxygen will -# evaluate all C-preprocessor directives found in the sources and include -# files. - -ENABLE_PREPROCESSING = YES - -# If the MACRO_EXPANSION tag is set to YES Doxygen will expand all macro -# names in the source code. If set to NO (the default) only conditional -# compilation will be performed. Macro expansion can be done in a controlled -# way by setting EXPAND_ONLY_PREDEF to YES. - -MACRO_EXPANSION = NO - -# If the EXPAND_ONLY_PREDEF and MACRO_EXPANSION tags are both set to YES -# then the macro expansion is limited to the macros specified with the -# PREDEFINED and EXPAND_AS_DEFINED tags. - -EXPAND_ONLY_PREDEF = NO - -# If the SEARCH_INCLUDES tag is set to YES (the default) the includes files -# in the INCLUDE_PATH (see below) will be search if a #include is found. - -SEARCH_INCLUDES = YES - -# The INCLUDE_PATH tag can be used to specify one or more directories that -# contain include files that are not input files but should be processed by -# the preprocessor. - -INCLUDE_PATH = - -# You can use the INCLUDE_FILE_PATTERNS tag to specify one or more wildcard -# patterns (like *.h and *.hpp) to filter out the header-files in the -# directories. If left blank, the patterns specified with FILE_PATTERNS will -# be used. - -INCLUDE_FILE_PATTERNS = - -# The PREDEFINED tag can be used to specify one or more macro names that -# are defined before the preprocessor is started (similar to the -D option of -# gcc). The argument of the tag is a list of macros of the form: name -# or name=definition (no spaces). If the definition and the = are -# omitted =1 is assumed. To prevent a macro definition from being -# undefined via #undef or recursively expanded use the := operator -# instead of the = operator. - -PREDEFINED = - -# If the MACRO_EXPANSION and EXPAND_ONLY_PREDEF tags are set to YES then -# this tag can be used to specify a list of macro names that should be expanded. -# The macro definition that is found in the sources will be used. -# Use the PREDEFINED tag if you want to use a different macro definition. - -EXPAND_AS_DEFINED = - -# If the SKIP_FUNCTION_MACROS tag is set to YES (the default) then -# doxygen's preprocessor will remove all function-like macros that are alone -# on a line, have an all uppercase name, and do not end with a semicolon. Such -# function macros are typically used for boiler-plate code, and will confuse -# the parser if not removed. - -SKIP_FUNCTION_MACROS = YES - -#--------------------------------------------------------------------------- -# Configuration::additions related to external references -#--------------------------------------------------------------------------- - -# The TAGFILES option can be used to specify one or more tagfiles. -# Optionally an initial location of the external documentation -# can be added for each tagfile. The format of a tag file without -# this location is as follows: -# TAGFILES = file1 file2 ... -# Adding location for the tag files is done as follows: -# TAGFILES = file1=loc1 "file2 = loc2" ... -# where "loc1" and "loc2" can be relative or absolute paths or -# URLs. If a location is present for each tag, the installdox tool -# does not have to be run to correct the links. -# Note that each tag file must have a unique name -# (where the name does NOT include the path) -# If a tag file is not located in the directory in which doxygen -# is run, you must also specify the path to the tagfile here. - -TAGFILES = - -# When a file name is specified after GENERATE_TAGFILE, doxygen will create -# a tag file that is based on the input files it reads. - -GENERATE_TAGFILE = - -# If the ALLEXTERNALS tag is set to YES all external classes will be listed -# in the class index. If set to NO only the inherited external classes -# will be listed. - -ALLEXTERNALS = NO - -# If the EXTERNAL_GROUPS tag is set to YES all external groups will be listed -# in the modules index. If set to NO, only the current project's groups will -# be listed. - -EXTERNAL_GROUPS = YES - -# The PERL_PATH should be the absolute path and name of the perl script -# interpreter (i.e. the result of `which perl'). - -PERL_PATH = /usr/bin/perl - -#--------------------------------------------------------------------------- -# Configuration options related to the dot tool -#--------------------------------------------------------------------------- - -# If the CLASS_DIAGRAMS tag is set to YES (the default) Doxygen will -# generate a inheritance diagram (in HTML, RTF and LaTeX) for classes with base -# or super classes. Setting the tag to NO turns the diagrams off. Note that -# this option is superseded by the HAVE_DOT option below. This is only a -# fallback. It is recommended to install and use dot, since it yields more -# powerful graphs. - -CLASS_DIAGRAMS = YES - -# If set to YES, the inheritance and collaboration graphs will hide -# inheritance and usage relations if the target is undocumented -# or is not a class. - -HIDE_UNDOC_RELATIONS = YES - -# If you set the HAVE_DOT tag to YES then doxygen will assume the dot tool is -# available from the path. This tool is part of Graphviz, a graph visualization -# toolkit from AT&T and Lucent Bell Labs. The other options in this section -# have no effect if this option is set to NO (the default) - -HAVE_DOT = NO - -# If the CLASS_GRAPH and HAVE_DOT tags are set to YES then doxygen -# will generate a graph for each documented class showing the direct and -# indirect inheritance relations. Setting this tag to YES will force the -# the CLASS_DIAGRAMS tag to NO. - -CLASS_GRAPH = YES - -# If the COLLABORATION_GRAPH and HAVE_DOT tags are set to YES then doxygen -# will generate a graph for each documented class showing the direct and -# indirect implementation dependencies (inheritance, containment, and -# class references variables) of the class with other documented classes. - -COLLABORATION_GRAPH = YES - -# If the GROUP_GRAPHS and HAVE_DOT tags are set to YES then doxygen -# will generate a graph for groups, showing the direct groups dependencies - -GROUP_GRAPHS = YES - -# If the UML_LOOK tag is set to YES doxygen will generate inheritance and -# collaboration diagrams in a style similar to the OMG's Unified Modeling -# Language. - -UML_LOOK = NO - -# If set to YES, the inheritance and collaboration graphs will show the -# relations between templates and their instances. - -TEMPLATE_RELATIONS = NO - -# If the ENABLE_PREPROCESSING, SEARCH_INCLUDES, INCLUDE_GRAPH, and HAVE_DOT -# tags are set to YES then doxygen will generate a graph for each documented -# file showing the direct and indirect include dependencies of the file with -# other documented files. - -INCLUDE_GRAPH = YES - -# If the ENABLE_PREPROCESSING, SEARCH_INCLUDES, INCLUDED_BY_GRAPH, and -# HAVE_DOT tags are set to YES then doxygen will generate a graph for each -# documented header file showing the documented files that directly or -# indirectly include this file. - -INCLUDED_BY_GRAPH = YES - -# If the CALL_GRAPH and HAVE_DOT tags are set to YES then doxygen will -# generate a call dependency graph for every global function or class method. -# Note that enabling this option will significantly increase the time of a run. -# So in most cases it will be better to enable call graphs for selected -# functions only using the \callgraph command. - -CALL_GRAPH = NO - -# If the GRAPHICAL_HIERARCHY and HAVE_DOT tags are set to YES then doxygen -# will graphical hierarchy of all classes instead of a textual one. - -GRAPHICAL_HIERARCHY = YES - -# If the DIRECTORY_GRAPH, SHOW_DIRECTORIES and HAVE_DOT tags are set to YES -# then doxygen will show the dependencies a directory has on other directories -# in a graphical way. The dependency relations are determined by the #include -# relations between the files in the directories. - -DIRECTORY_GRAPH = YES - -# The DOT_IMAGE_FORMAT tag can be used to set the image format of the images -# generated by dot. Possible values are png, jpg, or gif -# If left blank png will be used. - -DOT_IMAGE_FORMAT = png - -# The tag DOT_PATH can be used to specify the path where the dot tool can be -# found. If left blank, it is assumed the dot tool can be found in the path. - -DOT_PATH = - -# The DOTFILE_DIRS tag can be used to specify one or more directories that -# contain dot files that are included in the documentation (see the -# \dotfile command). - -DOTFILE_DIRS = - -# The MAX_DOT_GRAPH_WIDTH tag can be used to set the maximum allowed width -# (in pixels) of the graphs generated by dot. If a graph becomes larger than -# this value, doxygen will try to truncate the graph, so that it fits within -# the specified constraint. Beware that most browsers cannot cope with very -# large images. - -MAX_DOT_GRAPH_WIDTH = 1024 - -# The MAX_DOT_GRAPH_HEIGHT tag can be used to set the maximum allows height -# (in pixels) of the graphs generated by dot. If a graph becomes larger than -# this value, doxygen will try to truncate the graph, so that it fits within -# the specified constraint. Beware that most browsers cannot cope with very -# large images. - -MAX_DOT_GRAPH_HEIGHT = 1024 - -# The MAX_DOT_GRAPH_DEPTH tag can be used to set the maximum depth of the -# graphs generated by dot. A depth value of 3 means that only nodes reachable -# from the root by following a path via at most 3 edges will be shown. Nodes -# that lay further from the root node will be omitted. Note that setting this -# option to 1 or 2 may greatly reduce the computation time needed for large -# code bases. Also note that a graph may be further truncated if the graph's -# image dimensions are not sufficient to fit the graph (see MAX_DOT_GRAPH_WIDTH -# and MAX_DOT_GRAPH_HEIGHT). If 0 is used for the depth value (the default), -# the graph is not depth-constrained. - -MAX_DOT_GRAPH_DEPTH = 0 - -# Set the DOT_TRANSPARENT tag to YES to generate images with a transparent -# background. This is disabled by default, which results in a white background. -# Warning: Depending on the platform used, enabling this option may lead to -# badly anti-aliased labels on the edges of a graph (i.e. they become hard to -# read). - -DOT_TRANSPARENT = NO - -# Set the DOT_MULTI_TARGETS tag to YES allow dot to generate multiple output -# files in one run (i.e. multiple -o and -T options on the command line). This -# makes dot run faster, but since only newer versions of dot (>1.8.10) -# support this, this feature is disabled by default. - -DOT_MULTI_TARGETS = NO - -# If the GENERATE_LEGEND tag is set to YES (the default) Doxygen will -# generate a legend page explaining the meaning of the various boxes and -# arrows in the dot generated graphs. - -GENERATE_LEGEND = YES - -# If the DOT_CLEANUP tag is set to YES (the default) Doxygen will -# remove the intermediate dot files that are used to generate -# the various graphs. - -DOT_CLEANUP = YES - -#--------------------------------------------------------------------------- -# Configuration::additions related to the search engine -#--------------------------------------------------------------------------- - -# The SEARCHENGINE tag specifies whether or not a search engine should be -# used. If set to NO the values of all tags below this one will be ignored. - -SEARCHENGINE = NO diff --git a/doc/html/annotated.html b/doc/html/annotated.html deleted file mode 100644 index 57a9ccd..0000000 --- a/doc/html/annotated.html +++ /dev/null @@ -1,28 +0,0 @@ - - -briteny: Class List - - - - -
-
-
-
-

briteny Class List

Here are the classes, structs, unions and interfaces with brief descriptions: - - -
britney.Britney
excuse.Excuse
-
Generated on Fri Aug 18 23:23:25 2006 for briteny by  - -doxygen 1.4.7
- - diff --git a/doc/html/britney_8py-source.html b/doc/html/britney_8py-source.html deleted file mode 100644 index f4bc762..0000000 --- a/doc/html/britney_8py-source.html +++ /dev/null @@ -1,2658 +0,0 @@ - - -briteny: britney.py Source File - - - - -
-
-

britney.py

00001 #!/usr/bin/env python2.4 # -*- coding: utf-8 -*-
-00002 
-00003 # Copyright (C) 2001-2004 Anthony Towns <ajt@debian.org>
-00004 #                         Andreas Barth <aba@debian.org>
-00005 #                         Fabio Tranchitella <kobold@debian.org>
-00006 
-00007 # This program is free software; you can redistribute it and/or modify
-00008 # it under the terms of the GNU General Public License as published by
-00009 # the Free Software Foundation; either version 2 of the License, or
-00010 # (at your option) any later version.
-00011 
-00012 # This program is distributed in the hope that it will be useful,
-00013 # but WITHOUT ANY WARRANTY; without even the implied warranty of
-00014 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-00015 # GNU General Public License for more details.
-00016 
-00017 """
-00018 = Introdution =
-00019 
-00020 This is the Debian testing updater script, also known as "Britney".
-00021 
-00022 Packages are usually installed into the `testing' distribution after
-00023 they have undergone some degree of testing in unstable. The goal of
-00024 this software is to do this task in a smart way, allowing testing
-00025 to be always fully installable and close to being a release candidate.
-00026 
-00027 Britney source code is splitted in two different but related tasks:
-00028 the first one is the generation of the update excuses, while the
-00029 second tries to update testing with the valid candidates; first 
-00030 each package alone, then larger and even larger sets of packages
-00031 together. Each try is accepted if testing is not more uninstallable
-00032 after the update than before.
-00033 
-00034 = Data Loading =
-00035 
-00036 In order to analyze the entire Debian distribution, Britney needs to
-00037 load in memory the whole archive: this means more than 10.000 packages
-00038 for twelve architectures, as well as the dependency interconnection
-00039 between them. For this reason, the memory requirement for running this
-00040 software are quite high and at least 1 gigabyte of RAM should be available.
-00041 
-00042 Britney loads the source packages from the `Sources' file and the binary
-00043 packages from the `Packages_${arch}' files, where ${arch} is substituted
-00044 with the supported architectures. While loading the data, the software
-00045 analyze the dependencies and build a directed weighted graph in memory
-00046 with all the interconnections between the packages (see Britney.read_sources
-00047 and Britney.read_binaries).
-00048 
-00049 Other than source and binary packages, Britney loads the following data:
-00050 
-00051   * Bugs, which contains the count of release-critical bugs for a given
-00052     version of a source package (see Britney.read_bugs).
-00053 
-00054   * Dates, which contains the date of the upload of a given version 
-00055     of a source package (see Britney.read_dates).
-00056 
-00057   * Urgencies, which contains the urgency of the upload of a given
-00058     version of a source package (see Britney.read_urgencies).
-00059 
-00060   * Approvals, which contains the list of approved testing-proposed-updates
-00061     packages (see Britney.read_approvals).
-00062 
-00063   * Hints, which contains lists of commands which modify the standard behaviour
-00064     of Britney (see Britney.read_hints).
-00065 
-00066 For a more detailed explanation about the format of these files, please read
-00067 the documentation of the related methods. The exact meaning of them will be
-00068 instead explained in the chapter "Excuses Generation".
-00069 
-00070 = Excuses =
-00071 
-00072 An excuse is a detailed explanation of why a package can or cannot
-00073 be updated in the testing distribution from a newer package in 
-00074 another distribution (like for example unstable). The main purpose
-00075 of the excuses is to be written in an HTML file which will be 
-00076 published over HTTP. The maintainers will be able to parse it manually
-00077 or automatically to find the explanation of why their packages have
-00078 been updated or not.
-00079 
-00080 == Excuses generation ==
-00081 
-00082 These are the steps (with references to method names) that Britney
-00083 does for the generation of the update excuses.
-00084 
-00085  * If a source package is available in testing but it is not
-00086    present in unstable and no binary packages in unstable are
-00087    built from it, then it is marked for removal.
-00088 
-00089  * Every source package in unstable and testing-proposed-updates,
-00090    if already present in testing, is checked for binary-NMUs, new
-00091    or dropped binary packages in all the supported architectures
-00092    (see Britney.should_upgrade_srcarch). The steps to detect if an
-00093    upgrade is needed are:
-00094 
-00095     1. If there is a `remove' hint for the source package, the package
-00096        is ignored: it will be removed and not updated.
-00097 
-00098     2. For every binary package build from the new source, it checks
-00099        for unsatisfied dependencies, new binary package and updated
-00100        binary package (binNMU) excluding the architecture-independent
-00101        ones and the packages not built from the same source.
-00102 
-00103     3. For every binary package build from the old source, it checks
-00104        if it is still built from the new source; if this is not true
-00105        and the package is not architecture-independent, the script
-00106        removes it from testing.
-00107 
-00108     4. Finally, if there is something worth doing (eg. a new or updated
-00109        binary package) and nothing wrong it marks the source package
-00110        as "Valid candidate", or "Not considered" if there is something
-00111        wrong which prevented the update.
-00112 
-00113  * Every source package in unstable and testing-proposed-updates is
-00114    checked for upgrade (see Britney.should_upgrade_src). The steps
-00115    to detect if an upgrade is needed are:
-00116 
-00117     1. If the source package in testing is more recent the new one
-00118        is ignored.
-00119 
-00120     2. If the source package doesn't exist (is fake), which means that
-00121        a binary package refers to it but it is not present in the
-00122        `Sources' file, the new one is ignored.
-00123 
-00124     3. If the package doesn't exist in testing, the urgency of the
-00125        upload is ignored and set to the default (actually `low').
-00126 
-00127     4. If there is a `remove' hint for the source package, the package
-00128        is ignored: it will be removed and not updated.
-00129 
-00130     5. If there is a `block' hint for the source package without an
-00131        `unblock` hint or a `block-all source`, the package is ignored.
-00132 
-00133     7. If the suite is unstable, the update can go ahead only if the
-00134        upload happend more then the minimum days specified by the
-00135        urgency of the upload; if this is not true, the package is
-00136        ignored as `too-young'. Note that the urgency is sticky, meaning
-00137        that the highest urgency uploaded since the previous testing
-00138        transition is taken into account.
-00139 
-00140     8. All the architecture-dependent binary packages and the
-00141        architecture-independent ones for the `nobreakall' architectures
-00142        have to be built from the source we are considering. If this is
-00143        not true, then these are called `out-of-date' architectures and
-00144        the package is ignored.
-00145 
-00146     9. The source package must have at least a binary package, otherwise
-00147        it is ignored.
-00148 
-00149    10. If the suite is unstable, the count of release critical bugs for
-00150        the new source package must be less then the count for the testing
-00151        one. If this is not true, the package is ignored as `buggy'.
-00152 
-00153    11. If there is a `force' hint for the source package, then it is
-00154        updated even if it is marked as ignored from the previous steps.
-00155 
-00156    12. If the suite is testing-proposed-updates, the source package can
-00157        be updated only if there is an explicit approval for it.
-00158 
-00159    13. If the package will be ignored, mark it as "Valid candidate",
-00160        otherwise mark it as "Not considered".
-00161 
-00162  * The list of `remove' hints is processed: if the requested source
-00163    package is not already being updated or removed and the version
-00164    actually in testing is the same specified with the `remove' hint,
-00165    it is marked for removal.
-00166 
-00167  * The excuses are sorted by the number of days from the last upload
-00168    (days-old) and by name.
-00169 
-00170  * A list of unconsidered excuses (for which the package is not upgraded)
-00171    is built. Using this list, all the excuses depending on them is marked
-00172    as invalid for "unpossible dependency".
-00173 
-00174  * The excuses are written in an HTML file.
-00175 """
-00176 
-00177 import os
-00178 import re
-00179 import sys
-00180 import string
-00181 import time
-00182 import copy
-00183 import optparse
-00184 import operator
-00185 
-00186 import apt_pkg
-00187 
-00188 from excuse import Excuse
-00189 
-00190 __author__ = 'Fabio Tranchitella'
-00191 __version__ = '2.0.alpha1'
-00192 
-00193 # source package
-00194 VERSION = 0
-00195 SECTION = 1
-00196 BINARIES = 2
-00197 MAINTAINER = 3
-00198 FAKESRC = 4
-00199 
-00200 # binary package
-00201 SOURCE = 2
-00202 SOURCEVER = 3
-00203 ARCHITECTURE = 4
-00204 PREDEPENDS = 5
-00205 DEPENDS = 6
-00206 CONFLICTS = 7
-00207 PROVIDES = 8
-00208 RDEPENDS = 9
-00209 RCONFLICTS = 10
-00210 
-00211 
-00212 class Britney:
-00213     """Britney, the debian testing updater script
-00214     
-00215     This is the script that updates the testing_ distribution. It is executed
-00216     each day after the installation of the updated packages. It generates the 
-00217     `Packages' files for the testing distribution, but it does so in an
-00218     intelligent manner; it try to avoid any inconsistency and to use only
-00219     non-buggy packages.
-00220 
-00221     For more documentation on this script, please read the Developers Reference.
-00222     """
-00223 
-00224     HINTS_STANDARD = ("easy", "hint", "remove", "block", "unblock", "urgent", "approve")
-00225     HINTS_ALL = ("force", "force-hint", "block-all") + HINTS_STANDARD
-00226 
-00227     def __init__(self):
-00228         """Class constructor
-00229 
-00230         This method initializes and populates the data lists, which contain all
-00231         the information needed by the other methods of the class.
-00232         """
-00233         self.date_now = int(((time.time() / (60*60)) - 15) / 24)
-00234 
-00235         # parse the command line arguments
-00236         self.__parse_arguments()
-00237 
-00238         # initialize the apt_pkg back-end
-00239         apt_pkg.init()
-00240 
-00241         # if requested, build the non-installable status and save it
-00242         if not self.options.nuninst_cache:
-00243             self.__log("Building the list of not installable packages for the full archive", type="I")
-00244             self.sources = {'testing': self.read_sources(self.options.testing)}
-00245             nuninst = {}
-00246             for arch in self.options.architectures:
-00247                 self.binaries = {'testing': {arch: self.read_binaries(self.options.testing, "testing", arch)}}
-00248                 self.__log("> Checking for non-installable packages for architecture %s" % arch, type="I")
-00249                 result = self.get_nuninst(arch, build=True)
-00250                 nuninst.update(result)
-00251                 self.__log("> Found %d non-installable packages" % len(nuninst[arch]), type="I")
-00252             self.write_nuninst(nuninst)
-00253         else:
-00254             self.__log("Not building the list of not installable packages, as requested", type="I")
-00255 
-00256         # read the source and binary packages for the involved distributions
-00257         self.sources = {'testing': self.read_sources(self.options.testing),
-00258                         'unstable': self.read_sources(self.options.unstable),
-00259                         'tpu': self.read_sources(self.options.tpu),}
-00260         self.binaries = {'testing': {}, 'unstable': {}, 'tpu': {}}
-00261         for arch in self.options.architectures:
-00262             self.binaries['testing'][arch] = self.read_binaries(self.options.testing, "testing", arch)
-00263             self.binaries['unstable'][arch] = self.read_binaries(self.options.unstable, "unstable", arch)
-00264             self.binaries['tpu'][arch] = self.read_binaries(self.options.tpu, "tpu", arch)
-00265 
-00266         # read the release-critical bug summaries for testing and unstable
-00267         self.bugs = {'unstable': self.read_bugs(self.options.unstable),
-00268                      'testing': self.read_bugs(self.options.testing),}
-00269         self.normalize_bugs()
-00270 
-00271         # read additional data
-00272         self.dates = self.read_dates(self.options.testing)
-00273         self.urgencies = self.read_urgencies(self.options.testing)
-00274         self.approvals = self.read_approvals(self.options.tpu)
-00275         self.hints = self.read_hints(self.options.unstable)
-00276         self.excuses = []
-00277         self.dependencies = {}
-00278 
-00279     def __parse_arguments(self):
-00280         """Parse the command line arguments
-00281 
-00282         This method parses and initializes the command line arguments.
-00283         While doing so, it preprocesses some of the options to be converted
-00284         in a suitable form for the other methods of the class.
-00285         """
-00286         # initialize the parser
-00287         self.parser = optparse.OptionParser(version="%prog")
-00288         self.parser.add_option("-v", "", action="count", dest="verbose", help="enable verbose output")
-00289         self.parser.add_option("-c", "--config", action="store", dest="config", default="/etc/britney.conf",
-00290                                help="path for the configuration file")
-00291         self.parser.add_option("", "--architectures", action="store", dest="architectures", default=None,
-00292                                help="override architectures from configuration file")
-00293         self.parser.add_option("", "--actions", action="store", dest="actions", default=None,
-00294                                help="override the list of actions to be performed")
-00295         self.parser.add_option("", "--dry-run", action="store_true", dest="dry_run", default=False,
-00296                                help="disable all outputs to the testing directory")
-00297         self.parser.add_option("", "--compatible", action="store_true", dest="compatible", default=False,
-00298                                help="enable full compatibility with old britney's output")
-00299         self.parser.add_option("", "--control-files", action="store_true", dest="control_files", default=False,
-00300                                help="enable control files generation")
-00301         self.parser.add_option("", "--nuninst-cache", action="store_true", dest="nuninst_cache", default=False,
-00302                                help="do not build the non-installability status, use the cache from file")
-00303         (self.options, self.args) = self.parser.parse_args()
-00304 
-00305         # if the configuration file exists, than read it and set the additional options
-00306         if not os.path.isfile(self.options.config):
-00307             self.__log("Unable to read the configuration file (%s), exiting!" % self.options.config, type="E")
-00308             sys.exit(1)
-00309 
-00310         # minimum days for unstable-testing transition and the list of hints
-00311         # are handled as an ad-hoc case
-00312         self.MINDAYS = {}
-00313         self.HINTS = {}
-00314         for k, v in [map(string.strip,r.split('=', 1)) for r in file(self.options.config) if '=' in r and not r.strip().startswith('#')]:
-00315             if k.startswith("MINDAYS_"):
-00316                 self.MINDAYS[k.split("_")[1].lower()] = int(v)
-00317             elif k.startswith("HINTS_"):
-00318                 self.HINTS[k.split("_")[1].lower()] = \
-00319                     reduce(lambda x,y: x+y, [hasattr(self, "HINTS_" + i) and getattr(self, "HINTS_" + i) or (i,) for i in v.split()])
-00320             elif not hasattr(self.options, k.lower()) or \
-00321                  not getattr(self.options, k.lower()):
-00322                 setattr(self.options, k.lower(), v)
-00323 
-00324         # Sort the architecture list
-00325         allarches = sorted(self.options.architectures.split())
-00326         arches = [x for x in allarches if x in self.options.nobreakall_arches]
-00327         arches += [x for x in allarches if x not in arches and x not in self.options.fucked_arches.split()]
-00328         arches += [x for x in allarches if x not in arches and x not in self.options.break_arches.split()]
-00329         arches += [x for x in allarches if x not in arches and x not in self.options.new_arches.split()]
-00330         arches += [x for x in allarches if x not in arches]
-00331         self.options.architectures = arches
-00332         self.options.smooth_updates = self.options.smooth_updates.split()
-00333 
-00334     def __log(self, msg, type="I"):
-00335         """Print info messages according to verbosity level
-00336         
-00337         An easy-and-simple log method which prints messages to the standard
-00338         output. The type parameter controls the urgency of the message, and
-00339         can be equal to `I' for `Information', `W' for `Warning' and `E' for
-00340         `Error'. Warnings and errors are always printed, and information are
-00341         printed only if the verbose logging is enabled.
-00342         """
-00343         if self.options.verbose or type in ("E", "W"):
-00344             print "%s: [%s] - %s" % (type, time.asctime(), msg)
-00345 
-00346     # Data reading/writing methods
-00347     # ----------------------------
-00348 
-00349     def read_sources(self, basedir):
-00350         """Read the list of source packages from the specified directory
-00351         
-00352         The source packages are read from the `Sources' file within the
-00353         directory specified as `basedir' parameter. Considering the
-00354         large amount of memory needed, not all the fields are loaded
-00355         in memory. The available fields are Version, Maintainer and Section.
-00356 
-00357         The method returns a list where every item represents a source
-00358         package as a dictionary.
-00359         """
-00360         sources = {}
-00361         package = None
-00362         filename = os.path.join(basedir, "Sources")
-00363         self.__log("Loading source packages from %s" % filename)
-00364         Packages = apt_pkg.ParseTagFile(open(filename))
-00365         get_field = Packages.Section.get
-00366         while Packages.Step():
-00367             pkg = get_field('Package')
-00368             sources[pkg] = [get_field('Version'),
-00369                             get_field('Section'),
-00370                             [],
-00371                             get_field('Maintainer'),
-00372                             False,
-00373                            ]
-00374         return sources
-00375 
-00376     def read_binaries(self, basedir, distribution, arch):
-00377         """Read the list of binary packages from the specified directory
-00378         
-00379         The binary packages are read from the `Packages_${arch}' files
-00380         within the directory specified as `basedir' parameter, replacing
-00381         ${arch} with the value of the arch parameter. Considering the
-00382         large amount of memory needed, not all the fields are loaded
-00383         in memory. The available fields are Version, Source, Pre-Depends,
-00384         Depends, Conflicts, Provides and Architecture.
-00385         
-00386         After reading the packages, reverse dependencies are computed
-00387         and saved in the `rdepends' keys, and the `Provides' field is
-00388         used to populate the virtual packages list.
-00389 
-00390         The dependencies are parsed with the apt.pkg.ParseDepends method,
-00391         and they are stored both as the format of its return value and
-00392         text.
-00393 
-00394         The method returns a tuple. The first element is a list where
-00395         every item represents a binary package as a dictionary; the second
-00396         element is a dictionary which maps virtual packages to real
-00397         packages that provide it.
-00398         """
-00399 
-00400         packages = {}
-00401         provides = {}
-00402         sources = self.sources
-00403         package = None
-00404 
-00405         filename = os.path.join(basedir, "Packages_%s" % arch)
-00406         self.__log("Loading binary packages from %s" % filename)
-00407         Packages = apt_pkg.ParseTagFile(open(filename))
-00408         get_field = Packages.Section.get
-00409         while Packages.Step():
-00410             pkg = get_field('Package')
-00411             version = get_field('Version')
-00412             dpkg = [version,
-00413                     get_field('Section'),
-00414                     pkg, 
-00415                     version,
-00416                     get_field('Architecture'),
-00417                     get_field('Pre-Depends'),
-00418                     get_field('Depends'),
-00419                     get_field('Conflicts'),
-00420                     get_field('Provides'),
-00421                     [],
-00422                     [],
-00423                    ]
-00424 
-00425             # retrieve the name and the version of the source package
-00426             source = get_field('Source')
-00427             if source:
-00428                 dpkg[SOURCE] = source.split(" ")[0]
-00429                 if "(" in source:
-00430                     dpkg[SOURCEVER] = source[source.find("(")+1:source.find(")")]
-00431 
-00432             # if the source package is available in the distribution, then register this binary package
-00433             if dpkg[SOURCE] in sources[distribution]:
-00434                 sources[distribution][dpkg[SOURCE]][BINARIES].append(pkg + "/" + arch)
-00435             # if the source package doesn't exist, create a fake one
-00436             else:
-00437                 sources[distribution][dpkg[SOURCE]] = [dpkg[SOURCEVER], None, [pkg + "/" + arch], None, True]
-00438 
-00439             # register virtual packages and real packages that provide them
-00440             if dpkg[PROVIDES]:
-00441                 parts = map(string.strip, dpkg[PROVIDES].split(","))
-00442                 for p in parts:
-00443                     if p not in provides:
-00444                         provides[p] = []
-00445                     provides[p].append(pkg)
-00446                 dpkg[PROVIDES] = parts
-00447             else: dpkg[PROVIDES] = []
-00448 
-00449             # add the resulting dictionary to the package list
-00450             packages[pkg] = dpkg
-00451 
-00452         # loop again on the list of packages to register reverse dependencies and conflicts
-00453         register_reverses = self.register_reverses
-00454         for pkg in packages:
-00455             register_reverses(pkg, packages, provides, check_doubles=False)
-00456 
-00457         # return a tuple with the list of real and virtual packages
-00458         return (packages, provides)
-00459 
-00460     def register_reverses(self, pkg, packages, provides, check_doubles=True, parse_depends=apt_pkg.ParseDepends):
-00461         """Register reverse dependencies and conflicts for the specified package
-00462 
-00463         This method register the reverse dependencies and conflicts for
-00464         a give package using `packages` as list of packages and `provides`
-00465         as list of virtual packages.
-00466 
-00467         The method has an optional parameter parse_depends which is there
-00468         just for performance reasons and is not meant to be overwritten.
-00469         """
-00470         # register the list of the dependencies for the depending packages
-00471         dependencies = []
-00472         if packages[pkg][DEPENDS]:
-00473             dependencies.extend(parse_depends(packages[pkg][DEPENDS]))
-00474         if packages[pkg][PREDEPENDS]:
-00475             dependencies.extend(parse_depends(packages[pkg][PREDEPENDS]))
-00476         # go through the list
-00477         for p in dependencies:
-00478             for a in p:
-00479                 # register real packages
-00480                 if a[0] in packages and (not check_doubles or pkg not in packages[a[0]][RDEPENDS]):
-00481                     packages[a[0]][RDEPENDS].append(pkg)
-00482                 # register packages which provides a virtual package
-00483                 elif a[0] in provides:
-00484                     for i in provides.get(a[0]):
-00485                         if i not in packages: continue
-00486                         if not check_doubles or pkg not in packages[i][RDEPENDS]:
-00487                             packages[i][RDEPENDS].append(pkg)
-00488         # register the list of the conflicts for the conflicting packages
-00489         if packages[pkg][CONFLICTS]:
-00490             for p in parse_depends(packages[pkg][CONFLICTS]):
-00491                 for a in p:
-00492                     # register real packages
-00493                     if a[0] in packages and (not check_doubles or pkg not in packages[a[0]][RCONFLICTS]):
-00494                         packages[a[0]][RCONFLICTS].append(pkg)
-00495                     # register packages which provides a virtual package
-00496                     elif a[0] in provides:
-00497                         for i in provides[a[0]]:
-00498                             if i not in packages: continue
-00499                             if not check_doubles or pkg not in packages[i][RCONFLICTS]:
-00500                                 packages[i][RCONFLICTS].append(pkg)
-00501      
-00502     def read_bugs(self, basedir):
-00503         """Read the release critial bug summary from the specified directory
-00504         
-00505         The RC bug summaries are read from the `Bugs' file within the
-00506         directory specified as `basedir' parameter. The file contains
-00507         rows with the format:
-00508 
-00509         <package-name> <count-of-rc-bugs>
-00510 
-00511         The method returns a dictionary where the key is the binary package
-00512         name and the value is the number of open RC bugs for it.
-00513         """
-00514         bugs = {}
-00515         filename = os.path.join(basedir, "Bugs")
-00516         self.__log("Loading RC bugs count from %s" % filename)
-00517         for line in open(filename):
-00518             l = line.split()
-00519             if len(l) != 2: continue
-00520             try:
-00521                 bugs[l[0]] = int(l[1])
-00522             except ValueError:
-00523                 self.__log("Bugs, unable to parse \"%s\"" % line, type="E")
-00524         return bugs
-00525 
-00526     def write_bugs(self, basedir, bugs):
-00527         """Write the release critical bug summary to the specified directory
-00528 
-00529         For a more detailed explanation of the format, please check the method
-00530         read_bugs.
-00531         """
-00532         filename = os.path.join(basedir, "Bugs")
-00533         self.__log("Writing RC bugs count to %s" % filename)
-00534         f = open(filename, 'w')
-00535         for pkg in sorted(bugs.keys()):
-00536             if bugs[pkg] == 0: continue
-00537             f.write("%s %d\n" % (pkg, bugs[pkg]))
-00538         f.close()
-00539 
-00540     def __maxver(self, pkg, dist):
-00541         """Return the maximum version for a given package name
-00542         
-00543         This method returns None if the specified source package
-00544         is not available in the `dist' distribution. If the package
-00545         exists, then it returns the maximum version between the
-00546         source package and its binary packages.
-00547         """
-00548         maxver = None
-00549         if pkg in self.sources[dist]:
-00550             maxver = self.sources[dist][pkg][VERSION]
-00551         for arch in self.options.architectures:
-00552             if pkg not in self.binaries[dist][arch][0]: continue
-00553             pkgv = self.binaries[dist][arch][0][pkg][VERSION]
-00554             if maxver == None or apt_pkg.VersionCompare(pkgv, maxver) > 0:
-00555                 maxver = pkgv
-00556         return maxver
-00557 
-00558     def normalize_bugs(self):
-00559         """Normalize the release critical bug summaries for testing and unstable
-00560         
-00561         The method doesn't return any value: it directly modifies the
-00562         object attribute `bugs'.
-00563         """
-00564         # loop on all the package names from testing and unstable bug summaries
-00565         for pkg in set(self.bugs['testing'].keys() + self.bugs['unstable'].keys()):
-00566 
-00567             # make sure that the key is present in both dictionaries
-00568             if pkg not in self.bugs['testing']:
-00569                 self.bugs['testing'][pkg] = 0
-00570             elif pkg not in self.bugs['unstable']:
-00571                 self.bugs['unstable'][pkg] = 0
-00572 
-00573             # retrieve the maximum version of the package in testing:
-00574             maxvert = self.__maxver(pkg, 'testing')
-00575 
-00576             # if the package is not available in testing or it has the
-00577             # same RC bug count, then do nothing
-00578             if maxvert == None or \
-00579                self.bugs['testing'][pkg] == self.bugs['unstable'][pkg]:
-00580                 continue
-00581 
-00582             # retrieve the maximum version of the package in testing:
-00583             maxveru = self.__maxver(pkg, 'unstable')
-00584 
-00585             # if the package is not available in unstable, then do nothing
-00586             if maxveru == None:
-00587                 continue
-00588             # else if the testing package is more recent, then use the
-00589             # unstable RC bug count for testing, too
-00590             elif apt_pkg.VersionCompare(maxvert, maxveru) >= 0:
-00591                 self.bugs['testing'][pkg] = self.bugs['unstable'][pkg]
-00592 
-00593     def read_dates(self, basedir):
-00594         """Read the upload date for the packages from the specified directory
-00595         
-00596         The upload dates are read from the `Date' file within the directory
-00597         specified as `basedir' parameter. The file contains rows with the
-00598         format:
-00599 
-00600         <package-name> <version> <date-of-upload>
-00601 
-00602         The dates are expressed as days starting from the 1970-01-01.
-00603 
-00604         The method returns a dictionary where the key is the binary package
-00605         name and the value is tuple with two items, the version and the date.
-00606         """
-00607         dates = {}
-00608         filename = os.path.join(basedir, "Dates")
-00609         self.__log("Loading upload data from %s" % filename)
-00610         for line in open(filename):
-00611             l = line.split()
-00612             if len(l) != 3: continue
-00613             try:
-00614                 dates[l[0]] = (l[1], int(l[2]))
-00615             except ValueError:
-00616                 self.__log("Dates, unable to parse \"%s\"" % line, type="E")
-00617         return dates
-00618 
-00619     def write_dates(self, basedir, dates):
-00620         """Write the upload date for the packages to the specified directory
-00621 
-00622         For a more detailed explanation of the format, please check the method
-00623         read_dates.
-00624         """
-00625         filename = os.path.join(basedir, "Dates")
-00626         self.__log("Writing upload data to %s" % filename)
-00627         f = open(filename, 'w')
-00628         for pkg in sorted(dates.keys()):
-00629             f.write("%s %s %d\n" % ((pkg,) + dates[pkg]))
-00630         f.close()
-00631 
-00632 
-00633     def read_urgencies(self, basedir):
-00634         """Read the upload urgency of the packages from the specified directory
-00635         
-00636         The upload urgencies are read from the `Urgency' file within the
-00637         directory specified as `basedir' parameter. The file contains rows
-00638         with the format:
-00639 
-00640         <package-name> <version> <urgency>
-00641 
-00642         The method returns a dictionary where the key is the binary package
-00643         name and the value is the greatest urgency from the versions of the
-00644         package that are higher then the testing one.
-00645         """
-00646 
-00647         urgencies = {}
-00648         filename = os.path.join(basedir, "Urgency")
-00649         self.__log("Loading upload urgencies from %s" % filename)
-00650         for line in open(filename):
-00651             l = line.split()
-00652             if len(l) != 3: continue
-00653 
-00654             # read the minimum days associated to the urgencies
-00655             urgency_old = urgencies.get(l[0], self.options.default_urgency)
-00656             mindays_old = self.MINDAYS.get(urgency_old, self.MINDAYS[self.options.default_urgency])
-00657             mindays_new = self.MINDAYS.get(l[2], self.MINDAYS[self.options.default_urgency])
-00658 
-00659             # if the new urgency is lower (so the min days are higher), do nothing
-00660             if mindays_old <= mindays_new:
-00661                 continue
-00662 
-00663             # if the package exists in testing and it is more recent, do nothing
-00664             tsrcv = self.sources['testing'].get(l[0], None)
-00665             if tsrcv and apt_pkg.VersionCompare(tsrcv[VERSION], l[1]) >= 0:
-00666                 continue
-00667 
-00668             # if the package doesn't exist in unstable or it is older, do nothing
-00669             usrcv = self.sources['unstable'].get(l[0], None)
-00670             if not usrcv or apt_pkg.VersionCompare(usrcv[VERSION], l[1]) < 0:
-00671                 continue
-00672 
-00673             # update the urgency for the package
-00674             urgencies[l[0]] = l[2]
-00675 
-00676         return urgencies
-00677 
-00678     def read_approvals(self, basedir):
-00679         """Read the approval commands from the specified directory
-00680         
-00681         The approval commands are read from the files contained by the 
-00682         `Approved' directory within the directory specified as `basedir'
-00683         parameter. The name of the files has to be the same of the
-00684         authorized users for the approvals.
-00685         
-00686         The file contains rows with the format:
-00687 
-00688         <package-name> <version>
-00689 
-00690         The method returns a dictionary where the key is the binary package
-00691         name followed by an underscore and the version number, and the value
-00692         is the user who submitted the command.
-00693         """
-00694         approvals = {}
-00695         for approver in self.options.approvers.split():
-00696             filename = os.path.join(basedir, "Approved", approver)
-00697             self.__log("Loading approvals list from %s" % filename)
-00698             for line in open(filename):
-00699                 l = line.split()
-00700                 if len(l) != 2: continue
-00701                 approvals["%s_%s" % (l[0], l[1])] = approver
-00702         return approvals
-00703 
-00704     def read_hints(self, basedir):
-00705         """Read the hint commands from the specified directory
-00706         
-00707         The hint commands are read from the files contained by the `Hints'
-00708         directory within the directory specified as `basedir' parameter. 
-00709         The name of the files has to be the same of the authorized users
-00710         for the hints.
-00711         
-00712         The file contains rows with the format:
-00713 
-00714         <command> <package-name>[/<version>]
-00715 
-00716         The method returns a dictionary where the key is the command, and
-00717         the value is the list of affected packages.
-00718         """
-00719         hints = dict([(k,[]) for k in self.HINTS_ALL])
-00720 
-00721         for who in self.HINTS.keys():
-00722             filename = os.path.join(basedir, "Hints", who)
-00723             self.__log("Loading hints list from %s" % filename)
-00724             for line in open(filename):
-00725                 line = line.strip()
-00726                 if line == "": continue
-00727                 l = line.split()
-00728                 if l[0] == 'finished':
-00729                     break
-00730                 elif l[0] not in self.HINTS[who]:
-00731                     continue
-00732                 elif l[0] in ["easy", "hint", "force-hint"]:
-00733                     hints[l[0]].append((who, [k.split("/") for k in l if "/" in k]))
-00734                 elif l[0] in ["block-all"]:
-00735                     hints[l[0]].extend([(y, who) for y in l[1:]])
-00736                 elif l[0] in ["block"]:
-00737                     hints[l[0]].extend([(y, who) for y in l[1:]])
-00738                 elif l[0] in ["remove", "approve", "unblock", "force", "urgent"]:
-00739                     hints[l[0]].extend([(k.split("/")[0], (k.split("/")[1],who) ) for k in l if "/" in k])
-00740 
-00741         for x in ["block", "block-all", "unblock", "force", "urgent", "remove"]:
-00742             z = {}
-00743             for a, b in hints[x]:
-00744                 if a in z:
-00745                     self.__log("Overriding %s[%s] = %s with %s" % (x, a, z[a], b), type="W")
-00746                 z[a] = b
-00747             hints[x] = z
-00748 
-00749         return hints
-00750 
-00751     def write_heidi(self, basedir, filename):
-00752         """Write the output HeidiResult
-00753 
-00754         This method write the output for Heidi, which contains all the
-00755         binary packages and the source packages in the form:
-00756         
-00757         <pkg-name> <pkg-version> <pkg-architecture> <pkg-section>
-00758         <src-name> <src-version> <src-section>
-00759         """
-00760         filename = os.path.join(basedir, filename)
-00761         self.__log("Writing Heidi results to %s" % filename)
-00762         f = open(filename, 'w')
-00763 
-00764         # local copies
-00765         sources = self.sources['testing']
-00766 
-00767         # write binary packages
-00768         for arch in sorted(self.options.architectures):
-00769             binaries = self.binaries['testing'][arch][0]
-00770             for pkg_name in sorted(binaries):
-00771                 pkg = binaries[pkg_name]
-00772                 pkgv = pkg[VERSION]
-00773                 pkgarch = pkg[ARCHITECTURE]
-00774                 pkgsec = pkg[SECTION] or 'unknown'
-00775                 f.write('%s %s %s %s\n' % (pkg_name, pkgv, pkgarch, pkgsec))
-00776 
-00777         # write sources
-00778         for src_name in sorted(sources):
-00779             src = sources[src_name]
-00780             srcv = src[VERSION]
-00781             srcsec = src[FAKESRC] and 'faux' or src[SECTION] or 'unknown'
-00782             f.write('%s %s source %s\n' % (src_name, srcv, srcsec))
-00783 
-00784         f.close()
-00785 
-00786     def write_controlfiles(self, basedir, suite):
-00787         """Write the control files
-00788 
-00789         This method write the control files for the binary packages of all
-00790         the architectures and for the source packages.
-00791         """
-00792         sources = self.sources[suite]
-00793 
-00794         self.__log("Writing new %s control files to %s" % (suite, basedir))
-00795         for arch in self.options.architectures:
-00796             filename = os.path.join(basedir, 'Packages_%s' % arch)
-00797             f = open(filename, 'w')
-00798             binaries = self.binaries[suite][arch][0]
-00799             for pkg in binaries:
-00800                 output = "Package: %s\n" % pkg
-00801                 for key, k in ((SECTION, 'Section'), (ARCHITECTURE, 'Architecture'), (SOURCE, 'Source'), (VERSION, 'Version'), 
-00802                           (PREDEPENDS, 'Pre-Depends'), (DEPENDS, 'Depends'), (PROVIDES, 'Provides'), (CONFLICTS, 'Conflicts')):
-00803                     if not binaries[pkg][key]: continue
-00804                     if key == SOURCE:
-00805                         if binaries[pkg][SOURCE] == pkg:
-00806                             if binaries[pkg][SOURCEVER] != binaries[pkg][VERSION]:
-00807                                 source = binaries[pkg][SOURCE] + " (" + binaries[pkg][SOURCEVER] + ")"
-00808                             else: continue
-00809                         else:
-00810                             if binaries[pkg][SOURCEVER] != binaries[pkg][VERSION]:
-00811                                 source = binaries[pkg][SOURCE] + " (" + binaries[pkg][SOURCEVER] + ")"
-00812                             else:
-00813                                 source = binaries[pkg][SOURCE]
-00814                         output += (k + ": " + source + "\n")
-00815                         if sources[binaries[pkg][SOURCE]][MAINTAINER]:
-00816                             output += (k + ": " + sources[binaries[pkg][SOURCE]][MAINTAINER] + "\n")
-00817                     elif key == PROVIDES:
-00818                         if len(binaries[pkg][key]) > 0:
-00819                             output += (k + ": " + ", ".join(binaries[pkg][key]) + "\n")
-00820                     else:
-00821                         output += (k + ": " + binaries[pkg][key] + "\n")
-00822                 f.write(output + "\n")
-00823             f.close()
-00824 
-00825         filename = os.path.join(basedir, 'Sources')
-00826         f = open(filename, 'w')
-00827         for src in sources:
-00828             output = "Package: %s\n" % src
-00829             for k in ('Version', 'Section', 'Maintainer'):
-00830                 key = k.lower()
-00831                 if key not in sources[src] or not sources[src][key]: continue
-00832                 output += (k + ": " + sources[src][key] + "\n")
-00833             f.write(output + "\n")
-00834         f.close()
-00835 
-00836     def write_nuninst(self, nuninst):
-00837         """Write the non-installable report"""
-00838         f = open(self.options.noninst_status, 'w')
-00839         f.write("Built on: " + time.strftime("%Y.%m.%d %H:%M:%S %z", time.gmtime(time.time())) + "\n")
-00840         f.write("Last update: " + time.strftime("%Y.%m.%d %H:%M:%S %z", time.gmtime(time.time())) + "\n\n")
-00841         f.write("".join([k + ": " + " ".join(nuninst[k]) + "\n" for k in nuninst]))
-00842         f.close()
-00843 
-00844     def read_nuninst(self):
-00845         """Read the non-installable report"""
-00846         f = open(self.options.noninst_status)
-00847         nuninst = {}
-00848         for r in f:
-00849             if ":" not in r: continue
-00850             arch, packages = r.strip().split(":", 1)
-00851             if arch.split("+", 1)[0] in self.options.architectures:
-00852                 nuninst[arch] = packages.split()
-00853         return nuninst
-00854 
-00855 
-00856     # Utility methods for package analysis
-00857     # ------------------------------------
-00858 
-00859     def same_source(self, sv1, sv2):
-00860         """Check if two version numbers are built from the same source
-00861 
-00862         This method returns a boolean value which is true if the two
-00863         version numbers specified as parameters are built from the same
-00864         source. The main use of this code is to detect binary-NMU.
-00865         """
-00866         if sv1 == sv2:
-00867             return 1
-00868 
-00869         m = re.match(r'^(.*)\+b\d+$', sv1)
-00870         if m: sv1 = m.group(1)
-00871         m = re.match(r'^(.*)\+b\d+$', sv2)
-00872         if m: sv2 = m.group(1)
-00873 
-00874         if sv1 == sv2:
-00875             return 1
-00876 
-00877         if re.search("-", sv1) or re.search("-", sv2):
-00878             m = re.match(r'^(.*-[^.]+)\.0\.\d+$', sv1)
-00879             if m: sv1 = m.group(1)
-00880             m = re.match(r'^(.*-[^.]+\.[^.]+)\.\d+$', sv1)
-00881             if m: sv1 = m.group(1)
-00882 
-00883             m = re.match(r'^(.*-[^.]+)\.0\.\d+$', sv2)
-00884             if m: sv2 = m.group(1)
-00885             m = re.match(r'^(.*-[^.]+\.[^.]+)\.\d+$', sv2)
-00886             if m: sv2 = m.group(1)
-00887 
-00888             return (sv1 == sv2)
-00889         else:
-00890             m = re.match(r'^([^-]+)\.0\.\d+$', sv1)
-00891             if m and sv2 == m.group(1): return 1
-00892 
-00893             m = re.match(r'^([^-]+)\.0\.\d+$', sv2)
-00894             if m and sv1 == m.group(1): return 1
-00895 
-00896             return 0
-00897 
-00898     def get_dependency_solvers(self, block, arch, distribution, excluded=[], strict=False):
-00899         """Find the packages which satisfy a dependency block
-00900 
-00901         This method returns the list of packages which satisfy a dependency
-00902         block (as returned by apt_pkg.ParseDepends) for the given architecture
-00903         and distribution.
-00904 
-00905         It returns a tuple with two items: the first is a boolean which is
-00906         True if the dependency is satisfied, the second is the list of the
-00907         solving packages.
-00908         """
-00909 
-00910         packages = []
-00911 
-00912         # local copies for better performances
-00913         binaries = self.binaries[distribution][arch]
-00914 
-00915         # for every package, version and operation in the block
-00916         for name, version, op in block:
-00917             # look for the package in unstable
-00918             if name not in excluded and name in binaries[0]:
-00919                 package = binaries[0][name]
-00920                 # check the versioned dependency (if present)
-00921                 if op == '' and version == '' or apt_pkg.CheckDep(package[VERSION], op, version):
-00922                     packages.append(name)
-00923 
-00924             # look for the package in the virtual packages list and loop on them
-00925             for prov in binaries[1].get(name, []):
-00926                 if prov in excluded or \
-00927                    prov not in binaries[0]: continue
-00928                 package = binaries[0][prov]
-00929                 # check the versioned dependency (if present)
-00930                 # TODO: this is forbidden by the debian policy, which says that versioned
-00931                 #       dependencies on virtual packages are never satisfied. The old britney
-00932                 #       does it and we have to go with it, but at least a warning should be raised.
-00933                 if op == '' and version == '' or not strict and apt_pkg.CheckDep(package[VERSION], op, version):
-00934                     packages.append(prov)
-00935                     break
-00936 
-00937         return (len(packages) > 0, packages)
-00938 
-00939     def excuse_unsat_deps(self, pkg, src, arch, suite, excuse, excluded=[], conflicts=False):
-00940         """Find unsatisfied dependencies for a binary package
-00941 
-00942         This method analyzes the dependencies of the binary package specified
-00943         by the parameter `pkg', built from the source package `src', for the
-00944         architecture `arch' within the suite `suite'. If the dependency can't
-00945         be satisfied in testing and/or unstable, it updates the excuse passed
-00946         as parameter.
-00947 
-00948         The dependency fields checked are Pre-Depends and Depends.
-00949         """
-00950         # retrieve the binary package from the specified suite and arch
-00951         binary_u = self.binaries[suite][arch][0][pkg]
-00952 
-00953         # local copies for better performances
-00954         parse_depends = apt_pkg.ParseDepends
-00955         get_dependency_solvers = self.get_dependency_solvers
-00956         strict = True # not self.options.compatible
-00957 
-00958         # analyze the dependency fields (if present)
-00959         for type_key, type in ((PREDEPENDS, 'Pre-Depends'), (DEPENDS, 'Depends')):
-00960             if not binary_u[type_key]:
-00961                 continue
-00962 
-00963             # for every block of dependency (which is formed as conjunction of disconjunction)
-00964             for block, block_txt in zip(parse_depends(binary_u[type_key]), binary_u[type_key].split(',')):
-00965                 # if the block is satisfied in testing, then skip the block
-00966                 solved, packages = get_dependency_solvers(block, arch, 'testing', excluded, strict=strict)
-00967                 if solved:
-00968                     for p in packages:
-00969                         if p not in self.binaries[suite][arch][0]: continue
-00970                         excuse.add_sane_dep(self.binaries[suite][arch][0][p][SOURCE])
-00971                     continue
-00972 
-00973                 # check if the block can be satisfied in unstable, and list the solving packages
-00974                 solved, packages = get_dependency_solvers(block, arch, suite, [], strict=strict)
-00975                 packages = [self.binaries[suite][arch][0][p][SOURCE] for p in packages]
-00976 
-00977                 # if the dependency can be satisfied by the same source package, skip the block:
-00978                 # obviously both binary packages will enter testing togheter
-00979                 if src in packages: continue
-00980 
-00981                 # if no package can satisfy the dependency, add this information to the excuse
-00982                 if len(packages) == 0:
-00983                     excuse.addhtml("%s/%s unsatisfiable %s: %s" % (pkg, arch, type, block_txt.strip()))
-00984                     if arch not in self.options.break_arches: excuse.add_unsat_dep(arch)
-00985                     continue
-00986 
-00987                 # for the solving packages, update the excuse to add the dependencies
-00988                 for p in packages:
-00989                     if arch not in self.options.break_arches.split():
-00990                         excuse.add_dep(p)
-00991                     else:
-00992                         excuse.add_break_dep(p, arch)
-00993 
-00994         return True
-00995 
-00996     # Package analysis methods
-00997     # ------------------------
-00998 
-00999     def should_remove_source(self, pkg):
-01000         """Check if a source package should be removed from testing
-01001         
-01002         This method checks if a source package should be removed from the
-01003         testing distribution; this happen if the source package is not
-01004         present in the unstable distribution anymore.
-01005 
-01006         It returns True if the package can be removed, False otherwise.
-01007         In the former case, a new excuse is appended to the the object
-01008         attribute excuses.
-01009         """
-01010         # if the soruce package is available in unstable, then do nothing
-01011         if pkg in self.sources['unstable']:
-01012             return False
-01013         # otherwise, add a new excuse for its removal and return True
-01014         src = self.sources['testing'][pkg]
-01015         excuse = Excuse("-" + pkg)
-01016         excuse.set_vers(src[VERSION], None)
-01017         src[MAINTAINER] and excuse.set_maint(src[MAINTAINER].strip())
-01018         src[SECTION] and excuse.set_section(src[SECTION].strip())
-01019 
-01020         # if the package is blocked, skip it
-01021         if self.hints['block'].has_key('-' + pkg):
-01022             exc.addhtml("Not touching package, as requested by %s (contact debian-release if update is needed)" % hints['block']['-' + pkg])
-01023             return False
-01024 
-01025         excuse.addhtml("Valid candidate")
-01026         self.excuses.append(excuse)
-01027         return True
-01028 
-01029     def should_upgrade_srcarch(self, src, arch, suite):
-01030         """Check if binary package should be upgraded
-01031 
-01032         This method checks if a binary package should be upgraded; this can
-01033         happen also if the binary package is a binary-NMU for the given arch.
-01034         The analysis is performed for the source package specified by the
-01035         `src' parameter, checking the architecture `arch' for the distribution
-01036         `suite'.
-01037        
-01038         It returns False if the given package doesn't need to be upgraded,
-01039         True otherwise. In the former case, a new excuse is appended to
-01040         the the object attribute excuses.
-01041         """
-01042         # retrieve the source packages for testing and suite
-01043         source_t = self.sources['testing'][src]
-01044         source_u = self.sources[suite][src]
-01045 
-01046         # build the common part of the excuse, which will be filled by the code below
-01047         ref = "%s/%s%s" % (src, arch, suite != 'unstable' and "_" + suite or "")
-01048         excuse = Excuse(ref)
-01049         excuse.set_vers(source_t[VERSION], source_t[VERSION])
-01050         source_u[MAINTAINER] and excuse.set_maint(source_u[MAINTAINER].strip())
-01051         source_u[SECTION] and excuse.set_section(source_u[SECTION].strip())
-01052         
-01053         # if there is a `remove' hint and the requested version is the same of the
-01054         # version in testing, then stop here and return False
-01055         if src in self.hints["remove"] and \
-01056            self.same_source(source_t[VERSION], self.hints["remove"][src][0]):
-01057             excuse.addhtml("Removal request by %s" % (self.hints["remove"][src][1]))
-01058             excuse.addhtml("Trying to remove package, not update it")
-01059             excuse.addhtml("Not considered")
-01060             self.excuses.append(excuse)
-01061             return False
-01062 
-01063         # the starting point is that there is nothing wrong and nothing worth doing
-01064         anywrongver = False
-01065         anyworthdoing = False
-01066 
-01067         # for every binary package produced by this source in unstable for this architecture
-01068         for pkg in sorted(filter(lambda x: x.endswith("/" + arch), source_u[BINARIES]), key=lambda x: x.split("/")[0]):
-01069             pkg_name = pkg.split("/")[0]
-01070 
-01071             # retrieve the testing (if present) and unstable corresponding binary packages
-01072             binary_t = pkg in source_t[BINARIES] and self.binaries['testing'][arch][0][pkg_name] or None
-01073             binary_u = self.binaries[suite][arch][0][pkg_name]
-01074 
-01075             # this is the source version for the new binary package
-01076             pkgsv = self.binaries[suite][arch][0][pkg_name][SOURCEVER]
-01077 
-01078             # if the new binary package is architecture-independent, then skip it
-01079             if binary_u[ARCHITECTURE] == 'all':
-01080                 excuse.addhtml("Ignoring %s %s (from %s) as it is arch: all" % (pkg_name, binary_u[VERSION], pkgsv))
-01081                 continue
-01082 
-01083             # if the new binary package is not from the same source as the testing one, then skip it
-01084             if not self.same_source(source_t[VERSION], pkgsv):
-01085                 anywrongver = True
-01086                 excuse.addhtml("From wrong source: %s %s (%s not %s)" % (pkg_name, binary_u[VERSION], pkgsv, source_t[VERSION]))
-01087                 break
-01088 
-01089             # find unsatisfied dependencies for the new binary package
-01090             self.excuse_unsat_deps(pkg_name, src, arch, suite, excuse)
-01091 
-01092             # if the binary is not present in testing, then it is a new binary;
-01093             # in this case, there is something worth doing
-01094             if not binary_t:
-01095                 excuse.addhtml("New binary: %s (%s)" % (pkg_name, binary_u[VERSION]))
-01096                 anyworthdoing = True
-01097                 continue
-01098 
-01099             # at this point, the binary package is present in testing, so we can compare
-01100             # the versions of the packages ...
-01101             vcompare = apt_pkg.VersionCompare(binary_t[VERSION], binary_u[VERSION])
-01102 
-01103             # ... if updating would mean downgrading, then stop here: there is something wrong
-01104             if vcompare > 0:
-01105                 anywrongver = True
-01106                 excuse.addhtml("Not downgrading: %s (%s to %s)" % (pkg_name, binary_t[VERSION], binary_u[VERSION]))
-01107                 break
-01108             # ... if updating would mean upgrading, then there is something worth doing
-01109             elif vcompare < 0:
-01110                 excuse.addhtml("Updated binary: %s (%s to %s)" % (pkg_name, binary_t[VERSION], binary_u[VERSION]))
-01111                 anyworthdoing = True
-01112 
-01113         # if there is nothing wrong and there is something worth doing or the source
-01114         # package is not fake, then check what packages shuold be removed
-01115         if not anywrongver and (anyworthdoing or self.sources[suite][src][FAKESRC]):
-01116             srcv = self.sources[suite][src][VERSION]
-01117             ssrc = self.same_source(source_t[VERSION], srcv)
-01118             # for every binary package produced by this source in testing for this architecture
-01119             for pkg in sorted([x.split("/")[0] for x in self.sources['testing'][src][BINARIES] if x.endswith("/"+arch)]):
-01120                 # if the package is architecture-independent, then ignore it
-01121                 if self.binaries['testing'][arch][0][pkg][ARCHITECTURE] == 'all':
-01122                     excuse.addhtml("Ignoring removal of %s as it is arch: all" % (pkg))
-01123                     continue
-01124                 # if the package is not produced by the new source package, then remove it from testing
-01125                 if pkg not in self.binaries[suite][arch][0]:
-01126                     tpkgv = self.binaries['testing'][arch][0][pkg][VERSION]
-01127                     excuse.addhtml("Removed binary: %s %s" % (pkg, tpkgv))
-01128                     if ssrc: anyworthdoing = True
-01129 
-01130         # if there is nothing wrong and there is something worth doing, this is valid candidate
-01131         if not anywrongver and anyworthdoing:
-01132             excuse.addhtml("Valid candidate")
-01133             self.excuses.append(excuse)
-01134             return True
-01135         # else if there is something worth doing (but something wrong, too) this package won't be considered
-01136         elif anyworthdoing:
-01137             excuse.addhtml("Not considered")
-01138             self.excuses.append(excuse)
-01139 
-01140         # otherwise, return False
-01141         return False
-01142 
-01143     def should_upgrade_src(self, src, suite):
-01144         """Check if source package should be upgraded
-01145 
-01146         This method checks if a source package should be upgraded. The analysis
-01147         is performed for the source package specified by the `src' parameter, 
-01148         checking the architecture `arch' for the distribution `suite'.
-01149        
-01150         It returns False if the given package doesn't need to be upgraded,
-01151         True otherwise. In the former case, a new excuse is appended to
-01152         the the object attribute excuses.
-01153         """
-01154 
-01155         # retrieve the source packages for testing (if available) and suite
-01156         source_u = self.sources[suite][src]
-01157         if src in self.sources['testing']:
-01158             source_t = self.sources['testing'][src]
-01159             # if testing and unstable have the same version, then this is a candidate for binary-NMUs only
-01160             if apt_pkg.VersionCompare(source_t[VERSION], source_u[VERSION]) == 0:
-01161                 return False
-01162         else:
-01163             source_t = None
-01164 
-01165         # build the common part of the excuse, which will be filled by the code below
-01166         ref = "%s%s" % (src, suite != 'unstable' and "_" + suite or "")
-01167         excuse = Excuse(ref)
-01168         excuse.set_vers(source_t and source_t[VERSION] or None, source_u[VERSION])
-01169         source_u[MAINTAINER] and excuse.set_maint(source_u[MAINTAINER].strip())
-01170         source_u[SECTION] and excuse.set_section(source_u[SECTION].strip())
-01171 
-01172         # the starting point is that we will update the candidate
-01173         update_candidate = True
-01174         
-01175         # if the version in unstable is older, then stop here with a warning in the excuse and return False
-01176         if source_t and apt_pkg.VersionCompare(source_u[VERSION], source_t[VERSION]) < 0:
-01177             excuse.addhtml("ALERT: %s is newer in testing (%s %s)" % (src, source_t[VERSION], source_u[VERSION]))
-01178             self.excuses.append(excuse)
-01179             return False
-01180 
-01181         # check if the source package really exists or if it is a fake one
-01182         if source_u[FAKESRC]:
-01183             excuse.addhtml("%s source package doesn't exist" % (src))
-01184             update_candidate = False
-01185 
-01186         # retrieve the urgency for the upload, ignoring it if this is a NEW package (not present in testing)
-01187         urgency = self.urgencies.get(src, self.options.default_urgency)
-01188         if not source_t and urgency != self.options.default_urgency:
-01189             excuse.addhtml("Ignoring %s urgency setting for NEW package" % (urgency))
-01190             urgency = self.options.default_urgency
-01191 
-01192         # if there is a `remove' hint and the requested version is the same of the
-01193         # version in testing, then stop here and return False
-01194         if src in self.hints["remove"]:
-01195             if source_t and self.same_source(source_t[VERSION], self.hints['remove'][src][0]) or \
-01196                self.same_source(source_u[VERSION], self.hints['remove'][src][0]):
-01197                 excuse.addhtml("Removal request by %s" % (self.hints["remove"][src][1]))
-01198                 excuse.addhtml("Trying to remove package, not update it")
-01199                 update_candidate = False
-01200 
-01201         # check if there is a `block' hint for this package or a `block-all source' hint
-01202         blocked = None
-01203         if src in self.hints["block"]:
-01204             blocked = self.hints["block"][src]
-01205         elif 'source' in self.hints["block-all"]:
-01206             blocked = self.hints["block-all"]["source"]
-01207 
-01208         # if the source is blocked, then look for an `unblock' hint; the unblock request
-01209         # is processed only if the specified version is correct
-01210         if blocked:
-01211             unblock = self.hints["unblock"].get(src,(None,None))
-01212             if unblock[0] != None:
-01213                 if self.same_source(unblock[0], source_u[VERSION]):
-01214                     excuse.addhtml("Ignoring request to block package by %s, due to unblock request by %s" % (blocked, unblock[1]))
-01215                 else:
-01216                     excuse.addhtml("Unblock request by %s ignored due to version mismatch: %s" % (unblock[1], unblock[0]))
-01217             else:
-01218                 excuse.addhtml("Not touching package, as requested by %s (contact debian-release if update is needed)" % (blocked))
-01219                 update_candidate = False
-01220 
-01221         # if the suite is unstable, then we have to check the urgency and the minimum days of
-01222         # permanence in unstable before updating testing; if the source package is too young,
-01223         # the check fails and we set update_candidate to False to block the update
-01224         if suite == 'unstable':
-01225             if src not in self.dates:
-01226                 self.dates[src] = (source_u[VERSION], self.date_now)
-01227             elif not self.same_source(self.dates[src][0], source_u[VERSION]):
-01228                 self.dates[src] = (source_u[VERSION], self.date_now)
-01229 
-01230             days_old = self.date_now - self.dates[src][1]
-01231             min_days = self.MINDAYS[urgency]
-01232             excuse.setdaysold(days_old, min_days)
-01233             if days_old < min_days:
-01234                 if src in self.hints["urgent"] and self.same_source(source_u[VERSION], self.hints["urgent"][src][0]):
-01235                     excuse.addhtml("Too young, but urgency pushed by %s" % (self.hints["urgent"][src][1]))
-01236                 else:
-01237                     update_candidate = False
-01238 
-01239         # at this point, we check what is the status of the builds on all the supported architectures
-01240         # to catch the out-of-date ones
-01241         pkgs = {src: ["source"]}
-01242         for arch in self.options.architectures:
-01243             oodbins = {}
-01244             # for every binary package produced by this source in the suite for this architecture
-01245             for pkg in sorted([x.split("/")[0] for x in self.sources[suite][src][BINARIES] if x.endswith("/"+arch)]):
-01246                 if pkg not in pkgs: pkgs[pkg] = []
-01247                 pkgs[pkg].append(arch)
-01248 
-01249                 # retrieve the binary package and its source version
-01250                 binary_u = self.binaries[suite][arch][0][pkg]
-01251                 pkgsv = binary_u[SOURCEVER]
-01252 
-01253                 # if it wasn't builded by the same source, it is out-of-date
-01254                 if not self.same_source(source_u[VERSION], pkgsv):
-01255                     if pkgsv not in oodbins:
-01256                         oodbins[pkgsv] = []
-01257                     oodbins[pkgsv].append(pkg)
-01258                     continue
-01259 
-01260                 # if the package is architecture-dependent or the current arch is `nobreakall'
-01261                 # find unsatisfied dependencies for the binary package
-01262                 if binary_u[ARCHITECTURE] != 'all' or arch in self.options.nobreakall_arches:
-01263                     self.excuse_unsat_deps(pkg, src, arch, suite, excuse)
-01264 
-01265             # if there are out-of-date packages, warn about them in the excuse and set update_candidate
-01266             # to False to block the update; if the architecture where the package is out-of-date is
-01267             # in the `fucked_arches' list, then do not block the update
-01268             if oodbins:
-01269                 oodtxt = ""
-01270                 for v in oodbins.keys():
-01271                     if oodtxt: oodtxt = oodtxt + "; "
-01272                     oodtxt = oodtxt + "%s (from <a href=\"http://buildd.debian.org/build.php?" \
-01273                         "arch=%s&pkg=%s&ver=%s\" target=\"_blank\">%s</a>)" % \
-01274                         (", ".join(sorted(oodbins[v])), arch, src, v, v)
-01275                 text = "out of date on <a href=\"http://buildd.debian.org/build.php?" \
-01276                     "arch=%s&pkg=%s&ver=%s\" target=\"_blank\">%s</a>: %s" % \
-01277                     (arch, src, source_u[VERSION], arch, oodtxt)
-01278 
-01279                 if arch in self.options.fucked_arches:
-01280                     text = text + " (but %s isn't keeping up, so nevermind)" % (arch)
-01281                 else:
-01282                     update_candidate = False
-01283 
-01284                 if self.date_now != self.dates[src][1]:
-01285                     excuse.addhtml(text)
-01286 
-01287         # if the source package has no binaries, set update_candidate to False to block the update
-01288         if len(self.sources[suite][src][BINARIES]) == 0:
-01289             excuse.addhtml("%s has no binaries on any arch" % src)
-01290             update_candidate = False
-01291 
-01292         # if the suite is unstable, then we have to check the release-critical bug counts before
-01293         # updating testing; if the unstable package have a RC bug count greater than the testing
-01294         # one,  the check fails and we set update_candidate to False to block the update
-01295         if suite == 'unstable':
-01296             for pkg in pkgs.keys():
-01297                 if pkg not in self.bugs['testing']:
-01298                     self.bugs['testing'][pkg] = 0
-01299                 if pkg not in self.bugs['unstable']:
-01300                     self.bugs['unstable'][pkg] = 0
-01301 
-01302                 if self.bugs['unstable'][pkg] > self.bugs['testing'][pkg]:
-01303                     excuse.addhtml("%s (%s) is <a href=\"http://bugs.debian.org/cgi-bin/pkgreport.cgi?" \
-01304                                    "which=pkg&data=%s&sev-inc=critical&sev-inc=grave&sev-inc=serious\" " \
-01305                                    "target=\"_blank\">buggy</a>! (%d > %d)" % \
-01306                                    (pkg, ", ".join(pkgs[pkg]), pkg, self.bugs['unstable'][pkg], self.bugs['testing'][pkg]))
-01307                     update_candidate = False
-01308                 elif self.bugs['unstable'][pkg] > 0:
-01309                     excuse.addhtml("%s (%s) is (less) <a href=\"http://bugs.debian.org/cgi-bin/pkgreport.cgi?" \
-01310                                    "which=pkg&data=%s&sev-inc=critical&sev-inc=grave&sev-inc=serious\" " \
-01311                                    "target=\"_blank\">buggy</a>! (%d <= %d)" % \
-01312                                    (pkg, ", ".join(pkgs[pkg]), pkg, self.bugs['unstable'][pkg], self.bugs['testing'][pkg]))
-01313 
-01314         # check if there is a `force' hint for this package, which allows it to go in even if it is not updateable
-01315         if not update_candidate and src in self.hints["force"] and \
-01316            self.same_source(source_u[VERSION], self.hints["force"][src][0]):
-01317             excuse.dontinvalidate = 1
-01318             excuse.addhtml("Should ignore, but forced by %s" % (self.hints["force"][src][1]))
-01319             update_candidate = True
-01320 
-01321         # if the suite is testing-proposed-updates, the package needs an explicit approval in order to go in
-01322         if suite == "tpu":
-01323             key = "%s_%s" % (src, source_u[VERSION])
-01324             if key in self.approvals:
-01325                 excuse.addhtml("Approved by %s" % approvals[key])
-01326             else:
-01327                 excuse.addhtml("NEEDS APPROVAL BY RM")
-01328                 update_candidate = False
-01329 
-01330         # if the package can be updated, it is a valid candidate
-01331         if update_candidate:
-01332             excuse.addhtml("Valid candidate")
-01333         # else it won't be considered
-01334         else:
-01335             excuse.addhtml("Not considered")
-01336 
-01337         self.excuses.append(excuse)
-01338         return update_candidate
-01339 
-01340     def reversed_exc_deps(self):
-01341         """Reverse the excuses dependencies
-01342 
-01343         This method returns a dictionary where the keys are the package names
-01344         and the values are the excuse names which depend on it.
-01345         """
-01346         res = {}
-01347         for exc in self.excuses:
-01348             for d in exc.deps:
-01349                 if d not in res: res[d] = []
-01350                 res[d].append(exc.name)
-01351         return res
-01352 
-01353     def invalidate_excuses(self, valid, invalid):
-01354         """Invalidate impossible excuses
-01355 
-01356         This method invalidates the impossible excuses, which depend
-01357         on invalid excuses. The two parameters contains the list of
-01358         `valid' and `invalid' excuses.
-01359         """
-01360         # build a lookup-by-name map
-01361         exclookup = {}
-01362         for e in self.excuses:
-01363             exclookup[e.name] = e
-01364 
-01365         # build the reverse dependencies
-01366         revdeps = self.reversed_exc_deps()
-01367 
-01368         # loop on the invalid excuses
-01369         i = 0
-01370         while i < len(invalid):
-01371             # if there is no reverse dependency, skip the item
-01372             if invalid[i] not in revdeps:
-01373                 i += 1
-01374                 continue
-01375             # if there dependency can be satisfied by a testing-proposed-updates excuse, skip the item
-01376             if (invalid[i] + "_tpu") in valid:
-01377                 i += 1
-01378                 continue
-01379             # loop on the reverse dependencies
-01380             for x in revdeps[invalid[i]]:
-01381                 # if the item is valid and it is marked as `dontinvalidate', skip the item
-01382                 if x in valid and exclookup[x].dontinvalidate:
-01383                     continue
-01384 
-01385                 # otherwise, invalidate the dependency and mark as invalidated and
-01386                 # remove the depending excuses
-01387                 exclookup[x].invalidate_dep(invalid[i])
-01388                 if x in valid:
-01389                     p = valid.index(x)
-01390                     invalid.append(valid.pop(p))
-01391                     exclookup[x].addhtml("Invalidated by dependency")
-01392                     exclookup[x].addhtml("Not considered")
-01393             i = i + 1
-01394  
-01395     def write_excuses(self):
-01396         """Produce and write the update excuses
-01397 
-01398         This method handles the update excuses generation: the packages are
-01399         looked to determine whether they are valid candidates. For the details
-01400         of this procedure, please refer to the module docstring.
-01401         """
-01402 
-01403         self.__log("Update Excuses generation started", type="I")
-01404 
-01405         # list of local methods and variables (for better performance)
-01406         sources = self.sources
-01407         architectures = self.options.architectures
-01408         should_remove_source = self.should_remove_source
-01409         should_upgrade_srcarch = self.should_upgrade_srcarch
-01410         should_upgrade_src = self.should_upgrade_src
-01411 
-01412         # this list will contain the packages which are valid candidates;
-01413         # if a package is going to be removed, it will have a "-" prefix
-01414         upgrade_me = []
-01415 
-01416         # for every source package in testing, check if it should be removed
-01417         for pkg in sources['testing']:
-01418             if should_remove_source(pkg):
-01419                 upgrade_me.append("-" + pkg)
-01420 
-01421         # for every source package in unstable check if it should be upgraded
-01422         for pkg in sources['unstable']:
-01423             if sources['unstable'][pkg][FAKESRC]: continue
-01424             # if the source package is already present in testing,
-01425             # check if it should be upgraded for every binary package
-01426             if pkg in sources['testing'] and not sources['testing'][pkg][FAKESRC]:
-01427                 for arch in architectures:
-01428                     if should_upgrade_srcarch(pkg, arch, 'unstable'):
-01429                         upgrade_me.append("%s/%s" % (pkg, arch))
-01430 
-01431             # check if the source package should be upgraded
-01432             if should_upgrade_src(pkg, 'unstable'):
-01433                 upgrade_me.append(pkg)
-01434 
-01435         # for every source package in testing-proposed-updates, check if it should be upgraded
-01436         for pkg in sources['tpu']:
-01437             if sources['tpu'][pkg][FAKESRC]: continue
-01438             # if the source package is already present in testing,
-01439             # check if it should be upgraded for every binary package
-01440             if pkg in sources['testing']:
-01441                 for arch in architectures:
-01442                     if should_upgrade_srcarch(pkg, arch, 'tpu'):
-01443                         upgrade_me.append("%s/%s_tpu" % (pkg, arch))
-01444 
-01445             # check if the source package should be upgraded
-01446             if should_upgrade_src(pkg, 'tpu'):
-01447                 upgrade_me.append("%s_tpu" % pkg)
-01448 
-01449         # process the `remove' hints, if the given package is not yet in upgrade_me
-01450         for src in self.hints["remove"].keys():
-01451             if src in upgrade_me: continue
-01452             if ("-"+src) in upgrade_me: continue
-01453             if src not in sources['testing']: continue
-01454 
-01455             # check if the version specified in the hint is the same of the considered package
-01456             tsrcv = sources['testing'][src][VERSION]
-01457             if not self.same_source(tsrcv, self.hints["remove"][src][0]): continue
-01458 
-01459             # add the removal of the package to upgrade_me and build a new excuse
-01460             upgrade_me.append("-%s" % (src))
-01461             excuse = Excuse("-%s" % (src))
-01462             excuse.set_vers(tsrcv, None)
-01463             excuse.addhtml("Removal request by %s" % (self.hints["remove"][src][1]))
-01464             excuse.addhtml("Package is broken, will try to remove")
-01465             self.excuses.append(excuse)
-01466 
-01467         # sort the excuses by daysold and name
-01468         self.excuses.sort(lambda x, y: cmp(x.daysold, y.daysold) or cmp(x.name, y.name))
-01469 
-01470         # extract the not considered packages, which are in the excuses but not in upgrade_me
-01471         unconsidered = [e.name for e in self.excuses if e.name not in upgrade_me]
-01472 
-01473         # invalidate impossible excuses
-01474         for e in self.excuses:
-01475             for d in e.deps:
-01476                 if d not in upgrade_me and d not in unconsidered:
-01477                     e.addhtml("Unpossible dep: %s -> %s" % (e.name, d))
-01478         self.invalidate_excuses(upgrade_me, unconsidered)
-01479 
-01480         # sort the list of candidates
-01481         self.upgrade_me = sorted(upgrade_me)
-01482 
-01483         # write excuses to the output file
-01484         self.__log("> Writing Excuses to %s" % self.options.excuses_output, type="I")
-01485 
-01486         f = open(self.options.excuses_output, 'w')
-01487         f.write("<!DOCTYPE HTML PUBLIC \"-//W3C//DTD HTML 4.01//EN\" \"http://www.w3.org/TR/REC-html40/strict.dtd\">\n")
-01488         f.write("<html><head><title>excuses...</title>")
-01489         f.write("<meta http-equiv=\"Content-Type\" content=\"text/html;charset=utf-8\"></head><body>\n")
-01490         f.write("<p>Generated: " + time.strftime("%Y.%m.%d %H:%M:%S %z", time.gmtime(time.time())) + "</p>\n")
-01491         f.write("<ul>\n")
-01492         for e in self.excuses:
-01493             f.write("<li>%s" % e.html())
-01494         f.write("</ul></body></html>\n")
-01495         f.close()
-01496 
-01497         self.__log("Update Excuses generation completed", type="I")
-01498 
-01499     # Upgrade run
-01500     # -----------
-01501 
-01502     def newlyuninst(self, nuold, nunew):
-01503         """Return a nuninst statstic with only new uninstallable packages
-01504 
-01505         This method subtract the uninstallabla packages of the statistic
-01506         `nunew` from the statistic `nuold`.
-01507 
-01508         It returns a dictionary with the architectures as keys and the list
-01509         of uninstallable packages as values.
-01510         """
-01511         res = {}
-01512         for arch in nuold:
-01513             if arch not in nunew: continue
-01514             res[arch] = [x for x in nunew[arch] if x not in nuold[arch]]
-01515         return res
-01516 
-01517     def get_nuninst(self, requested_arch=None, build=False):
-01518         """Return the uninstallability statistic for all the architectures
-01519 
-01520         To calculate the uninstallability counters, the method checks the
-01521         installability of all the packages for all the architectures, and
-01522         tracking dependencies in a recursive way. The architecture
-01523         indipendent packages are checked only for the `nobreakall`
-01524         architectures.
-01525 
-01526         It returns a dictionary with the architectures as keys and the list
-01527         of uninstallable packages as values.
-01528         """
-01529         # if we are not asked to build the nuninst, read it from the cache
-01530         if not build:
-01531             return self.read_nuninst()
-01532 
-01533         nuninst = {}
-01534 
-01535         # local copies for better performances
-01536         binaries = self.binaries['testing']
-01537         check_installable = self.check_installable
-01538 
-01539         # when a new uninstallable package is discovered, check again all the
-01540         # reverse dependencies and if they are uninstallable, too, call itself
-01541         # recursively
-01542         def add_nuninst(pkg, arch):
-01543             if pkg not in nuninst[arch]:
-01544                 nuninst[arch].append(pkg)
-01545                 for p in binaries[arch][0][pkg][RDEPENDS]:
-01546                     r = check_installable(p, arch, 'testing', excluded=nuninst[arch], conflicts=True)
-01547                     if not r:
-01548                         add_nuninst(p, arch)
-01549 
-01550         # for all the architectures
-01551         for arch in self.options.architectures:
-01552             if requested_arch and arch != requested_arch: continue
-01553             # if it is in the nobreakall ones, check arch-indipendent packages too
-01554             if arch not in self.options.nobreakall_arches:
-01555                 skip_archall = True
-01556             else: skip_archall = False
-01557 
-01558             # check all the packages for this architecture, calling add_nuninst if a new
-01559             # uninstallable package is found
-01560             nuninst[arch] = []
-01561             for pkg_name in binaries[arch][0]:
-01562                 r = check_installable(pkg_name, arch, 'testing', excluded=nuninst[arch], conflicts=True)
-01563                 if not r:
-01564                     add_nuninst(pkg_name, arch)
-01565 
-01566             # if they are not required, removed architecture-indipendent packages
-01567             nuninst[arch + "+all"] = nuninst[arch][:]
-01568             if skip_archall:
-01569                 for pkg in nuninst[arch + "+all"]:
-01570                     bpkg = binaries[arch][0][pkg]
-01571                     if bpkg[ARCHITECTURE] == 'all':
-01572                         nuninst[arch].remove(pkg)
-01573 
-01574         # return the dictionary with the results
-01575         return nuninst
-01576 
-01577     def eval_nuninst(self, nuninst, original=None):
-01578         """Return a string which represents the uninstallability counters
-01579 
-01580         This method returns a string which represents the uninstallability
-01581         counters reading the uninstallability statistics `nuninst` and, if
-01582         present, merging the results with the `original` one.
-01583 
-01584         An example of the output string is:
-01585         1+2: i-0:a-0:a-0:h-0:i-1:m-0:m-0:p-0:a-0:m-0:s-2:s-0
-01586 
-01587         where the first part is the number of broken packages in non-break
-01588         architectures + the total number of broken packages for all the
-01589         architectures.
-01590         """
-01591         res = []
-01592         total = 0
-01593         totalbreak = 0
-01594         for arch in self.options.architectures:
-01595             if arch in nuninst:
-01596                 n = len(nuninst[arch])
-01597             elif original and arch in original:
-01598                 n = len(original[arch])
-01599             else: continue
-01600             if arch in self.options.break_arches:
-01601                 totalbreak = totalbreak + n
-01602             else:
-01603                 total = total + n
-01604             res.append("%s-%d" % (arch[0], n))
-01605         return "%d+%d: %s" % (total, totalbreak, ":".join(res))
-01606 
-01607     def eval_uninst(self, nuninst):
-01608         """Return a string which represents the uninstallable packages
-01609 
-01610         This method returns a string which represents the uninstallable
-01611         packages reading the uninstallability statistics `nuninst`.
-01612 
-01613         An example of the output string is:
-01614             * i386: broken-pkg1, broken-pkg2
-01615         """
-01616         parts = []
-01617         for arch in self.options.architectures:
-01618             if arch in nuninst and len(nuninst[arch]) > 0:
-01619                 parts.append("    * %s: %s\n" % (arch,", ".join(sorted(nuninst[arch]))))
-01620         return "".join(parts)
-01621 
-01622     def is_nuninst_asgood_generous(self, old, new):
-01623         diff = 0
-01624         for arch in self.options.architectures:
-01625             if arch in self.options.break_arches: continue
-01626             diff = diff + (len(new[arch]) - len(old[arch]))
-01627         return diff <= 0
-01628 
-01629     def check_installable(self, pkg, arch, suite, excluded=[], conflicts=False):
-01630         """Check if a package is installable
-01631 
-01632         This method analyzes the dependencies of the binary package specified
-01633         by the parameter `pkg' for the architecture `arch' within the suite
-01634         `suite'. If the dependency can be satisfied in the given `suite` and
-01635         `conflicts` parameter is True, then the co-installability with 
-01636         conflicts handling is checked.
-01637 
-01638         The dependency fields checked are Pre-Depends and Depends.
-01639 
-01640         The method returns a boolean which is True if the given package is
-01641         installable.
-01642         """
-01643         # retrieve the binary package from the specified suite and arch
-01644         binary_u = self.binaries[suite][arch][0][pkg]
-01645 
-01646         # local copies for better performances
-01647         parse_depends = apt_pkg.ParseDepends
-01648         get_dependency_solvers = self.get_dependency_solvers
-01649 
-01650         # analyze the dependency fields (if present)
-01651         for type in (PREDEPENDS, DEPENDS):
-01652             if not binary_u[type]:
-01653                 continue
-01654 
-01655             # for every block of dependency (which is formed as conjunction of disconjunction)
-01656             for block in parse_depends(binary_u[type]):
-01657                 # if the block is not satisfied, return False
-01658                 solved, packages = get_dependency_solvers(block, arch, 'testing', excluded, strict=True)
-01659                 if not solved:
-01660                     return False
-01661 
-01662         # otherwise, the package is installable (not considering conflicts)
-01663         # if the conflicts handling is enabled, then check conflicts before
-01664         # saying that the package is really installable
-01665         if conflicts:
-01666             return self.check_conflicts(pkg, arch, excluded, {}, {})
-01667 
-01668         return True
-01669 
-01670     def check_conflicts(self, pkg, arch, broken, system, conflicts):
-01671         """Check if a package can be installed satisfying the conflicts
-01672 
-01673         This method checks if the `pkg` package from the `arch` architecture
-01674         can be installed (excluding `broken` packages) within the system
-01675         `system` along with all its dependencies. This means that all the
-01676         conflicts relationships are checked in order to achieve the test
-01677         co-installability of the package.
-01678 
-01679         The method returns a boolean which is True if the given package is
-01680         co-installable in the given system.
-01681         """
-01682 
-01683         # local copies for better performances
-01684         binaries = self.binaries['testing'][arch]
-01685         parse_depends = apt_pkg.ParseDepends
-01686         check_depends = apt_pkg.CheckDep
-01687 
-01688         # unregister conflicts, local method to remove conflicts
-01689         # registered from a given package.
-01690         def unregister_conflicts(pkg, conflicts):
-01691             for c in conflicts.keys():
-01692                 i = 0
-01693                 while i < len(conflicts[c]):
-01694                     if conflicts[c][i][3] == pkg:
-01695                         del conflicts[c][i]
-01696                     else: i = i + 1
-01697                 if len(conflicts[c]) == 0:
-01698                     del conflicts[c]
-01699 
-01700         def remove_package(pkg, system, conflicts):
-01701             for k in system:
-01702                 if pkg in system[k][1]:
-01703                     system[k][1].remove(pkg)
-01704             unregister_conflicts(pkg, conflicts)
-01705 
-01706         # handle a conflict, local method to solve a conflict which happened
-01707         # in the system; the behaviour of the conflict-solver is:
-01708         #   1. If there are alternatives for the package which must be removed,
-01709         #      try them, and if one of them resolves the system return True;
-01710         #   2. If none of the alternatives can solve the conflict, then call
-01711         #      itself for the package which depends on the conflicting package.
-01712         #   3. If the top of the dependency tree is reached, then the conflict
-01713         #      can't be solved, so return False.
-01714         def handle_conflict(pkg, source, system, conflicts):
-01715             # skip packages which don't have reverse dependencies
-01716             if source not in system or system[source][1] == []:
-01717                 remove_package(source, system, conflicts)
-01718                 return (system, conflicts)
-01719             # reached the top of the tree
-01720             if not system[source][1][0]:
-01721                 return False
-01722             # remove its conflicts
-01723             unregister_conflicts(source, conflicts)
-01724             # if there are alternatives, try them
-01725             alternatives = system[source][0]
-01726             for alt in alternatives:
-01727                 if satisfy(alt, [x for x in alternatives if x != alt], pkg_from=system[source][1],
-01728                         system=system, conflicts=conflicts, excluded=[source]):
-01729                     remove_package(source, system, conflicts)
-01730                     return (system, conflicts)
-01731             # there are no good alternatives, so remove the package which depends on it
-01732             for p in system[source][1]:
-01733                 # the package does not exist, we reached the top of the tree
-01734                 if not p: return False
-01735                 # we are providing the package we conflict on (eg. exim4 and mail-transfer-agent), skip it
-01736                 if p == pkg: continue
-01737                 output = handle_conflict(pkg, p, system, conflicts)
-01738                 if output:
-01739                     system, conflicts = output
-01740                 else: return False
-01741             remove_package(source, system, conflicts)
-01742             return (system, conflicts)
-01743 
-01744         # dependency tree satisfier, local method which tries to satisfy the dependency
-01745         # tree for a given package. It calls itself recursively in order to check the
-01746         # co-installability of the full tree of dependency of the starting package.
-01747         # If a conflict is detected, it tries to handle it calling the handle_conflict
-01748         # method; if it can't be resolved, then it returns False.
-01749         def satisfy(pkg, pkg_alt=None, pkg_from=None, system=system, conflicts=conflicts, excluded=[]):
-01750             # if it is real package and it is already installed, skip it and return True
-01751             if pkg in binaries[0]:
-01752                 if pkg in system:
-01753                     if type(pkg_from) == list:
-01754                         system[pkg][1].extend(pkg_from)
-01755                     else:
-01756                         system[pkg][1].append(pkg_from)
-01757                     system[pkg] = (system[pkg][1], filter(lambda x: x in pkg_alt, system[pkg][0]))
-01758                     return True
-01759                 binary_u = binaries[0][pkg]
-01760             else: binary_u = None
-01761 
-01762             # if it is a virtual package
-01763             providers = []
-01764             if pkg_from and pkg in binaries[1]:
-01765                 providers = binaries[1][pkg]
-01766                 # it is both real and virtual, so the providers are alternatives
-01767                 if binary_u:
-01768                     providers = filter(lambda x: (not pkg_alt or x not in pkg_alt) and x != pkg, providers)
-01769                     if not pkg_alt:
-01770                         pkg_alt = []
-01771                     pkg_alt.extend(providers)
-01772                 # try all the alternatives and if none of them suits, give up and return False
-01773                 else:
-01774                     # if we already have a provider in the system, everything is ok and return True
-01775                     if len(filter(lambda x: x in providers and x not in excluded, system)) > 0:
-01776                         return True
-01777                     for p in providers:
-01778                         # try to install the providers skipping excluded packages,
-01779                         # which we already tried but do not work
-01780                         if p in excluded: continue
-01781                         elif satisfy(p, [a for a in providers if a != p], pkg_from):
-01782                             return True
-01783                     # if none of them suits, return False
-01784                     return False
-01785 
-01786             # if the package doesn't exist, return False
-01787             if not binary_u: return False
-01788 
-01789             # it is broken, but we have providers
-01790             if pkg in broken and pkg_from:
-01791                 for p in providers:
-01792                     # try to install the providers skipping excluded packages,
-01793                     # which we already tried but do not work
-01794                     if p in excluded: continue
-01795                     elif satisfy(p, [a for a in providers if a != p], pkg_from):
-01796                         return True
-01797                 return False
-01798 
-01799             # install the package into the system, recording which package required it
-01800             if type(pkg_from) != list:
-01801                 pkg_from = [pkg_from]
-01802             system[pkg] = (pkg_alt or [], pkg_from)
-01803 
-01804             # register provided packages
-01805             if binary_u[PROVIDES]:
-01806                 for p in binary_u[PROVIDES]:
-01807                     if p in system:
-01808                         # do not consider packages providing the one which we are checking
-01809                         if len(system[p][1]) == 1 and system[p][1][0] == None: continue
-01810                         system[p][1].append(pkg)
-01811                     else:
-01812                         system[p] = ([], [pkg])
-01813 
-01814             # check the conflicts
-01815             if pkg in conflicts:
-01816                 for name, version, op, conflicting in conflicts[pkg]:
-01817                     if conflicting in binary_u[PROVIDES] and system[conflicting][1] == [pkg]: continue
-01818                     if op == '' and version == '' or check_depends(binary_u[VERSION], op, version):
-01819                         # if conflict is found, check if it can be solved removing
-01820                         # already-installed packages without broking the system; if
-01821                         # this is not possible, give up and return False
-01822                         output = handle_conflict(pkg, conflicting, system.copy(), conflicts.copy())
-01823                         if output:
-01824                             system, conflicts = output
-01825                         else:
-01826                             del system[pkg]
-01827                             return False
-01828 
-01829             # register conflicts from the just-installed package
-01830             if binary_u[CONFLICTS]:
-01831                 for block in map(operator.itemgetter(0), parse_depends(binary_u[CONFLICTS] or [])):
-01832                     name, version, op = block
-01833                     # skip conflicts for packages provided by itself
-01834                     # if the conflicting package is in the system (and it is not a self-conflict)
-01835                     if not (name in binary_u[PROVIDES] and system[name][1] == [pkg]) and \
-01836                        block[0] != pkg and block[0] in system:
-01837                         if block[0] in binaries[0]:
-01838                             binary_c = binaries[0][block[0]]
-01839                         else: binary_c = None
-01840                         if op == '' and version == '' or binary_c and check_depends(binary_c[VERSION], op, version):
-01841                             # if conflict is found, check if it can be solved removing
-01842                             # already-installed packages without broking the system; if
-01843                             # this is not possible, give up and return False
-01844                             output = handle_conflict(pkg, name, system.copy(), conflicts.copy())
-01845                             if output:
-01846                                 system, conflicts = output
-01847                             else:
-01848                                 del system[pkg]
-01849                                 unregister_conflicts(pkg, conflicts)
-01850                                 return False
-01851                     # register the conflict)
-01852                     if block[0] not in conflicts:
-01853                         conflicts[block[0]] = []
-01854                     conflicts[block[0]].append((name, version, op, pkg))
-01855 
-01856             # list all its dependencies ...
-01857             dependencies = []
-01858             for key in (PREDEPENDS, DEPENDS):
-01859                 if not binary_u[key]: continue
-01860                 dependencies.extend(parse_depends(binary_u[key]))
-01861 
-01862             # ... and go through them
-01863             for block in dependencies:
-01864                 # list the possible alternatives, in case of a conflict
-01865                 alternatives = map(operator.itemgetter(0), block)
-01866                 valid = False
-01867                 for name, version, op in block:
-01868                     # otherwise, if it is already installed or it is installable, the block is satisfied
-01869                     if name in system or satisfy(name, [a for a in alternatives if a != name], pkg):
-01870                         valid = True
-01871                         break
-01872                 # if the block can't be satisfied, the package is not installable so
-01873                 # we need to remove it, its conflicts and its provided packages and
-01874                 # return False
-01875                 if not valid:
-01876                     del system[pkg]
-01877                     unregister_conflicts(pkg, conflicts)
-01878                     for p in providers:
-01879                         if satisfy(p, [a for a in providers if a != p], pkg_from):
-01880                             return True
-01881                     return False
-01882 
-01883             # if all the blocks have been satisfied, the package is installable
-01884             return True
-01885 
-01886         # check the package at the top of the tree
-01887         return satisfy(pkg)
-01888 
-01889     def doop_source(self, pkg):
-01890         """Apply a change to the testing distribution as requested by `pkg`
-01891 
-01892         This method apply the changes required by the action `pkg` tracking
-01893         them so it will be possible to revert them.
-01894 
-01895         The method returns a list of the package name, the suite where the
-01896         package comes from, the list of packages affected by the change and
-01897         the dictionary undo which can be used to rollback the changes.
-01898         """
-01899         undo = {'binaries': {}, 'sources': {}, 'virtual': {}, 'nvirtual': []}
-01900 
-01901         affected = []
-01902         arch = None
-01903 
-01904         # local copies for better performances
-01905         sources = self.sources
-01906         binaries = self.binaries['testing']
-01907 
-01908         # removal of single-arch binary package = "-<package>/<arch>"
-01909         if pkg[0] == "-" and "/" in pkg:
-01910             pkg_name, arch = pkg.split("/")
-01911             pkg_name = pkg_name[1:]
-01912             if arch.endswith("_tpu"):
-01913                 arch, suite = arch.split("_")
-01914             else: suite = "testing"
-01915         # arch = "<source>/<arch>",
-01916         elif "/" in pkg:
-01917             pkg_name, arch = pkg.split("/")
-01918             suite = "unstable"
-01919         # removal of source packages = "-<source>",
-01920         elif pkg[0] == "-":
-01921             pkg_name = pkg[1:]
-01922             suite = "testing"
-01923         # testing-proposed-updates = "<source>_tpu"
-01924         elif pkg[0].endswith("_tpu"):
-01925             pkg_name = pkg[:-4]
-01926             suite = "tpu"
-01927         # normal update of source packages = "<source>"
-01928         else:
-01929             pkg_name = pkg
-01930             suite = "unstable"
-01931 
-01932         # remove all binary packages (if the source already exists)
-01933         if not (arch and pkg[0] == '-'):
-01934             if pkg_name in sources['testing']:
-01935                 source = sources['testing'][pkg_name]
-01936                 # remove all the binaries
-01937                 for p in source[BINARIES]:
-01938                     binary, parch = p.split("/")
-01939                     if arch and parch != arch: continue
-01940                     # if a smooth update is possible for the package, skip it
-01941                     if not self.options.compatible and suite == 'unstable' and \
-01942                        binary not in self.binaries[suite][parch][0] and \
-01943                        ('ALL' in self.options.smooth_updates or \
-01944                         binaries[parch][0][binary][SECTION] in self.options.smooth_updates):
-01945                         continue
-01946                     # save the old binary for undo
-01947                     undo['binaries'][p] = binaries[parch][0][binary]
-01948                     # all the reverse dependencies are affected by the change
-01949                     for j in binaries[parch][0][binary][RDEPENDS]:
-01950                         key = (j, parch)
-01951                         if key not in affected: affected.append(key)
-01952                     # remove the provided virtual packages
-01953                     for j in binaries[parch][0][binary][PROVIDES]:
-01954                         key = j + "/" + parch
-01955                         if key not in undo['virtual']:
-01956                             undo['virtual'][key] = binaries[parch][1][j][:]
-01957                         binaries[parch][1][j].remove(binary)
-01958                         if len(binaries[parch][1][j]) == 0:
-01959                             del binaries[parch][1][j]
-01960                     # finally, remove the binary package
-01961                     del binaries[parch][0][binary]
-01962                 # remove the source package
-01963                 if not arch:
-01964                     undo['sources'][pkg_name] = source
-01965                     del sources['testing'][pkg_name]
-01966             else:
-01967                 # the package didn't exist, so we mark it as to-be-removed in case of undo
-01968                 undo['sources']['-' + pkg_name] = True
-01969 
-01970         # single binary removal
-01971         elif pkg_name in binaries[arch][0]:
-01972             undo['binaries'][pkg_name + "/" + arch] = binaries[arch][0][pkg_name]
-01973             for j in binaries[arch][0][pkg_name][RDEPENDS]:
-01974                 key = (j, arch)
-01975                 if key not in affected: affected.append(key)
-01976             del binaries[arch][0][pkg_name]
-01977 
-01978         # add the new binary packages (if we are not removing)
-01979         if pkg[0] != "-":
-01980             source = sources[suite][pkg_name]
-01981             for p in source[BINARIES]:
-01982                 binary, parch = p.split("/")
-01983                 if arch and parch != arch: continue
-01984                 key = (binary, parch)
-01985                 # obviously, added/modified packages are affected
-01986                 if key not in affected: affected.append(key)
-01987                 # if the binary already exists (built from another ource)
-01988                 if binary in binaries[parch][0]:
-01989                     # save the old binary package
-01990                     undo['binaries'][p] = binaries[parch][0][binary]
-01991                     # all the reverse dependencies are affected by the change
-01992                     for j in binaries[parch][0][binary][RDEPENDS]:
-01993                         key = (j, parch)
-01994                         if key not in affected: affected.append(key)
-01995                     # all the reverse conflicts and their dependency tree are affected by the change
-01996                     for j in binaries[parch][0][binary][RCONFLICTS]:
-01997                         key = (j, parch)
-01998                         if key not in affected: affected.append(key)
-01999                         for p in self.get_full_tree(j, parch, 'testing'):
-02000                             key = (p, parch)
-02001                             if key not in affected: affected.append(key)
-02002                 # add/update the binary package
-02003                 binaries[parch][0][binary] = self.binaries[suite][parch][0][binary]
-02004                 # register new provided packages
-02005                 for j in binaries[parch][0][binary][PROVIDES]:
-02006                     key = j + "/" + parch
-02007                     if j not in binaries[parch][1]:
-02008                         undo['nvirtual'].append(key)
-02009                         binaries[parch][1][j] = []
-02010                     elif key not in undo['virtual']:
-02011                         undo['virtual'][key] = binaries[parch][1][j][:]
-02012                     binaries[parch][1][j].append(binary)
-02013                 # all the reverse dependencies are affected by the change
-02014                 for j in binaries[parch][0][binary][RDEPENDS]:
-02015                     key = (j, parch)
-02016                     if key not in affected: affected.append(key)
-02017 
-02018             # register reverse dependencies and conflicts for the new binary packages
-02019             for p in source[BINARIES]:
-02020                 binary, parch = p.split("/")
-02021                 if arch and parch != arch: continue
-02022                 self.register_reverses(binary, binaries[parch][0] , binaries[parch][1])
-02023 
-02024             # add/update the source package
-02025             if not arch:
-02026                 sources['testing'][pkg_name] = sources[suite][pkg_name]
-02027 
-02028         # return the package name, the suite, the list of affected packages and the undo dictionary
-02029         return (pkg_name, suite, affected, undo)
-02030 
-02031     def get_full_tree(self, pkg, arch, suite):
-02032         """Calculate the full dependency tree for the given package
-02033 
-02034         This method returns the full dependency tree for the package `pkg`,
-02035         inside the `arch` architecture for the suite `suite`.
-02036         """
-02037         packages = [pkg]
-02038         binaries = self.binaries[suite][arch][0]
-02039         l = n = 0
-02040         while len(packages) > l:
-02041             l = len(packages)
-02042             for p in packages[n:]:
-02043                 packages.extend([x for x in binaries[p][RDEPENDS] if x not in packages and x in binaries])
-02044             n = l
-02045         return packages
-02046 
-02047     def iter_packages(self, packages, selected, hint=False, nuninst=None):
-02048         """Iter on the list of actions and apply them one-by-one
-02049 
-02050         This method apply the changes from `packages` to testing, checking the uninstallability
-02051         counters for every action performed. If the action do not improve the it, it is reverted.
-02052         The method returns the new uninstallability counters and the remaining actions if the
-02053         final result is successful, otherwise (None, None).
-02054         """
-02055         extra = []
-02056         deferred = []
-02057         skipped = []
-02058         mark_passed = False
-02059         position = len(packages)
-02060 
-02061         if nuninst:
-02062             nuninst_comp = nuninst.copy()
-02063         else:
-02064             nuninst_comp = self.nuninst_orig.copy()
-02065 
-02066         # local copies for better performances
-02067         check_installable = self.check_installable
-02068         binaries = self.binaries['testing']
-02069         sources = self.sources
-02070         architectures = self.options.architectures
-02071         nobreakall_arches = self.options.nobreakall_arches
-02072         new_arches = self.options.new_arches
-02073         break_arches = self.options.break_arches
-02074         dependencies = self.dependencies
-02075         compatible = self.options.compatible
-02076 
-02077         # pre-process a hint batch
-02078         pre_process = {}
-02079         if selected and hint:
-02080             for pkg in selected:
-02081                 pkg_name, suite, affected, undo = self.doop_source(pkg)
-02082                 pre_process[pkg] = (pkg_name, suite, affected, undo)
-02083 
-02084         lundo = []
-02085         if not hint:
-02086             self.output_write("recur: [%s] %s %d/%d\n" % ("", ",".join(selected), len(packages), len(extra)))
-02087 
-02088         # loop on the packages (or better, actions)
-02089         while packages:
-02090             pkg = packages.pop(0)
-02091 
-02092             # this is the marker for the first loop
-02093             if not compatible and not mark_passed and position < 0:
-02094                 mark_passed = True
-02095                 packages.extend(deferred)
-02096                 del deferred
-02097             else: position -= 1
-02098 
-02099             # defer packages if their dependency has been already skipped
-02100             if not compatible and not mark_passed:
-02101                 defer = False
-02102                 for p in dependencies.get(pkg, []):
-02103                     if p in skipped:
-02104                         deferred.append(pkg)
-02105                         skipped.append(pkg)
-02106                         defer = True
-02107                         break
-02108                 if defer: continue
-02109 
-02110             if not hint:
-02111                 self.output_write("trying: %s\n" % (pkg))
-02112 
-02113             better = True
-02114             nuninst = {}
-02115 
-02116             # apply the changes
-02117             if pkg in pre_process:
-02118                 pkg_name, suite, affected, undo = pre_process[pkg]
-02119             else:
-02120                 pkg_name, suite, affected, undo = self.doop_source(pkg)
-02121             if hint:
-02122                 lundo.append((undo, pkg, pkg_name, suite))
-02123 
-02124             # check the affected packages on all the architectures
-02125             for arch in ("/" in pkg and (pkg.split("/")[1].split("_")[0],) or architectures):
-02126                 if arch not in nobreakall_arches:
-02127                     skip_archall = True
-02128                 else: skip_archall = False
-02129 
-02130                 nuninst[arch] = [x for x in nuninst_comp[arch] if x in binaries[arch][0]]
-02131                 nuninst[arch + "+all"] = [x for x in nuninst_comp[arch + "+all"] if x in binaries[arch][0]]
-02132                 broken = nuninst[arch + "+all"]
-02133                 to_check = [x[0] for x in affected if x[1] == arch]
-02134                 # broken packages (first round)
-02135                 repaired = []
-02136                 broken_changed = True
-02137                 last_broken = None
-02138                 while broken_changed:
-02139                     broken_changed = False
-02140                     for p in to_check:
-02141                         if p == last_broken: break
-02142                         if p not in binaries[arch][0]: continue
-02143                         r = check_installable(p, arch, 'testing', excluded=broken, conflicts=True)
-02144                         if not r and p not in broken:
-02145                             last_broken = p
-02146                             broken.append(p)
-02147                             broken_changed = True
-02148                             if not (skip_archall and binaries[arch][0][p][ARCHITECTURE] == 'all'):
-02149                                 nuninst[arch].append(p)
-02150                         elif r and p in broken:
-02151                             last_broken = p
-02152                             repaired.append(p)
-02153                             broken.remove(p)
-02154                             broken_changed = True
-02155                             if not (skip_archall and binaries[arch][0][p][ARCHITECTURE] == 'all'):
-02156                                 nuninst[arch].remove(p)
-02157 
-02158                 # broken packages (second round, reverse dependencies of the first round)
-02159                 l = 0
-02160                 broken_changed = True
-02161                 last_broken = None
-02162                 while broken_changed:
-02163                     broken_changed = False
-02164                     for j in broken + repaired:
-02165                         if j not in binaries[arch][0]: continue
-02166                         for p in binaries[arch][0][j][RDEPENDS]:
-02167                             if p in broken or p not in binaries[arch][0]: continue
-02168                             r = check_installable(p, arch, 'testing', excluded=broken, conflicts=True)
-02169                             if not r and p not in broken:
-02170                                 l = -1
-02171                                 last_broken = j
-02172                                 broken.append(p)
-02173                                 broken_changed = True
-02174                                 if not (skip_archall and binaries[arch][0][p][ARCHITECTURE] == 'all'):
-02175                                     nuninst[arch].append(p)
-02176                             elif r and p in nuninst[arch + "+all"]:
-02177                                 last_broken = p
-02178                                 repaired.append(p)
-02179                                 broken.remove(p)
-02180                                 broken_changed = True
-02181                                 if not (skip_archall and binaries[arch][0][p][ARCHITECTURE] == 'all'):
-02182                                     nuninst[arch].remove(p)
-02183                     if l != -1 and last_broken == j: break
-02184 
-02185                 # if we are processing hints, go ahead
-02186                 if hint:
-02187                     nuninst_comp[arch] = nuninst[arch]
-02188                     nuninst_comp[arch + "+all"] = nuninst[arch + "+all"]
-02189                     continue
-02190 
-02191                 # if the uninstallability counter is worse than before, break the loop
-02192                 if (("/" in pkg and arch not in new_arches) or \
-02193                     (arch not in break_arches)) and len(nuninst[arch]) > len(nuninst_comp[arch]):
-02194                     better = False
-02195                     break
-02196 
-02197             # if we are processing hints or the package is already accepted, go ahead
-02198             if hint or pkg in selected: continue
-02199 
-02200             # check if the action improved the uninstallability counters
-02201             if better:
-02202                 lundo.append((undo, pkg, pkg_name, suite))
-02203                 selected.append(pkg)
-02204                 packages.extend(extra)
-02205                 extra = []
-02206                 self.output_write("accepted: %s\n" % (pkg))
-02207                 self.output_write("   ori: %s\n" % (self.eval_nuninst(self.nuninst_orig)))
-02208                 self.output_write("   pre: %s\n" % (self.eval_nuninst(nuninst_comp)))
-02209                 self.output_write("   now: %s\n" % (self.eval_nuninst(nuninst, nuninst_comp)))
-02210                 if len(selected) <= 20:
-02211                     self.output_write("   all: %s\n" % (" ".join(selected)))
-02212                 else:
-02213                     self.output_write("  most: (%d) .. %s\n" % (len(selected), " ".join(selected[-20:])))
-02214                 for k in nuninst:
-02215                     nuninst_comp[k] = nuninst[k]
-02216             else:
-02217                 self.output_write("skipped: %s (%d <- %d)\n" % (pkg, len(extra), len(packages)))
-02218                 self.output_write("    got: %s\n" % (self.eval_nuninst(nuninst, "/" in pkg and nuninst_comp or None)))
-02219                 self.output_write("    * %s: %s\n" % (arch, ", ".join(sorted([b for b in nuninst[arch] if b not in nuninst_comp[arch]]))))
-02220 
-02221                 extra.append(pkg)
-02222                 if not mark_passed:
-02223                     skipped.append(pkg)
-02224 
-02225                 # undo the changes (source)
-02226                 for k in undo['sources'].keys():
-02227                     if k[0] == '-':
-02228                         del sources['testing'][k[1:]]
-02229                     else: sources['testing'][k] = undo['sources'][k]
-02230 
-02231                 # undo the changes (new binaries)
-02232                 if pkg[0] != '-' and pkg_name in sources[suite]:
-02233                     for p in sources[suite][pkg_name][BINARIES]:
-02234                         binary, arch = p.split("/")
-02235                         if "/" in pkg and arch != pkg[pkg.find("/")+1:]: continue
-02236                         del binaries[arch][0][binary]
-02237 
-02238                 # undo the changes (binaries)
-02239                 for p in undo['binaries'].keys():
-02240                     binary, arch = p.split("/")
-02241                     if binary[0] == "-":
-02242                         del binaries[arch][0][binary[1:]]
-02243                     else: binaries[arch][0][binary] = undo['binaries'][p]
-02244 
-02245                 # undo the changes (virtual packages)
-02246                 for p in undo['nvirtual']:
-02247                     j, arch = p.split("/")
-02248                     del binaries[arch][1][j]
-02249                 for p in undo['virtual']:
-02250                     j, arch = p.split("/")
-02251                     if j[0] == '-':
-02252                         del binaries[arch][1][j[1:]]
-02253                     else: binaries[arch][1][j] = undo['virtual'][p]
-02254 
-02255         # if we are processing hints, return now
-02256         if hint:
-02257             return (nuninst_comp, [], lundo)
-02258 
-02259         self.output_write(" finish: [%s]\n" % ",".join(selected))
-02260         self.output_write("endloop: %s\n" % (self.eval_nuninst(self.nuninst_orig)))
-02261         self.output_write("    now: %s\n" % (self.eval_nuninst(nuninst_comp)))
-02262         self.output_write(self.eval_uninst(self.newlyuninst(self.nuninst_orig, nuninst_comp)))
-02263         self.output_write("\n")
-02264 
-02265         return (nuninst_comp, extra, lundo)
-02266 
-02267     def do_all(self, maxdepth=0, init=None, actions=None):
-02268         """Testing update runner
-02269 
-02270         This method tries to update testing checking the uninstallability
-02271         counters before and after the actions to decide if the update was
-02272         successful or not.
-02273         """
-02274         selected = []
-02275         if actions:
-02276             upgrade_me = actions[:]
-02277         else:
-02278             upgrade_me = self.upgrade_me[:]
-02279         nuninst_start = self.nuninst_orig
-02280 
-02281         # these are special parameters for hints processing
-02282         undo = False
-02283         force = False
-02284         earlyabort = False
-02285         if maxdepth == "easy" or maxdepth < 0:
-02286             force = maxdepth < 0
-02287             earlyabort = True
-02288             maxdepth = 0
-02289 
-02290         # if we have a list of initial packages, check them
-02291         if init:
-02292             self.output_write("leading: %s\n" % (",".join(init)))
-02293             for x in init:
-02294                 if x not in upgrade_me:
-02295                     self.output_write("failed: %s\n" % (x))
-02296                     return None
-02297                 selected.append(x)
-02298                 upgrade_me.remove(x)
-02299         
-02300         self.output_write("start: %s\n" % self.eval_nuninst(nuninst_start))
-02301         self.output_write("orig: %s\n" % self.eval_nuninst(nuninst_start))
-02302 
-02303         if earlyabort:
-02304             extra = upgrade_me[:]
-02305             (nuninst_end, extra, lundo) = self.iter_packages(init, selected, hint=True)
-02306             undo = True
-02307             self.output_write("easy: %s\n" % (self.eval_nuninst(nuninst_end)))
-02308             self.output_write(self.eval_uninst(self.newlyuninst(nuninst_start, nuninst_end)) + "\n")
-02309             if not force and not self.is_nuninst_asgood_generous(self.nuninst_orig, nuninst_end):
-02310                 nuninst_end, extra = None, None
-02311         else:
-02312             lundo = []
-02313             if init:
-02314                 (nuninst_end, extra, tundo) = self.iter_packages(init, selected, hint=True)
-02315                 lundo.extend(tundo)
-02316                 undo = True
-02317             else: nuninst_end = None
-02318             (nuninst_end, extra, tundo) = self.iter_packages(upgrade_me, selected, nuninst=nuninst_end)
-02319             lundo.extend(tundo)
-02320             if not self.is_nuninst_asgood_generous(self.nuninst_orig, nuninst_end):
-02321                 nuninst_end, extra = None, None
-02322 
-02323         if nuninst_end:
-02324             self.output_write("Apparently successful\n")
-02325             self.output_write("final: %s\n" % ",".join(sorted(selected)))
-02326             self.output_write("start: %s\n" % self.eval_nuninst(nuninst_start))
-02327             self.output_write(" orig: %s\n" % self.eval_nuninst(self.nuninst_orig))
-02328             self.output_write("  end: %s\n" % self.eval_nuninst(nuninst_end))
-02329             if force:
-02330                 self.output_write("force breaks:\n")
-02331                 self.output_write(self.eval_uninst(self.newlyuninst(nuninst_start, nuninst_end)) + "\n")
-02332             self.output_write("SUCCESS (%d/%d)\n" % (len(actions or self.upgrade_me), len(extra)))
-02333             self.nuninst_orig = nuninst_end
-02334             if not actions:
-02335                 self.upgrade_me = sorted(extra)
-02336                 if not self.options.compatible:
-02337                     self.sort_actions()
-02338         else:
-02339             self.output_write("FAILED\n")
-02340             if not undo: return
-02341 
-02342             # undo all the changes
-02343             for (undo, pkg, pkg_name, suite) in lundo:
-02344                 # undo the changes (source)
-02345                 for k in undo['sources'].keys():
-02346                     if k[0] == '-':
-02347                         del self.sources['testing'][k[1:]]
-02348                     else: self.sources['testing'][k] = undo['sources'][k]
-02349 
-02350                 # undo the changes (new binaries)
-02351                 if pkg[0] != '-' and pkg_name in self.sources[suite]:
-02352                     for p in self.sources[suite][pkg_name][BINARIES]:
-02353                         binary, arch = p.split("/")
-02354                         if "/" in pkg and arch != pkg[pkg.find("/")+1:]: continue
-02355                         del self.binaries['testing'][arch][0][binary]
-02356 
-02357                 # undo the changes (binaries)
-02358                 for p in undo['binaries'].keys():
-02359                     binary, arch = p.split("/")
-02360                     if binary[0] == "-":
-02361                         del self.binaries['testing'][arch][0][binary[1:]]
-02362                     else: self.binaries['testing'][arch][0][binary] = undo['binaries'][p]
-02363 
-02364                 # undo the changes (virtual packages)
-02365                 for p in undo['nvirtual']:
-02366                     j, arch = p.split("/")
-02367                     del self.binaries['testing'][arch][1][j]
-02368                 for p in undo['virtual']:
-02369                     j, arch = p.split("/")
-02370                     if j[0] == '-':
-02371                         del self.binaries['testing'][arch][1][j[1:]]
-02372                     else: self.binaries['testing'][arch][1][j] = undo['virtual'][p]
-02373 
-02374     def upgrade_testing(self):
-02375         """Upgrade testing using the unstable packages
-02376 
-02377         This method tries to upgrade testing using the packages from unstable.
-02378         Before running the do_all method, it tries the easy and force-hint
-02379         commands.
-02380         """
-02381 
-02382         self.__log("Starting the upgrade test", type="I")
-02383         self.__output = open(self.options.upgrade_output, 'w')
-02384         self.output_write("Generated on: %s\n" % (time.strftime("%Y.%m.%d %H:%M:%S %z", time.gmtime(time.time()))))
-02385         self.output_write("Arch order is: %s\n" % ", ".join(self.options.architectures))
-02386 
-02387         self.__log("> Calculating current uninstallability counters", type="I")
-02388         self.nuninst_orig = self.get_nuninst()
-02389 
-02390         if not self.options.actions:
-02391             # process `easy' hints
-02392             for x in self.hints['easy']:
-02393                 self.do_hint("easy", x[0], x[1])
-02394 
-02395             # process `force-hint' hints
-02396             for x in self.hints["force-hint"]:
-02397                 self.do_hint("force-hint", x[0], x[1])
-02398 
-02399         # run the first round of the upgrade
-02400         self.__log("> First loop on the packages with depth = 0", type="I")
-02401 
-02402         # separate runs for break arches
-02403         allpackages = []
-02404         normpackages = self.upgrade_me[:]
-02405         archpackages = {}
-02406         for a in self.options.break_arches.split():
-02407             archpackages[a] = [p for p in normpackages if p.endswith("/" + a)]
-02408             normpackages = [p for p in normpackages if not p.endswith("/" + a)]
-02409         self.upgrade_me = normpackages
-02410         self.output_write("info: main run\n")
-02411         self.do_all()
-02412         allpackages += self.upgrade_me
-02413         for a in self.options.break_arches.split():
-02414             backup = self.options.break_arches
-02415             self.options.break_arches = " ".join([x for x in self.options.break_arches.split() if x != a])
-02416             self.upgrade_me = archpackages[a]
-02417             self.output_write("info: broken arch run for %s\n" % (a))
-02418             self.do_all()
-02419             allpackages += self.upgrade_me
-02420             self.options.break_arches = backup
-02421         self.upgrade_me = allpackages
-02422 
-02423         if self.options.actions:
-02424             return
-02425 
-02426         # process `hint' hints
-02427         hintcnt = 0
-02428         for x in self.hints["hint"][:50]:
-02429             if hintcnt > 50:
-02430                 self.output_write("Skipping remaining hints...")
-02431                 break
-02432             if self.do_hint("hint", x[0], x[1]):
-02433                 hintcnt += 1
-02434 
-02435         # run the auto hinter
-02436         if not self.options.compatible:
-02437             self.auto_hinter()
-02438 
-02439         # smooth updates
-02440         if not self.options.compatible and len(self.options.smooth_updates) > 0:
-02441             self.__log("> Removing old packages left in testing from smooth updates", type="I")
-02442             removals = self.old_libraries()
-02443             if len(removals) > 0:
-02444                 self.output_write("Removing packages left in testing for smooth updates (%d):\n%s" % \
-02445                     (len(removals), self.old_libraries_format(removals)))
-02446                 self.do_all(actions=removals)
-02447                 removals = self.old_libraries()
-02448 
-02449         if not self.options.compatible:
-02450             self.output_write("List of old libraries in testing (%d):\n%s" % \
-02451                 (len(removals), self.old_libraries_format(removals)))
-02452 
-02453         # output files
-02454         if not self.options.dry_run:
-02455             # re-write control files
-02456             if self.options.control_files:
-02457                 self.write_controlfiles(self.options.testing, 'testing')
-02458 
-02459             # write bugs and dates
-02460             self.write_bugs(self.options.testing, self.bugs['testing'])
-02461             self.write_dates(self.options.testing, self.dates)
-02462 
-02463             # write HeidiResult
-02464             self.write_heidi(self.options.testing, 'HeidiResult')
-02465 
-02466         self.__output.close()
-02467         self.__log("Test completed!", type="I")
-02468 
-02469     def do_hint(self, type, who, pkgvers):
-02470         """Process hints
-02471 
-02472         This method process `easy`, `hint` and `force-hint` hints. If the
-02473         requested version is not in unstable, than the hint is skipped.
-02474         """
-02475         hintinfo = {"easy": "easy",
-02476                     "hint": 0,
-02477                     "force-hint": -1,}
-02478 
-02479         self.__log("> Processing '%s' hint from %s" % (type, who), type="I")
-02480         self.output_write("Trying %s from %s: %s\n" % (type, who, " ".join( ["%s/%s" % (p,v) for (p,v) in pkgvers])))
-02481 
-02482         ok = True
-02483         # loop on the requested packages and versions
-02484         for pkg, v in pkgvers:
-02485             # remove architecture
-02486             if "/" in pkg:
-02487                 pkg = pkg[:pkg.find("/")]
-02488 
-02489             # skip removal requests
-02490             if pkg[0] == "-":
-02491                 continue
-02492             # handle testing-proposed-updates
-02493             elif pkg.endswith("_tpu"):
-02494                 pkg = pkg[:-4]
-02495                 if pkg not in self.sources['tpu']: continue
-02496                 if apt_pkg.VersionCompare(self.sources['tpu'][pkg][VERSION], v) != 0:
-02497                     self.output_write(" Version mismatch, %s %s != %s\n" % (pkg, v, self.sources['tpu'][pkg][VERSION]))
-02498                     ok = False
-02499             # does the package exist in unstable?
-02500             elif pkg not in self.sources['unstable']:
-02501                 self.output_write(" Source %s has no version in unstable\n" % pkg)
-02502                 ok = False
-02503             elif apt_pkg.VersionCompare(self.sources['unstable'][pkg][VERSION], v) != 0:
-02504                 self.output_write(" Version mismatch, %s %s != %s\n" % (pkg, v, self.sources['unstable'][pkg][VERSION]))
-02505                 ok = False
-02506         if not ok:
-02507             self.output_write("Not using hint\n")
-02508             return False
-02509 
-02510         self.do_all(hintinfo[type], map(operator.itemgetter(0), pkgvers))
-02511         return True
-02512 
-02513     def sort_actions(self):
-02514         """Sort actions in a smart way
-02515 
-02516         This method sorts the list of actions in a smart way. In details, it uses
-02517         as base sort the number of days the excuse is old, then reordering packages
-02518         so the ones with most reverse dependencies are at the end of the loop.
-02519         If an action depends on another one, it is put after it.
-02520         """
-02521         upgrade_me = [x.name for x in self.excuses if x.name in self.upgrade_me]
-02522         for e in self.excuses:
-02523             if e.name not in upgrade_me: continue
-02524             # try removes at the end of the loop
-02525             elif e.name[0] == '-':
-02526                 upgrade_me.remove(e.name)
-02527                 upgrade_me.append(e.name)
-02528             # otherwise, put it in a good position checking its dependencies
-02529             else:
-02530                 pos = []
-02531                 udeps = [upgrade_me.index(x) for x in e.deps if x in upgrade_me and x != e.name]
-02532                 if len(udeps) > 0:
-02533                     pos.append(max(udeps))
-02534                 sdeps = [upgrade_me.index(x) for x in e.sane_deps if x in upgrade_me and x != e.name]
-02535                 if len(sdeps) > 0:
-02536                     pos.append(min(sdeps))
-02537                 if len(pos) == 0: continue
-02538                 upgrade_me.remove(e.name)
-02539                 upgrade_me.insert(max(pos)+1, e.name)
-02540                 self.dependencies[e.name] = e.deps
-02541 
-02542         # replace the list of actions with the new one
-02543         self.upgrade_me = upgrade_me
-02544 
-02545     def auto_hinter(self):
-02546         """Auto hint circular dependencies
-02547 
-02548         This method tries to auto hint circular dependencies analyzing the update
-02549         excuses relationships. If they build a circular dependency, which we already
-02550         know as not-working with the standard do_all algorithm, try to `easy` them.
-02551         """
-02552         self.__log("> Processing hints from the auto hinter", type="I")
-02553 
-02554         # consider only excuses which are valid candidates
-02555         excuses = dict([(x.name, x) for x in self.excuses if x.name in self.upgrade_me])
-02556 
-02557         def find_related(e, hint, first=False):
-02558             if e not in excuses:
-02559                 return False
-02560             excuse = excuses[e]
-02561             if e in self.sources['testing'] and self.sources['testing'][e][VERSION] == excuse.ver[1]:
-02562                 return True
-02563             if not first:
-02564                 hint[e] = excuse.ver[1]
-02565             if len(excuse.deps) == 0:
-02566                 return hint
-02567             for p in excuse.deps:
-02568                 if p in hint: continue
-02569                 if not find_related(p, hint):
-02570                     return False
-02571             return hint
-02572 
-02573         # loop on them
-02574         cache = []
-02575         for e in excuses:
-02576             excuse = excuses[e]
-02577             if e in self.sources['testing'] and self.sources['testing'][e][VERSION] == excuse.ver[1] or \
-02578                len(excuse.deps) == 0:
-02579                 continue
-02580             hint = find_related(e, {}, True)
-02581             if hint and e in hint and hint not in cache:
-02582                 self.do_hint("easy", "autohinter", hint.items())
-02583                 cache.append(hint)
-02584 
-02585     def old_libraries(self):
-02586         """Detect old libraries left in testing for smooth transitions
-02587 
-02588         This method detect old libraries which are in testing but no longer
-02589         built from the source package: they are still there because other
-02590         packages still depend on them, but they should be removed as soon
-02591         as possible.
-02592         """
-02593         sources = self.sources['testing']
-02594         testing = self.binaries['testing']
-02595         unstable = self.binaries['unstable']
-02596         removals = []
-02597         for arch in self.options.architectures:
-02598             for pkg_name in testing[arch][0]:
-02599                 pkg = testing[arch][0][pkg_name]
-02600                 if pkg_name not in unstable[arch][0] and \
-02601                    not self.same_source(sources[pkg[SOURCE]][VERSION], pkg[SOURCEVER]):
-02602                     removals.append("-" + pkg_name + "/" + arch)
-02603         return removals
-02604 
-02605     def old_libraries_format(self, libs):
-02606         """Format old libraries in a smart table"""
-02607         libraries = {}
-02608         for i in libs:
-02609             pkg, arch = i.split("/")
-02610             pkg = pkg[1:]
-02611             if pkg in libraries:
-02612                     libraries[pkg].append(arch)
-02613             else:
-02614                     libraries[pkg] = [arch]
-02615         return "\n".join(["  " + k + ": " + " ".join(libraries[k]) for k in libraries]) + "\n"
-02616 
-02617     def output_write(self, msg):
-02618         """Simple wrapper for output writing"""
-02619         self.__output.write(msg)
-02620 
-02621     def main(self):
-02622         """Main method
-02623         
-02624         This is the entry point for the class: it includes the list of calls
-02625         for the member methods which will produce the output files.
-02626         """
-02627         # if no actions are provided, build the excuses and sort them
-02628         if not self.options.actions:
-02629             self.write_excuses()
-02630             if not self.options.compatible:
-02631                 self.sort_actions()
-02632         # otherwise, use the actions provided by the command line
-02633         else: self.upgrade_me = self.options.actions.split()
-02634 
-02635         # run the upgrade test
-02636         self.upgrade_testing()
-02637 
-02638 if __name__ == '__main__':
-02639     Britney().main()
-
Generated on Fri Aug 18 23:23:25 2006 for briteny by  - -doxygen 1.4.7
- - diff --git a/doc/html/classbritney_1_1Britney-members.html b/doc/html/classbritney_1_1Britney-members.html deleted file mode 100644 index 2b988f1..0000000 --- a/doc/html/classbritney_1_1Britney-members.html +++ /dev/null @@ -1,71 +0,0 @@ - - -briteny: Member List - - - - -
-
-
-
-

britney.Britney Member List

This is the complete list of members for britney.Britney, including all inherited members.

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
__init__britney.Britney
auto_hinterbritney.Britney
check_conflictsbritney.Britney
check_installablebritney.Britney
do_allbritney.Britney
do_hintbritney.Britney
doop_sourcebritney.Britney
eval_nuninstbritney.Britney
eval_uninstbritney.Britney
excuse_unsat_depsbritney.Britney
get_dependency_solversbritney.Britney
get_full_treebritney.Britney
get_nuninstbritney.Britney
HINTS_ALLbritney.Britney [static]
HINTS_STANDARDbritney.Britney [static]
invalidate_excusesbritney.Britney
is_nuninst_asgood_generousbritney.Britney
iter_packagesbritney.Britney
mainbritney.Britney
newlyuninstbritney.Britney
normalize_bugsbritney.Britney
old_librariesbritney.Britney
old_libraries_formatbritney.Britney
output_writebritney.Britney
read_approvalsbritney.Britney
read_binariesbritney.Britney
read_bugsbritney.Britney
read_datesbritney.Britney
read_hintsbritney.Britney
read_nuninstbritney.Britney
read_sourcesbritney.Britney
read_urgenciesbritney.Britney
register_reversesbritney.Britney
reversed_exc_depsbritney.Britney
same_sourcebritney.Britney
should_remove_sourcebritney.Britney
should_upgrade_srcbritney.Britney
should_upgrade_srcarchbritney.Britney
sort_actionsbritney.Britney
upgrade_testingbritney.Britney
write_bugsbritney.Britney
write_controlfilesbritney.Britney
write_datesbritney.Britney
write_excusesbritney.Britney
write_heidibritney.Britney
write_nuninstbritney.Britney

Generated on Fri Aug 18 23:23:25 2006 for briteny by  - -doxygen 1.4.7
- - diff --git a/doc/html/classbritney_1_1Britney.html b/doc/html/classbritney_1_1Britney.html deleted file mode 100644 index 0375abe..0000000 --- a/doc/html/classbritney_1_1Britney.html +++ /dev/null @@ -1,1958 +0,0 @@ - - -briteny: britney.Britney Class Reference - - - - -
-
-
-
-
-britney.Britney
-

britney.Britney Class Reference

List of all members. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

Public Member Functions

def __init__
def read_sources
def read_binaries
def register_reverses
def read_bugs
def write_bugs
def normalize_bugs
def read_dates
def write_dates
def read_urgencies
def read_approvals
def read_hints
def write_heidi
def write_controlfiles
def write_nuninst
def read_nuninst
def same_source
def get_dependency_solvers
def excuse_unsat_deps
def should_remove_source
def should_upgrade_srcarch
def should_upgrade_src
def reversed_exc_deps
def invalidate_excuses
def write_excuses
def newlyuninst
def get_nuninst
def eval_nuninst
def eval_uninst
-def is_nuninst_asgood_generous
def check_installable
def check_conflicts
def doop_source
def get_full_tree
def iter_packages
def do_all
def upgrade_testing
def do_hint
def sort_actions
def auto_hinter
def old_libraries
def old_libraries_format
def output_write
def main

Static Public Attributes

-tuple HINTS_STANDARD = ("easy", "hint", "remove", "block", "unblock", "urgent", "approve")
-tuple HINTS_ALL = ("force", "force-hint", "block-all")
-

Detailed Description

-
Britney, the debian testing updater script
-
-This is the script that updates the testing_ distribution. It is executed
-each day after the installation of the updated packages. It generates the 
-`Packages' files for the testing distribution, but it does so in an
-intelligent manner; it try to avoid any inconsistency and to use only
-non-buggy packages.
-
-For more documentation on this script, please read the Developers Reference.
-
-

- -

-Definition at line 212 of file britney.py.

Member Function Documentation

- -
-
- - - - - - - - - -
def britney.Britney.__init__ (  self  ) 
-
-
- -

-

Class constructor
-
-This method initializes and populates the data lists, which contain all
-the information needed by the other methods of the class.
-
-

-Definition at line 218 of file britney.py. -

-

- -

-
- - - - - - - - - -
def britney.Britney.auto_hinter (  self  ) 
-
-
- -

-

Auto hint circular dependencies
-
-This method tries to auto hint circular dependencies analyzing the update
-excuses relationships. If they build a circular dependency, which we already
-know as not-working with the standard do_all algorithm, try to `easy` them.
-
-

-Definition at line 2536 of file britney.py. -

-

- -

-
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
def britney.Britney.check_conflicts (  self,
  pkg,
  arch,
  broken,
  system,
  conflicts 
)
-
-
- -

-

Check if a package can be installed satisfying the conflicts
-
-This method checks if the `pkg` package from the `arch` architecture
-can be installed (excluding `broken` packages) within the system
-`system` along with all its dependencies. This means that all the
-conflicts relationships are checked in order to achieve the test
-co-installability of the package.
-
-The method returns a boolean which is True if the given package is
-co-installable in the given system.
-
-

-Definition at line 1661 of file britney.py. -

-

- -

-
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
def britney.Britney.check_installable (  self,
  pkg,
  arch,
  suite,
  excluded = [],
  conflicts = False 
)
-
-
- -

-

Check if a package is installable
-
-This method analyzes the dependencies of the binary package specified
-by the parameter `pkg' for the architecture `arch' within the suite
-`suite'. If the dependency can be satisfied in the given `suite` and
-`conflicts` parameter is True, then the co-installability with 
-conflicts handling is checked.
-
-The dependency fields checked are Pre-Depends and Depends.
-
-The method returns a boolean which is True if the given package is
-installable.
-
-

-Definition at line 1620 of file britney.py. -

-

- -

-
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
def britney.Britney.do_all (  self,
  maxdepth = 0,
  init = None,
  actions = None 
)
-
-
- -

-

Testing update runner
-
-This method tries to update testing checking the uninstallability
-counters before and after the actions to decide if the update was
-successful or not.
-
-

-Definition at line 2258 of file britney.py. -

-

- -

-
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
def britney.Britney.do_hint (  self,
  type,
  who,
  pkgvers 
)
-
-
- -

-

Process hints
-
-This method process `easy`, `hint` and `force-hint` hints. If the
-requested version is not in unstable, than the hint is skipped.
-
-

-Definition at line 2460 of file britney.py. -

-

- -

-
- - - - - - - - - - - - - - - - - - -
def britney.Britney.doop_source (  self,
  pkg 
)
-
-
- -

-

Apply a change to the testing distribution as requested by `pkg`
-
-This method apply the changes required by the action `pkg` tracking
-them so it will be possible to revert them.
-
-The method returns a list of the package name, the suite where the
-package comes from, the list of packages affected by the change and
-the dictionary undo which can be used to rollback the changes.
-
-

-Definition at line 1880 of file britney.py. -

-

- -

-
- - - - - - - - - - - - - - - - - - - - - - - - -
def britney.Britney.eval_nuninst (  self,
  nuninst,
  original = None 
)
-
-
- -

-

Return a string which represents the uninstallability counters
-
-This method returns a string which represents the uninstallability
-counters reading the uninstallability statistics `nuninst` and, if
-present, merging the results with the `original` one.
-
-An example of the output string is:
-1+2: i-0:a-0:a-0:h-0:i-1:m-0:m-0:p-0:a-0:m-0:s-2:s-0
-
-where the first part is the number of broken packages in non-break
-architectures + the total number of broken packages for all the
-architectures.
-
-

-Definition at line 1568 of file britney.py. -

-

- -

-
- - - - - - - - - - - - - - - - - - -
def britney.Britney.eval_uninst (  self,
  nuninst 
)
-
-
- -

-

Return a string which represents the uninstallable packages
-
-This method returns a string which represents the uninstallable
-packages reading the uninstallability statistics `nuninst`.
-
-An example of the output string is:
-    * i386: broken-pkg1, broken-pkg2
-
-

-Definition at line 1598 of file britney.py. -

-

- -

-
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
def britney.Britney.excuse_unsat_deps (  self,
  pkg,
  src,
  arch,
  suite,
  excuse,
  excluded = [],
  conflicts = False 
)
-
-
- -

-

Find unsatisfied dependencies for a binary package
-
-This method analyzes the dependencies of the binary package specified
-by the parameter `pkg', built from the source package `src', for the
-architecture `arch' within the suite `suite'. If the dependency can't
-be satisfied in testing and/or unstable, it updates the excuse passed
-as parameter.
-
-The dependency fields checked are Pre-Depends and Depends.
-
-

-Definition at line 930 of file britney.py. -

-

- -

-
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
def britney.Britney.get_dependency_solvers (  self,
  block,
  arch,
  distribution,
  excluded = [],
  strict = False 
)
-
-
- -

-

Find the packages which satisfy a dependency block
-
-This method returns the list of packages which satisfy a dependency
-block (as returned by apt_pkg.ParseDepends) for the given architecture
-and distribution.
-
-It returns a tuple with two items: the first is a boolean which is
-True if the dependency is satisfied, the second is the list of the
-solving packages.
-
-

-Definition at line 889 of file britney.py. -

-

- -

-
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
def britney.Britney.get_full_tree (  self,
  pkg,
  arch,
  suite 
)
-
-
- -

-

Calculate the full dependency tree for the given package
-
-This method returns the full dependency tree for the package `pkg`,
-inside the `arch` architecture for the suite `suite`.
-
-

-Definition at line 2022 of file britney.py. -

-

- -

-
- - - - - - - - - - - - - - - - - - - - - - - - -
def britney.Britney.get_nuninst (  self,
  requested_arch = None,
  build = False 
)
-
-
- -

-

Return the uninstallability statistic for all the architectures
-
-To calculate the uninstallability counters, the method checks the
-installability of all the packages for all the architectures, and
-tracking dependencies in a recursive way. The architecture
-indipendent packages are checked only for the `nobreakall`
-architectures.
-
-It returns a dictionary with the architectures as keys and the list
-of uninstallable packages as values.
-
-

-Definition at line 1508 of file britney.py. -

-

- -

-
- - - - - - - - - - - - - - - - - - - - - - - - -
def britney.Britney.invalidate_excuses (  self,
  valid,
  invalid 
)
-
-
- -

-

Invalidate impossible excuses
-
-This method invalidates the impossible excuses, which depend
-on invalid excuses. The two parameters contains the list of
-`valid' and `invalid' excuses.
-
-

-Definition at line 1344 of file britney.py. -

-

- -

-
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
def britney.Britney.iter_packages (  self,
  packages,
  selected,
  hint = False,
  nuninst = None 
)
-
-
- -

-

Iter on the list of actions and apply them one-by-one
-
-This method apply the changes from `packages` to testing, checking the uninstallability
-counters for every action performed. If the action do not improve the it, it is reverted.
-The method returns the new uninstallability counters and the remaining actions if the
-final result is successful, otherwise (None, None).
-
-

-Definition at line 2038 of file britney.py. -

-

- -

-
- - - - - - - - - -
def britney.Britney.main (  self  ) 
-
-
- -

-

Main method
-
-This is the entry point for the class: it includes the list of calls
-for the member methods which will produce the output files.
-
-

-Definition at line 2612 of file britney.py. -

-

- -

-
- - - - - - - - - - - - - - - - - - - - - - - - -
def britney.Britney.newlyuninst (  self,
  nuold,
  nunew 
)
-
-
- -

-

Return a nuninst statstic with only new uninstallable packages
-
-This method subtract the uninstallabla packages of the statistic
-`nunew` from the statistic `nuold`.
-
-It returns a dictionary with the architectures as keys and the list
-of uninstallable packages as values.
-
-

-Definition at line 1493 of file britney.py. -

-

- -

-
- - - - - - - - - -
def britney.Britney.normalize_bugs (  self  ) 
-
-
- -

-

Normalize the release critical bug summaries for testing and unstable
-
-The method doesn't return any value: it directly modifies the
-object attribute `bugs'.
-
-

-Definition at line 549 of file britney.py. -

-

- -

-
- - - - - - - - - -
def britney.Britney.old_libraries (  self  ) 
-
-
- -

-

Detect old libraries left in testing for smooth transitions
-
-This method detect old libraries which are in testing but no longer
-built from the source package: they are still there because other
-packages still depend on them, but they should be removed as soon
-as possible.
-
-

-Definition at line 2576 of file britney.py. -

-

- -

-
- - - - - - - - - - - - - - - - - - -
def britney.Britney.old_libraries_format (  self,
  libs 
)
-
-
- -

-

Format old libraries in a smart table
-

-Definition at line 2596 of file britney.py. -

-

- -

-
- - - - - - - - - - - - - - - - - - -
def britney.Britney.output_write (  self,
  msg 
)
-
-
- -

-

Simple wrapper for output writing
-

-Definition at line 2608 of file britney.py. -

-

- -

-
- - - - - - - - - - - - - - - - - - -
def britney.Britney.read_approvals (  self,
  basedir 
)
-
-
- -

-

Read the approval commands from the specified directory
-
-The approval commands are read from the files contained by the 
-`Approved' directory within the directory specified as `basedir'
-parameter. The name of the files has to be the same of the
-authorized users for the approvals.
-
-The file contains rows with the format:
-
-<package-name> <version>
-
-The method returns a dictionary where the key is the binary package
-name followed by an underscore and the version number, and the value
-is the user who submitted the command.
-
-

-Definition at line 669 of file britney.py. -

-

- -

-
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
def britney.Britney.read_binaries (  self,
  basedir,
  distribution,
  arch 
)
-
-
- -

-

Read the list of binary packages from the specified directory
-
-The binary packages are read from the `Packages_${arch}' files
-within the directory specified as `basedir' parameter, replacing
-${arch} with the value of the arch parameter. Considering the
-large amount of memory needed, not all the fields are loaded
-in memory. The available fields are Version, Source, Pre-Depends,
-Depends, Conflicts, Provides and Architecture.
-
-After reading the packages, reverse dependencies are computed
-and saved in the `rdepends' keys, and the `Provides' field is
-used to populate the virtual packages list.
-
-The dependencies are parsed with the apt.pkg.ParseDepends method,
-and they are stored both as the format of its return value and
-text.
-
-The method returns a tuple. The first element is a list where
-every item represents a binary package as a dictionary; the second
-element is a dictionary which maps virtual packages to real
-packages that provide it.
-
-

-Definition at line 367 of file britney.py. -

-

- -

-
- - - - - - - - - - - - - - - - - - -
def britney.Britney.read_bugs (  self,
  basedir 
)
-
-
- -

-

Read the release critial bug summary from the specified directory
-
-The RC bug summaries are read from the `Bugs' file within the
-directory specified as `basedir' parameter. The file contains
-rows with the format:
-
-<package-name> <count-of-rc-bugs>
-
-The method returns a dictionary where the key is the binary package
-name and the value is the number of open RC bugs for it.
-
-

-Definition at line 493 of file britney.py. -

-

- -

-
- - - - - - - - - - - - - - - - - - -
def britney.Britney.read_dates (  self,
  basedir 
)
-
-
- -

-

Read the upload date for the packages from the specified directory
-
-The upload dates are read from the `Date' file within the directory
-specified as `basedir' parameter. The file contains rows with the
-format:
-
-<package-name> <version> <date-of-upload>
-
-The dates are expressed as days starting from the 1970-01-01.
-
-The method returns a dictionary where the key is the binary package
-name and the value is tuple with two items, the version and the date.
-
-

-Definition at line 584 of file britney.py. -

-

- -

-
- - - - - - - - - - - - - - - - - - -
def britney.Britney.read_hints (  self,
  basedir 
)
-
-
- -

-

Read the hint commands from the specified directory
-
-The hint commands are read from the files contained by the `Hints'
-directory within the directory specified as `basedir' parameter. 
-The name of the files has to be the same of the authorized users
-for the hints.
-
-The file contains rows with the format:
-
-<command> <package-name>[/<version>]
-
-The method returns a dictionary where the key is the command, and
-the value is the list of affected packages.
-
-

-Definition at line 695 of file britney.py. -

-

- -

-
- - - - - - - - - -
def britney.Britney.read_nuninst (  self  ) 
-
-
- -

-

Read the non-installable report
-

-Definition at line 835 of file britney.py. -

-

- -

-
- - - - - - - - - - - - - - - - - - -
def britney.Britney.read_sources (  self,
  basedir 
)
-
-
- -

-

Read the list of source packages from the specified directory
-
-The source packages are read from the `Sources' file within the
-directory specified as `basedir' parameter. Considering the
-large amount of memory needed, not all the fields are loaded
-in memory. The available fields are Version, Maintainer and Section.
-
-The method returns a list where every item represents a source
-package as a dictionary.
-
-

-Definition at line 340 of file britney.py. -

-

- -

-
- - - - - - - - - - - - - - - - - - -
def britney.Britney.read_urgencies (  self,
  basedir 
)
-
-
- -

-

Read the upload urgency of the packages from the specified directory
-
-The upload urgencies are read from the `Urgency' file within the
-directory specified as `basedir' parameter. The file contains rows
-with the format:
-
-<package-name> <version> <urgency>
-
-The method returns a dictionary where the key is the binary package
-name and the value is the greatest urgency from the versions of the
-package that are higher then the testing one.
-
-

-Definition at line 624 of file britney.py. -

-

- -

-
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
def britney.Britney.register_reverses (  self,
  pkg,
  packages,
  provides,
  check_doubles = True,
  parse_depends = apt_pkg.ParseDepends 
)
-
-
- -

-

Register reverse dependencies and conflicts for the specified package
-
-This method register the reverse dependencies and conflicts for
-a give package using `packages` as list of packages and `provides`
-as list of virtual packages.
-
-The method has an optional parameter parse_depends which is there
-just for performance reasons and is not meant to be overwritten.
-
-

-Definition at line 451 of file britney.py. -

-

- -

-
- - - - - - - - - -
def britney.Britney.reversed_exc_deps (  self  ) 
-
-
- -

-

Reverse the excuses dependencies
-
-This method returns a dictionary where the keys are the package names
-and the values are the excuse names which depend on it.
-
-

-Definition at line 1331 of file britney.py. -

-

- -

-
- - - - - - - - - - - - - - - - - - - - - - - - -
def britney.Britney.same_source (  self,
  sv1,
  sv2 
)
-
-
- -

-

Check if two version numbers are built from the same source
-
-This method returns a boolean value which is true if the two
-version numbers specified as parameters are built from the same
-source. The main use of this code is to detect binary-NMU.
-
-

-Definition at line 850 of file britney.py. -

-

- -

-
- - - - - - - - - - - - - - - - - - -
def britney.Britney.should_remove_source (  self,
  pkg 
)
-
-
- -

-

Check if a source package should be removed from testing
-
-This method checks if a source package should be removed from the
-testing distribution; this happen if the source package is not
-present in the unstable distribution anymore.
-
-It returns True if the package can be removed, False otherwise.
-In the former case, a new excuse is appended to the the object
-attribute excuses.
-
-

-Definition at line 990 of file britney.py. -

-

- -

-
- - - - - - - - - - - - - - - - - - - - - - - - -
def britney.Britney.should_upgrade_src (  self,
  src,
  suite 
)
-
-
- -

-

Check if source package should be upgraded
-
-This method checks if a source package should be upgraded. The analysis
-is performed for the source package specified by the `src' parameter, 
-checking the architecture `arch' for the distribution `suite'.
-       
-It returns False if the given package doesn't need to be upgraded,
-True otherwise. In the former case, a new excuse is appended to
-the the object attribute excuses.
-
-

-Definition at line 1134 of file britney.py. -

-

- -

-
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
def britney.Britney.should_upgrade_srcarch (  self,
  src,
  arch,
  suite 
)
-
-
- -

-

Check if binary package should be upgraded
-
-This method checks if a binary package should be upgraded; this can
-happen also if the binary package is a binary-NMU for the given arch.
-The analysis is performed for the source package specified by the
-`src' parameter, checking the architecture `arch' for the distribution
-`suite'.
-       
-It returns False if the given package doesn't need to be upgraded,
-True otherwise. In the former case, a new excuse is appended to
-the the object attribute excuses.
-
-

-Definition at line 1020 of file britney.py. -

-

- -

-
- - - - - - - - - -
def britney.Britney.sort_actions (  self  ) 
-
-
- -

-

Sort actions in a smart way
-
-This method sorts the list of actions in a smart way. In details, it uses
-as base sort the number of days the excuse is old, then reordering packages
-so the ones with most reverse dependencies are at the end of the loop.
-If an action depends on another one, it is put after it.
-
-

-Definition at line 2504 of file britney.py. -

-

- -

-
- - - - - - - - - -
def britney.Britney.upgrade_testing (  self  ) 
-
-
- -

-

Upgrade testing using the unstable packages
-
-This method tries to upgrade testing using the packages from unstable.
-Before running the do_all method, it tries the easy and force-hint
-commands.
-
-

-Definition at line 2365 of file britney.py. -

-

- -

-
- - - - - - - - - - - - - - - - - - - - - - - - -
def britney.Britney.write_bugs (  self,
  basedir,
  bugs 
)
-
-
- -

-

Write the release critical bug summary to the specified directory
-
-For a more detailed explanation of the format, please check the method
-read_bugs.
-
-

-Definition at line 517 of file britney.py. -

-

- -

-
- - - - - - - - - - - - - - - - - - - - - - - - -
def britney.Britney.write_controlfiles (  self,
  basedir,
  suite 
)
-
-
- -

-

Write the control files
-
-This method write the control files for the binary packages of all
-the architectures and for the source packages.
-
-

-Definition at line 777 of file britney.py. -

-

- -

-
- - - - - - - - - - - - - - - - - - - - - - - - -
def britney.Britney.write_dates (  self,
  basedir,
  dates 
)
-
-
- -

-

Write the upload date for the packages to the specified directory
-
-For a more detailed explanation of the format, please check the method
-read_dates.
-
-

-Definition at line 610 of file britney.py. -

-

- -

-
- - - - - - - - - -
def britney.Britney.write_excuses (  self  ) 
-
-
- -

-

Produce and write the update excuses
-
-This method handles the update excuses generation: the packages are
-looked to determine whether they are valid candidates. For the details
-of this procedure, please refer to the module docstring.
-
-

-Definition at line 1386 of file britney.py. -

-

- -

-
- - - - - - - - - - - - - - - - - - - - - - - - -
def britney.Britney.write_heidi (  self,
  basedir,
  filename 
)
-
-
- -

-

Write the output HeidiResult
-
-This method write the output for Heidi, which contains all the
-binary packages and the source packages in the form:
-
-<pkg-name> <pkg-version> <pkg-architecture> <pkg-section>
-<src-name> <src-version> <src-section>
-
-

-Definition at line 742 of file britney.py. -

-

- -

-
- - - - - - - - - - - - - - - - - - -
def britney.Britney.write_nuninst (  self,
  nuninst 
)
-
-
- -

-

Write the non-installable report
-

-Definition at line 827 of file britney.py. -

-

-

The documentation for this class was generated from the following file: -
Generated on Fri Aug 18 23:23:25 2006 for briteny by  - -doxygen 1.4.7
- - diff --git a/doc/html/classexcuse_1_1Excuse-members.html b/doc/html/classexcuse_1_1Excuse-members.html deleted file mode 100644 index e7cd138..0000000 --- a/doc/html/classexcuse_1_1Excuse-members.html +++ /dev/null @@ -1,41 +0,0 @@ - - -briteny: Member List - - - - -
-
-
-
-

excuse.Excuse Member List

This is the complete list of members for excuse.Excuse, including all inherited members.

- - - - - - - - - - - - - - - - -
__init__excuse.Excuse
add_break_depexcuse.Excuse
add_depexcuse.Excuse
add_sane_depexcuse.Excuse
add_unsat_depexcuse.Excuse
addhtmlexcuse.Excuse
htmlexcuse.Excuse
invalidate_depexcuse.Excuse
reemailexcuse.Excuse [static]
set_dateexcuse.Excuse
set_maintexcuse.Excuse
set_priorityexcuse.Excuse
set_sectionexcuse.Excuse
set_urgencyexcuse.Excuse
set_versexcuse.Excuse
setdaysoldexcuse.Excuse

Generated on Fri Aug 18 23:23:25 2006 for briteny by  - -doxygen 1.4.7
- - diff --git a/doc/html/classexcuse_1_1Excuse.html b/doc/html/classexcuse_1_1Excuse.html deleted file mode 100644 index 1baa28a..0000000 --- a/doc/html/classexcuse_1_1Excuse.html +++ /dev/null @@ -1,561 +0,0 @@ - - -briteny: excuse.Excuse Class Reference - - - - -
-
-
-
-
-excuse.Excuse
-

excuse.Excuse Class Reference

List of all members. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

Public Member Functions

def __init__
def set_vers
def set_maint
def set_section
def set_priority
def set_date
def set_urgency
def add_dep
def add_sane_dep
def add_break_dep
def add_unsat_dep
def invalidate_dep
def setdaysold
def addhtml
def html

Static Public Attributes

-tuple reemail = re.compile(r"<.*?>")
 Regular expression for removing the email address.
-

Detailed Description

-
Excuse class
-
-This class represents an update excuse, which is a detailed explanation
-of why a package can or cannot be updated in the testing distribution from
-a newer package in another distribution (like for example unstable).
-
-The main purpose of the excuses is to be written in an HTML file which
-will be published over HTTP. The maintainers will be able to parse it
-manually or automatically to find the explanation of why their packages
-have been updated or not.
-
-

- -

-Definition at line 21 of file excuse.py.

Member Function Documentation

- -
-
- - - - - - - - - - - - - - - - - - -
def excuse.Excuse.__init__ (  self,
  name 
)
-
-
- -

-

Class constructor
-
-This method initializes the excuse with the specified name and
-the default values.
-
-

-Definition at line 28 of file excuse.py. -

-

- -

-
- - - - - - - - - - - - - - - - - - - - - - - - -
def excuse.Excuse.add_break_dep (  self,
  name,
  arch 
)
-
-
- -

-

Add a break dependency
-

-Definition at line 86 of file excuse.py. -

-

- -

-
- - - - - - - - - - - - - - - - - - -
def excuse.Excuse.add_dep (  self,
  name 
)
-
-
- -

-

Add a dependency
-

-Definition at line 78 of file excuse.py. -

-

- -

-
- - - - - - - - - - - - - - - - - - -
def excuse.Excuse.add_sane_dep (  self,
  name 
)
-
-
- -

-

Add a sane dependency
-

-Definition at line 82 of file excuse.py. -

-

- -

-
- - - - - - - - - - - - - - - - - - -
def excuse.Excuse.add_unsat_dep (  self,
  arch 
)
-
-
- -

-

Add a flag for unsatisfied dependencies
-

-Definition at line 91 of file excuse.py. -

-

- -

-
- - - - - - - - - - - - - - - - - - -
def excuse.Excuse.addhtml (  self,
  note 
)
-
-
- -

-

Add a note in HTML
-

-Definition at line 104 of file excuse.py. -

-

- -

-
- - - - - - - - - -
def excuse.Excuse.html (  self  ) 
-
-
- -

-

Render the excuse in HTML
-

-Definition at line 108 of file excuse.py. -

-

- -

-
- - - - - - - - - - - - - - - - - - -
def excuse.Excuse.invalidate_dep (  self,
  name 
)
-
-
- -

-

Invalidate dependency
-

-Definition at line 95 of file excuse.py. -

-

- -

-
- - - - - - - - - - - - - - - - - - -
def excuse.Excuse.set_date (  self,
  date 
)
-
-
- -

-

Set the date of upload of the package
-

-Definition at line 70 of file excuse.py. -

-

- -

-
- - - - - - - - - - - - - - - - - - -
def excuse.Excuse.set_maint (  self,
  maint 
)
-
-
- -

-

Set the package maintainer's name
-

-Definition at line 58 of file excuse.py. -

-

- -

-
- - - - - - - - - - - - - - - - - - -
def excuse.Excuse.set_priority (  self,
  pri 
)
-
-
- -

-

Set the priority of the package
-

-Definition at line 66 of file excuse.py. -

-

- -

-
- - - - - - - - - - - - - - - - - - -
def excuse.Excuse.set_section (  self,
  section 
)
-
-
- -

-

Set the section of the package
-

-Definition at line 62 of file excuse.py. -

-

- -

-
- - - - - - - - - - - - - - - - - - -
def excuse.Excuse.set_urgency (  self,
  date 
)
-
-
- -

-

Set the urgency of upload of the package
-

-Definition at line 74 of file excuse.py. -

-

- -

-
- - - - - - - - - - - - - - - - - - - - - - - - -
def excuse.Excuse.set_vers (  self,
  tver,
  uver 
)
-
-
- -

-

Set the testing and unstable versions
-

-Definition at line 53 of file excuse.py. -

-

- -

-
- - - - - - - - - - - - - - - - - - - - - - - - -
def excuse.Excuse.setdaysold (  self,
  daysold,
  mindays 
)
-
-
- -

-

Set the number of days from the upload and the minimum number of days for the update
-

-Definition at line 99 of file excuse.py. -

-

-

The documentation for this class was generated from the following file: -
Generated on Fri Aug 18 23:23:25 2006 for briteny by  - -doxygen 1.4.7
- - diff --git a/doc/html/doxygen.css b/doc/html/doxygen.css deleted file mode 100644 index 5d58369..0000000 --- a/doc/html/doxygen.css +++ /dev/null @@ -1,358 +0,0 @@ -BODY,H1,H2,H3,H4,H5,H6,P,CENTER,TD,TH,UL,DL,DIV { - font-family: Geneva, Arial, Helvetica, sans-serif; -} -BODY,TD { - font-size: 90%; -} -H1 { - text-align: center; - font-size: 160%; -} -H2 { - font-size: 120%; -} -H3 { - font-size: 100%; -} -CAPTION { font-weight: bold } -DIV.qindex { - width: 100%; - background-color: #e8eef2; - border: 1px solid #84b0c7; - text-align: center; - margin: 2px; - padding: 2px; - line-height: 140%; -} -DIV.nav { - width: 100%; - background-color: #e8eef2; - border: 1px solid #84b0c7; - text-align: center; - margin: 2px; - padding: 2px; - line-height: 140%; -} -DIV.navtab { - background-color: #e8eef2; - border: 1px solid #84b0c7; - text-align: center; - margin: 2px; - margin-right: 15px; - padding: 2px; -} -TD.navtab { - font-size: 70%; -} -A.qindex { - text-decoration: none; - font-weight: bold; - color: #1A419D; -} -A.qindex:visited { - text-decoration: none; - font-weight: bold; - color: #1A419D -} -A.qindex:hover { - text-decoration: none; - background-color: #ddddff; -} -A.qindexHL { - text-decoration: none; - font-weight: bold; - background-color: #6666cc; - color: #ffffff; - border: 1px double #9295C2; -} -A.qindexHL:hover { - text-decoration: none; - background-color: #6666cc; - color: #ffffff; -} -A.qindexHL:visited { text-decoration: none; background-color: #6666cc; color: #ffffff } -A.el { text-decoration: none; font-weight: bold } -A.elRef { font-weight: bold } -A.code:link { text-decoration: none; font-weight: normal; color: #0000FF} -A.code:visited { text-decoration: none; font-weight: normal; color: #0000FF} -A.codeRef:link { font-weight: normal; color: #0000FF} -A.codeRef:visited { font-weight: normal; color: #0000FF} -A:hover { text-decoration: none; background-color: #f2f2ff } -DL.el { margin-left: -1cm } -.fragment { - font-family: monospace, fixed; - font-size: 95%; -} -PRE.fragment { - border: 1px solid #CCCCCC; - background-color: #f5f5f5; - margin-top: 4px; - margin-bottom: 4px; - margin-left: 2px; - margin-right: 8px; - padding-left: 6px; - padding-right: 6px; - padding-top: 4px; - padding-bottom: 4px; -} -DIV.ah { background-color: black; font-weight: bold; color: #ffffff; margin-bottom: 3px; margin-top: 3px } - -DIV.groupHeader { - margin-left: 16px; - margin-top: 12px; - margin-bottom: 6px; - font-weight: bold; -} -DIV.groupText { margin-left: 16px; font-style: italic; font-size: 90% } -BODY { - background: white; - color: black; - margin-right: 20px; - margin-left: 20px; -} -TD.indexkey { - background-color: #e8eef2; - font-weight: bold; - padding-right : 10px; - padding-top : 2px; - padding-left : 10px; - padding-bottom : 2px; - margin-left : 0px; - margin-right : 0px; - margin-top : 2px; - margin-bottom : 2px; - border: 1px solid #CCCCCC; -} -TD.indexvalue { - background-color: #e8eef2; - font-style: italic; - padding-right : 10px; - padding-top : 2px; - padding-left : 10px; - padding-bottom : 2px; - margin-left : 0px; - margin-right : 0px; - margin-top : 2px; - margin-bottom : 2px; - border: 1px solid #CCCCCC; -} -TR.memlist { - background-color: #f0f0f0; -} -P.formulaDsp { text-align: center; } -IMG.formulaDsp { } -IMG.formulaInl { vertical-align: middle; } -SPAN.keyword { color: #008000 } -SPAN.keywordtype { color: #604020 } -SPAN.keywordflow { color: #e08000 } -SPAN.comment { color: #800000 } -SPAN.preprocessor { color: #806020 } -SPAN.stringliteral { color: #002080 } -SPAN.charliteral { color: #008080 } -.mdescLeft { - padding: 0px 8px 4px 8px; - font-size: 80%; - font-style: italic; - background-color: #FAFAFA; - border-top: 1px none #E0E0E0; - border-right: 1px none #E0E0E0; - border-bottom: 1px none #E0E0E0; - border-left: 1px none #E0E0E0; - margin: 0px; -} -.mdescRight { - padding: 0px 8px 4px 8px; - font-size: 80%; - font-style: italic; - background-color: #FAFAFA; - border-top: 1px none #E0E0E0; - border-right: 1px none #E0E0E0; - border-bottom: 1px none #E0E0E0; - border-left: 1px none #E0E0E0; - margin: 0px; -} -.memItemLeft { - padding: 1px 0px 0px 8px; - margin: 4px; - border-top-width: 1px; - border-right-width: 1px; - border-bottom-width: 1px; - border-left-width: 1px; - border-top-color: #E0E0E0; - border-right-color: #E0E0E0; - border-bottom-color: #E0E0E0; - border-left-color: #E0E0E0; - border-top-style: solid; - border-right-style: none; - border-bottom-style: none; - border-left-style: none; - background-color: #FAFAFA; - font-size: 80%; -} -.memItemRight { - padding: 1px 8px 0px 8px; - margin: 4px; - border-top-width: 1px; - border-right-width: 1px; - border-bottom-width: 1px; - border-left-width: 1px; - border-top-color: #E0E0E0; - border-right-color: #E0E0E0; - border-bottom-color: #E0E0E0; - border-left-color: #E0E0E0; - border-top-style: solid; - border-right-style: none; - border-bottom-style: none; - border-left-style: none; - background-color: #FAFAFA; - font-size: 80%; -} -.memTemplItemLeft { - padding: 1px 0px 0px 8px; - margin: 4px; - border-top-width: 1px; - border-right-width: 1px; - border-bottom-width: 1px; - border-left-width: 1px; - border-top-color: #E0E0E0; - border-right-color: #E0E0E0; - border-bottom-color: #E0E0E0; - border-left-color: #E0E0E0; - border-top-style: none; - border-right-style: none; - border-bottom-style: none; - border-left-style: none; - background-color: #FAFAFA; - font-size: 80%; -} -.memTemplItemRight { - padding: 1px 8px 0px 8px; - margin: 4px; - border-top-width: 1px; - border-right-width: 1px; - border-bottom-width: 1px; - border-left-width: 1px; - border-top-color: #E0E0E0; - border-right-color: #E0E0E0; - border-bottom-color: #E0E0E0; - border-left-color: #E0E0E0; - border-top-style: none; - border-right-style: none; - border-bottom-style: none; - border-left-style: none; - background-color: #FAFAFA; - font-size: 80%; -} -.memTemplParams { - padding: 1px 0px 0px 8px; - margin: 4px; - border-top-width: 1px; - border-right-width: 1px; - border-bottom-width: 1px; - border-left-width: 1px; - border-top-color: #E0E0E0; - border-right-color: #E0E0E0; - border-bottom-color: #E0E0E0; - border-left-color: #E0E0E0; - border-top-style: solid; - border-right-style: none; - border-bottom-style: none; - border-left-style: none; - color: #606060; - background-color: #FAFAFA; - font-size: 80%; -} -.search { color: #003399; - font-weight: bold; -} -FORM.search { - margin-bottom: 0px; - margin-top: 0px; -} -INPUT.search { font-size: 75%; - color: #000080; - font-weight: normal; - background-color: #e8eef2; -} -TD.tiny { font-size: 75%; -} -a { - color: #1A41A8; -} -a:visited { - color: #2A3798; -} -.dirtab { padding: 4px; - border-collapse: collapse; - border: 1px solid #84b0c7; -} -TH.dirtab { background: #e8eef2; - font-weight: bold; -} -HR { height: 1px; - border: none; - border-top: 1px solid black; -} - -/* Style for detailed member documentation */ -.memtemplate { - font-size: 80%; - color: #606060; - font-weight: normal; -} -.memnav { - background-color: #e8eef2; - border: 1px solid #84b0c7; - text-align: center; - margin: 2px; - margin-right: 15px; - padding: 2px; -} -.memitem { - padding: 4px; - background-color: #eef3f5; - border-width: 1px; - border-style: solid; - border-color: #dedeee; - -moz-border-radius: 8px 8px 8px 8px; -} -.memname { - white-space: nowrap; - font-weight: bold; -} -.memdoc{ - padding-left: 10px; -} -.memproto { - background-color: #d5e1e8; - width: 100%; - border-width: 1px; - border-style: solid; - border-color: #84b0c7; - font-weight: bold; - -moz-border-radius: 8px 8px 8px 8px; -} -.paramkey { - text-align: right; -} -.paramtype { - white-space: nowrap; -} -.paramname { - color: #602020; - font-style: italic; -} -/* End Styling for detailed member documentation */ - -/* for the tree view */ -.ftvtree { - font-family: sans-serif; - margin:0.5em; -} -.directory { font-size: 9pt; font-weight: bold; } -.directory h3 { margin: 0px; margin-top: 1em; font-size: 11pt; } -.directory > h3 { margin-top: 0; } -.directory p { margin: 0px; white-space: nowrap; } -.directory div { display: none; margin: 0px; } -.directory img { vertical-align: -30%; } - diff --git a/doc/html/doxygen.png b/doc/html/doxygen.png deleted file mode 100644 index f0a274bbaffdd67f6d784c894d9cf28729db0e14..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 1281 zcmaJ>ZA?>F7(Vx-ms?uoS`b@hdRtpo6o^%HU>M$hfGrBvQnk$LE?p^P!kn&ikhyq! zX~V@&tPF5Qt@V?oTL96Bi%aRiwbe1)9DWQI#?)=HxS7QSw`J`5fAJ*eJbB;uNuKA& zdERDo*{Y<(If(#(B$Lr#;nB(8Y#ia=ZCeW?JfPLuQY`=@cW$k}Rivq|vbxGrRq1Tl9;+(gNt?}UtVKM2`T5t1jLzuL@0UIs`S#vlhl4)^ zLgSYrPj@$+`|j?eSbXTmiHGkWxV8V}BzNR?pl9k_s4pDu9vd5a_UzZEPk)}Ad{AV_ zzddrjrh4=Imr`E06;LY{)YYt?o}L~H@7C}F^WB!Ra=v`Q0bj{>5&$66CWF>mf6vjP z2N>RRY6ZYa=K`76>+|_)Xdwko+7wv}7cN|btOhWb(*{sta~6b?S8Omrxw}!4`NhGr zZVpNqpu1@BE`QGWNTpEpcJVW5izu~2B^GlM?1(OPg)zwW;QcP@Ltcclm>XbJL9C|j z=9!2?ua=uIlf0%AndzHsRC}IyTL$EhAee(fdKB`?27KeS^2M8M_7b~PiCFO&r5LC7 z7gl1*a<8;SjNaw#h=843_AV9iZbWQOAp5YOC^&_F*9K0> zB|6%IDb?aM#3viTxkLU4aXg&@+CkNTOnQ1iMP*^?b|^lJy$4C)Zk4isV!|RZ*XhXh zw8q3$=*0LeGC!XI_Wc?dkT~3+*Gu%%yIqP+Wr3H$=&ROMQU6q}Ag^P~>c5vAEO;a- z_dK-3PPeKar%)6$j~vI2#*-YH!1h6HYVtwCX5_wM`iF#UKz&&@9Oo5w3%XGYrX zW>dY~)SG-((Yim%`InwgTvyRC?e=Wh^8KCao!R6Eg&TpVWUY1sN~4G}V?nFnEGo-; zHZ_$eW9-GnC%^WS9b z@p;-$oH#MtC0v>Q$HX%4^JdFdO$0cbv-W)Q TtK}Eh@>>I#ipmV1>S*>q-hkC} diff --git a/doc/html/excuse_8py-source.html b/doc/html/excuse_8py-source.html deleted file mode 100644 index 9858d7e..0000000 --- a/doc/html/excuse_8py-source.html +++ /dev/null @@ -1,163 +0,0 @@ - - -briteny: excuse.py Source File - - - - -
-
-

excuse.py

00001 # -*- coding: utf-8 -*-
-00002 
-00003 # Copyright (C) 2001-2004 Anthony Towns <ajt@debian.org>
-00004 #                         Andreas Barth <aba@debian.org>
-00005 #                         Fabio Tranchitella <kobold@debian.org>
-00006 
-00007 # This program is free software; you can redistribute it and/or modify
-00008 # it under the terms of the GNU General Public License as published by
-00009 # the Free Software Foundation; either version 2 of the License, or
-00010 # (at your option) any later version.
-00011 
-00012 # This program is distributed in the hope that it will be useful,
-00013 # but WITHOUT ANY WARRANTY; without even the implied warranty of
-00014 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-00015 # GNU General Public License for more details.
-00016 
-00017 import re
-00018 import string
-00019 
-00020 
-00021 class Excuse:
-00022     """Excuse class
-00023     
-00024     This class represents an update excuse, which is a detailed explanation
-00025     of why a package can or cannot be updated in the testing distribution from
-00026     a newer package in another distribution (like for example unstable).
-00027 
-00028     The main purpose of the excuses is to be written in an HTML file which
-00029     will be published over HTTP. The maintainers will be able to parse it
-00030     manually or automatically to find the explanation of why their packages
-00031     have been updated or not.
-00032     """
-00033 
-00034     ## @var reemail
-00035     # Regular expression for removing the email address
-00036     reemail = re.compile(r"<.*?>")
-00037 
-00038     def __init__(self, name):
-00039         """Class constructor
-00040         
-00041         This method initializes the excuse with the specified name and
-00042         the default values.
-00043         """
-00044         self.name = name
-00045         self.ver = ("-", "-")
-00046         self.maint = None
-00047         self.pri = None
-00048         self.date = None
-00049         self.urgency = None
-00050         self.daysold = None
-00051         self.mindays = None
-00052         self.section = None
-00053         self.dontinvalidate = 0
-00054 
-00055         self.invalid_deps = []
-00056         self.deps = []
-00057         self.sane_deps = []
-00058         self.break_deps = []
-00059         self.unsat_deps = {}
-00060         self.bugs = []
-00061         self.htmlline = []
-00062 
-00063     def set_vers(self, tver, uver):
-00064         """Set the testing and unstable versions"""
-00065         if tver: self.ver = (tver, self.ver[1])
-00066         if uver: self.ver = (self.ver[0], uver)
-00067 
-00068     def set_maint(self, maint):
-00069         """Set the package maintainer's name"""
-00070         self.maint = self.reemail.sub("", maint)
-00071 
-00072     def set_section(self, section):
-00073         """Set the section of the package"""
-00074         self.section = section
-00075 
-00076     def set_priority(self, pri):
-00077         """Set the priority of the package"""
-00078         self.pri = pri
-00079 
-00080     def set_date(self, date):
-00081         """Set the date of upload of the package"""
-00082         self.date = date
-00083 
-00084     def set_urgency(self, date):
-00085         """Set the urgency of upload of the package"""
-00086         self.urgency = date
-00087 
-00088     def add_dep(self, name):
-00089         """Add a dependency"""
-00090         if name not in self.deps: self.deps.append(name)
-00091 
-00092     def add_sane_dep(self, name):
-00093         """Add a sane dependency"""
-00094         if name not in self.sane_deps: self.sane_deps.append(name)
-00095 
-00096     def add_break_dep(self, name, arch):
-00097         """Add a break dependency"""
-00098         if (name, arch) not in self.break_deps:
-00099             self.break_deps.append( (name, arch) )
-00100 
-00101     def add_unsat_dep(self, arch):
-00102         """Add a flag for unsatisfied dependencies"""
-00103         self.unsat_deps[arch] = True
-00104 
-00105     def invalidate_dep(self, name):
-00106         """Invalidate dependency"""
-00107         if name not in self.invalid_deps: self.invalid_deps.append(name)
-00108 
-00109     def setdaysold(self, daysold, mindays):
-00110         """Set the number of days from the upload and the minimum number of days for the update"""
-00111         self.daysold = daysold
-00112         self.mindays = mindays
-00113 
-00114     def addhtml(self, note):
-00115         """Add a note in HTML"""
-00116         self.htmlline.append(note)
-00117 
-00118     def html(self):
-00119         """Render the excuse in HTML"""
-00120         res = "<a id=\"%s\" name=\"%s\">%s</a> (%s to %s)\n<ul>\n" % \
-00121             (self.name, self.name, self.name, self.ver[0], self.ver[1])
-00122         if self.maint:
-00123             res = res + "<li>Maintainer: %s\n" % (self.maint)
-00124         if self.section and string.find(self.section, "/") > -1:
-00125             res = res + "<li>Section: %s\n" % (self.section)
-00126         if self.daysold != None:
-00127             if self.daysold < self.mindays:
-00128                 res = res + ("<li>Too young, only %d of %d days old\n" %
-00129                 (self.daysold, self.mindays))
-00130             else:
-00131                 res = res + ("<li>%d days old (needed %d days)\n" %
-00132                 (self.daysold, self.mindays))
-00133         for x in self.htmlline:
-00134             res = res + "<li>" + x + "\n"
-00135         for x in self.deps:
-00136             if x in self.invalid_deps:
-00137                 res = res + "<li>Depends: %s <a href=\"#%s\">%s</a> (not considered)\n" % (self.name, x, x)
-00138             else:
-00139                 res = res + "<li>Depends: %s <a href=\"#%s\">%s</a>\n" % (self.name, x, x)
-00140         for (n,a) in self.break_deps:
-00141             if n not in self.deps:
-00142                 res += "<li>Ignoring %s depends: <a href=\"#%s\">%s</a>\n" % (a, n, n)
-00143         res = res + "</ul>\n"
-00144         return res
-
Generated on Fri Aug 18 23:23:25 2006 for briteny by  - -doxygen 1.4.7
- - diff --git a/doc/html/files.html b/doc/html/files.html deleted file mode 100644 index f21e492..0000000 --- a/doc/html/files.html +++ /dev/null @@ -1,23 +0,0 @@ - - -briteny: File Index - - - - -
-
-

briteny File List

Here is a list of all documented files with brief descriptions: - - -
britney.py [code]
excuse.py [code]
-
Generated on Fri Aug 18 23:23:25 2006 for briteny by  - -doxygen 1.4.7
- - diff --git a/doc/html/functions.html b/doc/html/functions.html deleted file mode 100644 index 630da2d..0000000 --- a/doc/html/functions.html +++ /dev/null @@ -1,145 +0,0 @@ - - -briteny: Class Members - - - - -
-
-
-
-
- -
-
- -
- -

-Here is a list of all documented class members with links to the class documentation for each member: -

-

- _ -

-

- a -

-

- c -

-

- d -

-

- e -

-

- g -

-

- h -

-

- i -

-

- m -

-

- n -

-

- o -

-

- r -

-

- s -

-

- u -

-

- w -

-
Generated on Fri Aug 18 23:23:25 2006 for briteny by  - -doxygen 1.4.7
- - diff --git a/doc/html/functions_func.html b/doc/html/functions_func.html deleted file mode 100644 index 95facf9..0000000 --- a/doc/html/functions_func.html +++ /dev/null @@ -1,142 +0,0 @@ - - -briteny: Class Members - Functions - - - - -
-
-
-
-
- -
-
- -
- -

-  -

-

- _ -

-

- a -

-

- c -

-

- d -

-

- e -

-

- g -

-

- h -

-

- i -

-

- m -

-

- n -

-

- o -

-

- r -

-

- s -

-

- u -

-

- w -

-
Generated on Fri Aug 18 23:23:25 2006 for briteny by  - -doxygen 1.4.7
- - diff --git a/doc/html/functions_vars.html b/doc/html/functions_vars.html deleted file mode 100644 index 2a11ba9..0000000 --- a/doc/html/functions_vars.html +++ /dev/null @@ -1,38 +0,0 @@ - - -briteny: Class Members - Variables - - - - -
-
-
-
-
- -
-  -

-

-
Generated on Fri Aug 18 23:23:25 2006 for briteny by  - -doxygen 1.4.7
- - diff --git a/doc/html/hierarchy.html b/doc/html/hierarchy.html deleted file mode 100644 index e55f482..0000000 --- a/doc/html/hierarchy.html +++ /dev/null @@ -1,29 +0,0 @@ - - -briteny: Hierarchical Index - - - - -
-
-
-
-

briteny Class Hierarchy

This inheritance list is sorted roughly, but not completely, alphabetically: -
Generated on Sun Jun 25 12:04:03 2006 for briteny by  - -doxygen 1.4.6
- - diff --git a/doc/html/index.html b/doc/html/index.html deleted file mode 100644 index b2e3692..0000000 --- a/doc/html/index.html +++ /dev/null @@ -1,21 +0,0 @@ - - -briteny: Main Page - - - - -
-
-

briteny Documentation

-

-

2.0.alpha1

Generated on Fri Aug 18 23:23:25 2006 for briteny by  - -doxygen 1.4.7
- - diff --git a/doc/html/namespacebritney.html b/doc/html/namespacebritney.html deleted file mode 100644 index 82c9a06..0000000 --- a/doc/html/namespacebritney.html +++ /dev/null @@ -1,27 +0,0 @@ - - -briteny: Package britney - - - - -
-
-

Package britney

-

- - - - - -

Classes

class  Britney
-

Generated on Fri Aug 18 23:23:25 2006 for briteny by  - -doxygen 1.4.7
- - diff --git a/doc/html/namespaceexcuse.html b/doc/html/namespaceexcuse.html deleted file mode 100644 index f4c09ec..0000000 --- a/doc/html/namespaceexcuse.html +++ /dev/null @@ -1,27 +0,0 @@ - - -briteny: Package excuse - - - - -
-
-

Package excuse

-

- - - - - -

Classes

class  Excuse
-

Generated on Fri Aug 18 23:23:25 2006 for briteny by  - -doxygen 1.4.7
- - diff --git a/doc/html/namespaces.html b/doc/html/namespaces.html deleted file mode 100644 index 7b294e2..0000000 --- a/doc/html/namespaces.html +++ /dev/null @@ -1,23 +0,0 @@ - - -briteny: Package List - - - - -
-
-

briteny Package List

Here are the packages with brief descriptions (if available): - - -
britney
excuse
-
Generated on Fri Aug 18 23:23:25 2006 for briteny by  - -doxygen 1.4.7
- - diff --git a/doc/html/tab_b.gif b/doc/html/tab_b.gif deleted file mode 100644 index 0d623483ffdf5f9f96900108042a7ab0643fe2a3..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 35 ncmZ?wbhEHbWMp7uXkcJy*>IeJfk6j|fqX^=1|}vKMh0sDa2W*H diff --git a/doc/html/tab_l.gif b/doc/html/tab_l.gif deleted file mode 100644 index 9b1e6337c9299a700401a2a78a2c6ffced475216..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 706 zcmZ?wbhEHbZT`}F1e&(Gg}Y(8=I;HA5#Z$3JI=gGB)FQ#odI(O&E^@q;x zK6mr*m3xOS-#u~t!I@i+u0DKm^U160k6t`|^WpV}&n+8{U%dD9&a>B#U%!9-@yol< zU%&tQ{rk_K|NsC0`}dE5ET99@1@a36+kb~?0UJ*yc&I3X_m z!ND^5$O7$#8OFRuDhG}!?8z?cdZK&!`PWjdR;Aj^wZ` zeK{IEYHBJ)6K8VIp1`BVt++swf6j+=L{p1*nO(VhE`pFexG@5$|>uaCcd z`0m=9m+yak{QmXN#Sc$^{$X9h9&q2jiKAI|&T)a;PPx2K9p`YIdw8HtR5k2Q$2-O2 z*;3y{MQ-RnJTgJfI&R5|O)AHxDf_00XbPvDZPy4t=hHd)nfLPvms&O`Ok(sD()5v$ z5U@&h;a=#xbxVbo2~X&Xj0Ie(f{v>vERH+qC+nTG=B8Nca=wU-O$?1&vUgV~9=!H; zx>3p9Yn%*<>t~sk+&0xfyS8RsPfYBd<~wWK%j-LmpU>O7yX^h#UCp1x-p#i7@bE;py8XI6 zmY<)m>~)W~yIWcMVoiPg{duuf<*)9qZ9l$m*Ph&W&$jlv*Vpa+{pH@n=IQ$L?0$ax ec60Ul|8o2P|NVbd{6P)#weSbE3}s?04AuZvx_~SI diff --git a/doc/html/tab_r.gif b/doc/html/tab_r.gif deleted file mode 100644 index ce9dd9f533cb5486d6941844f442b59d4a9e9175..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 2585 zcmbV}`9Bkk1ILFF--w5zJc=ZZT(zjE=;2|_S)Qm~rCWz1Pc)KPl;jv%A#&v2*x}yc zmf2~Jm~&=xjJY?PqwIN}f8qQ2{r$uH{c*nJbmr{cR5??*egHrs-B=MzCF`3%e{FAW z{oL5xTHn~5TM{jaB;@|_Ue5F&Zb@p(kMyG{*;gWDg zyeL|eZf7Qd8=#bXzSiR{yzRgLSj-fJS8>lBjVHN z^o-0eS=nE6a`W;LChBs=`+QAJP~{b93>H^eRb5kCSC1zUNezun%`L5M?RDzv#%jk7 zYVRX=vATPD`+oEfum^{RM@GjuP?-r=yh0!p;Vx^T9G7~`7%5ydH%70=jyJ;;`d;hv92x3R=z{xp+Lg2!*@OK*K15-t&okoPtSED)h&$RLxdbA zseWm^C3d%-yRNi-ryk^!ek+C`n&~cd$#ZWct_cUL{l~i+Nzx^5d!n94(>bW-iL~Rl z&8r)?q|1DIo=0=judQ{FaGcfLERz8gfn3-Qt<2lksh{mzpT}DXxUuR^z=^key&q4! z+wWI45vL0k$R^(F#{qfqhUsN@WA+w-V?LPH33!Q?WFSB3)WBojE@hK41Nb?KfS+Qo zXgrzfsP$wr4Qzy*{OD>uJBjdgGM@VMml5)2f~_}lD*YyOb}Hjeobhz#4c`w(l^>KK zr?Ud;W~Z}*w;%hZ|2^p^+f06gJDJQD zeIhGADbDmm&6arh(q>EZ<7mjzg7l|z$hRL8=1>)Nv=S7CY$B}iYJ&*T_-T_OG*L1q ztZ3Lana33?y3AKnyq^YCF|4x%Rb5WU&2qcl{TFKey%QJeMxn^SdT!hZ5+0i1zeusiYVp-phBl7b5+Px-X&LhByq z0F&<;K0l2+v>qiHlXb#$jXMv$uK-dEGE9L~qtdU(XeRXmvu*K2Q&6!fD**JxYP4b4BR7FdJ$Qx9G9`J%-_X!a#LGpp3g9)VWytGCa;7`S1_e8F~!R+aSJ zOF17p2`H?2kPs8Q`_;U}+D%3p zs2-0BTqFwpUoBk`?P;iPQ(IbEA|JmMx!P&YYG|R@S=5Mnw;-?A6rEEVyV%d7{iU4a zNk`i!%F(Ykpm`}#oH;BjY->@b8vQedv;pza2FL&*6ufjd+*3Ute&>kes~TU?^KkojsTh(o~(3tk1Y6>4(yn( z#U*ID9@eg-beKo1B;HXe+}{Z%n@7m0+yxivuqk9~;!1LGQlah)xYK4>wgL}l6dsaN zIxlRlq`*`j9PG4*0hD6YV_b_2w5b#)o7J?`q#{GjvvKlD`T*dWcZx<-s(ZvLB44E# z=!|sw!?)@%y$oRNL#25WS3lzdii}TuQ3?CLnvQ1_n};2sT_;Y;#d3=+-(O% zMN$>O!3;ke(UuLR%h_&)N zs^!-@A>QR}4yB1bPp`9S19ikTbZ~O{&FF-yHK{En;mmShDUIEw03`j(DBIsM}Rjki2J#SQa3gFZTKBPDeIiLt9Z z%bL3(B@Qw%(B`wSMS~dPh$=R`(}lBoFXKy(s|*{#ru$wjsBc_O#zxNk9w+UUHmx(U zmJ8+M+ndtnZ<7|VU9Mbt61zpo9T&3%Wx&XII=#QJxjR`CZf22ac3d51Z?GD%LEe_&*t46Qf;4`bZ7p2K(Ab5>GfT^}4! zBT&HZD`^PEgWoI&{~o-ID0F?O`75sm(87x%A{(}Ch1)QlzdJ)1B-eqe5a(weg0`4lQIf1evjvbBY50DVbzO7CLf|vP z2#0(U-|jZ`H{y5N^o7%iK6H>_HEGN->U6^!)1{XpJV!!4(Ig7wzZQ*9WYF4X1rG0x z=1uA@i`rIAciubDC{;~b(|&|A@xkjRP5aRcvRU9tvIm}jDB6J eQ0-6-y)mpwdT=ayS0tBxKDA*~;EWmo diff --git a/doc/html/tabs.css b/doc/html/tabs.css deleted file mode 100644 index a61552a..0000000 --- a/doc/html/tabs.css +++ /dev/null @@ -1,102 +0,0 @@ -/* tabs styles, based on http://www.alistapart.com/articles/slidingdoors */ - -DIV.tabs -{ - float : left; - width : 100%; - background : url("tab_b.gif") repeat-x bottom; - margin-bottom : 4px; -} - -DIV.tabs UL -{ - margin : 0px; - padding-left : 10px; - list-style : none; -} - -DIV.tabs LI, DIV.tabs FORM -{ - display : inline; - margin : 0px; - padding : 0px; -} - -DIV.tabs FORM -{ - float : right; -} - -DIV.tabs A -{ - float : left; - background : url("tab_r.gif") no-repeat right top; - border-bottom : 1px solid #84B0C7; - font-size : x-small; - font-weight : bold; - text-decoration : none; -} - -DIV.tabs A:hover -{ - background-position: 100% -150px; -} - -DIV.tabs A:link, DIV.tabs A:visited, -DIV.tabs A:active, DIV.tabs A:hover -{ - color: #1A419D; -} - -DIV.tabs SPAN -{ - float : left; - display : block; - background : url("tab_l.gif") no-repeat left top; - padding : 5px 9px; - white-space : nowrap; -} - -DIV.tabs INPUT -{ - float : right; - display : inline; - font-size : 1em; -} - -DIV.tabs TD -{ - font-size : x-small; - font-weight : bold; - text-decoration : none; -} - - - -/* Commented Backslash Hack hides rule from IE5-Mac \*/ -DIV.tabs SPAN {float : none;} -/* End IE5-Mac hack */ - -DIV.tabs A:hover SPAN -{ - background-position: 0% -150px; -} - -DIV.tabs LI#current A -{ - background-position: 100% -150px; - border-width : 0px; -} - -DIV.tabs LI#current SPAN -{ - background-position: 0% -150px; - padding-bottom : 6px; -} - -DIV.nav -{ - background : none; - border : none; - border-bottom : 1px solid #84B0C7; -} diff --git a/doc/latex/FreeSans.ttf b/doc/latex/FreeSans.ttf deleted file mode 100644 index b550b90ba5480f9a3db170a19a1f86daecb0dc92..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 22932 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 RlllN>Fk>(~eFPlj{{dxA`xyWL diff --git a/doc/latex/Helvetica.ttf b/doc/latex/Helvetica.ttf deleted file mode 100644 index 8051f8a119f13c1cce42c147c8252d69c40d8dff..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 32760 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 _~!~TPBcwBP@B)(YIaPm95^@Y>JFX0bY}ls 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

l4D1v*qT z^1)6D0{|AAWZWc~21!|D$`7Rc@Y1=&zZ<^2XYZc^``jzWtlRUSF6%k3zKihDcMVqy7Jw5U>tiU6Pdm7)Y< zrjd=hM2jh%^7@Jo7u0=lckR~P=8oWt3l=`RYw6;hYo6S2_37=HSwE~dF+%Cq^6opY zzH#o|*I~>CgEsm>vg|NsU#OD<$Y&=bm^c>~N61r{ncQ4)iYzElm{LfFbMO;DDn*N!O|A*@eFuvMybW zR(4zf&>Y-feN@9kI=Wc)fL5@t2VP53*pl$SO&8KY5**T)Ao zGyOU06|LZ&n!uwwQM2l|iP+@Mb?3REY0mwa{&B-@gWxe_8uq)}+^n14U8W~cm?9V$ zy~!tGJBiw?EW;ydJM=hqT2D{mjDtqbyHI{cCUEaBV8c(9MZq z%y%F|lmmT9t(9fYmLrF4L*#xoUQBVPKT_F(hMi&W;>iai}<}BB#IHKh!Vlw$N=^Gjx+eld@`ansUx%d=vUU?S~Ar)4|(Y z$$^$kpH-(>FeM03AGKdis0|)%K&5NB+MDzFOj5s8pI&m<3&I6b*yTFw#EMgO);gP@ z`(VBahf!)E{T0(0)0d`B6B{s9n5w`kx}!PsLsTIlOO4mlh=iJX3IbjM0I;2UUE0WT zA=#1(bg6o1Vb_d%Nii)QP|_3_ekVkINhZK=x#&~($vyhaU%t*|#0&R-c4^Lg_nlbs z+?3CD{O-F)o?E_b*WM+Ica8Q83-_2jrey!Uxcu{N7;o6tbgk~EGmBqfvfpca<=xlb zcnxNMEl~X_yU2zP9EFBNXzsB)3&U&?(~mi3V6`r+bcn;8f?032F&xnFeVon))Tpqi z78DnDint9}Rzo#l(pgwsxZiQfLFPGjIQBa_9jt@c!pUl+9X@;s&If4GS?~=k8fqT^ zLqj8yuDWCt28nhdQcDGfil%3pxEXn)E^OrWUThFR(BSC<(8y08#GuvLsb|D?sI*cp zEA(`m*S6f*w(zCFEemE=-&YQ9@ShLFpLx7v0@=BC>F|xqJC1{ltpgQ&9v8edUM(#78f!@I7frG@?5nKM`I zY~<=WQ2x%Rpa;54yG9FoM6HAjhwI4}aBDcuDR7*Q1uipZMc5z{09K&KRMye!l6jra zY}yQZ54Z|+e1#=xvy20Bg8ZtmlH!(v-VYCC zzkTn$pO-#j9QXh`?&^-$D<@Oy2IJ5C1otN6cU6y$AIXmq8I$2(+!dY~!7P%9g%4Ua zAmLK8C4&MBms((J0agYa2x$k@Rd9r70Ziaa!~rlmd^c&dw1`z?Cr8XwVx zg&1EdRv4-bHEaz(T2~`3XYb%15#Qkd$bQ6M;J?-VoBvs`TO?quFf5@I7GSVQ93Y+H zByk1EEa4=XMS_`U1t`2~PmmI189}QYHXY$q!$koxPaNwBmOssi^6bt_1uX`38uUCC!4zzhiGjJ5`uq3N_F=A^_# z0b1oKIptsq<*0mcFsN+~gp#xrXrO~aWIYtvHSmfDOe&<6@(()b=8J=h#%zI&_DZj9 z4#>%W1}F)#b9ySv=PVX%4mg|5R<5n!Tvrad=s*AcfH(PZU`tUvq+X-F0REH)w3l@) zc+a0CV?dh+6jI)h(U=a-5ZV~4xAD^lSLzY6&5A8dHKn0 z@+nMhY8b4N38)dq$dHzlpjz)dL=AJHl-chC-fr z!|Jd%bP~Lrrj=9^>l-K@p&69BAw$=&d9aLp1Uyk1dgCZ`?|!28mJMJTFR&NHKRYi5 zxevK3LE;pGX`;&;1Xwf8@8j)08B`GSX+Tnu&W7>k@QyGEgDx7wo3-ZN_#sz#Gd#AS z6~|R5)E1ye2!JCj4P@fErxssMK zKx}@)Ry0C2AY#*-z1U)~UpJRDYN2;$r!E44#@M9jR=i%pWHYrrTm6O>1jX}jiPfRaz0OxJ*|eQLqy zwL7a7sU>^nEsf8!k%#y7n^)Omc}F8zGiP@12j1Urk$*mv2 z-y)3UYlLb13_&PV$}DA$B3D0Uuw}5LpKBa9PP|o#TjGveU9-8_;$&sEWwv9oYY{Zn z@SI^Ra~pS?G*&;0nZiwxX6YrTkJXt$>JaO3Ll|@Mo_+|5CUHqs%Sd|y+Cz=9WA#4eW2L^Rey0fH(b1(yIo{K$E{j_By^8z zk?(I~k-pE|^ZU=RW9i@S{W8&h^x)bx2b))~JxHuLW8=capF2+f?Jn%chIdcB``+(Q zy#uFS3ph~-#>E0r-Wl~-z0ytTr3_Zsis1er2?VqBX(>JIJyLE?nHSs~6v~`s-a*bm z-Wp-7ew=fh7fKiU8Om(uOmAE8ecR`*&pq$^FW4^l&j&k$jx;u^MD0avnF7^OWsGuB z{#!~yks7=Jpk!C*2o9{m9Imj zLM2LTrPpX5sNUM8WV9@;^}1!4ncuV!u6?HLf$8hc)-CvQ>6lI3&Ce}d{KE6|8xJIA za4)YPHf%%Zwx<(U?;TRsag}-I^y{ZSJoV1UFkZJLW-#YrycFbvzQAoViIQwrPcoR? zq30{?74E_A&Hf#JuFzWOt?>7?_Vq$C@110wTM&1VL6f!!E1&C&yCajoLQ?04V#G2-t z|3}uD;{T60HyPw!rV-D7jSsY0!c!NtBwfo5AhP|Blrty$;SnzPFpEnM(4fWJb|q0phJ+mX2YxsAW{VfLOr{o0!!eDo%bCRRhZ^ahNM8Qrb+%(Y^L z#c6CI+lL*_PG#q_yl56gK{Qy+q5;A4Ut~=TkR)bqhCYVWpcPw5s`>vIrCJ7b;Su01 z0ByM3K>6!*(rNpd7AiqE9(^7eg&`U!`!8u^lX(vixXr7dx@ktm*zq^rd~?t7Ha{EL zS$|8}^BDswY8yH}px0jkNW%fR{yhAtx|B_|rIv|<#J=exQ>UaZ6E}*h(x0=wkaLnT zh)$2onKwA+BPZu2BM4D?V97O37$=UC#>wOK;|z5|omeN;$#wcVLrbJ3!$esV=~>0; zW272+a%6Jm{IvN%s(Da)T>n7k!#P{>o{@IzpU!wDvpMqnh$97}0@dP=jS(`!dWrP} zBX(Bqp5mbywlCnWa96n}xc9lwxOtO1;GXOL(#;0ko7}{G9Kc^Y%)uU2Q798s!Dk^# z(hyoOKFu~qq1II5H^M^^arbd4vreVW5x zj&{LC^?(-vIjg=w1KJwsQyk#03*v<6R?X<C-hsFWBU#o~@M^~<-SqdOiKnc6iik|^b zjDx(6HirBclLhER^s#YNJt7qcP4_Hawzw$#;2V!r^)Ai6fB5p3$C&r)8)q!5b2xIn zt6q6{$qD>(tIgaDZQZgvTBb$^|ppY3X zVLk5D3H`)=wYqu0&E5=6ir`~*07<(|cUH&ij*&VbF%%zwAeVYy?Eyhhbh|*U002+) zDUC4Z1;CV};Z`&nb|$eWiWHbjKxfj-T5~l~JVVNFpOv#}Rr8@k)@Y`G=XT|$DNm6} z8?bIx;=TsBmr(IIBEVja^6{ibUhaOuU zGN2)5xE)mB2)mqGh~dO-PV5{Ced$myp&^Fnl84Om?C|XObb441mN0o(#b_`YC{u%W6+w)_>b=Myn3Ks9Gz=vR z%v~TH^#0KV3fN57$^T5nvJb~UU8Tq^vU$$1VHzk#iThIV$Bpyj>gwf(uJeAB4W{8Us z&<@BQ!eViev=*u|YnXd<>xA{<6KI=wzw{z{N_rU`(H)T9M!%QNp%10MqrXa5(Pb$I zngS#ja!8qoHc!LzekGApEsjD?g+NgPic46OY@#Rucm?^C#$Dl{lYsUW&@!NajN{?AE{UZbG!p60v=cUg*eS`;SXZMWb$R! zGOu45CSc7eq5oIzAY=y`u}9;D03igwl$iCq3t=ev{QYQR4jbuMHEr%~3&}c~y(cT@ zM_@)QzMYjbWUCZ*a zC>sTfg5VjgI-lT`Qy_Q?>#~KYu@DvM%7mWAzRUn#)l~|Eg16@Myz!+vA>+H#ryMf6!1jclajpb9Sl-AGb^%h}pF7&t~2;1&&3r%EPc@HMjz z8a>PwOBA3X04I!+ULQ6XZO{xLm`$drBtVH@pbVt0S%eOAorM)lX1&oMnI(8u4e&u| zUmKlP3$Q?qNU~i~445_-H5nK~D}Ek$A5{{bE3Kfle=8%`4!+1oV}xaJW{> z2cc^KKYs{cv0edN1a84y36Bk8A*QEa_Q7FG4CTNAxWNG{P2y{k8L-yBK*>)U>B;KUm`_Xwg9j&$ zAKP8Q7VJK{y{OmWeTkOiyR$w9p?~ax`5iK+W810IWa`y(WZ9u>XF&Q*V2}O*(y!n} zM@$xMf^t7aDpcql7-QPXZWW*f)zrqd@ol+q?-<`z&M_Z~?-@Q*E=m>)RI!tkBwo}=NhY8i11HI3GAK6) zNs7e7b3-KM4fKXcl&7#!8Z^EZ8#8aHl?1GEL;gJ5^wsc#o)j zHQxjzl~&S6H3peGNop0`=s@$bWOR5rXPdDs*i`5rhQMPy#Do-ERub7PHePOf!NzT4yzx*{ir4B*9pjzexJIkj z%9mPSz(J%j)_gdL<&!@LgGZ;=nxw^fy&5D^=fo==@ewJ1);v;<{Yiu|nxk#O;DI%q z^XoCKM6HT5N12wt|1nD_mHRLoViD4Yb4Qrmh>8~Lc2a=o!n&QPV+;#Iz^q+QM32lw zk9-ctj?O@m?2PE(7y4r=4%JlE#NyZYhV6@C*SUQZ*+W3Q^Djd3#X2+eB4r0kh3}|S1mgK zz@}|mHuKeAy!uRYaK5PLBJ|UfsOLm>mp1{5tbS_dR#p)e?|K7g0yCzv2FwjG=Dh5^ z3YKDC6jN@2XhG}@*2-JWGh*ggx>+ahG=KsH&E8qllUR`zk~3T&Q)XP^R2PnYOieFLr{a>5c)LqW!FZR92d!N@m}5_l z*TAjNe^6Cf$I`IX2h9~YxGa`GFqxGkyzy}8#jcsv1JUl7E842v3#;vYzBucm#cP+V z=BB0g>Sd+g&MdC=%;GEfoIy5wTIV%aT4MLN-#Y%efAz+)Nzb1;?($Xcw`8n*i1iJ2 z2nirMh8+^23tyoM=<;M+y-=`bc$o7GIy_0k%i_bT(5NHc4#jo{#DVaQ0HIeD%QVTy z_Crs}t)Fg1Smh|m4YDM+3B8~nji3yRA?htmH+tm=N)p}RBX12X8ATa5=D-p(eAFP( zm5}1lw8Vsi*6doFt1z|J>M|DA79C`2t??jrurL~Pf9ZozYbw(4Wr>P5h(;(^+@d8a zc2{MIrX@nC4XRj-9(=MuNP6I9QK~e?5eP}bi=s7;@eN-o&=^Z7FtEg6y0k#~ibr|J zj`87X3wp1##O-gt?ems(+g(+MP91l*Oxtfs?|W!`?~V?Xz#?9zE>t#Q{dR#D1FV{! z6PKE&M#*PotdFWm5lUyEyH)5& z!RxqqNkVbsT=O)s=q%rFDy!1Oz%>bAT(s(``rB{v`<+cYE4{bPtH1WcIo|cW?DZR* zQ**7e>rU2J+E!JG+QtGynD(YWUb!@>{$qT70tBK*-YYB-rvAI0BC%s;`ZYA~<1+=| z7e1svQ^WXdYBAd*k3^1`emy~#juI_1PLOyFqKJadPtg)}fYJanOu2NuVIc*ebGC~= zL0beUx#U%!q7C4G0{2ZYj|#uwUjTR;P!CuL$OZ`7EI z?X=FYFmfL8?J>MU*8m=Z{Soy&I$*4!YjOV={Jns4!&QO@VeK(KL3=^}4&0Z6_7Kbf z?jMG|8~!Fw*keq0Qx<4303+zd2xliigxC3!?z-$GygC_-M zGvH443f;wCi97;#m~3ffp9B}k@KsNPNhXt8+jjonKWcLU%wQG5V^6O{3I1xvV! zDDfIZXN0cj4x;48h^)UPO4W$cx`@(2&w#(oV?{n_(K(g;4$_H=$E@-uRm#6^#T?GK0sBkUdM?}Rp5tZDF{ZW{ua4SQa%eO*Zz6EeQ zQ3b-Bf;>z^8miHVYY;~5eSnXM>JWb&!m6(ZpbYBI5H&o3Vtk9JNhN9qy#?vloRHCrd2CEJp~Vz#@cl5+RgRt;8aPa_WZb6!5$W zoHYI^aI(Y&aGfU8GY!7pguPZ`k+v$yUnS$JA`4=vk}+0MF5<1CJc&gJRa7DQeUj2D zaht?55pNaEllBGDzEIi&(%vP*>;|quEIwcn3l4)ydoFlt5R1SfmKy8@3EU=mW+KKK zge>?)$mp>Wi=5UXwB5iK@YEtSVb7KJJc$b=k5A$@Ntub-szqpme}TjSiMt~oL5Hy@ zw|ZG_^$61kyC}VSgt;3yFLE=mNMXH9VLehPctqao5vH)um#&@C9+19*z%%frlQ(IB zOzi@h&LHf46okDGI?qHdx+J|@(z_*HjLOR>09^;-$FZZ4PH2sM2;Yi|{){wxVnD{z z9Hi(t&LOFRvtg1&g)JU!5K{1<#9|jIYUel~Zkw>HpqDgl=jF zP(QSAuAzCd6C{`C_D3!pIV`1tqrwt6}8h$nuXGv10l@0$lrYG zMExwp$QnScbkWu5@QY~)^tp$q$1rK_rZsCUYuBy4wr9iY{v zk>R(I|3;~H)3@jWdYj!Ba|orkh{E99k9yyyELK@$W#n_Dz(Lm|4Jyj;b@n2}@@Jxj zyw5V(7NrHDJQ~p>{|PP|%CL|2(NXC9o6a4E?#Qgj>!{^2x&fg+K*Mwx*BCudzi07= zbCJiO`a26XI|KO{r8n4%%J}(h!kLVTp1#_~O_&P(pp#rMRZ;G5m z`?&%&xQKoTpZ~)?;ahRtqWnZ{jWna3ZKrRF(xxBNJ1m=(L$Y`wFNQ+!hm;Lyk)`l^ z1+749-vNyvuh3hVIv(cn{DktT`lR}WF?alQBoQ^@rUz+1y~GlbQ;iL#K*s0$Bxe#-o!ikYJOJf zQ`RfbtIfDD*HLeS$kI;ZnehO$K>pYGCy|QC9cZ0fXd6=hE$BNKMLRh`zr*!5y~_+N z4&suDNQr|jU^nC1%I;>5umkLIHi}q&!QN#bu)nd7*%urg6^9#erkv;Fa`FxQdVW9u z4%A1U;J@I1;h!lPO1|PzAcn34m32tfoyxtq4k_=b+3E>3f^x1f?14zh0mGAqmksBP z@upj$p62KOeDr+D`M1Vt{I2mmB?fISJ|lCsO(X6<>$&Dly{YXDF4J2QDdQJAzyW?9(B69 zRNbULq`t4dZ|FAs%vuJ@A zf9$lf4FZ3M=pH^r&EjwHH_)D!(h6l3M@!`g*j@Y^Y?K!mZZOvIIyRfmscw|@PjE!< zAG}VP1#QRkX%)XB8lW*%#jFK0;N$q7#WCdV4TOAyF`jMZXN~bR%;Y?q{aBf-dX%5h z@0GV9S@$r#sp3#2`;h-o=|C%ZUTrW0$f10P4l3)RY4{NLW48B&c^BI8Y=$`}b+QWf zse;#hJ{zs5N_h`bMXUL5=|lA6yXf0&g}RdN!IzJ=(EIcQ^onA`T4RYZjs2A4lnR6s zMv1GBBX>1W&!QMo>2|hQ*=Ibm%Ff zMngdTC0mKt&V}SsPh)i3qEx63n73e5>Bg9L7`^)_#(^ef7ATo$IWy5N7GQ+fhifm! z2^B4y9%874$YpIYs<;b65lw%31EEWBoSXZ!S0ASnvP>)RO)xOhBVzB(xI)at*uPl zJ9|Lrxr7kXHIP~_=g~FcuLn+-aeBdd%~v?RQBLngPG-^SslKdK^E);Db)QokV_kCt zu;1--1~vUdX`dzS_ey&L><$M!X#UJTpQf{r=GR*{_YL|(zOqs_6c^j#Z0U_HE2W{> zI9TIg(=(jc4Y7;{CM`U}Ups^&f(gi?p6&Gc^(-g6A{fQx?^&UD%nkT`ISxm#tW;+$ z%bm+~ayIKp9?3#2G8*03qMKwiTEC9m&`xcr^u@tlV-{K#^2D!juIT9w=t>X5@axGQ z#Ou>DZu(>9m$wMq+7h_)Qr8@1(4X0_3Fg7UJ2m}#a|4(7&2fkjf zyHHc@^EJfAw+90{+m0wTkrR=tX#RSgenAPX()1W-v$Jn-RR~p+J*d;X8y&;h+1?|O z)0FMk20H^zhu)au4EFeJL#Z@4@5YfVuaC-PJ+P;WI2F0V!f;1^`@rLRDZ^y@J#p+QTnpd*V+ zH@GZLZSZ443vhn;m&++V6BMJ%@-YcV(M~QlHJ$ZbujPqL(^`1@*gmj3@Z_eR|(PQ7UU!O%pjZSM?RdKWzv zBMKDd2Db^Dp3)LfayV$h#&ZJ8_rnd=*}FybypB2*2ikg#`sGk1y*~c zDVe{3>bC=z0~!Hy080V80Y?4;&mUf4w>HJ$;~TG;vAn>C=>uv0fF3cEca`1iZkbWx z)dX_aUI`n}cQq(j^1AmtfLnpw_uL1YK3BayK5+VsK%p0aPXHqF&I=|j zKgyhyC(QhjlE&!$q}qygO>O)*JRV0i9H+MdDk|tWg#af23MBzI0+s?^1e^s#07h`< zBOkjZP693mGy;|aZULMH7-e$KA}O5K0gEI)BNJ8*+z6N>?)Y(BV#4a+4sR|#6y&kA zDZ8=BmdEDgMe=wRrKe-^WKA~XQ$PuaKS}uXlLU%sisAS0-FSVpW11K>cMpG-i?4+2 z9dCXJ zAMGDt_YBrEw&(1pv@w+p+kXwplZWjmZ9D8gEgv(3a?A}KE5r7qnq)m3p)@nac0J$VA4~RcHTa}8A?Q6Tu$xF zH2oj*ontI^ZkKLwHZ$GYPVJq|dbOv0%oLfYS9#iXQ^(bTA;#_rf~xbo#u&z(F%}V| z?KxsraD*63-hOwEFpIX|9Sl-t`sT*WMr%WIO{?!~P)HI(KCvS(@xwOO#b2f;SKov0 z9P3Zy2K5SIiR40%;6KE);Rs%k&iQ>u*k6Sa3>;A!*x&r~1YK$H1%vHlY@y`C4#{7^ zhZX|^eC9mT1RrVUyeQwkD4z@d!B-#*@WnuBzvOep#7I7s3BI9$0>5vl00=x88VyLE zfeh_Zp4VL9aRGrRJxs4jp4ZaDf=6$V!PsnI$pZol!&{eRv9WB)B2zvjS;{9^c3foH zA!AaasgXPaA(({I7kCm*gXdx~{yR%=Gj_N}>VnI={g`rvoc>-wNZ+}+FH;XM)3l-G zLE(Uzk2|z%d7m(Qdi9{Q*QYOc`m~`s>F+Df-NL!f=^LVMe`jE*+uQ3KuJhLUojtzb z$n=h>RhPxJ<6>M>JH95a4iOlXerZF~rN6JlRVAFKi@2&pTvZ~j>E7uwE|P7$BQRv9 z<{+j8(j0+)2(;Hwjw9HdZn>^OHr_f%=GL5}DzO6;hpA9JCeH}~(XPvy%9?}|`jl`= z6!Yo{r_8N&j+~?Hz=V?pG@8TiA;DihgFc19;g@sRb diff --git a/doc/latex/Makefile b/doc/latex/Makefile deleted file mode 100644 index 776fcf9..0000000 --- a/doc/latex/Makefile +++ /dev/null @@ -1,39 +0,0 @@ -all: clean refman.dvi - -ps: refman.ps - -pdf: refman.pdf - -ps_2on1: refman_2on1.ps - -pdf_2on1: refman_2on1.pdf - -refman.ps: refman.dvi - dvips -o refman.ps refman.dvi - -refman.pdf: refman.ps - ps2pdf refman.ps refman.pdf - -refman.dvi: refman.tex doxygen.sty - echo "Running latex..." - latex refman.tex - echo "Running makeindex..." - makeindex refman.idx - echo "Rerunning latex...." - latex refman.tex - latex_count=5 ; \ - while egrep -s 'Rerun (LaTeX|to get cross-references right)' refman.log && [ $$latex_count -gt 0 ] ;\ - do \ - echo "Rerunning latex...." ;\ - latex refman.tex ;\ - latex_count=`expr $$latex_count - 1` ;\ - done - -refman_2on1.ps: refman.ps - psnup -2 refman.ps >refman_2on1.ps - -refman_2on1.pdf: refman_2on1.ps - ps2pdf refman_2on1.ps refman_2on1.pdf - -clean: - rm -f *.ps *.dvi *.aux *.toc *.idx *.ind *.ilg *.log *.out refman.pdf diff --git a/doc/latex/annotated.tex b/doc/latex/annotated.tex deleted file mode 100644 index 9203e2a..0000000 --- a/doc/latex/annotated.tex +++ /dev/null @@ -1,5 +0,0 @@ -\section{briteny Class List} -Here are the classes, structs, unions and interfaces with brief descriptions:\begin{CompactList} -\item\contentsline{section}{\bf{britney.Britney} }{\pageref{classbritney_1_1Britney}}{} -\item\contentsline{section}{\bf{excuse.Excuse} }{\pageref{classexcuse_1_1Excuse}}{} -\end{CompactList} diff --git a/doc/latex/classbritney_1_1Britney.tex b/doc/latex/classbritney_1_1Britney.tex deleted file mode 100644 index 9857bff..0000000 --- a/doc/latex/classbritney_1_1Britney.tex +++ /dev/null @@ -1,906 +0,0 @@ -\section{britney.Britney Class Reference} -\label{classbritney_1_1Britney}\index{britney::Britney@{britney::Britney}} -\subsection*{Public Member Functions} -\begin{CompactItemize} -\item -def \bf{\_\-\_\-init\_\-\_\-} -\item -def \bf{read\_\-sources} -\item -def \bf{read\_\-binaries} -\item -def \bf{register\_\-reverses} -\item -def \bf{read\_\-bugs} -\item -def \bf{write\_\-bugs} -\item -def \bf{normalize\_\-bugs} -\item -def \bf{read\_\-dates} -\item -def \bf{write\_\-dates} -\item -def \bf{read\_\-urgencies} -\item -def \bf{read\_\-approvals} -\item -def \bf{read\_\-hints} -\item -def \bf{write\_\-heidi} -\item -def \bf{write\_\-controlfiles} -\item -def \bf{write\_\-nuninst} -\item -def \bf{read\_\-nuninst} -\item -def \bf{same\_\-source} -\item -def \bf{get\_\-dependency\_\-solvers} -\item -def \bf{excuse\_\-unsat\_\-deps} -\item -def \bf{should\_\-remove\_\-source} -\item -def \bf{should\_\-upgrade\_\-srcarch} -\item -def \bf{should\_\-upgrade\_\-src} -\item -def \bf{reversed\_\-exc\_\-deps} -\item -def \bf{invalidate\_\-excuses} -\item -def \bf{write\_\-excuses} -\item -def \bf{newlyuninst} -\item -def \bf{get\_\-nuninst} -\item -def \bf{eval\_\-nuninst} -\item -def \bf{eval\_\-uninst} -\item -def \bf{is\_\-nuninst\_\-asgood\_\-generous}\label{classbritney_1_1Britney_2f7401c8e41b8095bd99bd656bb41546} - -\item -def \bf{check\_\-installable} -\item -def \bf{check\_\-conflicts} -\item -def \bf{doop\_\-source} -\item -def \bf{get\_\-full\_\-tree} -\item -def \bf{iter\_\-packages} -\item -def \bf{do\_\-all} -\item -def \bf{upgrade\_\-testing} -\item -def \bf{do\_\-hint} -\item -def \bf{sort\_\-actions} -\item -def \bf{auto\_\-hinter} -\item -def \bf{old\_\-libraries} -\item -def \bf{old\_\-libraries\_\-format} -\item -def \bf{output\_\-write} -\item -def \bf{main} -\end{CompactItemize} -\subsection*{Static Public Attributes} -\begin{CompactItemize} -\item -tuple \bf{HINTS\_\-STANDARD} = (\char`\"{}easy\char`\"{}, \char`\"{}hint\char`\"{}, \char`\"{}remove\char`\"{}, \char`\"{}block\char`\"{}, \char`\"{}unblock\char`\"{}, \char`\"{}urgent\char`\"{}, \char`\"{}approve\char`\"{})\label{classbritney_1_1Britney_ebbe3f40cca59e2de275b0558556ee63} - -\item -tuple \bf{HINTS\_\-ALL} = (\char`\"{}force\char`\"{}, \char`\"{}force-hint\char`\"{}, \char`\"{}block-all\char`\"{})\label{classbritney_1_1Britney_a088d6fd96963f87f88c9c40cda10bfa} - -\end{CompactItemize} - - -\subsection{Detailed Description} - - -\footnotesize\begin{verbatim}Britney, the debian testing updater script - -This is the script that updates the testing_ distribution. It is executed -each day after the installation of the updated packages. It generates the -`Packages' files for the testing distribution, but it does so in an -intelligent manner; it try to avoid any inconsistency and to use only -non-buggy packages. - -For more documentation on this script, please read the Developers Reference. -\end{verbatim} -\normalsize - - - - -Definition at line 212 of file britney.py. - -\subsection{Member Function Documentation} -\index{britney::Britney@{britney::Britney}!__init__@{\_\-\_\-init\_\-\_\-}} -\index{__init__@{\_\-\_\-init\_\-\_\-}!britney::Britney@{britney::Britney}} -\subsubsection{\setlength{\rightskip}{0pt plus 5cm}def britney.Britney.\_\-\_\-init\_\-\_\- ( {\em self})}\label{classbritney_1_1Britney_5846d81eace24f479292c47e30fd1851} - - - - -\footnotesize\begin{verbatim}Class constructor - -This method initializes and populates the data lists, which contain all -the information needed by the other methods of the class. -\end{verbatim} -\normalsize - - -Definition at line 218 of file britney.py.\index{britney::Britney@{britney::Britney}!auto_hinter@{auto\_\-hinter}} -\index{auto_hinter@{auto\_\-hinter}!britney::Britney@{britney::Britney}} -\subsubsection{\setlength{\rightskip}{0pt plus 5cm}def britney.Britney.auto\_\-hinter ( {\em self})}\label{classbritney_1_1Britney_c9c109f54ddce53b17513405e07dba1a} - - - - -\footnotesize\begin{verbatim}Auto hint circular dependencies - -This method tries to auto hint circular dependencies analyzing the update -excuses relationships. If they build a circular dependency, which we already -know as not-working with the standard do_all algorithm, try to `easy` them. -\end{verbatim} -\normalsize - - -Definition at line 2536 of file britney.py.\index{britney::Britney@{britney::Britney}!check_conflicts@{check\_\-conflicts}} -\index{check_conflicts@{check\_\-conflicts}!britney::Britney@{britney::Britney}} -\subsubsection{\setlength{\rightskip}{0pt plus 5cm}def britney.Britney.check\_\-conflicts ( {\em self}, {\em pkg}, {\em arch}, {\em broken}, {\em system}, {\em conflicts})}\label{classbritney_1_1Britney_998b3ddbaedbb6cdb732b2307477e96f} - - - - -\footnotesize\begin{verbatim}Check if a package can be installed satisfying the conflicts - -This method checks if the `pkg` package from the `arch` architecture -can be installed (excluding `broken` packages) within the system -`system` along with all its dependencies. This means that all the -conflicts relationships are checked in order to achieve the test -co-installability of the package. - -The method returns a boolean which is True if the given package is -co-installable in the given system. -\end{verbatim} -\normalsize - - -Definition at line 1661 of file britney.py.\index{britney::Britney@{britney::Britney}!check_installable@{check\_\-installable}} -\index{check_installable@{check\_\-installable}!britney::Britney@{britney::Britney}} -\subsubsection{\setlength{\rightskip}{0pt plus 5cm}def britney.Britney.check\_\-installable ( {\em self}, {\em pkg}, {\em arch}, {\em suite}, {\em excluded} = {\tt []}, {\em conflicts} = {\tt False})}\label{classbritney_1_1Britney_4c06ddd116a40752c62d4395e92a97df} - - - - -\footnotesize\begin{verbatim}Check if a package is installable - -This method analyzes the dependencies of the binary package specified -by the parameter `pkg' for the architecture `arch' within the suite -`suite'. If the dependency can be satisfied in the given `suite` and -`conflicts` parameter is True, then the co-installability with -conflicts handling is checked. - -The dependency fields checked are Pre-Depends and Depends. - -The method returns a boolean which is True if the given package is -installable. -\end{verbatim} -\normalsize - - -Definition at line 1620 of file britney.py.\index{britney::Britney@{britney::Britney}!do_all@{do\_\-all}} -\index{do_all@{do\_\-all}!britney::Britney@{britney::Britney}} -\subsubsection{\setlength{\rightskip}{0pt plus 5cm}def britney.Britney.do\_\-all ( {\em self}, {\em maxdepth} = {\tt 0}, {\em init} = {\tt None}, {\em actions} = {\tt None})}\label{classbritney_1_1Britney_3ef9b6f600eac492fc5aa4b31638198f} - - - - -\footnotesize\begin{verbatim}Testing update runner - -This method tries to update testing checking the uninstallability -counters before and after the actions to decide if the update was -successful or not. -\end{verbatim} -\normalsize - - -Definition at line 2258 of file britney.py.\index{britney::Britney@{britney::Britney}!do_hint@{do\_\-hint}} -\index{do_hint@{do\_\-hint}!britney::Britney@{britney::Britney}} -\subsubsection{\setlength{\rightskip}{0pt plus 5cm}def britney.Britney.do\_\-hint ( {\em self}, {\em type}, {\em who}, {\em pkgvers})}\label{classbritney_1_1Britney_7bf70a5ad5754eb949205db3dc4b9c8a} - - - - -\footnotesize\begin{verbatim}Process hints - -This method process `easy`, `hint` and `force-hint` hints. If the -requested version is not in unstable, than the hint is skipped. -\end{verbatim} -\normalsize - - -Definition at line 2460 of file britney.py.\index{britney::Britney@{britney::Britney}!doop_source@{doop\_\-source}} -\index{doop_source@{doop\_\-source}!britney::Britney@{britney::Britney}} -\subsubsection{\setlength{\rightskip}{0pt plus 5cm}def britney.Britney.doop\_\-source ( {\em self}, {\em pkg})}\label{classbritney_1_1Britney_22af61b8a7f6fe71a79d28b5016cae1d} - - - - -\footnotesize\begin{verbatim}Apply a change to the testing distribution as requested by `pkg` - -This method apply the changes required by the action `pkg` tracking -them so it will be possible to revert them. - -The method returns a list of the package name, the suite where the -package comes from, the list of packages affected by the change and -the dictionary undo which can be used to rollback the changes. -\end{verbatim} -\normalsize - - -Definition at line 1880 of file britney.py.\index{britney::Britney@{britney::Britney}!eval_nuninst@{eval\_\-nuninst}} -\index{eval_nuninst@{eval\_\-nuninst}!britney::Britney@{britney::Britney}} -\subsubsection{\setlength{\rightskip}{0pt plus 5cm}def britney.Britney.eval\_\-nuninst ( {\em self}, {\em nuninst}, {\em original} = {\tt None})}\label{classbritney_1_1Britney_e5c18b706e6598474435b1996313cf27} - - - - -\footnotesize\begin{verbatim}Return a string which represents the uninstallability counters - -This method returns a string which represents the uninstallability -counters reading the uninstallability statistics `nuninst` and, if -present, merging the results with the `original` one. - -An example of the output string is: -1+2: i-0:a-0:a-0:h-0:i-1:m-0:m-0:p-0:a-0:m-0:s-2:s-0 - -where the first part is the number of broken packages in non-break -architectures + the total number of broken packages for all the -architectures. -\end{verbatim} -\normalsize - - -Definition at line 1568 of file britney.py.\index{britney::Britney@{britney::Britney}!eval_uninst@{eval\_\-uninst}} -\index{eval_uninst@{eval\_\-uninst}!britney::Britney@{britney::Britney}} -\subsubsection{\setlength{\rightskip}{0pt plus 5cm}def britney.Britney.eval\_\-uninst ( {\em self}, {\em nuninst})}\label{classbritney_1_1Britney_b8dd18ead23b6e1126bb4c2a5c3cd8ba} - - - - -\footnotesize\begin{verbatim}Return a string which represents the uninstallable packages - -This method returns a string which represents the uninstallable -packages reading the uninstallability statistics `nuninst`. - -An example of the output string is: - * i386: broken-pkg1, broken-pkg2 -\end{verbatim} -\normalsize - - -Definition at line 1598 of file britney.py.\index{britney::Britney@{britney::Britney}!excuse_unsat_deps@{excuse\_\-unsat\_\-deps}} -\index{excuse_unsat_deps@{excuse\_\-unsat\_\-deps}!britney::Britney@{britney::Britney}} -\subsubsection{\setlength{\rightskip}{0pt plus 5cm}def britney.Britney.excuse\_\-unsat\_\-deps ( {\em self}, {\em pkg}, {\em src}, {\em arch}, {\em suite}, {\em excuse}, {\em excluded} = {\tt []}, {\em conflicts} = {\tt False})}\label{classbritney_1_1Britney_f51c60a69f3a9dc2bc5afdb2ffaf3990} - - - - -\footnotesize\begin{verbatim}Find unsatisfied dependencies for a binary package - -This method analyzes the dependencies of the binary package specified -by the parameter `pkg', built from the source package `src', for the -architecture `arch' within the suite `suite'. If the dependency can't -be satisfied in testing and/or unstable, it updates the excuse passed -as parameter. - -The dependency fields checked are Pre-Depends and Depends. -\end{verbatim} -\normalsize - - -Definition at line 930 of file britney.py.\index{britney::Britney@{britney::Britney}!get_dependency_solvers@{get\_\-dependency\_\-solvers}} -\index{get_dependency_solvers@{get\_\-dependency\_\-solvers}!britney::Britney@{britney::Britney}} -\subsubsection{\setlength{\rightskip}{0pt plus 5cm}def britney.Britney.get\_\-dependency\_\-solvers ( {\em self}, {\em block}, {\em arch}, {\em distribution}, {\em excluded} = {\tt []}, {\em strict} = {\tt False})}\label{classbritney_1_1Britney_5461f49e3e75a251ebedfd37d2a5ff0c} - - - - -\footnotesize\begin{verbatim}Find the packages which satisfy a dependency block - -This method returns the list of packages which satisfy a dependency -block (as returned by apt_pkg.ParseDepends) for the given architecture -and distribution. - -It returns a tuple with two items: the first is a boolean which is -True if the dependency is satisfied, the second is the list of the -solving packages. -\end{verbatim} -\normalsize - - -Definition at line 889 of file britney.py.\index{britney::Britney@{britney::Britney}!get_full_tree@{get\_\-full\_\-tree}} -\index{get_full_tree@{get\_\-full\_\-tree}!britney::Britney@{britney::Britney}} -\subsubsection{\setlength{\rightskip}{0pt plus 5cm}def britney.Britney.get\_\-full\_\-tree ( {\em self}, {\em pkg}, {\em arch}, {\em suite})}\label{classbritney_1_1Britney_a923f6b90e2574e3bb2bb099b05925dd} - - - - -\footnotesize\begin{verbatim}Calculate the full dependency tree for the given package - -This method returns the full dependency tree for the package `pkg`, -inside the `arch` architecture for the suite `suite`. -\end{verbatim} -\normalsize - - -Definition at line 2022 of file britney.py.\index{britney::Britney@{britney::Britney}!get_nuninst@{get\_\-nuninst}} -\index{get_nuninst@{get\_\-nuninst}!britney::Britney@{britney::Britney}} -\subsubsection{\setlength{\rightskip}{0pt plus 5cm}def britney.Britney.get\_\-nuninst ( {\em self}, {\em requested\_\-arch} = {\tt None}, {\em build} = {\tt False})}\label{classbritney_1_1Britney_41c5ee0b9d64b2e76a0c1a1c2b28c73e} - - - - -\footnotesize\begin{verbatim}Return the uninstallability statistic for all the architectures - -To calculate the uninstallability counters, the method checks the -installability of all the packages for all the architectures, and -tracking dependencies in a recursive way. The architecture -indipendent packages are checked only for the `nobreakall` -architectures. - -It returns a dictionary with the architectures as keys and the list -of uninstallable packages as values. -\end{verbatim} -\normalsize - - -Definition at line 1508 of file britney.py.\index{britney::Britney@{britney::Britney}!invalidate_excuses@{invalidate\_\-excuses}} -\index{invalidate_excuses@{invalidate\_\-excuses}!britney::Britney@{britney::Britney}} -\subsubsection{\setlength{\rightskip}{0pt plus 5cm}def britney.Britney.invalidate\_\-excuses ( {\em self}, {\em valid}, {\em invalid})}\label{classbritney_1_1Britney_171969785db449d7a06c3f762774e0cd} - - - - -\footnotesize\begin{verbatim}Invalidate impossible excuses - -This method invalidates the impossible excuses, which depend -on invalid excuses. The two parameters contains the list of -`valid' and `invalid' excuses. -\end{verbatim} -\normalsize - - -Definition at line 1344 of file britney.py.\index{britney::Britney@{britney::Britney}!iter_packages@{iter\_\-packages}} -\index{iter_packages@{iter\_\-packages}!britney::Britney@{britney::Britney}} -\subsubsection{\setlength{\rightskip}{0pt plus 5cm}def britney.Britney.iter\_\-packages ( {\em self}, {\em packages}, {\em selected}, {\em hint} = {\tt False}, {\em nuninst} = {\tt None})}\label{classbritney_1_1Britney_d453398832baaa7f477f720cfb643029} - - - - -\footnotesize\begin{verbatim}Iter on the list of actions and apply them one-by-one - -This method apply the changes from `packages` to testing, checking the uninstallability -counters for every action performed. If the action do not improve the it, it is reverted. -The method returns the new uninstallability counters and the remaining actions if the -final result is successful, otherwise (None, None). -\end{verbatim} -\normalsize - - -Definition at line 2038 of file britney.py.\index{britney::Britney@{britney::Britney}!main@{main}} -\index{main@{main}!britney::Britney@{britney::Britney}} -\subsubsection{\setlength{\rightskip}{0pt plus 5cm}def britney.Britney.main ( {\em self})}\label{classbritney_1_1Britney_0e9551bdf927388f55be5ce15a48c94f} - - - - -\footnotesize\begin{verbatim}Main method - -This is the entry point for the class: it includes the list of calls -for the member methods which will produce the output files. -\end{verbatim} -\normalsize - - -Definition at line 2612 of file britney.py.\index{britney::Britney@{britney::Britney}!newlyuninst@{newlyuninst}} -\index{newlyuninst@{newlyuninst}!britney::Britney@{britney::Britney}} -\subsubsection{\setlength{\rightskip}{0pt plus 5cm}def britney.Britney.newlyuninst ( {\em self}, {\em nuold}, {\em nunew})}\label{classbritney_1_1Britney_60ccd1851bcea5659fed15010541e244} - - - - -\footnotesize\begin{verbatim}Return a nuninst statstic with only new uninstallable packages - -This method subtract the uninstallabla packages of the statistic -`nunew` from the statistic `nuold`. - -It returns a dictionary with the architectures as keys and the list -of uninstallable packages as values. -\end{verbatim} -\normalsize - - -Definition at line 1493 of file britney.py.\index{britney::Britney@{britney::Britney}!normalize_bugs@{normalize\_\-bugs}} -\index{normalize_bugs@{normalize\_\-bugs}!britney::Britney@{britney::Britney}} -\subsubsection{\setlength{\rightskip}{0pt plus 5cm}def britney.Britney.normalize\_\-bugs ( {\em self})}\label{classbritney_1_1Britney_5a6af4a100cfd54e872a27fa7f48ac3c} - - - - -\footnotesize\begin{verbatim}Normalize the release critical bug summaries for testing and unstable - -The method doesn't return any value: it directly modifies the -object attribute `bugs'. -\end{verbatim} -\normalsize - - -Definition at line 549 of file britney.py.\index{britney::Britney@{britney::Britney}!old_libraries@{old\_\-libraries}} -\index{old_libraries@{old\_\-libraries}!britney::Britney@{britney::Britney}} -\subsubsection{\setlength{\rightskip}{0pt plus 5cm}def britney.Britney.old\_\-libraries ( {\em self})}\label{classbritney_1_1Britney_39c07e55b274ff98cb9cecb5f051bc5d} - - - - -\footnotesize\begin{verbatim}Detect old libraries left in testing for smooth transitions - -This method detect old libraries which are in testing but no longer -built from the source package: they are still there because other -packages still depend on them, but they should be removed as soon -as possible. -\end{verbatim} -\normalsize - - -Definition at line 2576 of file britney.py.\index{britney::Britney@{britney::Britney}!old_libraries_format@{old\_\-libraries\_\-format}} -\index{old_libraries_format@{old\_\-libraries\_\-format}!britney::Britney@{britney::Britney}} -\subsubsection{\setlength{\rightskip}{0pt plus 5cm}def britney.Britney.old\_\-libraries\_\-format ( {\em self}, {\em libs})}\label{classbritney_1_1Britney_7c45f1c5b1dbd442fb9b85fef3fe1823} - - - - -\footnotesize\begin{verbatim}Format old libraries in a smart table\end{verbatim} -\normalsize - - -Definition at line 2596 of file britney.py.\index{britney::Britney@{britney::Britney}!output_write@{output\_\-write}} -\index{output_write@{output\_\-write}!britney::Britney@{britney::Britney}} -\subsubsection{\setlength{\rightskip}{0pt plus 5cm}def britney.Britney.output\_\-write ( {\em self}, {\em msg})}\label{classbritney_1_1Britney_b0406f20fbbbb08cd3c6e5e6b35f77d5} - - - - -\footnotesize\begin{verbatim}Simple wrapper for output writing\end{verbatim} -\normalsize - - -Definition at line 2608 of file britney.py.\index{britney::Britney@{britney::Britney}!read_approvals@{read\_\-approvals}} -\index{read_approvals@{read\_\-approvals}!britney::Britney@{britney::Britney}} -\subsubsection{\setlength{\rightskip}{0pt plus 5cm}def britney.Britney.read\_\-approvals ( {\em self}, {\em basedir})}\label{classbritney_1_1Britney_39248f0cfea1c8798b2ca5a97d37eaf8} - - - - -\footnotesize\begin{verbatim}Read the approval commands from the specified directory - -The approval commands are read from the files contained by the -`Approved' directory within the directory specified as `basedir' -parameter. The name of the files has to be the same of the -authorized users for the approvals. - -The file contains rows with the format: - - - -The method returns a dictionary where the key is the binary package -name followed by an underscore and the version number, and the value -is the user who submitted the command. -\end{verbatim} -\normalsize - - -Definition at line 669 of file britney.py.\index{britney::Britney@{britney::Britney}!read_binaries@{read\_\-binaries}} -\index{read_binaries@{read\_\-binaries}!britney::Britney@{britney::Britney}} -\subsubsection{\setlength{\rightskip}{0pt plus 5cm}def britney.Britney.read\_\-binaries ( {\em self}, {\em basedir}, {\em distribution}, {\em arch})}\label{classbritney_1_1Britney_1b2b0f42e4af1cee472f93e955b30421} - - - - -\footnotesize\begin{verbatim}Read the list of binary packages from the specified directory - -The binary packages are read from the `Packages_${arch}' files -within the directory specified as `basedir' parameter, replacing -${arch} with the value of the arch parameter. Considering the -large amount of memory needed, not all the fields are loaded -in memory. The available fields are Version, Source, Pre-Depends, -Depends, Conflicts, Provides and Architecture. - -After reading the packages, reverse dependencies are computed -and saved in the `rdepends' keys, and the `Provides' field is -used to populate the virtual packages list. - -The dependencies are parsed with the apt.pkg.ParseDepends method, -and they are stored both as the format of its return value and -text. - -The method returns a tuple. The first element is a list where -every item represents a binary package as a dictionary; the second -element is a dictionary which maps virtual packages to real -packages that provide it. -\end{verbatim} -\normalsize - - -Definition at line 367 of file britney.py.\index{britney::Britney@{britney::Britney}!read_bugs@{read\_\-bugs}} -\index{read_bugs@{read\_\-bugs}!britney::Britney@{britney::Britney}} -\subsubsection{\setlength{\rightskip}{0pt plus 5cm}def britney.Britney.read\_\-bugs ( {\em self}, {\em basedir})}\label{classbritney_1_1Britney_6c777aae69e7bec2efebaf23ddd4a86c} - - - - -\footnotesize\begin{verbatim}Read the release critial bug summary from the specified directory - -The RC bug summaries are read from the `Bugs' file within the -directory specified as `basedir' parameter. The file contains -rows with the format: - - - -The method returns a dictionary where the key is the binary package -name and the value is the number of open RC bugs for it. -\end{verbatim} -\normalsize - - -Definition at line 493 of file britney.py.\index{britney::Britney@{britney::Britney}!read_dates@{read\_\-dates}} -\index{read_dates@{read\_\-dates}!britney::Britney@{britney::Britney}} -\subsubsection{\setlength{\rightskip}{0pt plus 5cm}def britney.Britney.read\_\-dates ( {\em self}, {\em basedir})}\label{classbritney_1_1Britney_085af5ac906813ea40fc2e623748f517} - - - - -\footnotesize\begin{verbatim}Read the upload date for the packages from the specified directory - -The upload dates are read from the `Date' file within the directory -specified as `basedir' parameter. The file contains rows with the -format: - - - -The dates are expressed as days starting from the 1970-01-01. - -The method returns a dictionary where the key is the binary package -name and the value is tuple with two items, the version and the date. -\end{verbatim} -\normalsize - - -Definition at line 584 of file britney.py.\index{britney::Britney@{britney::Britney}!read_hints@{read\_\-hints}} -\index{read_hints@{read\_\-hints}!britney::Britney@{britney::Britney}} -\subsubsection{\setlength{\rightskip}{0pt plus 5cm}def britney.Britney.read\_\-hints ( {\em self}, {\em basedir})}\label{classbritney_1_1Britney_46d535f617fcf1faaaf5d841ea23c184} - - - - -\footnotesize\begin{verbatim}Read the hint commands from the specified directory - -The hint commands are read from the files contained by the `Hints' -directory within the directory specified as `basedir' parameter. -The name of the files has to be the same of the authorized users -for the hints. - -The file contains rows with the format: - - [/] - -The method returns a dictionary where the key is the command, and -the value is the list of affected packages. -\end{verbatim} -\normalsize - - -Definition at line 695 of file britney.py.\index{britney::Britney@{britney::Britney}!read_nuninst@{read\_\-nuninst}} -\index{read_nuninst@{read\_\-nuninst}!britney::Britney@{britney::Britney}} -\subsubsection{\setlength{\rightskip}{0pt plus 5cm}def britney.Britney.read\_\-nuninst ( {\em self})}\label{classbritney_1_1Britney_24fe2c117eadac8eb783e3cb86300265} - - - - -\footnotesize\begin{verbatim}Read the non-installable report\end{verbatim} -\normalsize - - -Definition at line 835 of file britney.py.\index{britney::Britney@{britney::Britney}!read_sources@{read\_\-sources}} -\index{read_sources@{read\_\-sources}!britney::Britney@{britney::Britney}} -\subsubsection{\setlength{\rightskip}{0pt plus 5cm}def britney.Britney.read\_\-sources ( {\em self}, {\em basedir})}\label{classbritney_1_1Britney_054f44c47f17c0c4f5a069e821b7f868} - - - - -\footnotesize\begin{verbatim}Read the list of source packages from the specified directory - -The source packages are read from the `Sources' file within the -directory specified as `basedir' parameter. Considering the -large amount of memory needed, not all the fields are loaded -in memory. The available fields are Version, Maintainer and Section. - -The method returns a list where every item represents a source -package as a dictionary. -\end{verbatim} -\normalsize - - -Definition at line 340 of file britney.py.\index{britney::Britney@{britney::Britney}!read_urgencies@{read\_\-urgencies}} -\index{read_urgencies@{read\_\-urgencies}!britney::Britney@{britney::Britney}} -\subsubsection{\setlength{\rightskip}{0pt plus 5cm}def britney.Britney.read\_\-urgencies ( {\em self}, {\em basedir})}\label{classbritney_1_1Britney_09fc27899506b4830b1961f125a7b6a4} - - - - -\footnotesize\begin{verbatim}Read the upload urgency of the packages from the specified directory - -The upload urgencies are read from the `Urgency' file within the -directory specified as `basedir' parameter. The file contains rows -with the format: - - - -The method returns a dictionary where the key is the binary package -name and the value is the greatest urgency from the versions of the -package that are higher then the testing one. -\end{verbatim} -\normalsize - - -Definition at line 624 of file britney.py.\index{britney::Britney@{britney::Britney}!register_reverses@{register\_\-reverses}} -\index{register_reverses@{register\_\-reverses}!britney::Britney@{britney::Britney}} -\subsubsection{\setlength{\rightskip}{0pt plus 5cm}def britney.Britney.register\_\-reverses ( {\em self}, {\em pkg}, {\em packages}, {\em provides}, {\em check\_\-doubles} = {\tt True}, {\em parse\_\-depends} = {\tt apt\_\-pkg.ParseDepends})}\label{classbritney_1_1Britney_f86b93b64ac43c1d04fe88a6a8b1777e} - - - - -\footnotesize\begin{verbatim}Register reverse dependencies and conflicts for the specified package - -This method register the reverse dependencies and conflicts for -a give package using `packages` as list of packages and `provides` -as list of virtual packages. - -The method has an optional parameter parse_depends which is there -just for performance reasons and is not meant to be overwritten. -\end{verbatim} -\normalsize - - -Definition at line 451 of file britney.py.\index{britney::Britney@{britney::Britney}!reversed_exc_deps@{reversed\_\-exc\_\-deps}} -\index{reversed_exc_deps@{reversed\_\-exc\_\-deps}!britney::Britney@{britney::Britney}} -\subsubsection{\setlength{\rightskip}{0pt plus 5cm}def britney.Britney.reversed\_\-exc\_\-deps ( {\em self})}\label{classbritney_1_1Britney_be1b4af9d6c6650c70b24267412bc1a8} - - - - -\footnotesize\begin{verbatim}Reverse the excuses dependencies - -This method returns a dictionary where the keys are the package names -and the values are the excuse names which depend on it. -\end{verbatim} -\normalsize - - -Definition at line 1331 of file britney.py.\index{britney::Britney@{britney::Britney}!same_source@{same\_\-source}} -\index{same_source@{same\_\-source}!britney::Britney@{britney::Britney}} -\subsubsection{\setlength{\rightskip}{0pt plus 5cm}def britney.Britney.same\_\-source ( {\em self}, {\em sv1}, {\em sv2})}\label{classbritney_1_1Britney_85d2e45e8431779b62f398c34972ddf1} - - - - -\footnotesize\begin{verbatim}Check if two version numbers are built from the same source - -This method returns a boolean value which is true if the two -version numbers specified as parameters are built from the same -source. The main use of this code is to detect binary-NMU. -\end{verbatim} -\normalsize - - -Definition at line 850 of file britney.py.\index{britney::Britney@{britney::Britney}!should_remove_source@{should\_\-remove\_\-source}} -\index{should_remove_source@{should\_\-remove\_\-source}!britney::Britney@{britney::Britney}} -\subsubsection{\setlength{\rightskip}{0pt plus 5cm}def britney.Britney.should\_\-remove\_\-source ( {\em self}, {\em pkg})}\label{classbritney_1_1Britney_f8a6c9adbdec7a5a982dd2b74febcc08} - - - - -\footnotesize\begin{verbatim}Check if a source package should be removed from testing - -This method checks if a source package should be removed from the -testing distribution; this happen if the source package is not -present in the unstable distribution anymore. - -It returns True if the package can be removed, False otherwise. -In the former case, a new excuse is appended to the the object -attribute excuses. -\end{verbatim} -\normalsize - - -Definition at line 990 of file britney.py.\index{britney::Britney@{britney::Britney}!should_upgrade_src@{should\_\-upgrade\_\-src}} -\index{should_upgrade_src@{should\_\-upgrade\_\-src}!britney::Britney@{britney::Britney}} -\subsubsection{\setlength{\rightskip}{0pt plus 5cm}def britney.Britney.should\_\-upgrade\_\-src ( {\em self}, {\em src}, {\em suite})}\label{classbritney_1_1Britney_94785175a85f44b1afaf3add167a211f} - - - - -\footnotesize\begin{verbatim}Check if source package should be upgraded - -This method checks if a source package should be upgraded. The analysis -is performed for the source package specified by the `src' parameter, -checking the architecture `arch' for the distribution `suite'. - -It returns False if the given package doesn't need to be upgraded, -True otherwise. In the former case, a new excuse is appended to -the the object attribute excuses. -\end{verbatim} -\normalsize - - -Definition at line 1134 of file britney.py.\index{britney::Britney@{britney::Britney}!should_upgrade_srcarch@{should\_\-upgrade\_\-srcarch}} -\index{should_upgrade_srcarch@{should\_\-upgrade\_\-srcarch}!britney::Britney@{britney::Britney}} -\subsubsection{\setlength{\rightskip}{0pt plus 5cm}def britney.Britney.should\_\-upgrade\_\-srcarch ( {\em self}, {\em src}, {\em arch}, {\em suite})}\label{classbritney_1_1Britney_bd18d7acde434387e94344a39db5b0e5} - - - - -\footnotesize\begin{verbatim}Check if binary package should be upgraded - -This method checks if a binary package should be upgraded; this can -happen also if the binary package is a binary-NMU for the given arch. -The analysis is performed for the source package specified by the -`src' parameter, checking the architecture `arch' for the distribution -`suite'. - -It returns False if the given package doesn't need to be upgraded, -True otherwise. In the former case, a new excuse is appended to -the the object attribute excuses. -\end{verbatim} -\normalsize - - -Definition at line 1020 of file britney.py.\index{britney::Britney@{britney::Britney}!sort_actions@{sort\_\-actions}} -\index{sort_actions@{sort\_\-actions}!britney::Britney@{britney::Britney}} -\subsubsection{\setlength{\rightskip}{0pt plus 5cm}def britney.Britney.sort\_\-actions ( {\em self})}\label{classbritney_1_1Britney_70115e28e2ee6aa3a09d1efbd81b4a87} - - - - -\footnotesize\begin{verbatim}Sort actions in a smart way - -This method sorts the list of actions in a smart way. In details, it uses -as base sort the number of days the excuse is old, then reordering packages -so the ones with most reverse dependencies are at the end of the loop. -If an action depends on another one, it is put after it. -\end{verbatim} -\normalsize - - -Definition at line 2504 of file britney.py.\index{britney::Britney@{britney::Britney}!upgrade_testing@{upgrade\_\-testing}} -\index{upgrade_testing@{upgrade\_\-testing}!britney::Britney@{britney::Britney}} -\subsubsection{\setlength{\rightskip}{0pt plus 5cm}def britney.Britney.upgrade\_\-testing ( {\em self})}\label{classbritney_1_1Britney_921effe0d64ed713c38888684a0a26d4} - - - - -\footnotesize\begin{verbatim}Upgrade testing using the unstable packages - -This method tries to upgrade testing using the packages from unstable. -Before running the do_all method, it tries the easy and force-hint -commands. -\end{verbatim} -\normalsize - - -Definition at line 2365 of file britney.py.\index{britney::Britney@{britney::Britney}!write_bugs@{write\_\-bugs}} -\index{write_bugs@{write\_\-bugs}!britney::Britney@{britney::Britney}} -\subsubsection{\setlength{\rightskip}{0pt plus 5cm}def britney.Britney.write\_\-bugs ( {\em self}, {\em basedir}, {\em bugs})}\label{classbritney_1_1Britney_0a5591fc94b89d53d12cbb8f27d100a7} - - - - -\footnotesize\begin{verbatim}Write the release critical bug summary to the specified directory - -For a more detailed explanation of the format, please check the method -read_bugs. -\end{verbatim} -\normalsize - - -Definition at line 517 of file britney.py.\index{britney::Britney@{britney::Britney}!write_controlfiles@{write\_\-controlfiles}} -\index{write_controlfiles@{write\_\-controlfiles}!britney::Britney@{britney::Britney}} -\subsubsection{\setlength{\rightskip}{0pt plus 5cm}def britney.Britney.write\_\-controlfiles ( {\em self}, {\em basedir}, {\em suite})}\label{classbritney_1_1Britney_1a3695a37b15ebd7e81cc33683fde461} - - - - -\footnotesize\begin{verbatim}Write the control files - -This method write the control files for the binary packages of all -the architectures and for the source packages. -\end{verbatim} -\normalsize - - -Definition at line 777 of file britney.py.\index{britney::Britney@{britney::Britney}!write_dates@{write\_\-dates}} -\index{write_dates@{write\_\-dates}!britney::Britney@{britney::Britney}} -\subsubsection{\setlength{\rightskip}{0pt plus 5cm}def britney.Britney.write\_\-dates ( {\em self}, {\em basedir}, {\em dates})}\label{classbritney_1_1Britney_83e0bd993e7a099e6bf89d760183a76b} - - - - -\footnotesize\begin{verbatim}Write the upload date for the packages to the specified directory - -For a more detailed explanation of the format, please check the method -read_dates. -\end{verbatim} -\normalsize - - -Definition at line 610 of file britney.py.\index{britney::Britney@{britney::Britney}!write_excuses@{write\_\-excuses}} -\index{write_excuses@{write\_\-excuses}!britney::Britney@{britney::Britney}} -\subsubsection{\setlength{\rightskip}{0pt plus 5cm}def britney.Britney.write\_\-excuses ( {\em self})}\label{classbritney_1_1Britney_010f6deffca32f7f71ecf1f5c1bb4985} - - - - -\footnotesize\begin{verbatim}Produce and write the update excuses - -This method handles the update excuses generation: the packages are -looked to determine whether they are valid candidates. For the details -of this procedure, please refer to the module docstring. -\end{verbatim} -\normalsize - - -Definition at line 1386 of file britney.py.\index{britney::Britney@{britney::Britney}!write_heidi@{write\_\-heidi}} -\index{write_heidi@{write\_\-heidi}!britney::Britney@{britney::Britney}} -\subsubsection{\setlength{\rightskip}{0pt plus 5cm}def britney.Britney.write\_\-heidi ( {\em self}, {\em basedir}, {\em filename})}\label{classbritney_1_1Britney_20f846da79d595d36628c8da3195ac7a} - - - - -\footnotesize\begin{verbatim}Write the output HeidiResult - -This method write the output for Heidi, which contains all the -binary packages and the source packages in the form: - - - -\end{verbatim} -\normalsize - - -Definition at line 742 of file britney.py.\index{britney::Britney@{britney::Britney}!write_nuninst@{write\_\-nuninst}} -\index{write_nuninst@{write\_\-nuninst}!britney::Britney@{britney::Britney}} -\subsubsection{\setlength{\rightskip}{0pt plus 5cm}def britney.Britney.write\_\-nuninst ( {\em self}, {\em nuninst})}\label{classbritney_1_1Britney_1dd8c704e1dab571e4bb62ae15f6ee52} - - - - -\footnotesize\begin{verbatim}Write the non-installable report\end{verbatim} -\normalsize - - -Definition at line 827 of file britney.py. - -The documentation for this class was generated from the following file:\begin{CompactItemize} -\item -britney.py\end{CompactItemize} diff --git a/doc/latex/classexcuse_1_1Excuse.tex b/doc/latex/classexcuse_1_1Excuse.tex deleted file mode 100644 index 6723888..0000000 --- a/doc/latex/classexcuse_1_1Excuse.tex +++ /dev/null @@ -1,239 +0,0 @@ -\section{excuse.Excuse Class Reference} -\label{classexcuse_1_1Excuse}\index{excuse::Excuse@{excuse::Excuse}} -\subsection*{Public Member Functions} -\begin{CompactItemize} -\item -def \bf{\_\-\_\-init\_\-\_\-} -\item -def \bf{set\_\-vers} -\item -def \bf{set\_\-maint} -\item -def \bf{set\_\-section} -\item -def \bf{set\_\-priority} -\item -def \bf{set\_\-date} -\item -def \bf{set\_\-urgency} -\item -def \bf{add\_\-dep} -\item -def \bf{add\_\-sane\_\-dep} -\item -def \bf{add\_\-break\_\-dep} -\item -def \bf{add\_\-unsat\_\-dep} -\item -def \bf{invalidate\_\-dep} -\item -def \bf{setdaysold} -\item -def \bf{addhtml} -\item -def \bf{html} -\end{CompactItemize} -\subsection*{Static Public Attributes} -\begin{CompactItemize} -\item -tuple \bf{reemail} = re.compile(r\char`\"{}$<$.$\ast$?$>$\char`\"{})\label{classexcuse_1_1Excuse_bb15f55eed8f034db8a64b4ddc46460d} - -\begin{CompactList}\small\item\em Regular expression for removing the email address. \item\end{CompactList}\end{CompactItemize} - - -\subsection{Detailed Description} - - -\footnotesize\begin{verbatim}Excuse class - -This class represents an update excuse, which is a detailed explanation -of why a package can or cannot be updated in the testing distribution from -a newer package in another distribution (like for example unstable). - -The main purpose of the excuses is to be written in an HTML file which -will be published over HTTP. The maintainers will be able to parse it -manually or automatically to find the explanation of why their packages -have been updated or not. -\end{verbatim} -\normalsize - - - - -Definition at line 21 of file excuse.py. - -\subsection{Member Function Documentation} -\index{excuse::Excuse@{excuse::Excuse}!__init__@{\_\-\_\-init\_\-\_\-}} -\index{__init__@{\_\-\_\-init\_\-\_\-}!excuse::Excuse@{excuse::Excuse}} -\subsubsection{\setlength{\rightskip}{0pt plus 5cm}def excuse.Excuse.\_\-\_\-init\_\-\_\- ( {\em self}, {\em name})}\label{classexcuse_1_1Excuse_4bdb0917f763d74951c621e466e98bdb} - - - - -\footnotesize\begin{verbatim}Class constructor - -This method initializes the excuse with the specified name and -the default values. -\end{verbatim} -\normalsize - - -Definition at line 28 of file excuse.py.\index{excuse::Excuse@{excuse::Excuse}!add_break_dep@{add\_\-break\_\-dep}} -\index{add_break_dep@{add\_\-break\_\-dep}!excuse::Excuse@{excuse::Excuse}} -\subsubsection{\setlength{\rightskip}{0pt plus 5cm}def excuse.Excuse.add\_\-break\_\-dep ( {\em self}, {\em name}, {\em arch})}\label{classexcuse_1_1Excuse_60e00fe0515f2dab003bd29baceedd34} - - - - -\footnotesize\begin{verbatim}Add a break dependency\end{verbatim} -\normalsize - - -Definition at line 86 of file excuse.py.\index{excuse::Excuse@{excuse::Excuse}!add_dep@{add\_\-dep}} -\index{add_dep@{add\_\-dep}!excuse::Excuse@{excuse::Excuse}} -\subsubsection{\setlength{\rightskip}{0pt plus 5cm}def excuse.Excuse.add\_\-dep ( {\em self}, {\em name})}\label{classexcuse_1_1Excuse_fa97c9f61fef17d6028491362153a766} - - - - -\footnotesize\begin{verbatim}Add a dependency\end{verbatim} -\normalsize - - -Definition at line 78 of file excuse.py.\index{excuse::Excuse@{excuse::Excuse}!add_sane_dep@{add\_\-sane\_\-dep}} -\index{add_sane_dep@{add\_\-sane\_\-dep}!excuse::Excuse@{excuse::Excuse}} -\subsubsection{\setlength{\rightskip}{0pt plus 5cm}def excuse.Excuse.add\_\-sane\_\-dep ( {\em self}, {\em name})}\label{classexcuse_1_1Excuse_8a89f54df8036e6f5c7c6bfa3f0cc6fc} - - - - -\footnotesize\begin{verbatim}Add a sane dependency\end{verbatim} -\normalsize - - -Definition at line 82 of file excuse.py.\index{excuse::Excuse@{excuse::Excuse}!add_unsat_dep@{add\_\-unsat\_\-dep}} -\index{add_unsat_dep@{add\_\-unsat\_\-dep}!excuse::Excuse@{excuse::Excuse}} -\subsubsection{\setlength{\rightskip}{0pt plus 5cm}def excuse.Excuse.add\_\-unsat\_\-dep ( {\em self}, {\em arch})}\label{classexcuse_1_1Excuse_7c76b47749dc3da2b1988a6991664a40} - - - - -\footnotesize\begin{verbatim}Add a flag for unsatisfied dependencies\end{verbatim} -\normalsize - - -Definition at line 91 of file excuse.py.\index{excuse::Excuse@{excuse::Excuse}!addhtml@{addhtml}} -\index{addhtml@{addhtml}!excuse::Excuse@{excuse::Excuse}} -\subsubsection{\setlength{\rightskip}{0pt plus 5cm}def excuse.Excuse.addhtml ( {\em self}, {\em note})}\label{classexcuse_1_1Excuse_eb0a1ea0fae66a571e5efa703e53ba3a} - - - - -\footnotesize\begin{verbatim}Add a note in HTML\end{verbatim} -\normalsize - - -Definition at line 104 of file excuse.py.\index{excuse::Excuse@{excuse::Excuse}!html@{html}} -\index{html@{html}!excuse::Excuse@{excuse::Excuse}} -\subsubsection{\setlength{\rightskip}{0pt plus 5cm}def excuse.Excuse.html ( {\em self})}\label{classexcuse_1_1Excuse_84049740652a58b248fabdb3fa9d4b2c} - - - - -\footnotesize\begin{verbatim}Render the excuse in HTML\end{verbatim} -\normalsize - - -Definition at line 108 of file excuse.py.\index{excuse::Excuse@{excuse::Excuse}!invalidate_dep@{invalidate\_\-dep}} -\index{invalidate_dep@{invalidate\_\-dep}!excuse::Excuse@{excuse::Excuse}} -\subsubsection{\setlength{\rightskip}{0pt plus 5cm}def excuse.Excuse.invalidate\_\-dep ( {\em self}, {\em name})}\label{classexcuse_1_1Excuse_8594c46ccf4182fa8b37fe487bf53850} - - - - -\footnotesize\begin{verbatim}Invalidate dependency\end{verbatim} -\normalsize - - -Definition at line 95 of file excuse.py.\index{excuse::Excuse@{excuse::Excuse}!set_date@{set\_\-date}} -\index{set_date@{set\_\-date}!excuse::Excuse@{excuse::Excuse}} -\subsubsection{\setlength{\rightskip}{0pt plus 5cm}def excuse.Excuse.set\_\-date ( {\em self}, {\em date})}\label{classexcuse_1_1Excuse_ac01c3b9802ad26571f01b55ffc1098c} - - - - -\footnotesize\begin{verbatim}Set the date of upload of the package\end{verbatim} -\normalsize - - -Definition at line 70 of file excuse.py.\index{excuse::Excuse@{excuse::Excuse}!set_maint@{set\_\-maint}} -\index{set_maint@{set\_\-maint}!excuse::Excuse@{excuse::Excuse}} -\subsubsection{\setlength{\rightskip}{0pt plus 5cm}def excuse.Excuse.set\_\-maint ( {\em self}, {\em maint})}\label{classexcuse_1_1Excuse_189ec1709eef0bd8acb9cd093b8350b5} - - - - -\footnotesize\begin{verbatim}Set the package maintainer's name\end{verbatim} -\normalsize - - -Definition at line 58 of file excuse.py.\index{excuse::Excuse@{excuse::Excuse}!set_priority@{set\_\-priority}} -\index{set_priority@{set\_\-priority}!excuse::Excuse@{excuse::Excuse}} -\subsubsection{\setlength{\rightskip}{0pt plus 5cm}def excuse.Excuse.set\_\-priority ( {\em self}, {\em pri})}\label{classexcuse_1_1Excuse_3a0ebe3eb87c1af8f093e80a874ea0fa} - - - - -\footnotesize\begin{verbatim}Set the priority of the package\end{verbatim} -\normalsize - - -Definition at line 66 of file excuse.py.\index{excuse::Excuse@{excuse::Excuse}!set_section@{set\_\-section}} -\index{set_section@{set\_\-section}!excuse::Excuse@{excuse::Excuse}} -\subsubsection{\setlength{\rightskip}{0pt plus 5cm}def excuse.Excuse.set\_\-section ( {\em self}, {\em section})}\label{classexcuse_1_1Excuse_6b435fa4d19b929d9fb70c8d28688387} - - - - -\footnotesize\begin{verbatim}Set the section of the package\end{verbatim} -\normalsize - - -Definition at line 62 of file excuse.py.\index{excuse::Excuse@{excuse::Excuse}!set_urgency@{set\_\-urgency}} -\index{set_urgency@{set\_\-urgency}!excuse::Excuse@{excuse::Excuse}} -\subsubsection{\setlength{\rightskip}{0pt plus 5cm}def excuse.Excuse.set\_\-urgency ( {\em self}, {\em date})}\label{classexcuse_1_1Excuse_c504d40ac6d07ffdb08b7ff8ed555d10} - - - - -\footnotesize\begin{verbatim}Set the urgency of upload of the package\end{verbatim} -\normalsize - - -Definition at line 74 of file excuse.py.\index{excuse::Excuse@{excuse::Excuse}!set_vers@{set\_\-vers}} -\index{set_vers@{set\_\-vers}!excuse::Excuse@{excuse::Excuse}} -\subsubsection{\setlength{\rightskip}{0pt plus 5cm}def excuse.Excuse.set\_\-vers ( {\em self}, {\em tver}, {\em uver})}\label{classexcuse_1_1Excuse_b8751fc5d0033b4c734c476d92841d99} - - - - -\footnotesize\begin{verbatim}Set the testing and unstable versions\end{verbatim} -\normalsize - - -Definition at line 53 of file excuse.py.\index{excuse::Excuse@{excuse::Excuse}!setdaysold@{setdaysold}} -\index{setdaysold@{setdaysold}!excuse::Excuse@{excuse::Excuse}} -\subsubsection{\setlength{\rightskip}{0pt plus 5cm}def excuse.Excuse.setdaysold ( {\em self}, {\em daysold}, {\em mindays})}\label{classexcuse_1_1Excuse_cf1fa7c6fb741bbe7e3120113748f3a5} - - - - -\footnotesize\begin{verbatim}Set the number of days from the upload and the minimum number of days for the update\end{verbatim} -\normalsize - - -Definition at line 99 of file excuse.py. - -The documentation for this class was generated from the following file:\begin{CompactItemize} -\item -excuse.py\end{CompactItemize} diff --git a/doc/latex/doxygen.sty b/doc/latex/doxygen.sty deleted file mode 100644 index 8d3c774..0000000 --- a/doc/latex/doxygen.sty +++ /dev/null @@ -1,78 +0,0 @@ -\NeedsTeXFormat{LaTeX2e} -\ProvidesPackage{doxygen} -\RequirePackage{calc} -\RequirePackage{array} -\pagestyle{fancyplain} -\newcommand{\clearemptydoublepage}{\newpage{\pagestyle{empty}\cleardoublepage}} -\renewcommand{\chaptermark}[1]{\markboth{#1}{}} -\renewcommand{\sectionmark}[1]{\markright{\thesection\ #1}} -\lhead[\fancyplain{}{\bfseries\thepage}] - {\fancyplain{}{\bfseries\rightmark}} -\rhead[\fancyplain{}{\bfseries\leftmark}] - {\fancyplain{}{\bfseries\thepage}} -\rfoot[\fancyplain{}{\bfseries\scriptsize Generated on Fri Aug 18 23:23:25 2006 for briteny by Doxygen }]{} -\lfoot[]{\fancyplain{}{\bfseries\scriptsize Generated on Fri Aug 18 23:23:25 2006 for briteny by Doxygen }} -\cfoot{} -\newenvironment{Code} -{\footnotesize} -{\normalsize} -\newcommand{\doxyref}[3]{\textbf{#1} (\textnormal{#2}\,\pageref{#3})} -\newenvironment{DocInclude} -{\footnotesize} -{\normalsize} -\newenvironment{VerbInclude} -{\footnotesize} -{\normalsize} -\newenvironment{Image} -{\begin{figure}[H]} -{\end{figure}} -\newenvironment{ImageNoCaption}{}{} -\newenvironment{CompactList} -{\begin{list}{}{ - \setlength{\leftmargin}{0.5cm} - \setlength{\itemsep}{0pt} - \setlength{\parsep}{0pt} - \setlength{\topsep}{0pt} - \renewcommand{\makelabel}{\hfill}}} -{\end{list}} -\newenvironment{CompactItemize} -{ - \begin{itemize} - \setlength{\itemsep}{-3pt} - \setlength{\parsep}{0pt} - \setlength{\topsep}{0pt} - \setlength{\partopsep}{0pt} -} -{\end{itemize}} -\newcommand{\PBS}[1]{\let\temp=\\#1\let\\=\temp} -\newlength{\tmplength} -\newenvironment{TabularC}[1] -{ -\setlength{\tmplength} - {\linewidth/(#1)-\tabcolsep*2-\arrayrulewidth*(#1+1)/(#1)} - \par\begin{tabular*}{\linewidth} - {*{#1}{|>{\PBS\raggedright\hspace{0pt}}p{\the\tmplength}}|} -} -{\end{tabular*}\par} -\newcommand{\entrylabel}[1]{ - {\parbox[b]{\labelwidth-4pt}{\makebox[0pt][l]{\textbf{#1}}\vspace{1.5\baselineskip}}}} -\newenvironment{Desc} -{\begin{list}{} - { - \settowidth{\labelwidth}{40pt} - \setlength{\leftmargin}{\labelwidth} - \setlength{\parsep}{0pt} - \setlength{\itemsep}{-4pt} - \renewcommand{\makelabel}{\entrylabel} - } -} -{\end{list}} -\newenvironment{Indent} - {\begin{list}{}{\setlength{\leftmargin}{0.5cm}} - \item[]\ignorespaces} - {\unskip\end{list}} -\setlength{\parindent}{0cm} -\setlength{\parskip}{0.2cm} -\addtocounter{secnumdepth}{1} -\sloppy -\usepackage[T1]{fontenc} diff --git a/doc/latex/hierarchy.tex b/doc/latex/hierarchy.tex deleted file mode 100644 index d73be1d..0000000 --- a/doc/latex/hierarchy.tex +++ /dev/null @@ -1,5 +0,0 @@ -\section{briteny Class Hierarchy} -This inheritance list is sorted roughly, but not completely, alphabetically:\begin{CompactList} -\item \contentsline{section}{britney.Britney}{\pageref{classbritney_1_1Britney}}{} -\item \contentsline{section}{excuse.Excuse}{\pageref{classexcuse_1_1Excuse}}{} -\end{CompactList} diff --git a/doc/latex/namespacebritney.tex b/doc/latex/namespacebritney.tex deleted file mode 100644 index 1af6167..0000000 --- a/doc/latex/namespacebritney.tex +++ /dev/null @@ -1,9 +0,0 @@ -\section{Package britney} -\label{namespacebritney}\index{britney@{britney}} - - -\subsection*{Classes} -\begin{CompactItemize} -\item -class \bf{Britney} -\end{CompactItemize} diff --git a/doc/latex/namespaceexcuse.tex b/doc/latex/namespaceexcuse.tex deleted file mode 100644 index 4d878c0..0000000 --- a/doc/latex/namespaceexcuse.tex +++ /dev/null @@ -1,9 +0,0 @@ -\section{Package excuse} -\label{namespaceexcuse}\index{excuse@{excuse}} - - -\subsection*{Classes} -\begin{CompactItemize} -\item -class \bf{Excuse} -\end{CompactItemize} diff --git a/doc/latex/namespaces.tex b/doc/latex/namespaces.tex deleted file mode 100644 index 1bf85c5..0000000 --- a/doc/latex/namespaces.tex +++ /dev/null @@ -1,5 +0,0 @@ -\section{briteny Package List} -Here are the packages with brief descriptions (if available):\begin{CompactList} -\item\contentsline{section}{\bf{britney} }{\pageref{namespacebritney}}{} -\item\contentsline{section}{\bf{excuse} }{\pageref{namespaceexcuse}}{} -\end{CompactList} diff --git a/doc/latex/refman.tex b/doc/latex/refman.tex deleted file mode 100644 index eacbe7f..0000000 --- a/doc/latex/refman.tex +++ /dev/null @@ -1,41 +0,0 @@ -\documentclass[a4paper]{book} -\usepackage{a4wide} -\usepackage{makeidx} -\usepackage{fancyhdr} -\usepackage{graphicx} -\usepackage{multicol} -\usepackage{float} -\usepackage{textcomp} -\usepackage{alltt} -\usepackage{doxygen} -\makeindex -\setcounter{tocdepth}{1} -\renewcommand{\footrulewidth}{0.4pt} -\begin{document} -\begin{titlepage} -\vspace*{7cm} -\begin{center} -{\Large briteny Reference Manual\\[1ex]\large 2.0.alpha1 }\\ -\vspace*{1cm} -{\large Generated by Doxygen 1.4.7}\\ -\vspace*{0.5cm} -{\small Fri Aug 18 23:23:25 2006}\\ -\end{center} -\end{titlepage} -\clearemptydoublepage -\pagenumbering{roman} -\tableofcontents -\clearemptydoublepage -\pagenumbering{arabic} -\chapter{briteny Namespace Index} -\input{namespaces} -\chapter{briteny Class Index} -\input{annotated} -\chapter{briteny Namespace Documentation} -\input{namespacebritney} -\include{namespaceexcuse} -\chapter{briteny Class Documentation} -\input{classbritney_1_1Britney} -\include{classexcuse_1_1Excuse} -\printindex -\end{document}