;ò Ÿ’UBc@sÎdZdkZdkZdkZdkZdkZdklZdkl Z dk l Z dk l Z dklZdkZdefd„ƒYZdkZdkZdkZd efd „ƒYZd ZdS( sè Main distutils extensions for generating documentation Copyright 2005 Fourthought, Inc. (USA). Detailed license and copyright information: http://4suite.org/COPYRIGHT Project home, documentation, distributions: http://4suite.org/ N(sCommand(s newer_group(s copy_file(sDistutilsFileError(s convert_paths BuildDocscBsqtZdZdZdddfdddfgZdgZd „Zd „Zd „Zd „Z d „Z d„Z RS(Ns build_docssbuild documentation filess build-dir=sds"directory to "build" (generate) tosforcesfs2forcibly build everything (ignore file timestamps)cCsPt|_t|_t|_t|_t|_t|_t|_g|_ dSdS(N( sNonesselfs build_dirs build_libsdebugsforcesxml_dirshtml_dirstext_dirsoutfiles(sself((sS/mnt/gmirror/ports/textproc/py-4suite/work/4Suite-1.0b1/Ft/Lib/DistExt/BuildDocs.pysinitialize_options"s        cCs |idddfddfddfddfƒtii|idƒ|_tii|idƒ|_tii|id ƒ|_|i i pg|_ dSdS( Nsbuilds build_docss build_dirs build_libsdebugsforcesxmlshtmlstext( sselfsset_undefined_optionssosspathsjoins build_dirsxml_dirshtml_dirstext_dirs distributions doc_filessdocs(sself((sS/mnt/gmirror/ports/textproc/py-4suite/work/4Suite-1.0b1/Ft/Lib/DistExt/BuildDocs.pysfinalize_options.s     cCsB|iii|iƒ od|_|iƒ|`n|iSdS(Ni(sselfs distributionshave_runsgets command_namesdry_runsrunsoutfiles(sself((sS/mnt/gmirror/ports/textproc/py-4suite/work/4Suite-1.0b1/Ft/Lib/DistExt/BuildDocs.pys get_outputs;s    cCsDtd„|iƒ}g}x|D]}|i|iƒq"W|SdS(NcCst|tiƒS(N(s isinstancesxs StructuressDocument(sx((sS/mnt/gmirror/ports/textproc/py-4suite/work/4Suite-1.0b1/Ft/Lib/DistExt/BuildDocs.pysDs(sfiltersselfsdocss filenamessdocumentsappendssource(sselfsdocssdocuments filenames((sS/mnt/gmirror/ports/textproc/py-4suite/work/4Suite-1.0b1/Ft/Lib/DistExt/BuildDocs.pysget_source_filesBs c Cs€| ogSn|i|ƒ}|iƒ}t||ƒ}t |ƒt t i ƒ}gi }|D]}|||ƒqa~SdS(N(shas_anysselfsget_finalized_commands build_cmds get_outputss build_filessgetattrs cmd_options build_dirslensossseps prefix_lensappends_[1]sfname( sselfshas_anys build_cmds cmd_optionsfnames build_dirs_[1]s build_filess prefix_len((sS/mnt/gmirror/ports/textproc/py-4suite/work/4Suite-1.0b1/Ft/Lib/DistExt/BuildDocs.pys _get_modulesJs c Cs9tidjo|iodSng} |iiƒo3|idƒ|idƒ}| i |i ƒƒn|ii ƒo3|idƒ|idƒ}| i |i ƒƒn|iiƒo|idƒn|iipg}gi}|D]'} t| tiƒo|| ƒqðqð~}td„|iƒ}tidƒ}tidƒ} t|dƒ}|id ƒ|id |iƒ|id ƒ|id ƒ|id t ƒ|iddi!t"t#| ƒƒƒ|iddi!t"t#|ƒƒƒ|iddi!t"t#|ƒƒƒ|idt$|ii%ƒƒ|idƒ|id|i|i&|i'|i(|i)|i*|i+|i,fƒ|idƒ|id| ƒ|idƒ|idƒ|i-ƒziti.ti/t0i1t0i1|gƒyt| ƒi2ƒ}Wn|i4dƒnX|i5i t6|ƒƒWdXdSdS(Nsntsbuild_pys build_exts build_l10ncCst|tiƒS(N(s isinstancesxs StructuressDocument(sx((sS/mnt/gmirror/ports/textproc/py-4suite/work/4Suite-1.0b1/Ft/Lib/DistExt/BuildDocs.pyssss.pys.outsws import sys ssys.path.insert(0, %r) s(from distutils.dist import Distribution s(from Ft.Lib.DistExt.Structures import * s!from %s import ExternalBuildDocs smodules = [%s] s, sscripts = [%s] s docs = [%s] s attrs = %r sdist = Distribution(attrs) sVcmd = ExternalBuildDocs(dist, modules, scripts, docs, %r, %r, %r, %r, %r, %r, %r, %r) s cmd.run() sfile = open(%r, "w") s$file.write(repr(cmd.get_outputs())) s file.close() sfailure during documenting(7sossnamesselfsdebugsmoduless distributionshas_pure_moduless run_commandsget_finalized_commandsbuild_pysextends get_outputsshas_ext_moduless build_extshas_l10nsscriptssappends_[1]sxs isinstances StructuressScriptsfiltersdocsstempfilesmktemps script_names outputs_namesopensscriptswrites build_libs__name__sjoinsmapsreprsvarssmetadatas build_dirsxml_dirshtml_dirstext_dirsforcesverbosesdry_runsclosesspawnvsP_WAITssyss executablesreadsoutputsswarnsoutfilesseval( sselfs script_names build_exts_[1]sbuild_pysscriptsoutputssdocssscriptss outputs_namesmodulessx((sS/mnt/gmirror/ports/textproc/py-4suite/work/4Suite-1.0b1/Ft/Lib/DistExt/BuildDocs.pysrunVsZ  >   ### A    "( s__name__s __module__s command_names descriptions user_optionssboolean_optionssinitialize_optionssfinalize_optionss get_outputssget_source_filess _get_modulessrun(((sS/mnt/gmirror/ports/textproc/py-4suite/work/4Suite-1.0b1/Ft/Lib/DistExt/BuildDocs.pys BuildDocss    sExternalBuildDocscBs†tZdZd„Zd„Zd„Zed„Zd„Zd„Z d„Z d „Z d „Z d „Z d „Zd „Zd„ZRS(Ns build_docsc Cs´||_||_||_||_||_||_||_||_ | |_ | |_ | |_ ydk l} Wntj onX| i|i ƒ| |_g|_dSdS(N(slog(sdistsselfs distributionsmodulessscriptssdocss build_libs build_dirsxml_dirshtml_dirstext_dirsforcesverboses distutilsslogs ImportErrors set_verbositysdry_runsoutfiles(sselfsdistsmodulessscriptssdocss build_libs build_dirsxml_dirshtml_dirstext_dirsforcesverbosesdry_runslog((sS/mnt/gmirror/ports/textproc/py-4suite/work/4Suite-1.0b1/Ft/Lib/DistExt/BuildDocs.pys__init__²s&             cCs |iSdS(N(sselfsoutfiles(sself((sS/mnt/gmirror/ports/textproc/py-4suite/work/4Suite-1.0b1/Ft/Lib/DistExt/BuildDocs.pys get_outputsÉscCs²hdg<dg<dg<}xŽ|iD]ƒ}h}t|iƒ}|io t|iƒ}||d %sisencodings iso-8859-1swbsnot documenting %s (up-to-date)isFt/Data/%s_html.xsltscategory("ssourcessappendsinspects getmodules formatters __class__s__file__sosspathsjoinsselfsxml_dirscategorysnamesxmlfileshtml_dirshtmlfilestext_dirstextfilesoutfilessmkpathsdirnamesforces newer_groupsannouncesdry_runsdocumentsobjectsxmlsopenswritesdocss StructuressDocument( sselfscategorysnamessourcessobjects formattersxmlsxmlfileshtmlfilestextfile((sS/mnt/gmirror/ports/textproc/py-4suite/work/4Suite-1.0b1/Ft/Lib/DistExt/BuildDocs.pysdocument$s$   c CsR|\}}}hd|<d|<d|<d|<}||i|ƒdSdS(Nsnamesxmlshtmlstext(sxmlshtmlstextsnamesinfosindexscategorysappend( sselfsindexscategorysnames.8sxmlshtmlstextsinfo((sS/mnt/gmirror/ports/textproc/py-4suite/work/4Suite-1.0b1/Ft/Lib/DistExt/BuildDocs.pysadd_index_infoCs*cCsøh} t|iƒttiƒ}xy|iD]n} ti i | |ƒd} ti i | ƒdjoti i | ƒ} n| itidƒ} | | | ‡sN(s FormatterssExtensionFormattersselfsextdocscategorysfilters extensionsspkgssignoredsnamessourcesmodulesosspathsdirnames package_dirsbasenames package_fileslistdirsfilesappendsjoinsdocumentsfilessadd_index_infosindex(sselfs extensionssindexscategorysnamesignoredsExtensionFormattersmodulessourcespkgssfilesextdocs package_filesfiless package_dir((sS/mnt/gmirror/ports/textproc/py-4suite/work/4Suite-1.0b1/Ft/Lib/DistExt/BuildDocs.pysdoc_extensions}s(  ( cCsdkl}|i|ƒ} d}xé|iD]Þ}|i}|it |dt ƒ|ƒ} | t joq,nt | |i ƒƒ} | ig} xH| iƒD]:\} }t|iihhdgƒ}| i|iƒq›W|i||| | | ƒ}|i||||ƒq,WdSdS(N(sCommandLineFormatters commandlinesmodules*(s FormatterssCommandLineFormattersselfs cmdlinedocscategorysscriptssscriptsnameslocatesgetattrsNonesmodules identifiersapps__file__ssourcessget_help_doc_infoscmd_namescmds __import__s __class__s __module__sclassmodsappendsdocumentsfilessadd_index_infosindex(sselfsindexscategorysCommandLineFormattersfilessnamesscriptscmdsclassmodsmodulessourcesscmd_namesapps cmdlinedoc((sS/mnt/gmirror/ports/textproc/py-4suite/work/4Suite-1.0b1/Ft/Lib/DistExt/BuildDocs.pys doc_scripts–s$      cCs0t|iƒ}|io t|iƒ}|itj outii|i |t|iƒƒ}|i |tii|i |tii|ƒƒ|i|iƒ|ii|ƒn|ioutii|i|t|iƒƒ}|i |tii|i |tii|ƒƒ|i|iƒ|ii|ƒndS(N(s convert_pathsdocssourcesoutdirs htmlOutfilesNonesosspathsjoinsselfshtml_dirsoutfiles render_onesxml_dirsbasenameshtmlStylesheetssparamssoutfilessappends textOutfilestext_dirstextStylesheets(sselfsdocsoutfilessourcesoutdir((sS/mnt/gmirror/ports/textproc/py-4suite/work/4Suite-1.0b1/Ft/Lib/DistExt/BuildDocs.pys render_doc°s $ $  $ $ cCs\dkl} dkl}dkl} |iti i |ƒƒ|i o{|g}x>|D]6}t|ƒ}ti i|ƒo|i|ƒq[q[Wt||ƒ o|id|dƒdSqÆn|id||fdƒ|i om| iƒ}d} xš|D]’}t|ƒ}ti i|ƒog| i|dtƒ} y#|ii| ƒ}|i|ƒWq–t j o} t"d || f‚q–Xqd } qWt#|d ƒ}| i|dtƒ} hd |i%i&ƒ<}|i(|ƒy/|ii| ƒ}|i)|| |d |ƒWn(t j o} t"d|| f‚nX|i*dƒ|i+ƒndS(N(s Processor(s InputSource(sUrisnot rendering %s (up-to-date)isrendering %s -> %sisattemptAbsolutes!could not use stylesheet '%s': %siswsversions outputStreamscould not render '%s': %ss (,s Ft.Xml.Xslts ProcessorsFt.Xmls InputSourcesFt.LibsUrisselfsmkpathsosspathsdirnamesoutfilesforcessourcessourcess stylesheetssfiles convert_pathsexistssappends newer_groupsannouncesdry_runs processors ignorePiss OsPathToUrisTruesurlsDefaultFactorysfromUrisiSrcsappendStylesheets ExceptionsexcsDistutilsFileErrorsopensstreams distributions get_versionsparamssupdatesrunswritesclose(sselfsoutfilessources stylesheetssparamssstreamssourcessfiles InputSources ignorePissUris ProcessorsexcsurlsiSrcs processor((sS/mnt/gmirror/ports/textproc/py-4suite/work/4Suite-1.0b1/Ft/Lib/DistExt/BuildDocs.pys render_oneÄsP             c Cstii|idƒ}|ii|ƒ|id|dƒt |i ƒ} x¸|i ƒD]ª\} }x›|D]“}xŠ|i ƒD]|\}}|i|i ƒo]d|| ||<|dddgjo tidjo!||itidƒ|| %sis..shtmlsxmlstexts/swbs%s Documentation Indexs s%s s

%s

s
%s
cCsñ| odSn|id„ƒ|d|ƒ|dƒt|ƒdd}xt|ƒD]‚}|dƒxet||d|ƒD]M}|dƒ|t|ƒjo|d||ƒn |d ƒ|d ƒq€W|d ƒqYW|d ƒdSdS( NcCst|d|dƒS(Nsname(scmpsasb(sasb((sS/mnt/gmirror/ports/textproc/py-4suite/work/4Suite-1.0b1/Ft/Lib/DistExt/BuildDocs.pysss

%s

s iis s! s s
s%(name)ss s
( slist_ssortswritestitleslensrowssrangesrowsi(stitleslist_swritesrowssisrow((sS/mnt/gmirror/ports/textproc/py-4suite/work/4Suite-1.0b1/Ft/Lib/DistExt/BuildDocs.pyssections&      sGeneralcCs |idƒS(Nshtml(sxshas_key(sx((sS/mnt/gmirror/ports/textproc/py-4suite/work/4Suite-1.0b1/Ft/Lib/DistExt/BuildDocs.pys&ssgeneralsModulessmodulessXPath/XSLT Extensionss extensionssCommand-line Applicationss commandlines (!sosspathsjoinsselfshtml_dirshtmlfilesoutfilessappendsannounceslens build_dirs prefix_lensindexsitemsssectionsinfossinfoskeysvalues startswithssepsreplacesdry_runsopensfs distributionsmetadatas get_fullnamestitleswritesPREAMBLEsfiltersclose( sselfsindexsinfosfshtmlfilestitlesinfossvalueskeys prefix_lenssection((sS/mnt/gmirror/ports/textproc/py-4suite/work/4Suite-1.0b1/Ft/Lib/DistExt/BuildDocs.pysbuild_html_indexúsB  &1   c sÆdkl‰tii|idƒ}|ii |ƒ|i d|dƒt |iƒ} x|iƒD]s\} }xd|D]\}xS|iƒD]E\} }| dgjo|i|iƒo|| d|| %sisxmliswbs%s Document Indexsb
%s Generated by build_docs csµ| odSn|id„ƒ|d|ƒ|dƒx^|D]V}|d}|d}ˆi|dt ƒ}ˆi |ƒd}|d||fƒq?W|d ƒ|d ƒdSdS( NcCst|d|dƒS(Nsname(scmpsasb(sasb((sS/mnt/gmirror/ports/textproc/py-4suite/work/4Suite-1.0b1/Ft/Lib/DistExt/BuildDocs.pysRss
%s s snamesxmlsattemptAbsoluteisN %s%s s s
( slistssortswritestitlesitemsnames xmlospathsUris OsPathToUrisFalsesxmluris SplitUriRefs xmluripath(stitleslistswritesnamesitems xmluripaths xmlospathsxmluri(sUri(sS/mnt/gmirror/ports/textproc/py-4suite/work/4Suite-1.0b1/Ft/Lib/DistExt/BuildDocs.pyssectionOs     sGeneralcCs |idƒS(Nshtml(sxshas_key(sx((sS/mnt/gmirror/ports/textproc/py-4suite/work/4Suite-1.0b1/Ft/Lib/DistExt/BuildDocs.pysassgeneralsModulessmodulessXPath/XSLT Extensionss extensionssCommand-line Applicationss commandlines
(sFt.LibsUrisosspathsjoinsselfsxml_dirsxmlfilesoutfilessappendsannounceslens prefix_lensindexsitemsssectionsinfossinfoskeysvalues startswithsdry_runsopensfs distributionsmetadatas get_fullnamestitleswritesfiltersclose( sselfsindexsinfosxmlfilesfstitlesinfossUrisvalueskeys prefix_lenssection((sUrisS/mnt/gmirror/ports/textproc/py-4suite/work/4Suite-1.0b1/Ft/Lib/DistExt/BuildDocs.pysbuild_xml_index1s:   #"   (s__name__s __module__s command_names__init__s get_outputssrunsNoneslocatesdocumentsadd_index_infos doc_modulessdoc_extensionss doc_scriptss render_docs render_onesbuild_html_indexsbuild_xml_index(((sS/mnt/gmirror/ports/textproc/py-4suite/work/4Suite-1.0b1/Ft/Lib/DistExt/BuildDocs.pysExternalBuildDocs®s   N  1    6 7s

Copyright 2001-2005 Fourthought, Inc., USA. Please read the COPYRIGHT file for terms of license.

For release notes and news, see the 4Suite home page (http://4suite.org/).

For complete installation instructions, see the following documents listed in the "General" section below: Installing 4Suite on UNIX/Windows, and 4Suite CVS access.

If you have questions not answered by the documents, first stop is the FAQ. Next try the Akara pages on Python/XML and 4Suite. Then check the mailing archives of the 4Suite list or post there. Or drop by on IRC (#4suite on irc.freenode.net).

People interested in participating in or closely following the development process of 4Suite can join the mailing list for core 4Suite developers, which is open (as are its archives).

These links and others are also provided on Uche Ogbuji's 4Suite page.

(s__doc__ssyssossimps cStringIOstempfilesdistutils.coresCommandsdistutils.dep_utils newer_groupsdistutils.file_utils copy_filesdistutils.errorssDistutilsFileErrorsdistutils.utils convert_paths Structuress BuildDocsspydocsinspectsExternalBuildDocssPREAMBLE(s cStringIOs StructuressDistutilsFileErrors convert_pathstempfiles newer_groupsinspectspydocsExternalBuildDocsssyssimpsCommandsPREAMBLEs copy_files BuildDocssos((sS/mnt/gmirror/ports/textproc/py-4suite/work/4Suite-1.0b1/Ft/Lib/DistExt/BuildDocs.pys? s-      ˜ÿ¿