From fba4094bdc89569883c5a64ac9c635807b1ae643 Mon Sep 17 00:00:00 2001 From: Thomas Nagy Date: Sun, 16 Nov 2014 22:30:54 +0100 Subject: [PATCH] No more dia diagrams! --- docs/book/architecture.txt | 4 +- docs/book/classes_build.dia | 4058 ---------------------------------- docs/book/classes_build.semd | Bin 0 -> 1750 bytes docs/book/tasks.txt | 2 +- docs/book/tasks_actors.dia | 533 ----- docs/book/tasks_actors.semd | Bin 0 -> 804 bytes 6 files changed, 3 insertions(+), 4594 deletions(-) delete mode 100644 docs/book/classes_build.dia create mode 100644 docs/book/classes_build.semd delete mode 100644 docs/book/tasks_actors.dia create mode 100644 docs/book/tasks_actors.semd diff --git a/docs/book/architecture.txt b/docs/book/architecture.txt index 0973e8ca..1a9306e6 100644 --- a/docs/book/architecture.txt +++ b/docs/book/architecture.txt @@ -50,7 +50,7 @@ class somename(Context): fun = 'foo' --------------- -image::classes{PIC}["Context classes"{backend@docbook:,width=1000:},align="center"] +image::classes{PIC}["Context classes"{backend@docbook:,width=850:},align="center"] ==== Build classes @@ -62,7 +62,7 @@ The 'Parallel' object encapsulates the iteration over all tasks of the build con The overall structure is represented on the following diagram: -image::classes_build{PIC}["Build classes"{backend@docbook:,width=1000:},align="center"] +image::classes_build{PIC}["Build classes"{backend@docbook:,width=1100:},align="center"] === Context objects diff --git a/docs/book/classes_build.dia b/docs/book/classes_build.dia deleted file mode 100644 index c444ad95..00000000 --- a/docs/book/classes_build.dia +++ /dev/null @@ -1,4058 +0,0 @@ - - - - - - - - - - - - - #A4# - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - #BuildContext# - - - ## - - - ## - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - #groups# - - - #task_gen# - - - ## - - - ## - - - - - - - - - - - - - - #env# - - - #ConfigSet# - - - ## - - - ## - - - - - - - - - - - - - - - - #store# - - - ## - - - #void# - - - - - - ## - - - - - - - - - - - - - - - - - #filename# - - - ## - - - ## - - - ## - - - - - - - - - - #load# - - - ## - - - #void# - - - - - - ## - - - - - - - - - - - - - - - - - #filename# - - - ## - - - ## - - - ## - - - - - - - - - - #install_files# - - - ## - - - #void# - - - - - - ## - - - - - - - - - - - - - - - - - - #install_as# - - - ## - - - #void# - - - - - - ## - - - - - - - - - - - - - - - - - - #symlink_as# - - - ## - - - ## - - - - - - ## - - - - - - - - - - - - - - - - - - #init_dirs# - - - ## - - - #void# - - - - - - ## - - - - - - - - - - - - - - - - - - #get_tgen_by_name# - - - ## - - - #task_gen# - - - - - - ## - - - - - - - - - - - - - - - - - #name# - - - #string# - - - ## - - - ## - - - - - - - - - - #add_group# - - - ## - - - #void# - - - - - - ## - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - #ConfigSet# - - - ## - - - ## - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - #parent# - - - #Environment# - - - ## - - - ## - - - - - - - - - - - - - - #table# - - - #dict# - - - ## - - - ## - - - - - - - - - - - - - - - - #derive# - - - ## - - - #Environment# - - - - - - ## - - - - - - - - - - - - - - - - - - #store# - - - ## - - - #void# - - - - - - ## - - - - - - - - - - - - - - - - - #filename# - - - ## - - - ## - - - ## - - - - - - - - - - #load# - - - ## - - - #void# - - - - - - ## - - - - - - - - - - - - - - - - - - #append_value# - - - ## - - - ## - - - - - - ## - - - - - - - - - - - - - - - - - #var# - - - #string# - - - ## - - - ## - - - - - - - - #val# - - - #string# - - - ## - - - ## - - - - - - - - - - #append_unique# - - - ## - - - ## - - - - - - ## - - - - - - - - - - - - - - - - - #var# - - - #string# - - - ## - - - ## - - - - - - - - #val# - - - #string# - - - ## - - - ## - - - - - - - - - - #prepend_value# - - - ## - - - ## - - - - - - ## - - - - - - - - - - - - - - - - - #var# - - - #string# - - - ## - - - ## - - - - - - - - #val# - - - #string# - - - ## - - - ## - - - - - - - - - - #__getitem__# - - - ## - - - #object# - - - - - - ## - - - - - - - - - - - - - - - - - #variable# - - - ## - - - ## - - - ## - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - #task_gen# - - - ## - - - ## - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - #tasks# - - - #TaskBase# - - - ## - - - ## - - - - - - - - - - - - - - - - #get_name# - - - ## - - - #void# - - - - - - ## - - - - - - - - - - - - - - - - - - #post# - - - ## - - - #void# - - - - - - ## - - - - - - - - - - - - - - - - - - #apply# - - - ## - - - #void# - - - - - - ## - - - - - - - - - - - - - - - - - - #create_task# - - - ## - - - #TaskBase# - - - - - - ## - - - - - - - - - - - - - - - - - #name# - - - #string# - - - ## - - - ## - - - - - - - - - - #clone# - - - ## - - - #task_gen# - - - - - - ## - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - #Parallel# - - - ## - - - ## - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - #bld# - - - #BuildContext# - - - ## - - - ## - - - - - - - - - - - - - - #numjobs# - - - #int# - - - ## - - - ## - - - - - - - - - - - - - - #maxjobs# - - - #int# - - - ## - - - ## - - - - - - - - - - - - - - #processed# - - - #int# - - - ## - - - ## - - - - - - - - - - - - - - #total# - - - #int# - - - ## - - - ## - - - - - - - - - - - - - - #count# - - - #int# - - - ## - - - ## - - - - - - - - - - - - - - #outstanding# - - - #List<TaskBase># - - - ## - - - ## - - - - - - - - - - - - - - #frozen# - - - #List<TaskBase># - - - ## - - - ## - - - - - - - - - - - - - - #out# - - - #Queue<TaskBase># - - - ## - - - ## - - - - - - - - - - - - - - #error# - - - #List<TaskBase># - - - ## - - - ## - - - - - - - - - - - - - - #stop# - - - #boolean# - - - ## - - - ## - - - - - - - - - - - - - - #biter# - - - #PyGenerator<TaskBase># - - - ## - - - ## - - - - - - - - - - - - - - - - #postpone# - - - ## - - - #void# - - - - - - ## - - - - - - - - - - - - - - - - - #TaskBase# - - - ## - - - ## - - - ## - - - - - - - - - - #get_next_task# - - - ## - - - #TaskBase# - - - - - - ## - - - - - - - - - - - - - - - - - - #refill_task_list# - - - ## - - - #void# - - - - - - ## - - - - - - - - - - - - - - - - - - #start# - - - ## - - - #void# - - - - - - ## - - - - - - - - - - - - - - - - - - #error_handler# - - - ## - - - #void# - - - - - - ## - - - - - - - - - - - - - - - - - #task# - - - #TaskBase# - - - ## - - - ## - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - #TaskConsumer# - - - ## - - - ## - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - #pool# - - - #List<TaskConsumer># - - - ## - - - ## - - - - - - - - - - - - - - #ready# - - - #Queue<Task># - - - ## - - - ## - - - - - - - - - - - - - - - - #run# - - - ## - - - #void# - - - - - - ## - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - #TaskBase# - - - ## - - - ## - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - #classes (static)# - - - #class# - - - ## - - - ## - - - - - - - - - - - - - - - - #run# - - - ## - - - #int# - - - - - - ## - - - - - - - - - - - - - - - - - - #runnable_status# - - - ## - - - #int# - - - - - - ## - - - - - - - - - - - - - - - - - - #post_run# - - - ## - - - #void# - - - - - - ## - - - - - - - - - - - - - - - - - - #unique_id# - - - ## - - - #int# - - - - - - ## - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - #Task# - - - ## - - - ## - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - #inputs# - - - #Node# - - - ## - - - ## - - - - - - - - - - - - - - #outputs# - - - #Node# - - - ## - - - ## - - - - - - - - - - - - - - #run_after# - - - #list<TaskBase># - - - ## - - - ## - - - - - - - - - - - - - - - - #unique_id# - - - ## - - - #int# - - - - - - ## - - - - - - - - - - - - - - - - - - #signature# - - - ## - - - #int# - - - - - - ## - - - - - - - - - - - - - - - - - - #sign_explicit_deps# - - - ## - - - #int# - - - - - - ## - - - - - - - - - - - - - - - - - - #sign_implicit_deps# - - - ## - - - #int# - - - - - - ## - - - - - - - - - - - - - - - - - - #sign_vars# - - - ## - - - #int# - - - - - - ## - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - #store_task_type# - - - #metaclass# - - - ## - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - ## - - - ## - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - #use# - - - ## - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - #use# - - - ## - - - - - - - - - - - - - - - - - - - - ## - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - ## - - - ## - - - - - - - - - - - - - - - - - - - - - - - - - - - #Node# - - - ## - - - ## - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - #name# - - - #string# - - - ## - - - ## - - - - - - - - - - - - - - #parent# - - - #Node# - - - ## - - - ## - - - - - - - - - - - - - - #sig# - - - #long# - - - ## - - - ## - - - - - - - - - - - - - - #children# - - - #dict<string, Node># - - - ## - - - ## - - - - - - - - - - - - - - #cache_abspath# - - - #string# - - - ## - - - ## - - - - - - - - - - - - - - #cache_isdir# - - - #boolean# - - - ## - - - ## - - - - - - - - - - - - - - - - #abspath# - - - ## - - - #string# - - - - - - ## - - - - - - - - - - - - - - - - - - #find_dir# - - - ## - - - #Node# - - - - - - ## - - - - - - - - - - - - - - - - - #path# - - - ## - - - ## - - - ## - - - - - - - - - - #find_resource# - - - ## - - - #Node# - - - - - - ## - - - - - - - - - - - - - - - - - #path# - - - ## - - - ## - - - ## - - - - - - - - - - #find_or_declare# - - - ## - - - #Node# - - - - - - ## - - - - - - - - - - - - - - - - - #path# - - - ## - - - ## - - - ## - - - - - - - - - - - - - - - - ## - - - - - - - - - - - - ## - - - ## - - - - - - - - - #children# - - - #0..n# - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - ## - - - - - - - - - - - - ## - - - ## - - - - - - - - - #parent# - - - #0..1# - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - ## - - - - - - - - - - - - #outputs# - - - #0..n# - - - - - - - - - ## - - - ## - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - ## - - - - - - - - - - - - #inputs# - - - #0..n# - - - - - - - - - ## - - - ## - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - ## - - - - - - - - - - - - ## - - - ## - - - - - - - - - #tasks# - - - #0..n# - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - ## - - - - - - - - - - - - ## - - - ## - - - - - - - - - #groups# - - - #0..n# - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - ## - - - - - - - - - - - - ## - - - ## - - - - - - - - - #env# - - - #1# - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - ## - - - - - - - - - - - - ## - - - ## - - - - - - - - - #env# - - - #1# - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - ## - - - - - - - - - - - - ## - - - ## - - - - - - - - - #env# - - - #1# - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - diff --git a/docs/book/classes_build.semd b/docs/book/classes_build.semd new file mode 100644 index 0000000000000000000000000000000000000000..45e9f47bfd71575f321f72122fcc4dbec21ce6c5 GIT binary patch literal 1750 zcmV;{1}XU;iwFp^6=_rg|6^=nb8}^LUt)D>Y-BETWo={t?OI!J+cp%=>-sAM6&O+= zX+%kuWjASoc6(cg4c+!C&=PI4)vYAu#QXI-BqdpP+C-_Pq}%ufu%si2hvz#Nl49Z_ ze|eLoCu70^1ir71fP>06{w2741KzhbgmGHr zS2lX-*cQp-BBA-}%C5vRwBNjbcF9SGb3s4to^)rj&ZqnxqDG8(uft;V7;d=phx;5S?y7iV1bo9MoLZW>Vq^upFxxs zS(M`ptbHfNt!z=SguqkJb=T z{?AbeY+qm50rUm}z}wmVJjP41!0;-##I~%B4hH!v-CL`;r3|&o-c~eC-hpLsrM1pN zM{Au(<3X$EO_W*}O?G;h@zN!((kmO=S8ORApJIbG0{imi^^FDtMv`lv_?oQ$i1 z=J0x&Mp6ks9aRM$seQi9puT(>t^E}dkyw#DT5MHDpUR)P^+7PmC(tM`{}jRfVYT8U ziB_zr%G1#zDZb3FL>FNU!cQxO)Mb6^9NPzlZ;dh7z7iltV zgUVriZv8^J_%Ri)n$Y-hC0_Mv|MH@3{LY%`H8t}$%pkW&TGvaju9vQ>>!n-QOXNO% zy_9*B!&xL*kzw}-9N%J21`oZw%03ng@B<9kL%4OxioZ#|b8FM_-fq38eVBd0Te+OW zjjCjB{a%r3kVt0)C)>I8xp#YgBinBxdskM~`~w}#1l*aPfFR^Nd1RLb7vq%a7+wr~k`gEa?{O(>fX>!4>z$O}SqRWKB<{2u=wJu0GQtkV5fs)*>*#UBf09_gHLO5PmuI?}v^_1bPeD?c6#xJVnXaTr`8yafM^Hy2-Hu7o>}{hzNMu3|}{ z*p91$6U^fEW7xq6FDe!ftLD}WSKO#!LT_FSwW{U)SG7GyvY|e8LYbXgX)#Ra;x$bZ zCO@$qtPdVk{`wXZbZd7jl+{5^g@dDax8z=gRHg}U7T)>_R)lhz?Ksc{WpneLL0zHjs>sF0-Cxl3xU7O3QuOp*I97-W`#TLO@nufhOkS+ z^e`CQBa>q4?-AioJ4DP{B9#0gNpYOB{l{{)=XOHg9md(`YBS)QbH6)3kOk|g`N1I( zDu8x_!L%I=)Qy^mi4*j9wsW+zgU52V+ZpcAFuo4I>}WM7l*i_u@m@bWF)%PNFfcGM sFfcGMFfcGMFfcGMFfcGMFfcGMFfcGMFfcGMF!-P1A13(--~dnn0MXuK8UO$Q literal 0 HcmV?d00001 diff --git a/docs/book/tasks.txt b/docs/book/tasks.txt index 5f62fe7b..a50be86a 100644 --- a/docs/book/tasks.txt +++ b/docs/book/tasks.txt @@ -9,7 +9,7 @@ This chapter provides a description of the task classes which are used during th The build context is only used to create the tasks and to return lists of tasks that may be executed in parallel. The scheduling is delegated to a task producer which lets task consumers to execute the tasks. The task producer keeps a record of the build state such as the amount of tasks processed or the errors. -image::tasks_actors{PIC}["Actors processing the tasks"{backend@docbook:,width=150:},align="center"] +image::tasks_actors{PIC}["Actors processing the tasks"{backend@docbook:,width=250:},align="center"] // To reduce the build time, it is interesting to take advantage of the hardware (multiple cpu cores) or of the environment (distributed builds). The amount of consumers is determined from the number of processors, or may be set manually by using the '-j' option: diff --git a/docs/book/tasks_actors.dia b/docs/book/tasks_actors.dia deleted file mode 100644 index 4d2efa4a..00000000 --- a/docs/book/tasks_actors.dia +++ /dev/null @@ -1,533 +0,0 @@ - - - - - - - - - - - - - #A4# - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - #BuildContext# - - - - - - - - - - - - - - - - - - - - ## - - - ## - - - - - ## - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - #Task Producer# - - - - - - - - - - - - - - - - - - - - ## - - - ## - - - - - ## - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - #Task consumer# - - - - - - - - - - - - - - - - - - - - ## - - - ## - - - - - ## - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - #Process a task# - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - #Get tasks to process# - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - #Task consumer n# - - - - - - - - - - - - - - - - - - - - ## - - - ## - - - - - ## - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - #Process a task# - - - - - - - - - - - - - - diff --git a/docs/book/tasks_actors.semd b/docs/book/tasks_actors.semd new file mode 100644 index 0000000000000000000000000000000000000000..3c0437db15923f6f2472619984d6a42064dd66ae GIT binary patch literal 804 zcmV+<1Ka!`iwFo27im-i|8!wxlR6lN0RNNmkoqoU_mDkX~we8oY83PT=26^U5!2x zAz+#$b_6^hlV}?EbLYollExzxjy?gc(nKQkE+Y5E{U?}T!|tO8Disra5#X~hK$PdA zV0^U*T3yb9>#Olx(VB40?sqGr;A;G3&Uh(MC32#zGe8BCW)Q7zT5V=)#Jep*Vs8} zo|wBE^|H#Ocm(;eGaw{q6ssq>DTpT4pJPjtM{Y0*+ziT8)EOr=$h|S{!M7B$ps?!1 z72e=yoLhHkF}R)5VR6C8N|HJ&g$el^{X>4Y=#FrOehMxoIGmi~Njgcx$?$`XpMw}h zwT5j_Xi(UzJMWUc6dRjwjB(Vb_-o6m;s(gT3eaW|oW>Ur#6mf+ z?#$`y%)HYaejM|(XZ}Go(!j2e7O0UTr%HA7rVi{@hcic?IQryu`s4`ui=O`0F}e^O zZ!}Fh*_Rz}cu@8+yt4zmNt*V&(>L=%&$~Cg4Ux9Jxbk*ZBh0~z!q7CXHJq^i&{<=+ zn(SEn^Y6Mx-+tlthVo45ZAGm$Mga4M)NcPkkG1T%NiWU2q8P5g+-|OEpA{`(9kd23 zN19&VnGh97p_$$`gUU|Z>nfAOD&u{X5spnEzD?z9UnP$ARL1e3GQvlw#Guk}^zt%M zme4;