diff options
author | Dr. David von Oheimb <David.von.Oheimb@siemens.com> | 2020-06-10 17:49:25 +0200 |
---|---|---|
committer | Dr. David von Oheimb <David.von.Oheimb@siemens.com> | 2020-07-05 11:29:43 +0200 |
commit | 1dc1ea182be183d8a393fdce4494360aee059cd2 (patch) | |
tree | 88ed6f74c0c79a5efa10a7f463061ed223b97fa6 /crypto/objects | |
parent | Rename NOTES*, README*, VERSION, HACKING, LICENSE to .md or .txt (diff) | |
download | openssl-1dc1ea182be183d8a393fdce4494360aee059cd2.tar.xz openssl-1dc1ea182be183d8a393fdce4494360aee059cd2.zip |
Fix many MarkDown issues in {NOTES*,README*,HACKING,LICENSE}.md files
Reviewed-by: Tim Hudson <tjh@openssl.org>
(Merged from https://github.com/openssl/openssl/pull/12109)
Diffstat (limited to 'crypto/objects')
-rw-r--r-- | crypto/objects/README.md | 51 |
1 files changed, 25 insertions, 26 deletions
diff --git a/crypto/objects/README.md b/crypto/objects/README.md index 700f9c5e54..49c749887d 100644 --- a/crypto/objects/README.md +++ b/crypto/objects/README.md @@ -1,44 +1,43 @@ objects.txt syntax ------------------- +================== -To cover all the naming hacks that were previously in objects.h needed some -kind of hacks in objects.txt. +To cover all the naming hacks that were previously in `objects.h` needed some +kind of hacks in `objects.txt`. The basic syntax for adding an object is as follows: - 1 2 3 4 : shortName : Long Name + 1 2 3 4 : shortName : Long Name - If Long Name contains only word characters and hyphen-minus - (0x2D) or full stop (0x2E) then Long Name is used as basis - for the base name in C. Otherwise, the shortName is used. + If Long Name contains only word characters and hyphen-minus + (0x2D) or full stop (0x2E) then Long Name is used as basis + for the base name in C. Otherwise, the shortName is used. - The base name (let's call it 'base') will then be used to - create the C macros SN_base, LN_base, NID_base and OBJ_base. + The base name (let's call it 'base') will then be used to + create the C macros SN_base, LN_base, NID_base and OBJ_base. - Note that if the base name contains spaces, dashes or periods, - those will be converted to underscore. + Note that if the base name contains spaces, dashes or periods, + those will be converted to underscore. Then there are some extra commands: - !Alias foo 1 2 3 4 + !Alias foo 1 2 3 4 - This just makes a name foo for an OID. The C macro - OBJ_foo will be created as a result. + This just makes a name foo for an OID. The C macro + OBJ_foo will be created as a result. - !Cname foo + !Cname foo - This makes sure that the name foo will be used as base name - in C. + This makes sure that the name foo will be used as base name + in C. - !module foo - 1 2 3 4 : shortName : Long Name - !global + !module foo + 1 2 3 4 : shortName : Long Name + !global - The !module command was meant to define a kind of modularity. - What it does is to make sure the module name is prepended - to the base name. !global turns this off. This construction - is not recursive. + The !module command was meant to define a kind of modularity. + What it does is to make sure the module name is prepended + to the base name. !global turns this off. This construction + is not recursive. -Lines starting with # are treated as comments, as well as any line starting +Lines starting with `#` are treated as comments, as well as any line starting with ! and not matching the commands above. - |