Forum > Documentation (Maintaining -)
doc (CHM) snapshot updated 2021-04-11
marcov:
The last two months were very busy on the fpdoc front, so better have a new topic.
I did another beta build of the (chm) docs. It uses lazarus trunk and fpc 3.2.1 compiled with fpc trunk fpdoc.
http://www.stack.nl/~marcov/doc-chmbeta.zip
The lazutils file is back up to size. The ref.chm still has mutilated accents it seems, despite my quick fix.
Andrey Sobol:
Thanks, I think this is the best version at last time :)
Also, we can do better that :)
That is a quick analize of a log.
#########################
--- Code: Pascal [+][-]window.onload = function(){var x1 = document.getElementById("main_content_section"); if (x1) { var x = document.getElementsByClassName("geshi");for (var i = 0; i < x.length; i++) { x[i].style.maxHeight='none'; x[i].style.height = Math.min(x[i].clientHeight+15,306)+'px'; x[i].style.resize = "vertical";}};} ---rtlUnresolved links: 203fclUnresolved links: 603fcl-resUnresolved links: 165laz-utilsUnresolved links: 15lclUnresolved links: 365 At first you should enable a new option for fpdoc.
The option is "--fallback-seealso-links" - Simplify seealso links by exluding last link level for see also.
For a build_lcl_docs, that option is activated as the "--arg --fallback-seealso-links"
That will reduce the count of the unresolved links at several times. And we will see wrong descriptions links only.
For lcl package I have got only 13 unresolved links with that option.
--- Code: Pascal [+][-]window.onload = function(){var x1 = document.getElementById("main_content_section"); if (x1) { var x = document.getElementsByClassName("geshi");for (var i = 0; i < x.length; i++) { x[i].style.maxHeight='none'; x[i].style.height = Math.min(x[i].clientHeight+15,306)+'px'; x[i].style.resize = "vertical";}};} ---Warning: Target ID of <link> in unit "unicodedata", element "#rtl.unicodedata.TUInt24Rec.implicit(TUInt24Rec):Word", is unknown:
- I think that it is unresolved by FPDoc or the fpc-src - construction implicit(TUInt24Rec).
--- Code: Pascal [+][-]window.onload = function(){var x1 = document.getElementById("main_content_section"); if (x1) { var x = document.getElementsByClassName("geshi");for (var i = 0; i < x.length; i++) { x[i].style.maxHeight='none'; x[i].style.height = Math.min(x[i].clientHeight+15,306)+'px'; x[i].style.resize = "vertical";}};} ---Warning: Target ID of <link> in unit "?", element "How to implement a new resource class", is unknown: "resource.TAbstractResource.SetDescOwner"Warning: Target ID of <link> in unit "?", element "How to implement a new resource class", is unknown: "resource.TAbstractResource.ChangeDescTypeAllowed"Warning: Target ID of <link> in unit "?", element "How to implement a new resource reader", is unknown: "resource.TAbstractResourceReader.GetDescription"Warning: Target ID of <link> in unit "?", element "How to implement a new resource reader", is unknown: "resource.TAbstractResourceReader.CheckMagic"Warning: Target ID of <link> in unit "?", element "How to implement a new resource reader", is unknown: "resource.TAbstractResourceReader.Load" #fcl-res.machowriter.EMachOResourceWriterSymbolTableWrongOrderExceptionWarning: Target ID of <link> in unit "?", element "Introduction", is unknown: "Basic Usage"Warning: Target ID of <link> in unit "?", element "Basic Usage", is unknown: "resource.TResources"
- I don`t know what that is. I think a wrong structure of the documentation xml.
--- Code: Pascal [+][-]window.onload = function(){var x1 = document.getElementById("main_content_section"); if (x1) { var x = document.getElementsByClassName("geshi");for (var i = 0; i < x.length; i++) { x[i].style.maxHeight='none'; x[i].style.height = Math.min(x[i].clientHeight+15,306)+'px'; x[i].style.resize = "vertical";}};} ---ERROR Tree Class information: #fcl.streamex.TStreamHelper
- Not exist a tree class information for the helpers. A Class tree is not displayed for helpers. That is my todo.
Andrey Sobol:
A description to this buld.
2020-01-21 build
1. Resolved specialize class objects. You can see that into lazutils.chm, unit lazListClasses.
2. Building a class tree with the specialize class objects.
2020-01-20 build
1. Fixed seealso links of the unit Dbactions.
2. Fixed the lazlistclasses`s parse process - Generic classes.
2020-01-17 build - need to enable the "--arg --fallback-seealso-links" option
1. Fix ResolveLinkID(). After that unresolved links count (for seeAlso) was reduced from < 500 to 349 for the lcl. Was resolved the links of first level for unit without UnitName prefix (classes and procedure without unitName prefix).
2. Wrote an addtional procedure ResolveLinkIDUnStrict() as a second stage resolving ResolveLinkID() for seeAlso links only. Excluded last token (fields for classes and types) After that unresolved links count was reduced from 349 to 24 for the lcl.
3. Only 13 unresolved links exists now for the lcl after fixing rests by hand.
2020-01-12 build - this patch is not applied yet.
1. Fix footer information
2. Fix a menu style.
2020-01-10
1. chm`s - At branch TOC "Classes and objects, by unit" are clickable now.
marcov:
--- Quote from: Andrey Sobol on January 30, 2021, 07:29:36 pm --- The option is "--fallback-seealso-links" - Simplify seealso links by exluding last link level for see also.
For a build_lcl_docs, that option is activated as the "--arg --fallback-seealso-links"
--- End quote ---
Hmm, that is potentially dangerous, since that could mean #rtl.classes.nonexistingsymbol could be come #rtl.classes without much warning?
I don't like that as default solution
Andrey Sobol:
--- Quote ---Hmm, that is potentially dangerous, since that could mean #rtl.classes.nonexistingsymbol could be come #rtl.classes without much warning?
I don't like that as default solution
--- End quote ---
Very often Users:
1. set the link to protected fields or private fields (those pages sometimes is not included inside a documentation). I`ll get link to class
2. set links to parameters of methods or procedures (those pages not exist). I`ll get link to the method or procedure.
3. That option is valid only for the seealso links (user defined).
4. That is second stage of resolving links (links was unresolved by a general procedure).
Any way on the beta build process, I would like to see only critical errors. The log file is a huge now, I can`t see noting usefull.
Also the warnings about that:
--- Quote ---No documentation node found for identifier : #fcl.Zipper.INFOZIP_UNICODE_PATH_ID
No documentation node found for identifier : #fcl.Zipper.EFS_LANGUAGE_ENCODING_FLAG
--- End quote ---
is political position. I would see better the unresolved links only instead.
We have more than 1000 unresolved links now. Into laz-utils I have found mistakes only with that option enabled.
Navigation
[0] Message Index
[#] Next page