Outdated parts of the tutorial

[bockthom]

While working on uptdating outdated parts of the woc tutorial (see PR #1), a number of questions came up that I am unable to answer myself. Could you please provide help in this regard? I will continuously add commits to my pull requests based on your suggestions here.

(1) Could somebody please explain to me what the different parameters for showCnt do? (1,2,3, etc.) For 3, the tutorial states "defines that raw output needs to be produced". But as also 1 is used in the tutorial and one might wonder what 2 does, it might be helpful to explain this as well.

worldofcode.org/docs/tutorial.md

Line 208 in 1164f50

[username@da0]~% echo 009d7b6da9c4419fe96ffd1fffb2ee61fa61532a | ~/lookup/showCnt commit 3

worldofcode.org/docs/tutorial.md

Line 248 in 1164f50

[username@da0]~% echo a8fe822f075fa3d159a203adfa40c3f59d6dd999 | ~/lookup/showCnt blob 1

If someone can provide me with an explaination, I'll add to the PR.

---

(2) Could somebody please let me know how to update the following comment:

worldofcode.org/docs/tutorial.md

Line 298 in 1164f50

- b = Blob (b2c map will become obsolete as of version U as one can get more info from b2tac)

---

(3) Should we add "k" to the following list of variables? It seems to be used somewhere, but I have no idea what it is...

worldofcode.org/docs/tutorial.md

Lines 297 to 303 in 1164f50

	- a = Author (A - aliased author)
	- b = Blob (b2c map will become obsolete as of version U as one can get more info from b2tac)
	- c = Commit, cc - child commit and pc - parent commit
	- f = File (occasionally its an adjective modifying the following object as in fa or First Author)
	- p = Project (P - deforked project)
	- t = Time (unix unsigned long in UTC)
	- g = gender

---

(4) b2tac does not exist any more. But I am unsure how to replace the following example easily without using b2tac:

worldofcode.org/docs/tutorial.md

Lines 325 to 353 in 1164f50

	Going back to blob we may ask if this blob has been widely copied as would be expected for copyright files. We can use b2tac to obtain a sha1's blob to time, author, and commit. The following example pipes the output to only see the first entry:
	```bash
	[username@da0]~% echo a8fe822f075fa3d159a203adfa40c3f59d6dd999 | ~/lookup/getValues b2tac | cut -d ";" -f1-4
	a8fe822f075fa3d159a203adfa40c3f59d6dd999;1072910122;Warner Losh <imp@FreeBSD.org>;121f970412fec7f9af0352a9b4ce8dca43bdb59e
	```
	b2tac (blob to time, author, commit) shows the numerous commits that introduced that blob in all repositories. We can further use commit to project map (c2p)
	to identify all associated projects:
	```bash
	[username@da0]~% echo a8fe822f075fa3d159a203adfa40c3f59d6dd999 | ~/lookup/getValues b2tac | awk -F \; '{for(i=4;i<NF;i+=3){print $i}}' | ~/lookup/getValues -f c2p | cut -d ";" -f2 | sort -u | head -3
	0cjs_unix-history-repo
	0mp_freebsd
	0xbda2d2f8_freebsd
	```
	In fact, there are 1719 distinct repositories where this blob appears. If you would like to see them all, remove the last `head` portion in the previous command.
	Finally, we have the author 'Warner Losh <imp@FreeBSD.org>' for the commit we have investigated.
	Can we find what other commits Warner has made? (The following output is limited to three commits only):
	```bash
	[username@da0]~% echo 'Warner Losh <imp@FreeBSD.org>' | ~/lookup/getValues a2c | tr ";" "\n" | head -n 4
	Warner Losh <imp@FreeBSD.org>
	0000ce4417bd8d9a2d66a7a61393558d503f2805
	000109ae96e7132d90440c8fa12cb7df95a806c6
	0001246ed9e02765dfc9044a1804c3c614d25dde
	```

---

(5) The tutorial uses a2cFull.V3.0.s and a2cFull.V3.?.s - should we update the corresponding examples? If so, how?

worldofcode.org/docs/tutorial.md

Line 376 in 1164f50

[username@da0]~% zcat /da7_data/basemaps/gz/a2cFull.V3.0.s | grep 'Warner Losh'

worldofcode.org/docs/tutorial.md

Line 386 in 1164f50

[username@da0]~% zcat /da?_data/basemaps/gz/a2cFull.V3.?.s | grep 'Warner Losh'

---

(6) The tutorial uses "zcat /da0_data/basemaps/gz/a2cFull*.s | grep -i 'audris' | grep -i 'mockus' | wc -l", but this ends up in "gzip: /da0_data/basemaps/gz/a2cFull*.s.gz: No such file or directory" - How to replace it?

---

(7) Which of these maps do still exist / shall still exist? Which ones to add?

worldofcode.org/docs/tutorial.md

Line 433 in 1164f50

~/lookup/getValues [-f] a2c|c2dat|b2ta|b2fa|c2b|b2f|c2f|p2c|c2p|c2P|P2c

c2f and b2ta seem to be non-existing

---

(I used tried Activities 1 to 5; I will potentially add further issues for Activities 6-end later)

[bockthom]

I've continued with activity 6 now. Here are the corresponding outdated pieces of the tutorial:

(8) Information regarding da2 and home:

worldofcode.org/docs/tutorial.md

Line 607 in 1164f50

All home folders are on da2, so it is preferred not to do very large

Is this still correct? If I am not mistaken, @audrism has recently moved home to another server...

---

(9) What's Tdiff, Tokens (ctags) and Torvalds Path? All three of them need some explanation...

worldofcode.org/docs/tutorial.md

Lines 644 to 646 in 1164f50

	- td = Tdiff
	- tk = Tokens (ctags)
	- trp = Torvalds Path

---

(10) Seems like L, Lb, and tac don't exist any more. However, l is missing in the explanation. Does it replace L?

worldofcode.org/docs/tutorial.md

Lines 650 to 653 in 1164f50

	- L = LICENSE\* files
	- Lb - blobs that are shared among fewer than 100 Projects
	- fb = firstblob
	- tac = time, author, commit

Are there any other special relationships we should add? What about the following:

• Does pkg refer to packages? If so, how are packages determined?
• What's i and nin P2binf or P2nfb?
• Whats m` in P2mnc?
• I wonder why there is a P2g but no A2g. How is the gender of a project determined?

---

(11) I have no idea what this list is going to tell, so I don't know how to update it. (I've already the list of relationships directly above these lines in my PR #1). Should we just remove it as the list of relationships is directly above? Not sure about the (.s) then, this information is not present any more then...

worldofcode.org/docs/tutorial.md

Lines 674 to 681 in 1164f50

	* a2b * a2c (.s) * a2f * a2ft
	* a2p (.s) * a2trp0 (.s)
	* b2a * b2tac (.s) * b2f (.s) * b2ob * ob2b
	* b2tk
	* c2b (.s) * c2cc * c2f (.s) * c2h * c2pc
	* c2p (.s) * c2P * c2ta (.s) * c2td
	* p2a (.s) * p2c (.s) * P2c
	* td2c * td2f

---

(12) c2fbb does not exist any more. Is there a replacement of should we remove it?

worldofcode.org/docs/tutorial.md

Line 692 in 1164f50

c2fbb - result of diff on a commit: commit file, blob, old blob

---

(13) P2core: does "core" refer to a or A?

worldofcode.org/docs/tutorial.md

Line 694 in 1164f50

P2core - Project to devs who make 80+% of the commits

---

(14) How to replace b2fLICENSE and bL2P?

worldofcode.org/docs/tutorial.md

Lines 696 to 697 in 1164f50

	b2fLICENSE - grep for LICESNSE in b2f
	bL2P - license blob to project

---

(15) What are the columns in c2dat? commit, time, timezone, author (in a manner?), what are the remaining two columns that are hashes? And why is this considered "full" data? Aren't the committers not processed in WoC?

---

(16) dl2Pf does not exist any more. Can we remove it or is there a replacement? (Even if it existed, I have no idea what "API defined" means and how "language" is processed...)

worldofcode.org/docs/tutorial.md

Line 701 in 1164f50

dl2Pf - API defined; language; project; file

---

(17) Can we update the versions to the most recent version?

worldofcode.org/docs/tutorial.md

Line 687 in 1164f50

Versions T or U:

---

(18) Do we still need this link to an old issue from 2021, or can we remove it?

worldofcode.org/docs/tutorial.md

Line 707 in 1164f50

The list of relationships is not exhaustive and more information can be found at https://github.com/woc-hack/tutorial/issues/17#issuecomment-850823408

---

(19) The statement in the result of Exercise 6 seems to be inappropriate for the tutorial as it takes very very long to run (may take hours). Can we provide an easier statement that just greps a subset of the data?

worldofcode.org/docs/tutorial.md

Line 716 in 1164f50

[username@da0] zcat /da?_data/basemaps/gz/b2fFullU*.s | grep '\.jl;'

I like this exercise, but I don't wait for hours to receive a result...

---

(End of Activity 6; to be continued) Preview of Activity 7:

Activity 7 often mentions versions R and U. Can we update this to the most recent version?
Activity 7 also mentions clickhouse. Not sure what this is. Should we keep this or can this be removed?

[hrz6976]

Hi Thomas, The tutorial file is an exact clone of woc-hack/tutorial. I’m not familiar with the shell API so I’m forwarding this email to Audris. Best, Runzhi

…

2025年4月23日 05:31，Thomas Bock ***@***.***> 写道： bockthom created an issue (ssc-oscar/worldofcode.org#2) While working on uptdating outdated parts of the woc tutorial (see PR #1), a number of questions came up that I am unable to answer myself. Could you please provide help in this regard? I will continuously add commits to my pull requests based on your suggestions here. (1) Could somebody please explain to me what the different parameters for showCnt do? (1,2,3, etc.) For 3, the tutorial states "defines that raw output needs to be produced". But as also 1 is used in the tutorial and one might wonder what 2 does, it might be helpful to explain this as well. https://github.com/ssc-oscar/woc-frontend/blob/1164f5012ebbe5e32a199990f07a5ceecab6efa4/docs/tutorial.md?plain=1#L208 https://github.com/ssc-oscar/woc-frontend/blob/1164f5012ebbe5e32a199990f07a5ceecab6efa4/docs/tutorial.md?plain=1#L248 If someone can provide me with an explaination, I'll add to the PR. (2) Could somebody please let me know how to update the following comment: https://github.com/ssc-oscar/woc-frontend/blob/1164f5012ebbe5e32a199990f07a5ceecab6efa4/docs/tutorial.md?plain=1#L298 (3) Should we add "k" to the following list of variables? It seems to be used somewhere, but I have no idea what it is... https://github.com/ssc-oscar/woc-frontend/blob/1164f5012ebbe5e32a199990f07a5ceecab6efa4/docs/tutorial.md?plain=1#L297-L303 (4) b2tac does not exist any more. But I am unsure how to replace the following example easily without using b2tac: https://github.com/ssc-oscar/woc-frontend/blob/1164f5012ebbe5e32a199990f07a5ceecab6efa4/docs/tutorial.md?plain=1#L325-L353 (5) The tutorial uses a2cFull.V3.0.s and a2cFull.V3.?.s - should we update the corresponding examples? If so, how? https://github.com/ssc-oscar/woc-frontend/blob/1164f5012ebbe5e32a199990f07a5ceecab6efa4/docs/tutorial.md?plain=1#L376 https://github.com/ssc-oscar/woc-frontend/blob/1164f5012ebbe5e32a199990f07a5ceecab6efa4/docs/tutorial.md?plain=1#L386 (6) The tutorial uses "zcat /da0_data/basemaps/gz/a2cFull*.s | grep -i 'audris' | grep -i 'mockus' | wc -l", but this ends up in "gzip: /da0_data/basemaps/gz/a2cFull*.s.gz: No such file or directory" - How to replace it? (7) Which of these maps do still exist / shall still exist? Which ones to add? https://github.com/ssc-oscar/woc-frontend/blob/1164f5012ebbe5e32a199990f07a5ceecab6efa4/docs/tutorial.md?plain=1#L433 c2f and b2ta seem to be non-existing (I used tried Activities 1 to 5; I will potentially add further issues for Activities 6-end later) — Reply to this email directly, view it on GitHub, or unsubscribe. You are receiving this because you are subscribed to this thread. <https://aus01.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2Fssc-oscar%2Fwoc-frontend%2Fpull%2F1&data=05%7C02%7C%7Cd2f8070938d841a51a0208dd81e50c62%7C84df9e7fe9f640afb435aaaaaaaaaaaa%7C1%7C0%7C638809542947079530%7CUnknown%7CTWFpbGZsb3d8eyJFbXB0eU1hcGkiOnRydWUsIlYiOiIwLjAuMDAwMCIsIlAiOiJXaW4zMiIsIkFOIjoiTWFpbCIsIldUIjoyfQ%3D%3D%7C0%7C%7C%7C&sdata=lDoW9EgKLmbVMGDvUaxK80xrdEQurPsx9FJeWgLuJ70%3D&reserved=0> <https://aus01.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2Fssc-oscar%2Fwoc-frontend%2Fblob%2F1164f5012ebbe5e32a199990f07a5ceecab6efa4%2Fdocs%2Ftutorial.md%3Fplain%3D1%23L208&data=05%7C02%7C%7Cd2f8070938d841a51a0208dd81e50c62%7C84df9e7fe9f640afb435aaaaaaaaaaaa%7C1%7C0%7C638809542947088923%7CUnknown%7CTWFpbGZsb3d8eyJFbXB0eU1hcGkiOnRydWUsIlYiOiIwLjAuMDAwMCIsIlAiOiJXaW4zMiIsIkFOIjoiTWFpbCIsIldUIjoyfQ%3D%3D%7C0%7C%7C%7C&sdata=X7BF%2By8Z9jxTop7NtUwtq1kQb8kKl%2FsObpohIEFvmh4%3D&reserved=0> <https://aus01.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2Fssc-oscar%2Fwoc-frontend%2Fblob%2F1164f5012ebbe5e32a199990f07a5ceecab6efa4%2Fdocs%2Ftutorial.md%3Fplain%3D1%23L248&data=05%7C02%7C%7Cd2f8070938d841a51a0208dd81e50c62%7C84df9e7fe9f640afb435aaaaaaaaaaaa%7C1%7C0%7C638809542947097329%7CUnknown%7CTWFpbGZsb3d8eyJFbXB0eU1hcGkiOnRydWUsIlYiOiIwLjAuMDAwMCIsIlAiOiJXaW4zMiIsIkFOIjoiTWFpbCIsIldUIjoyfQ%3D%3D%7C0%7C%7C%7C&sdata=%2FbfhabxcqePHBLNTJDAtHaWzbMZ9QGz0SMrO5Rf3Kyo%3D&reserved=0> <https://aus01.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2Fssc-oscar%2Fwoc-frontend%2Fblob%2F1164f5012ebbe5e32a199990f07a5ceecab6efa4%2Fdocs%2Ftutorial.md%3Fplain%3D1%23L298&data=05%7C02%7C%7Cd2f8070938d841a51a0208dd81e50c62%7C84df9e7fe9f640afb435aaaaaaaaaaaa%7C1%7C0%7C638809542947105528%7CUnknown%7CTWFpbGZsb3d8eyJFbXB0eU1hcGkiOnRydWUsIlYiOiIwLjAuMDAwMCIsIlAiOiJXaW4zMiIsIkFOIjoiTWFpbCIsIldUIjoyfQ%3D%3D%7C0%7C%7C%7C&sdata=Wbt8vx%2FIoi4HGjdPzgoV9nbs6E9o2Qh%2FRBROlUprEI4%3D&reserved=0> <https://aus01.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2Fssc-oscar%2Fwoc-frontend%2Fblob%2F1164f5012ebbe5e32a199990f07a5ceecab6efa4%2Fdocs%2Ftutorial.md%3Fplain%3D1%23L297-L303&data=05%7C02%7C%7Cd2f8070938d841a51a0208dd81e50c62%7C84df9e7fe9f640afb435aaaaaaaaaaaa%7C1%7C0%7C638809542947113796%7CUnknown%7CTWFpbGZsb3d8eyJFbXB0eU1hcGkiOnRydWUsIlYiOiIwLjAuMDAwMCIsIlAiOiJXaW4zMiIsIkFOIjoiTWFpbCIsIldUIjoyfQ%3D%3D%7C0%7C%7C%7C&sdata=3wLmGncaU1gevERWaytRLXYLsYB3kv9TPHCzJlg%2B30w%3D&reserved=0> <https://aus01.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2Fssc-oscar%2Fwoc-frontend%2Fblob%2F1164f5012ebbe5e32a199990f07a5ceecab6efa4%2Fdocs%2Ftutorial.md%3Fplain%3D1%23L325-L353&data=05%7C02%7C%7Cd2f8070938d841a51a0208dd81e50c62%7C84df9e7fe9f640afb435aaaaaaaaaaaa%7C1%7C0%7C638809542947121870%7CUnknown%7CTWFpbGZsb3d8eyJFbXB0eU1hcGkiOnRydWUsIlYiOiIwLjAuMDAwMCIsIlAiOiJXaW4zMiIsIkFOIjoiTWFpbCIsIldUIjoyfQ%3D%3D%7C0%7C%7C%7C&sdata=mZN7rw%2BuigT2ipCvq00ZQW1j%2BHQRo399iZ5gL%2FMfNrk%3D&reserved=0> <https://aus01.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2Fssc-oscar%2Fwoc-frontend%2Fblob%2F1164f5012ebbe5e32a199990f07a5ceecab6efa4%2Fdocs%2Ftutorial.md%3Fplain%3D1%23L376&data=05%7C02%7C%7Cd2f8070938d841a51a0208dd81e50c62%7C84df9e7fe9f640afb435aaaaaaaaaaaa%7C1%7C0%7C638809542947130051%7CUnknown%7CTWFpbGZsb3d8eyJFbXB0eU1hcGkiOnRydWUsIlYiOiIwLjAuMDAwMCIsIlAiOiJXaW4zMiIsIkFOIjoiTWFpbCIsIldUIjoyfQ%3D%3D%7C0%7C%7C%7C&sdata=dXpOhWVTtjRIJDxOZkLgcd%2BZ2uaNIM3aMsedxqcIAEE%3D&reserved=0> <https://aus01.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2Fssc-oscar%2Fwoc-frontend%2Fblob%2F1164f5012ebbe5e32a199990f07a5ceecab6efa4%2Fdocs%2Ftutorial.md%3Fplain%3D1%23L386&data=05%7C02%7C%7Cd2f8070938d841a51a0208dd81e50c62%7C84df9e7fe9f640afb435aaaaaaaaaaaa%7C1%7C0%7C638809542947138166%7CUnknown%7CTWFpbGZsb3d8eyJFbXB0eU1hcGkiOnRydWUsIlYiOiIwLjAuMDAwMCIsIlAiOiJXaW4zMiIsIkFOIjoiTWFpbCIsIldUIjoyfQ%3D%3D%7C0%7C%7C%7C&sdata=KbjGL3pjA9eIRQeHkBTbVhhRnIE3QbudGGw%2BOkx6Ylw%3D&reserved=0> <https://aus01.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2Fssc-oscar%2Fwoc-frontend%2Fblob%2F1164f5012ebbe5e32a199990f07a5ceecab6efa4%2Fdocs%2Ftutorial.md%3Fplain%3D1%23L433&data=05%7C02%7C%7Cd2f8070938d841a51a0208dd81e50c62%7C84df9e7fe9f640afb435aaaaaaaaaaaa%7C1%7C0%7C638809542947146153%7CUnknown%7CTWFpbGZsb3d8eyJFbXB0eU1hcGkiOnRydWUsIlYiOiIwLjAuMDAwMCIsIlAiOiJXaW4zMiIsIkFOIjoiTWFpbCIsIldUIjoyfQ%3D%3D%7C0%7C%7C%7C&sdata=yn6wCqrXC5vCbAYIZUBRDAhopFbDM%2Fwo%2FJcaSzO8yoY%3D&reserved=0> <https://aus01.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2Fssc-oscar%2Fwoc-frontend%2Fissues%2F2&data=05%7C02%7C%7Cd2f8070938d841a51a0208dd81e50c62%7C84df9e7fe9f640afb435aaaaaaaaaaaa%7C1%7C0%7C638809542947154100%7CUnknown%7CTWFpbGZsb3d8eyJFbXB0eU1hcGkiOnRydWUsIlYiOiIwLjAuMDAwMCIsIlAiOiJXaW4zMiIsIkFOIjoiTWFpbCIsIldUIjoyfQ%3D%3D%7C0%7C%7C%7C&sdata=%2Fpi%2BKsKqn6o437rar7n0iqTPpbh3TL3q73Ukbq6EjO0%3D&reserved=0> <https://aus01.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2Fnotifications%2Funsubscribe-auth%2FALETPB72WTPISBORY4LO7T3222YLFAVCNFSM6AAAAAB3UXRPUSVHI2DSMVQWIX3LMV43ASLTON2WKOZTGAYTEMJXGM2TONY&data=05%7C02%7C%7Cd2f8070938d841a51a0208dd81e50c62%7C84df9e7fe9f640afb435aaaaaaaaaaaa%7C1%7C0%7C638809542947162757%7CUnknown%7CTWFpbGZsb3d8eyJFbXB0eU1hcGkiOnRydWUsIlYiOiIwLjAuMDAwMCIsIlAiOiJXaW4zMiIsIkFOIjoiTWFpbCIsIldUIjoyfQ%3D%3D%7C0%7C%7C%7C&sdata=I9DCSdciQM9orNtIjFV0HPr2lWKUt3oYvfp2Nrn%2BhHA%3D&reserved=0> bockthom created an issue (ssc-oscar/worldofcode.org#2) <https://aus01.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2Fssc-oscar%2Fwoc-frontend%2Fissues%2F2&data=05%7C02%7C%7Cd2f8070938d841a51a0208dd81e50c62%7C84df9e7fe9f640afb435aaaaaaaaaaaa%7C1%7C0%7C638809542947172816%7CUnknown%7CTWFpbGZsb3d8eyJFbXB0eU1hcGkiOnRydWUsIlYiOiIwLjAuMDAwMCIsIlAiOiJXaW4zMiIsIkFOIjoiTWFpbCIsIldUIjoyfQ%3D%3D%7C0%7C%7C%7C&sdata=r04uNOQ5viuEEPCjB1XWFGijV%2F0eKY2E72LZg14ENU4%3D&reserved=0> While working on uptdating outdated parts of the woc tutorial (see PR #1 <https://aus01.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2Fssc-oscar%2Fwoc-frontend%2Fpull%2F1&data=05%7C02%7C%7Cd2f8070938d841a51a0208dd81e50c62%7C84df9e7fe9f640afb435aaaaaaaaaaaa%7C1%7C0%7C638809542947182738%7CUnknown%7CTWFpbGZsb3d8eyJFbXB0eU1hcGkiOnRydWUsIlYiOiIwLjAuMDAwMCIsIlAiOiJXaW4zMiIsIkFOIjoiTWFpbCIsIldUIjoyfQ%3D%3D%7C0%7C%7C%7C&sdata=sYxBfSgZZG9kAY9nuevqGC%2BnGplTqgCpels9bMwNorE%3D&reserved=0>), a number of questions came up that I am unable to answer myself. Could you please provide help in this regard? I will continuously add commits to my pull requests based on your suggestions here. (1) Could somebody please explain to me what the different parameters for showCnt do? (1,2,3, etc.) For 3, the tutorial states "defines that raw output needs to be produced". But as also 1 is used in the tutorial and one might wonder what 2 does, it might be helpful to explain this as well. https://github.com/ssc-oscar/woc-frontend/blob/1164f5012ebbe5e32a199990f07a5ceecab6efa4/docs/tutorial.md?plain=1#L208 <https://aus01.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2Fssc-oscar%2Fwoc-frontend%2Fblob%2F1164f5012ebbe5e32a199990f07a5ceecab6efa4%2Fdocs%2Ftutorial.md%3Fplain%3D1%23L208&data=05%7C02%7C%7Cd2f8070938d841a51a0208dd81e50c62%7C84df9e7fe9f640afb435aaaaaaaaaaaa%7C1%7C0%7C638809542947191082%7CUnknown%7CTWFpbGZsb3d8eyJFbXB0eU1hcGkiOnRydWUsIlYiOiIwLjAuMDAwMCIsIlAiOiJXaW4zMiIsIkFOIjoiTWFpbCIsIldUIjoyfQ%3D%3D%7C0%7C%7C%7C&sdata=miCSnQx9nHATOfaPutMeAJhXtLLwbFlT4tB%2BSHHhYfw%3D&reserved=0> https://github.com/ssc-oscar/woc-frontend/blob/1164f5012ebbe5e32a199990f07a5ceecab6efa4/docs/tutorial.md?plain=1#L248 <https://aus01.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2Fssc-oscar%2Fwoc-frontend%2Fblob%2F1164f5012ebbe5e32a199990f07a5ceecab6efa4%2Fdocs%2Ftutorial.md%3Fplain%3D1%23L248&data=05%7C02%7C%7Cd2f8070938d841a51a0208dd81e50c62%7C84df9e7fe9f640afb435aaaaaaaaaaaa%7C1%7C0%7C638809542947199097%7CUnknown%7CTWFpbGZsb3d8eyJFbXB0eU1hcGkiOnRydWUsIlYiOiIwLjAuMDAwMCIsIlAiOiJXaW4zMiIsIkFOIjoiTWFpbCIsIldUIjoyfQ%3D%3D%7C0%7C%7C%7C&sdata=pH3%2B0DHDP8NJwtm4OwEeII71m6bKh%2B%2FsMaadKl7iLHY%3D&reserved=0> If someone can provide me with an explaination, I'll add to the PR. (2) Could somebody please let me know how to update the following comment: https://github.com/ssc-oscar/woc-frontend/blob/1164f5012ebbe5e32a199990f07a5ceecab6efa4/docs/tutorial.md?plain=1#L298 <https://aus01.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2Fssc-oscar%2Fwoc-frontend%2Fblob%2F1164f5012ebbe5e32a199990f07a5ceecab6efa4%2Fdocs%2Ftutorial.md%3Fplain%3D1%23L298&data=05%7C02%7C%7Cd2f8070938d841a51a0208dd81e50c62%7C84df9e7fe9f640afb435aaaaaaaaaaaa%7C1%7C0%7C638809542947206980%7CUnknown%7CTWFpbGZsb3d8eyJFbXB0eU1hcGkiOnRydWUsIlYiOiIwLjAuMDAwMCIsIlAiOiJXaW4zMiIsIkFOIjoiTWFpbCIsIldUIjoyfQ%3D%3D%7C0%7C%7C%7C&sdata=3uDRZBfQVh%2F70tvbLXmg%2B7P54DMauXdDkZZ61xNEMX8%3D&reserved=0> (3) Should we add "k" to the following list of variables? It seems to be used somewhere, but I have no idea what it is... https://github.com/ssc-oscar/woc-frontend/blob/1164f5012ebbe5e32a199990f07a5ceecab6efa4/docs/tutorial.md?plain=1#L297-L303 <https://aus01.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2Fssc-oscar%2Fwoc-frontend%2Fblob%2F1164f5012ebbe5e32a199990f07a5ceecab6efa4%2Fdocs%2Ftutorial.md%3Fplain%3D1%23L297-L303&data=05%7C02%7C%7Cd2f8070938d841a51a0208dd81e50c62%7C84df9e7fe9f640afb435aaaaaaaaaaaa%7C1%7C0%7C638809542947214857%7CUnknown%7CTWFpbGZsb3d8eyJFbXB0eU1hcGkiOnRydWUsIlYiOiIwLjAuMDAwMCIsIlAiOiJXaW4zMiIsIkFOIjoiTWFpbCIsIldUIjoyfQ%3D%3D%7C0%7C%7C%7C&sdata=W87MKyxIym3eFb6kG8rrAGjSaxAA1hdgpaZGHGf8VgE%3D&reserved=0> (4) b2tac does not exist any more. But I am unsure how to replace the following example easily without using b2tac: https://github.com/ssc-oscar/woc-frontend/blob/1164f5012ebbe5e32a199990f07a5ceecab6efa4/docs/tutorial.md?plain=1#L325-L353 <https://aus01.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2Fssc-oscar%2Fwoc-frontend%2Fblob%2F1164f5012ebbe5e32a199990f07a5ceecab6efa4%2Fdocs%2Ftutorial.md%3Fplain%3D1%23L325-L353&data=05%7C02%7C%7Cd2f8070938d841a51a0208dd81e50c62%7C84df9e7fe9f640afb435aaaaaaaaaaaa%7C1%7C0%7C638809542947222730%7CUnknown%7CTWFpbGZsb3d8eyJFbXB0eU1hcGkiOnRydWUsIlYiOiIwLjAuMDAwMCIsIlAiOiJXaW4zMiIsIkFOIjoiTWFpbCIsIldUIjoyfQ%3D%3D%7C0%7C%7C%7C&sdata=QBM6g7YzQPryK2F8208hBKJF8yGazv4b97U2UOvUDjo%3D&reserved=0> (5) The tutorial uses a2cFull.V3.0.s and a2cFull.V3.?.s - should we update the corresponding examples? If so, how? https://github.com/ssc-oscar/woc-frontend/blob/1164f5012ebbe5e32a199990f07a5ceecab6efa4/docs/tutorial.md?plain=1#L376 <https://aus01.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2Fssc-oscar%2Fwoc-frontend%2Fblob%2F1164f5012ebbe5e32a199990f07a5ceecab6efa4%2Fdocs%2Ftutorial.md%3Fplain%3D1%23L376&data=05%7C02%7C%7Cd2f8070938d841a51a0208dd81e50c62%7C84df9e7fe9f640afb435aaaaaaaaaaaa%7C1%7C0%7C638809542947230631%7CUnknown%7CTWFpbGZsb3d8eyJFbXB0eU1hcGkiOnRydWUsIlYiOiIwLjAuMDAwMCIsIlAiOiJXaW4zMiIsIkFOIjoiTWFpbCIsIldUIjoyfQ%3D%3D%7C0%7C%7C%7C&sdata=q7myau7QqDci2YoXIJ4WuUQHB0iYR3KHOVr3aOIUeao%3D&reserved=0> https://github.com/ssc-oscar/woc-frontend/blob/1164f5012ebbe5e32a199990f07a5ceecab6efa4/docs/tutorial.md?plain=1#L386 <https://aus01.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2Fssc-oscar%2Fwoc-frontend%2Fblob%2F1164f5012ebbe5e32a199990f07a5ceecab6efa4%2Fdocs%2Ftutorial.md%3Fplain%3D1%23L386&data=05%7C02%7C%7Cd2f8070938d841a51a0208dd81e50c62%7C84df9e7fe9f640afb435aaaaaaaaaaaa%7C1%7C0%7C638809542947238521%7CUnknown%7CTWFpbGZsb3d8eyJFbXB0eU1hcGkiOnRydWUsIlYiOiIwLjAuMDAwMCIsIlAiOiJXaW4zMiIsIkFOIjoiTWFpbCIsIldUIjoyfQ%3D%3D%7C0%7C%7C%7C&sdata=IbHoHVXD%2FFher6MSyLpy7%2BcC6aFE3swEP%2FPIro9FTdI%3D&reserved=0> (6) The tutorial uses "zcat /da0_data/basemaps/gz/a2cFull*.s | grep -i 'audris' | grep -i 'mockus' | wc -l", but this ends up in "gzip: /da0_data/basemaps/gz/a2cFull*.s.gz: No such file or directory" - How to replace it? (7) Which of these maps do still exist / shall still exist? Which ones to add? https://github.com/ssc-oscar/woc-frontend/blob/1164f5012ebbe5e32a199990f07a5ceecab6efa4/docs/tutorial.md?plain=1#L433 <https://aus01.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2Fssc-oscar%2Fwoc-frontend%2Fblob%2F1164f5012ebbe5e32a199990f07a5ceecab6efa4%2Fdocs%2Ftutorial.md%3Fplain%3D1%23L433&data=05%7C02%7C%7Cd2f8070938d841a51a0208dd81e50c62%7C84df9e7fe9f640afb435aaaaaaaaaaaa%7C1%7C0%7C638809542947246355%7CUnknown%7CTWFpbGZsb3d8eyJFbXB0eU1hcGkiOnRydWUsIlYiOiIwLjAuMDAwMCIsIlAiOiJXaW4zMiIsIkFOIjoiTWFpbCIsIldUIjoyfQ%3D%3D%7C0%7C%7C%7C&sdata=I5SkGahRz61sqwjQzLuDivqpvnTfYpuWWNktaKhaXZU%3D&reserved=0> c2f and b2ta seem to be non-existing (I used tried Activities 1 to 5; I will potentially add further issues for Activities 6-end later) — Reply to this email directly, view it on GitHub <https://aus01.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2Fssc-oscar%2Fwoc-frontend%2Fissues%2F2&data=05%7C02%7C%7Cd2f8070938d841a51a0208dd81e50c62%7C84df9e7fe9f640afb435aaaaaaaaaaaa%7C1%7C0%7C638809542947254264%7CUnknown%7CTWFpbGZsb3d8eyJFbXB0eU1hcGkiOnRydWUsIlYiOiIwLjAuMDAwMCIsIlAiOiJXaW4zMiIsIkFOIjoiTWFpbCIsIldUIjoyfQ%3D%3D%7C0%7C%7C%7C&sdata=IgJRd5banDko5puD1Hb5j3loNAQhuWSOAPH%2BvjFK%2FMs%3D&reserved=0>, or unsubscribe <https://aus01.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2Fnotifications%2Funsubscribe-auth%2FALETPB72WTPISBORY4LO7T3222YLFAVCNFSM6AAAAAB3UXRPUSVHI2DSMVQWIX3LMV43ASLTON2WKOZTGAYTEMJXGM2TONY&data=05%7C02%7C%7Cd2f8070938d841a51a0208dd81e50c62%7C84df9e7fe9f640afb435aaaaaaaaaaaa%7C1%7C0%7C638809542947262043%7CUnknown%7CTWFpbGZsb3d8eyJFbXB0eU1hcGkiOnRydWUsIlYiOiIwLjAuMDAwMCIsIlAiOiJXaW4zMiIsIkFOIjoiTWFpbCIsIldUIjoyfQ%3D%3D%7C0%7C%7C%7C&sdata=V2ru%2F5s3cY7Z96UxakwHS3ZmPqt0WX%2FuOkpiEDlrSZI%3D&reserved=0>. You are receiving this because you are subscribed to this thread.

[loconous]

I am going to add comments for each item to try to give you answers in a clean manner.

(1)

The lookup BitBucket repo documentation is clear for parameters "1" and "3", but somewhat obscure for "2". Here is my understanding, backed up with examples using showCnt commit:

• Parameters:
  No parameter -> Default. Returns a concise structured record with commit metadata fields
  1 -> Outputs essential metadata only (the commit timestamp and author)
  2 -> (less documented) Outputs metadata with the full commit message in one line. It adds more human-readable info than 1, but it's compact
  3 -> Outputs full raw commit object (git cat-file -p ), including multi-line messages

Here is the breakdown:

• No parameter:
  Command: echo <blob> | ~/lookup/showCnt commit
  Output: <blob>;<tree>;<parent>;<author>;<committer>;<auth_date>;<commit_date>
  Example:

$ echo 009d7b6da9c4419fe96ffd1fffb2ee61fa61532a | ~/lookup/showCnt commit
009d7b6da9c4419fe96ffd1fffb2ee61fa61532a;464ac950171f673d1e45e2134ac9a52eca422132;dddff9a89ddd7098a1625cafd3c9d1aa87474cc7;Warner Losh <imp@FreeBSD.org>;Warner Losh <imp@FreeBSD.org>;1092638038;1092638038

• 1:
  Command: echo <blob> | ~/lookup/showCnt commit 1
  Output: <blob>;<commit_timestamp>;<author>
  Example:

$ echo 009d7b6da9c4419fe96ffd1fffb2ee61fa61532a | ~/lookup/showCnt commit 1
009d7b6da9c4419fe96ffd1fffb2ee61fa61532a;1092638038;Warner Losh <imp@FreeBSD.org>

• 2:
  Command: echo <blob> | ~/lookup/showCnt commit 2
  Output: <blob>;<author>;<timestamp>;<timezone>;<commit message>
  Example:

$ echo 009d7b6da9c4419fe96ffd1fffb2ee61fa61532a | ~/lookup/showCnt commit 2
009d7b6da9c4419fe96ffd1fffb2ee61fa61532a;Warner Losh <imp@FreeBSD.org>;1092638038;+0000;Don't need to declare cbb module.  don't know why I never saw duplicate messages..

• 3:
  Command: echo <blob> | ~/lookup/showCnt commit 3
  Output:

tree <tree>
parent <parent>
author <author> <timestamp> <timezone>
committer <committer> <timestamp> <timezone>

<full commit message, multiline>

Example:

$ echo 009d7b6da9c4419fe96ffd1fffb2ee61fa61532a | ~/lookup/showCnt commit 3
tree 464ac950171f673d1e45e2134ac9a52eca422132
parent dddff9a89ddd7098a1625cafd3c9d1aa87474cc7
author Warner Losh <imp@FreeBSD.org> 1092638038 +0000
committer Warner Losh <imp@FreeBSD.org> 1092638038 +0000

Don't need to declare cbb module.  don't know why I never saw
duplicate messages..

[bockthom]

Thanks @loconous, this makes sense. I'll add parts of your information / examples to my tutorial pull-request.

What about the other items of my (admittedly lengthy) list?

[loconous]

(2)

Remove the parenthesis statement.

[loconous]

(3)

k is used in combinations. Pkg for package, and tk for tokens, which is already listed in Activity 6. I would not worry about this one. Although, now that I notice, pkg is not listed in the breakdown for Activity 6, but it is part of Activity 7.

Also, I want to add an additional clarification for this portion.
Instead of:

• a = Author (A - aliased author)

Let's do:

• a = Author
• A = Aliased author

[loconous]

(4)

I do not have a quick one for this. I would like to see the whole tutorial to be worked up with a more recent example.
@audrism could you please help with this one?

[loconous]

(5)

The reason we have this example is to just teach them how to "fish" per say. There are ..Full.V#.s or just ..FullV#.s for previous versions. I would want to say that at some point we work the version naming convention. The problem with changing this one is that does a search for that author with zcat /da?_data/basemaps/gz/a2cFull.V*.s | grep author takes a long time to return.
For example, it has been 20 minutes for me running this:

[lgonzal6@da0]/da1_data/basemaps/gz% zcat /da?_data/basemaps/gz/a2cFull.V*.s | grep 'Warner Losh'
Warner Losh <imp@NetBSD.org>;02769672bbae665f8862f9d366860f3b4f0ae44b
Warner Losh <imp@NetBSD.org>;0c11b2d9049883ed330c7cfa9dabaa37e737af76
Warner Losh <imp@NetBSD.org>;0d5f5ad549e3ee6fa4f080b86340fd07bf0f11d2
Warner Losh <imp@NetBSD.org>;0fa5ae8e8e8eff2ca4c5ea3e94dcefc305cc2f07
Warner Losh <imp@NetBSD.org>;151e8558af292cc1aca6679e59db4dfdd98dd183
Warner Losh <imp@NetBSD.org>;225b85ffaf91cfd0a97e89416ebfe817d89fbc5a
Warner Losh <imp@NetBSD.org>;28cbb22cd4607adcd1e80e304b607eab9d4da527
Warner Losh <imp@NetBSD.org>;2d32a89891346b4b96ffbd881057eed98391f088
Warner Losh <imp@NetBSD.org>;375196def4db3a8a8cecc92f2e30485d82c9771d
Warner Losh <imp@NetBSD.org>;402fd5a5c7d8d28001fbcc0e964d796b83a03809
Warner Losh <imp@NetBSD.org>;437dd59273fdb6ec3732ff1707ae893672c80952
Warner Losh <imp@NetBSD.org>;49e2d3e9dc504b1471c04604e89cb704edc469f7
Warner Losh <imp@NetBSD.org>;4db671910ae783058d82a1c87e7a4cba91dcd928
Warner Losh <imp@NetBSD.org>;65627e03217cd0ae27b13269ec39b4c445a0948e
Warner Losh <imp@NetBSD.org>;6e27f3b906135cfa404ed0c492cfd575488d0d77
Warner Losh <imp@NetBSD.org>;78f7c2b09921b6e492a7c945b8c20f6dec9b0a1d
Warner Losh <imp@NetBSD.org>;7d156ce63925edf250bde92b134c551aa9720346
Warner Losh <imp@NetBSD.org>;80b1cd9020dd3c514a5ec9ea7ce99857d7072b11
Warner Losh <imp@NetBSD.org>;80d969976ad01153632d34e22bba20a048d86a7f
Warner Losh <imp@NetBSD.org>;8cdae4b8ab4e3f330fc94c2b3e70858ac1837cea
Warner Losh <imp@NetBSD.org>;8e7ecd4fca1532215fa5302a3fa132409be4125a
Warner Losh <imp@NetBSD.org>;91da2fc35780266962b0f73a694afa9541f8c39f
Warner Losh <imp@NetBSD.org>;95f7e260be362538bac9df99c8474dea1c4a3483
Warner Losh <imp@NetBSD.org>;97e18c31417b886a6675a80ce2e4a92ac09845e5
Warner Losh <imp@NetBSD.org>;996fe179e29d0f2cae2901c60433025bb6eb3128
Warner Losh <imp@NetBSD.org>;9fc85e95344b7e6dddbcf75386adcdd7eaf1fd16
Warner Losh <imp@NetBSD.org>;a5f900d786a88792b92cfb54ab4ebf8b722fb04f
Warner Losh <imp@NetBSD.org>;a8b294ded5e958c75f570137e154a34fddbf38ee
Warner Losh <imp@NetBSD.org>;ae6d8ba46c019cd8850879a2f60277fab7124586
Warner Losh <imp@NetBSD.org>;b07186271d1554f5af94334af0f91de0b38759f9
Warner Losh <imp@NetBSD.org>;b3a0b601a9f9c1a76d9c293f924b643fd616a14a
Warner Losh <imp@NetBSD.org>;b66f60577db704b30864093d7c981fe26769a661
Warner Losh <imp@NetBSD.org>;b946e9b3daf33948c04b64a2999ff04b710349ba
Warner Losh <imp@NetBSD.org>;bcd589e800f30818af53ce16096605a2d64a90b4
Warner Losh <imp@NetBSD.org>;d218addab5a2b8cfff87adbf9dfccf1023810517
Warner Losh <imp@NetBSD.org>;d223dcf4d932a80eac9b0b6daaeb3fd1de9cc399
Warner Losh <imp@NetBSD.org>;db3fbb786e22f7845c1fee2255dbf0eb2e3e93a2
Warner Losh <imp@NetBSD.org>;e86fe46d572e104c1485ab2c069a36248a26bc8a
Warner Losh <imp@NetBSD.org>;f5353633e9e79991eb2a5aba13263564cf896a44
Warner Losh <imp@NetBSD.org>;face84cfa8d628b9b8b5beab23df79f48cece085
Warner Losh <imp@NetBSD.org>;fe1944e3959ff162d9b7561ade17816d2ef7e383

..and it is not done yet.
I would suggest to leave as is. If we are able to address the appropriate versioning numbers in a clear way, users should be able to figure it out.

[loconous]

(6)

da0_data was moved when RHEL9 install hit. Use da1:zcat /da1_data/basemaps/gz/a2cFull*.s | grep -i 'audris' | grep -i 'mockus' | wc -l

This works:

$ zcat /da1_data/basemaps/gz/a2cFull*.s | grep -i 'audris' | grep -i 'mockus' | wc -l
5352