Index: trunk/doc/user/06_features/hierarchic/index.html =================================================================== --- trunk/doc/user/06_features/hierarchic/index.html (revision 10261) +++ trunk/doc/user/06_features/hierarchic/index.html (revision 10262) @@ -349,6 +349,14 @@ file with a matching name. The name is either in the form of "foo.rs" or just "foo" (sch-rnd automatically macthes the .rs or .lht endings).

+Example project: +50_hlibrary is +a modified copy if the 20_led example; led.rs is the same child sheet, +referenced as cschem/child/name=led from main.rs +S1 and S2. The file lives in ./hlibrary/, which is a preconfigured standard +hlibrary search path. The file is searched and picked up upon the first +compilation. +

Sheets loaded this way are not added to the project file and are listed as [E] (for external) sheets in the sheet selector. This is a clear indication that the sheet is not listed in the project file and is automatically @@ -368,7 +376,18 @@ The path must be relative to the parent sheet's path on thefile system. The sheet is automatically loaded as an external sheet during compilation.

-This method can not be used to address hlibrary child sheets because of +Example project: +52_path is +a modified copy if the 20_led example; led.rs is the same child sheet, +referenced as cschem/child/path=my_lib/led.rs from main.rs +S1 and S2. The file lives in ./my_lib/, which is not on +hlibrary search path, thus the file is not searched. It is picked up +by a direct file system lookup, using path ./my_lib/led.rs +relative to main.rs. Note: since there is no search, there is also +no file name matching, thus in the path addressing method the exact +file name must be specified, the .rs ending can not be left off. +

+This method can not be used to address central hlibrary child sheets because of the relative addressing in the file system. It is useful for large projects with a local system of child sheets with redundant names, sorted into subdirectories. In that case the designer may wish to explicitly refer to