From 1dc1ea182be183d8a393fdce4494360aee059cd2 Mon Sep 17 00:00:00 2001 From: "Dr. David von Oheimb" Date: Wed, 10 Jun 2020 17:49:25 +0200 Subject: Fix many MarkDown issues in {NOTES*,README*,HACKING,LICENSE}.md files Reviewed-by: Tim Hudson (Merged from https://github.com/openssl/openssl/pull/12109) --- crypto/objects/README.md | 51 ++++++++++++++++++++++++------------------------ 1 file changed, 25 insertions(+), 26 deletions(-) (limited to 'crypto/objects') 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. - -- cgit v1.2.3