write shit

example/ppic.toml

@@ -1,12 +1,40 @@
+# Identifier is used as an unique symbol for your program.
+# Please choose it carefully to avoid any name conflict.
+# 
+# The value of identifier should only contain alphabet chars and digits and 
+# digits should not be the first char (like C variable naming convention).
+# 
+# More preciously, this identifier is used as the "vendor" part of ProgId.
 identifier = "PineapplePicture"
+# The fully qualified path to the application.
+# 
+# A fully qualified path or absolute path always defines an exact path 
+# from a particular drive or device to a target file or directory, 
+# and does not depend on the current drive or current directory.
+# 
+# Considering Windows use back-slash as path splittor, which is frequently used as escape char,
+# you can utilize "literal strings" syntax in this TOML file to quickly write this path 
+# as this example following does.
 path = 'C:\path\to\ppic.exe'
+# CLSID is an unique UUID or GUID of your program.
 clsid = "{B5291320-FE7C-4069-BF87-A0AC327FCD20}"
 
 [manners]
+# Each manner has a name as its key, and detailed command line arguments list as its value.
+# The name of manner will be used sonner for associating with specific file extension.
+# The command line arguments indicate which program should be executed and how to configure their arguments.
+#
+# Also, you can utilize "literal strings" syntax to write this pair,
+# because quotes usually need special escape in "basic string" syntax.
 common = '"C:\path\to\ppic.exe" "%1"'
 
+# "exts" list hold all potential file extensions related with this program,
+# and the correct manner for opening them.
 [exts]
+# In this case, we bind ".jpg" file extension with "common" manner for opening
+# which was defined above.
 ".jpg" = "common"
+# Set more file extensions with manner defined above.
 ".jfif" = "common"
 ".gif" = "common"
 ".bmp" = "common"