docs: Make use of text highlighting

As of 4.9.7 FreeIPA makes use of raw lexer in doc/designs/subordinate-ids.md.

raw alias has been removed in Pygments 2.8.0:
https://pygments.org/docs/changelog/#version-2-8-0
https://github.com/pygments/pygments/pull/1643

This causes the failure of Azure Docs job.

I think that the original goal of `raw` was the disabling of block
highlighting, which can be done with `text` lexer:
https://pygments.org/docs/lexers/#pygments.lexers.special.TextLexer

Fixes: https://pagure.io/freeipa/issue/8985
Signed-off-by: Stanislav Levin <slev@altlinux.org>
Reviewed-By: Alexander Bokovoy <abokovoy@redhat.com>
This commit is contained in:
Stanislav Levin 2021-09-08 10:18:23 +03:00 committed by Florence Blanc-Renaud
parent 2ba3028b96
commit 0d33d21a05

View File

@ -136,7 +136,7 @@ All count and number attributes are single-value ``INTEGER`` type with
standard integer matching rules. OIDs ``2.16.840.1.113730.3.8.23.8`` and standard integer matching rules. OIDs ``2.16.840.1.113730.3.8.23.8`` and
``2.16.840.1.113730.3.8.23.11`` are reserved for future use. ``2.16.840.1.113730.3.8.23.11`` are reserved for future use.
```raw ```text
attributeTypes: ( attributeTypes: (
2.16.840.1.113730.3.8.23.7 2.16.840.1.113730.3.8.23.7
NAME 'ipaSubUidNumber' NAME 'ipaSubUidNumber'
@ -192,7 +192,7 @@ The ``ipaSubordinateId`` object class is an auxiliary subclass of
``top`` and requires all four subordinate id attributes as well as ``top`` and requires all four subordinate id attributes as well as
``ipaOwner`` attribute`` ``ipaOwner`` attribute``
```raw ```text
objectClasses: ( objectClasses: (
2.16.840.1.113730.3.8.24.4 2.16.840.1.113730.3.8.24.4
NAME 'ipaSubordinateId' NAME 'ipaSubordinateId'
@ -207,7 +207,7 @@ objectClasses: (
The ``ipaSubordinateGid`` and ``ipaSubordinateUid`` are defined for The ``ipaSubordinateGid`` and ``ipaSubordinateUid`` are defined for
future use. IPA always assumes the presence of ``ipaSubordinateId``. future use. IPA always assumes the presence of ``ipaSubordinateId``.
```raw ```text
objectClasses: ( objectClasses: (
2.16.840.1.113730.3.8.24.2 2.16.840.1.113730.3.8.24.2
NAME 'ipaSubordinateUid' NAME 'ipaSubordinateUid'
@ -233,7 +233,7 @@ Subordinate id entries have the structural object class
classes ``ipaSubordinateId``, ``ipaSubordinateGid``, or classes ``ipaSubordinateId``, ``ipaSubordinateGid``, or
``ipaSubordinateUid``. ``ipaUniqueId`` is used as a primary key (RDN). ``ipaSubordinateUid``. ``ipaUniqueId`` is used as a primary key (RDN).
```raw ```text
objectClasses: ( objectClasses: (
2.16.840.1.113730.3.8.24.5 2.16.840.1.113730.3.8.24.5
NAME 'ipaSubordinateIdEntry' NAME 'ipaSubordinateIdEntry'
@ -278,7 +278,7 @@ to use the value of entry attributes as step size.
The config plugin has a new option to enable or disable generation of The config plugin has a new option to enable or disable generation of
subordinate id entries for new users: subordinate id entries for new users:
```raw ```text
$ ipa config-mod --user-default-subid=true $ ipa config-mod --user-default-subid=true
``` ```
@ -286,7 +286,7 @@ Subordinate ids are managed by a new plugin class. The ``subid-add``
and ``subid-del`` commands are hidden from command line. New subordinate and ``subid-del`` commands are hidden from command line. New subordinate
ids are generated and auto-assigned with ``subid-generate``. ids are generated and auto-assigned with ``subid-generate``.
```raw ```text
$ ipa help subid $ ipa help subid
Topic commands: Topic commands:
subid-find Search for subordinate id. subid-find Search for subordinate id.
@ -297,7 +297,7 @@ Topic commands:
subid-stats Subordinate id statistics subid-stats Subordinate id statistics
``` ```
```raw ```text
$ ipa subid-generate --owner testuser9 $ ipa subid-generate --owner testuser9
----------------------------------------------------------- -----------------------------------------------------------
Added subordinate id "aa28f132-457c-488b-82e1-d123727e4f81" Added subordinate id "aa28f132-457c-488b-82e1-d123727e4f81"
@ -312,7 +312,7 @@ Added subordinate id "aa28f132-457c-488b-82e1-d123727e4f81"
``` ```
```raw ```text
$ ipa subid-find --owner testuser9 $ ipa subid-find --owner testuser9
------------------------ ------------------------
1 subordinate id matched 1 subordinate id matched
@ -328,7 +328,7 @@ Number of entries returned 1
---------------------------- ----------------------------
``` ```
```raw ```text
$ ipa -vv subid-stats $ ipa -vv subid-stats
... ...
ipa: INFO: Response: { ipa: INFO: Response: {
@ -432,7 +432,7 @@ The command uses automatic LDAPI EXTERNAL bind when it's executed as
root user. Other it requires valid Kerberos TGT of an admin or user root user. Other it requires valid Kerberos TGT of an admin or user
administrator. administrator.
```raw ```text
# /usr/libexec/ipa/ipa-subids --help # /usr/libexec/ipa/ipa-subids --help
Usage: ipa-subids Usage: ipa-subids
@ -479,7 +479,7 @@ The ``user-find`` command search by start value of subordinate uid and
gid range. The new command ``user-match-subid`` can be used to find a gid range. The new command ``user-match-subid`` can be used to find a
user by any subordinate id in their range. user by any subordinate id in their range.
```raw ```text
$ ipa subid-match --subuid=2147549183 $ ipa subid-match --subuid=2147549183
------------------------ ------------------------
1 subordinate id matched 1 subordinate id matched
@ -528,7 +528,7 @@ attribute to fetch ``uidNumber`` from the user object.
### Deref control example ### Deref control example
```raw ```text
$ ldapsearch -L -E '!deref=ipaOwner:uid,uidNumber' \ $ ldapsearch -L -E '!deref=ipaOwner:uid,uidNumber' \
-b 'cn=subids,cn=accounts,dc=ipasubid,dc=test' \ -b 'cn=subids,cn=accounts,dc=ipasubid,dc=test' \
'(ipaOwner=uid=testuser10,cn=users,cn=accounts,dc=ipasubid,dc=test)' '(ipaOwner=uid=testuser10,cn=users,cn=accounts,dc=ipasubid,dc=test)'