X-Git-Url: https://git.openssl.org/gitweb/?p=openssl.git;a=blobdiff_plain;f=crypto%2Fobjects%2FREADME.md;fp=crypto%2Fobjects%2FREADME.md;h=49c749887d2f017af7b14e1bea6f53ba5e3a6955;hp=700f9c5e54f964d3e65fd3479b11af7a9d35ceb9;hb=1dc1ea182be183d8a393fdce4494360aee059cd2;hpb=036cbb6bbf30955abdcffaf6e52cd926d8d8ee75 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. -