fixed some errors, steps into dunder method list

Author: thomasWeise

bibliography/bibliography.bib

@@ -30,7 +30,7 @@ @string { a_antiga_luca
 @string { a_archibald_anne_m = "Anne M.\ Archibald" }
 @string { a_arthur_jones = "Arthur Jones" }
 @string { a_ascher_david = "David Ascher" }
-@string { a_b_jean_francois = "Jean{-}Fran{\c{c}}ois B." }
+@string { a_b_jean_francois = "Jean{\nobreakdashes-}Fran{\c{c}}ois B." }
 @string { a_babuska_ivo = "Ivo Babu{\v{s}}ka" }
 @string { a_bachmann_paul_gustav_heinrich = "Paul Gustav Heinrich Bachmann" }
 @string { a_back_ralph_johan = "Ralph{\nobreakdashes-}Johan Back" }
@@ -164,7 +164,7 @@ @string { a_haberland_matt
 @string { a_haldane_allan = "Allan Haldane" }
 @string { a_hammoud_mohammad = "Mohammad Hammoud" }
 @string { a_hammouda_imed = "Imed Hammouda" }
-@string { a_han_myung_ja_k = "Myung{-}Ja K.\ Han" }
+@string { a_han_myung_ja_k = "Myung{\nobreakdashes-}Ja K.\ Han" }
 @string { a_hance_jared = "Jared Hance" }
 @string { a_harris_charles_r = "Charles R.\ Harris" }
 @string { a_hastings_larry = "Larry Hastings" }
@@ -177,7 +177,7 @@ @string { a_herbsleb_james_d
 @string { a_hetland_magnus_lie = "Magnus Lie Hetland" }
 @string { a_hettinger_raymond = "Raymond Hettinger" }
 @string { a_hickson_ian = "Ian Hickson" }
-@string { a_hilton_balfe_james = "James Hilton{-}Balfe" }
+@string { a_hilton_balfe_james = "James Hilton{\nobreakdashes-}Balfe" }
 @string { a_hollasch_steve = "Steve Hollasch" }
 @string { a_hoyer_stephan = "Stephan Hoyer" }
 @string { a_hubbard_steve = "Steve Hubbard" }
@@ -190,7 +190,7 @@ @string { a_ito_ysuaki
 @string { a_jackson_dean = "Dean Jackson" }
 @string { a_jain_shantanu = "Shantanu Jain" }
 @string { a_james_mike = "Mike James" }
-@string { a_jewet_jim_j = "Jim J\. Jewett" }
+@string { a_jewet_jim_j = "Jim J.\ Jewett" }
 @string { a_joh_sangwoo = "Sangwoo Joh" }
 @string { a_johansson_robert = "Robert Johansson" }
 @string { a_johnson_stephen_curtis = "Stephen Curtis Johnson" }
@@ -370,7 +370,7 @@ @string { a_smith_ethan
 @string { a_smith_nathaniel_j = "Nathaniel J.\ Smith" }
 @string { a_sobolev_nikita = "Nikita Sobolev" }
 @string { a_sottet_jean_sebastien = "Jean{\nobreakdashes-}S{\'e}bastien Sottet" }
-@string { a_sperberg_mcqueen_c_m = "C.\ M.\ Sperberg{-}McQueen" }
+@string { a_sperberg_mcqueen_c_m = "C.\ M.\ Sperberg{\nobreakdashes-}McQueen" }
 @string { a_sphinx_developers = "{\Pgls{sphinx} Developers}" }
 @string { a_srinivasan_pradeep_kumar = "Pradeep Kumar Srinivasan" }
 @string { a_stein_clifford = "Clifford Stein" }
@@ -530,15 +530,15 @@ @string { l_usa_wilmington
 %% publishers
 @string { p_aci_learning = "{{ACI} Learning}" }
 @string { p_acm = "{Association for Computing Machinery~({ACM})}" }
-@string { p_active_state = "ActiveState Software Inc." }
+@string { p_active_state = "{ActiveState Software~Inc.}" }
 @string { p_addison_wesley = "{Addison\nobreakdashes-Wesley Professional}" }
-@string { p_addison_wesley_longman = "{Addison Wesley Longman Publishing Co., Inc.}" }
+@string { p_addison_wesley_longman = "{Addison Wesley Longman Publishing Co.,~Inc.}" }
 @string { p_adobe = "{Adobe Systems Incorporated}" }
-@string { p_amacom = "AMACOM" }
+@string { p_amacom = "{AMACOM}" }
 @string { p_ams = "{American Mathematical Society~({AMS})}" }
 @string { p_apress = "{Apress Media,~LLC}" }
 @string { p_asa = "{American Standards Association Incorporated}" }
-@string { p_astral = "Astral Software~Inc." }
+@string { p_astral = "{Astral Software~Inc.}" }
 @string { p_bell_labs = "{Bell Telephone Laboratories, Incorporated}" }
 @string { p_birkhauser_boston = "{Birkh{\"a}user}" }
 @string { p_bruhin_software = "{Bruhin Software}" }
@@ -547,27 +547,27 @@ @string { p_carnegie_mellon_university_qatar
 @string { p_cnri = "{Corporation for National Research Initiatives~({CNRI})}" }
 @string { p_crc_press = "{{CRC} Press}" }
 @string { p_cornell_university_library = "{Cornell Universiy Library}" }
-@string { p_document_foundation = "The Document Foundation" }
-@string { p_ecma = "Ecma International" }
+@string { p_document_foundation = "{The Document Foundation}" }
+@string { p_ecma = "{Ecma International}" }
 @string { p_elsevier = "{Elsevier~B.V.}" }
-@string { p_encyclopaedia_britannica_inc = "Encyclop{\ae}dia Britannica, Inc." }
+@string { p_encyclopaedia_britannica_inc = "{Encyclop{\ae}dia Britannica,~Inc.}" }
 @string { p_geeksforgeeks = "{GeeksforGeeks -- Sanchhaya Education Private Limited}" }
 @string { p_github = "{\github~Inc}" }
 @string { p_hanser_verlag = "{Carl Hanser Verlag GmbH \& Co.~KG}" }
 @string { p_hiroshima_university_dep_ie = "{Department of Information Engineering, Hiroshima University}" }
-@string { p_ibm = "International Business Machines Corporation~{(IBM)}" }
+@string { p_ibm = "{International Business Machines Corporation~{(IBM)}}" }
 @string { p_iec = "{International Electrotechnical Commission~{(IEC)}}" }
 @string { p_ieee = "{Institute of Electrical and Electronics Engineers~{(IEEE)}}" }
 @string { p_ieee_computer_society = "{{IEEE}~Computer Society}" }
 @string { p_ietf = "{Internet Engineering Task Force~{(IETF)}}" }
 @string { p_ifip = "{International Federation for Information Processing~{(IFIP)}}" }
-@string { p_infinite_skills = "Infinite Skills Inc" }
+@string { p_infinite_skills = "{Infinite Skills~Inc}" }
 @string { p_informs = "{The Institute for Operations Research and the Management Sciences~({INFORMS})}" }
 @string { p_io_press = "{{I/O}~Press}" }
 @string { p_iso = "{International Organization for Standardization~{(ISO)}}" }
 @string { p_leibniz_zentrum_fur_informatik = "{{Schloss Dagstuhl} -- {Leibniz\nobreakdashes-Zentrum f{\"u}r Informatik}}" }
-@string { p_libraries_unlimited = "Libraries Unlimited" }
-@string { p_logilab = "Logilab" }
+@string { p_libraries_unlimited = "{Libraries Unlimited}" }
+@string { p_logilab = "{Logilab}" }
 @string { p_manning_publications = "{Manning Publications}" }
 @string { p_mcgraw_hill = "{McGraw\nobreakdashes-Hill}" }
 @string { p_merlinux = "{merlinux GmbH}" }
@@ -578,32 +578,32 @@ @string { p_nasa
 @string { p_nasa_asd = "{Astrophysics Science Division~{(ASD)}}, " # p_nasa }
 @string { p_neurips = "{The Neural Information Processing Systems Foundation~{(NeurIPS)}}" }
 @string { p_north_holland = "{North\nobreakdashes-Holland Publishing Co.}" }
-@string { p_oeis_foundation = "The {OEIS} Foundation Inc." }
-@string { p_open_group = "The Open Group" }
+@string { p_oeis_foundation = "{The {OEIS} Foundation~Inc.}" }
+@string { p_open_group = "{The Open Group}" }
 @string { p_oracle = "{Oracle Corporation}" }
-@string { p_oreilly = "{{O'Reilly} Media, Inc.}" }
+@string { p_oreilly = "{{O'Reilly} Media,~Inc.}" }
 @string { p_oxford_university_cl = "{Oxford University Computing Laboratory}" }
 @string { p_oxford_university_press = "{Oxford University Press}" }
 @string { p_packt = "{Packt Publishing Ltd}" }
-@string { p_payhip = "Payhip" }
-@string { p_pearson_education = "{Pearson Education, Inc.}" }
+@string { p_payhip = "{Payhip}" }
+@string { p_pearson_education = "{Pearson Education,~Inc.}" }
 @string { p_microsoft_press = "{Microsoft Press}, " # p_pearson_education }
-@string { p_plos = "Public Library of Science~{(PLOS)}" }
+@string { p_plos = "{Public Library of Science~{(PLOS)}}" }
 @string { p_pragmatic_ai_labs = "{Pragmatic {AI} Labs}" }
 @string { p_pragmatic_bookshelf = "{{Pragmatic Bookshelf} {by} {The Pragmatic Programmers, {L.L.C.}}}" }
-@string { p_princeton_university_press = "Princeton University Press" }
+@string { p_princeton_university_press = "{Princeton University Press}" }
 @string { p_project_gutenberg = "{Project Gutenberg Literary Archive Foundation}" }
 @string { p_python_morsels = "{Python Morsels}" }
 @string { p_python_software_foundation = "{\python\ Software Foundation~{(PSF)}}" }
-@string { p_readthedocs_inc = "{Read the Docs, Inc.}" }
+@string { p_readthedocs_inc = "{Read the Docs,~Inc.}" }
 @string { p_springer_cham = "{Springer}" }
 @string { p_springer_nature_limited = "{Springer Nature Limited}" }
 @string { p_springer_new_york = "{Springer New York}" }
 @string { p_springer_science_and_business = "{Springer Science+Business Media}" }
 @string { p_springer_verlag = "{Springer\nobreakdashes-Verlag {GmbH} Germany}" }
 @string { p_story_needle = "{Story Needle}" }
-@string { p_taylor_and_francis = "{Taylor and Francis Ltd.}" }
-@string { p_teubner_b_g = "{B.\ G.\ Teubner}" }
+@string { p_taylor_and_francis = "{Taylor and Francis~Ltd.}" }
+@string { p_teubner_b_g = "{B.~G.~Teubner}" }
 @string { p_typis_academiae = "{Typis Academiae}" }
 @string { p_unicode_consortium = "{The Unicode Consortium}" }
 @string { p_universidad_del_pais_vasco = "{{Universidad del Pa{\'i}s Vasco} / {Euskal Herriko Unibertsitatea}}" }
@@ -616,9 +616,9 @@ @string { p_usas
 @string { p_usenix = "{{USENIX} Association}" }
 @string { p_w3c = "{World Wide Web Consortium~{(W3C)}}" }
 @string { p_wiley = "{Wiley}" }
-@string { p_wiley_and_sons_ltd = "{John Wiley and Sons Ltd.}" }
-@string { p_wiley_vch = "Wiley\nobreakdashes-VCH GmbH" }
-@string { p_wolfram_research = "{Wolfram Research, Inc.}" }
+@string { p_wiley_and_sons_ltd = "{John Wiley and Sons~Ltd.}" }
+@string { p_wiley_vch = "{Wiley\nobreakdashes-VCH GmbH}" }
+@string { p_wolfram_research = "{Wolfram Research,~Inc.}" }
 
 
 %% publisher addresses
@@ -1221,7 +1221,7 @@ @article{B2012DPWP
 
 @techreport{B2017TJONJDIF,
  author = a_bray_tim,
- title = {The \pgls{javascript} Object Notation (\pgls{JSON}) Data Interchange Format},
+ title = {The \pgls{javascript} Object Notation~(\pgls{json}) Data Interchange Format},
  xdata = {rep_rfc},
  number = {8259},
  date = {2017-12},
@@ -1753,7 +1753,7 @@ @article{H2007MA2GE
 
 @book{H2021D0XBPFPSM,
  author = a_helmes_christian,
- title = {defusedxml~0.7.1: \pgls{xml}~Bomb Protection for \python\ stdlib Modules},
+ title = {\pythonilIdx{defusedxml}~0.7.1: \pgls{xml}~Bomb Protection for \python\ stdlib Modules},
  date = {2021-03-08},
  url = {https://pypi.org/project/defusedxml},
  urldate = {2024-12-15}
@@ -1780,7 +1780,7 @@ @book{H2023ABGTP3P
 
 @book{H2024PBOTTCODDSIPP33,
  author = a_hunner_trey,
- title = {\python\ Big~\bigO:~{T}he Time Complexities of Different Data Structures in \python; \python~3.8-3.12},
+ title = {\python\ Big~\bigO:~{T}he Time Complexities of Different Data Structures in \python; \python~3.8\nobreakdashes-3.12},
  date = {2024-04-16},
  publisher = p_python_morsels,
  address = pa_python_morsels,
@@ -1946,7 +1946,7 @@ @book{K2018EIPFEUU
 
 @book{K2019ITXJY,
  author = a_kodes_katie,
- title = {Intro to~\pgls{xml}, JSON, \&~YAML},
+ title = {Intro to~\pgls{xml}, \pgls{json}, \&~YAML},
  date = {2019/2020-09-04},
  publisher = p_payhip,
  address = pa_payhip
@@ -2450,7 +2450,7 @@ @techreport{PEP515
 
 @techreport{PEP585,
  author = a_langa_lukasz,
- title = {Type Hinting Generics In Standard Collections},
+ title = {\glslink{typeHint}{Type Hinting} Generics In Standard Collections},
  xdata = {rep_pep},
  number = {585},
  date = {2019-03-03},
@@ -2461,7 +2461,7 @@ @techreport{PEP585
 @techreport{PEP586,
  author = a_lee_michael # and # a_levkivskyi_ivan # and # a_lehtosalo_jukka,
  title = {\pythonilIdx{Literal} Types},
- type = {rep_pep},
+ xdata = {rep_pep},
  number = {586},
  date = {2019-03-14},
  url = {https://peps.python.org/pep-0586},
@@ -2480,7 +2480,7 @@ @techreport{PEP591
 
 @techreport{PEP604,
  author = a_prados_philippe # and # a_moss_maggie,
- title = {Allow Writing Union Types as \pythonil{X | Y}},
+ title = {Allow Writing Union Types as \pythonil{X | Y}\pythonIdx{"|}},
  xdata = {rep_pep},
  number = {604},
  date = {2019-08-28},
@@ -2521,6 +2521,7 @@ @techreport{PEP635
 @techreport{PEP673,
  author = a_srinivasan_pradeep_kumar # and # a_hilton_balfe_james,
  number = {673},
+ xdata = {rep_pep},
  title = {\pythonilIdx{Self}\pythonIdx{typing!Self} Type},
  date = {2021-11-10/2021-11-17},
  url = {https://peps.python.org/pep-0673},

text/main/classes/dunder/dunder.tex

@@ -1460,4 +1460,53 @@
 \FloatBarrier%
 \endhsection%
 %
+\hsection{Overview over Dunder Methods}%
+%
+\begin{figure}%
+\renewcommand*\DTstylecomment{\relax}%
+\renewcommand*\DTstyle{\small}%
+\def\dunder#1{\expandafter\pythonilIdx{\_\_#1\_\_}\expandafter\pythonIdx{dunder!\_\_#1\_\_}}%
+%
+\dirtree{%
+.1 String Representation.
+.2 \dunder{str}\DTcomment{returns a concise string representation for users; \pythonil{str(a)} $\equiv$ \pythonil{a.\_\_str\_\_()}}.
+.2 \dunder{repr}\DTcomment{a string with all information about the object for programmers; \pythonil{repr(a)} $\equiv$ \pythonil{a.\_\_repr\_\_()}}.
+.1 Hashing.
+.2 \dunder{hash}\DTcomment{compute an integer value representing this object; \pythonil{hash(a)} $\equiv$ \pythonil{a.\_\_hash\_\_()}}.
+.1 Ordering and Equality.
+.2 \dunder{eq}\DTcomment{equality: \pythonil{a == b} $\equiv$ \pythonil{a.\_\_eq\_\_(b)}}.
+.2 \dunder{ne}\DTcomment{inequality: \pythonil{a != b} $\equiv$ \pythonil{a.\_\_ne\_\_(b)}}.
+.2 \dunder{lt}\DTcomment{less than: \pythonil{a < b} $\equiv$ \pythonil{a.\_\_lt\_\_(b)}}.
+.2 \dunder{le}\DTcomment{less than or equal: \pythonil{a <= b} $\equiv$ \pythonil{a.\_\_le\_\_(b)}}.
+.2 \dunder{gt}\DTcomment{greater than: \pythonil{a > b} $\equiv$ \pythonil{a.\_\_gt\_\_(b)}}.
+.2 \dunder{ge}\DTcomment{greater than or equal: \pythonil{a >= b} $\equiv$ \pythonil{a.\_\_ge\_\_(b)}}.
+.1 Context Managers.
+.2 \dunder{enter}\DTcomment{enter a \pythonilIdx{with} statement, returns a value given to \pythonilIdx{as}}.
+.2 \dunder{exit}\DTcomment{leave a \pythonilIdx{with} statement, receive exception information, returns~\pythonil{False} to re-raise caught exceptions, if any}.
+.1 Arithmetics.
+.2 \dunder{add}\DTcomment{add: \pythonil{a + b} $\equiv$ \pythonil{a.\_\_add\_\_(b)}}.
+.2 \dunder{radd}\DTcomment{right-add: \pythonil{a + b} $\equiv$ \pythonil{b.\_\_radd\_\_(a)}, if \pythonil{a.\_\_add\_\_(b)} yields~\pythonilIdx{NotImplemented}}.
+.2 \dunder{sub}\DTcomment{subtract: \pythonil{a - b} $\equiv$ \pythonil{a.\_\_sub\_\_(b)}}.
+.2 \dunder{rsub}\DTcomment{right-subtract: \pythonil{a - b} $\equiv$ \pythonil{b.\_\_rsub\_\_(a)}, if \pythonil{a.\_\_sub\_\_(b)} yields~\pythonilIdx{NotImplemented}}.
+.2 \dunder{mul}\DTcomment{multiply: \pythonil{a * b} $\equiv$ \pythonil{a.\_\_mul\_\_(b)}}.
+.2 \dunder{rmul}\DTcomment{right-multiply: \pythonil{a * b} $\equiv$ \pythonil{b.\_\_rmul\_\_(a)}, if \pythonil{a.\_\_mul\_\_(b)} yields~\pythonilIdx{NotImplemented}}.
+.2 \dunder{truediv}\DTcomment{divide: \pythonil{a / b} $\equiv$ \pythonil{a.\_\_truediv\_\_(b)}}.
+.2 \dunder{rtruediv}\DTcomment{right-divide: \pythonil{a / b} $\equiv$ \pythonil{b.\_\_rtruediv\_\_(a)}, if \pythonil{a.\_\_truediv\_\_(b)} yields~\pythonilIdx{NotImplemented}}.
+.2 \dunder{mod}\DTcomment{modulo-divide: \pythonil{a \% b} $\equiv$ \pythonil{a.\_\_mod\_\_(b)}}.
+.2 \dunder{rmod}\DTcomment{right-modulo-divide: \pythonil{a \% b} $\equiv$ \pythonil{b.\_\_rmod\_\_(a)}, if \pythonil{a.\_\_mod\_\_(b)} yields~\pythonilIdx{NotImplemented}}.
+.2 \dunder{floordiv}\DTcomment{integer-divide: \pythonil{a // b} $\equiv$ \pythonil{a.\_\_floordiv\_\_(b)}}.
+.2 \dunder{rfloordiv}\DTcomment{right-integer-divide: \pythonil{a // b} $\equiv$ \pythonil{b.\_\_rfloordiv\_\_(a)}, if \pythonil{a.\_\_floordiv\_\_(b)} yields~\pythonilIdx{NotImplemented}}.
+.2 \dunder{pow}\DTcomment{exponential: \pythonil{a ** b} $\equiv$ \pythonil{a.\_\_pow\_\_(b)}}.
+.2 \dunder{rpow}\DTcomment{right-exponential: \pythonil{a ** b} $\equiv$ \pythonil{b.\_\_rpow\_\_(a)}, if \pythonil{a.\_\_pow\_\_(b)} yields~\pythonilIdx{NotImplemented}}.
+.2 \dunder{matmul}\DTcomment{matrix-multiply: \pythonil{a @ b} $\equiv$ \pythonil{a.\_\_matmul\_\_(b)}}.
+.2 \dunder{rmatmul}\DTcomment{right-matrix-multiply: \pythonil{a @ b} $\equiv$ \pythonil{b.\_\_rmatmul\_\_(a)}, if \pythonil{a.\_\_matmul\_\_(b)} yields~\pythonilIdx{NotImplemented}}.
+}%
+%
+\caption{An overview of the dunder in \python.}%
+\label{fig:pythonDunder}%
+\end{figure}%
+%
+\FloatBarrier%
+\endhsection%
+%
 \endhsection%