author: kx <kx@radix-linux.su> 2024-12-30 12:16:19 +0300
committer: kx <kx@radix-linux.su> 2024-12-30 12:16:19 +0300
commit: af4d49422d9c2db9223933cc251c8ba6b4944580
parent: ebc15ef0c9527c78a6462a9b8ed61887d52fb434
Commit Summary:
Diffstat:
24 files changed, 196 insertions, 18 deletions
diff --git a/man/Makefile.am b/man/Makefile.am
index fb233f9..3a3d2ed 100644
--- a/man/Makefile.am
+++ b/man/Makefile.am
@@ -1,14 +1,20 @@
SUBDIRS = ru
-MAN3 = iadc.3mpu iadd.3mpu \
- isbb.3mpu isub.3mpu \
- shifts.3mpu \
- isal.3mpu isar.3mpu \
- ishl.3mpu ishr.3mpu \
- circular-shifts.3mpu \
- ircl.3mpu ircr.3mpu \
- irol.3mpu iror.3mpu
+MAN3 = iadc.3mpu iadd.3mpu \
+ isbb.3mpu isub.3mpu \
+ shifts.3mpu \
+ isal.3mpu isar.3mpu \
+ ishl.3mpu ishr.3mpu \
+ circular-shifts.3mpu \
+ ircl.3mpu ircr.3mpu \
+ irol.3mpu iror.3mpu \
+ shifts-n.3mpu \
+ isaln.3mpu isarn.3mpu \
+ ishln.3mpu ishrn.3mpu \
+ circular-shifts-n.3mpu \
+ ircln.3mpu ircrn.3mpu \
+ iroln.3mpu irorn.3mpu
MAN7 = libmpu.7
diff --git a/man/circular-shifts-n.3mpu b/man/circular-shifts-n.3mpu
new file mode 100644
index 0000000..9eeac3d
--- /dev/null
+++ b/man/circular-shifts-n.3mpu
@@ -0,0 +1,38 @@
+.\" Copyright 2024 Andrew V.Kosteltsev (kx@radix-linux.su)
+.\"
+.\"
+.TH circular\-shifts\-n 3 "December 27, 2024" "libmpu" "LibMPU Programmer's Manual"
+.SH NAME
+\fBiroln\fP, \fBirorn\fP, \fBircln\fP, \fBircrn\fP \- cyclic shift operations by \fBn\fP bits
+.SH SYNOPSIS
+.nf
+.B #include <libmpu.h>
+.PP
+.BI "void iroln( mpu_int *" c ", mpu_int *" a ", unsigned int " ns ", int " nb " );
+.BI "void irorn( mpu_int *" c ", mpu_int *" a ", unsigned int " ns ", int " nb " );
+.BI "void ircln( mpu_int *" c ", mpu_int *" a ", unsigned int " ns ", int " nb " );
+.BI "void ircrn( mpu_int *" c ", mpu_int *" a ", unsigned int " ns ", int " nb " );
+.fi
+.SH DESCRIPTION
+The action of these functions is similar to \fBirol\fP(), \fBiror\fP(), \fBircl\fP(), \fBircr\fP(),
+except that they shift their operands by the number of bits specified by the \fBns\fP parameter.
+The state of the carry flag \fBC\fP is determined by the last pushed outward bit.
+.sp
+.SH SEE ALSO
+.BR iadd(3),
+.BR iadc(3),
+.BR isub(3),
+.BR isbb(3),
+.BR ishl(3),
+.BR ishr(3),
+.BR isal(3),
+.BR isar(3),
+.BR irol(3),
+.BR iror(3),
+.BR ircl(3),
+.BR ircr(3),
+.BR ishln(3),
+.BR ishrn(3),
+.BR isaln(3),
+.BR isarn(3).
+
diff --git a/man/circular-shifts.3mpu b/man/circular-shifts.3mpu
index 97a9fb8..fc59829 100644
--- a/man/circular-shifts.3mpu
+++ b/man/circular-shifts.3mpu
@@ -22,7 +22,7 @@ located at address \fBa\fP will remain unchanged after the operation if the spac
it does not overlap with the space occupied by variable \fBc\fP.
.PP
When performing cyclic shift operations, the carry flag \fBC\fP always contains the value of the
-last putted forward bit. The following types of cyclic shift operations are available:
+last pushed outward bit. The following types of cyclic shift operations are available:
.PP
.RS 3
ROL \- cyclic shift to the left by one bit.
diff --git a/man/ircln.3mpu b/man/ircln.3mpu
new file mode 100644
index 0000000..441dbdf
--- /dev/null
+++ b/man/ircln.3mpu
@@ -0,0 +1 @@
+.so man3/circular-shifts-n.3mpu
diff --git a/man/ircrn.3mpu b/man/ircrn.3mpu
new file mode 100644
index 0000000..441dbdf
--- /dev/null
+++ b/man/ircrn.3mpu
@@ -0,0 +1 @@
+.so man3/circular-shifts-n.3mpu
diff --git a/man/iroln.3mpu b/man/iroln.3mpu
new file mode 100644
index 0000000..441dbdf
--- /dev/null
+++ b/man/iroln.3mpu
@@ -0,0 +1 @@
+.so man3/circular-shifts-n.3mpu
diff --git a/man/irorn.3mpu b/man/irorn.3mpu
new file mode 100644
index 0000000..441dbdf
--- /dev/null
+++ b/man/irorn.3mpu
@@ -0,0 +1 @@
+.so man3/circular-shifts-n.3mpu
diff --git a/man/isaln.3mpu b/man/isaln.3mpu
new file mode 100644
index 0000000..c55f38a
--- /dev/null
+++ b/man/isaln.3mpu
@@ -0,0 +1 @@
+.so man3/shifts-n.3mpu
diff --git a/man/isarn.3mpu b/man/isarn.3mpu
new file mode 100644
index 0000000..c55f38a
--- /dev/null
+++ b/man/isarn.3mpu
@@ -0,0 +1 @@
+.so man3/shifts-n.3mpu
diff --git a/man/ishln.3mpu b/man/ishln.3mpu
new file mode 100644
index 0000000..c55f38a
--- /dev/null
+++ b/man/ishln.3mpu
@@ -0,0 +1 @@
+.so man3/shifts-n.3mpu
diff --git a/man/ishrn.3mpu b/man/ishrn.3mpu
new file mode 100644
index 0000000..c55f38a
--- /dev/null
+++ b/man/ishrn.3mpu
@@ -0,0 +1 @@
+.so man3/shifts-n.3mpu
diff --git a/man/ru/Makefile.am b/man/ru/Makefile.am
index 34d7f3a..361751f 100644
--- a/man/ru/Makefile.am
+++ b/man/ru/Makefile.am
@@ -3,14 +3,20 @@ LANG = ru
mandir = @mandir@/$(LANG)
-MAN3 = iadc.3mpu iadd.3mpu \
- isbb.3mpu isub.3mpu \
- shifts.3mpu \
- isal.3mpu isar.3mpu \
- ishl.3mpu ishr.3mpu \
- circular-shifts.3mpu \
- ircl.3mpu ircr.3mpu \
- irol.3mpu iror.3mpu
+MAN3 = iadc.3mpu iadd.3mpu \
+ isbb.3mpu isub.3mpu \
+ shifts.3mpu \
+ isal.3mpu isar.3mpu \
+ ishl.3mpu ishr.3mpu \
+ circular-shifts.3mpu \
+ ircl.3mpu ircr.3mpu \
+ irol.3mpu iror.3mpu \
+ shifts-n.3mpu \
+ isaln.3mpu isarn.3mpu \
+ ishln.3mpu ishrn.3mpu \
+ circular-shifts-n.3mpu \
+ ircln.3mpu ircrn.3mpu \
+ iroln.3mpu irorn.3mpu
MAN7 = libmpu.7
diff --git a/man/ru/circular-shifts-n.3mpu b/man/ru/circular-shifts-n.3mpu
new file mode 100644
index 0000000..61de3d2
--- /dev/null
+++ b/man/ru/circular-shifts-n.3mpu
@@ -0,0 +1,38 @@
+.\" Copyright 2024 Andrew V.Kosteltsev (kx@radix-linux.su)
+.\"
+.\"
+.TH circular\-shifts\-n 3 "December 27, 2024" "libmpu" "LibMPU Programmer's Manual"
+.SH NAME
+\fBiroln\fP, \fBirorn\fP, \fBircln\fP, \fBircrn\fP \- операции циклического сдвига на \fBn\fP бит
+.SH SYNOPSIS
+.nf
+.B #include <libmpu.h>
+.PP
+.BI "void iroln( mpu_int *" c ", mpu_int *" a ", unsigned int " ns ", int " nb " );
+.BI "void irorn( mpu_int *" c ", mpu_int *" a ", unsigned int " ns ", int " nb " );
+.BI "void ircln( mpu_int *" c ", mpu_int *" a ", unsigned int " ns ", int " nb " );
+.BI "void ircrn( mpu_int *" c ", mpu_int *" a ", unsigned int " ns ", int " nb " );
+.fi
+.SH DESCRIPTION
+Действие данных функций аналогично функциям \fBirol\fP(), \fBiror\fP(), \fBircl\fP(), \fBircr\fP(),
+за исключением того, что они сдвигают свои операнды на заданное параметром \fBns\fP количество бит.
+Состояние флага переноса \fBC\fP определяется последним выдвинутым битом.
+.sp
+.SH SEE ALSO
+.BR iadd(3),
+.BR iadc(3),
+.BR isub(3),
+.BR isbb(3),
+.BR ishl(3),
+.BR ishr(3),
+.BR isal(3),
+.BR isar(3),
+.BR irol(3),
+.BR iror(3),
+.BR ircl(3),
+.BR ircr(3),
+.BR ishln(3),
+.BR ishrn(3),
+.BR isaln(3),
+.BR isarn(3).
+
diff --git a/man/ru/ircln.3mpu b/man/ru/ircln.3mpu
new file mode 100644
index 0000000..441dbdf
--- /dev/null
+++ b/man/ru/ircln.3mpu
@@ -0,0 +1 @@
+.so man3/circular-shifts-n.3mpu
diff --git a/man/ru/ircrn.3mpu b/man/ru/ircrn.3mpu
new file mode 100644
index 0000000..441dbdf
--- /dev/null
+++ b/man/ru/ircrn.3mpu
@@ -0,0 +1 @@
+.so man3/circular-shifts-n.3mpu
diff --git a/man/ru/iroln.3mpu b/man/ru/iroln.3mpu
new file mode 100644
index 0000000..441dbdf
--- /dev/null
+++ b/man/ru/iroln.3mpu
@@ -0,0 +1 @@
+.so man3/circular-shifts-n.3mpu
diff --git a/man/ru/irorn.3mpu b/man/ru/irorn.3mpu
new file mode 100644
index 0000000..441dbdf
--- /dev/null
+++ b/man/ru/irorn.3mpu
@@ -0,0 +1 @@
+.so man3/circular-shifts-n.3mpu
diff --git a/man/ru/isaln.3mpu b/man/ru/isaln.3mpu
new file mode 100644
index 0000000..c55f38a
--- /dev/null
+++ b/man/ru/isaln.3mpu
@@ -0,0 +1 @@
+.so man3/shifts-n.3mpu
diff --git a/man/ru/isarn.3mpu b/man/ru/isarn.3mpu
new file mode 100644
index 0000000..c55f38a
--- /dev/null
+++ b/man/ru/isarn.3mpu
@@ -0,0 +1 @@
+.so man3/shifts-n.3mpu
diff --git a/man/ru/ishln.3mpu b/man/ru/ishln.3mpu
new file mode 100644
index 0000000..c55f38a
--- /dev/null
+++ b/man/ru/ishln.3mpu
@@ -0,0 +1 @@
+.so man3/shifts-n.3mpu
diff --git a/man/ru/ishrn.3mpu b/man/ru/ishrn.3mpu
new file mode 100644
index 0000000..c55f38a
--- /dev/null
+++ b/man/ru/ishrn.3mpu
@@ -0,0 +1 @@
+.so man3/shifts-n.3mpu
diff --git a/man/ru/shifts-n.3mpu b/man/ru/shifts-n.3mpu
new file mode 100644
index 0000000..b894563
--- /dev/null
+++ b/man/ru/shifts-n.3mpu
@@ -0,0 +1,37 @@
+.\" Copyright 2024 Andrew V.Kosteltsev (kx@radix-linux.su)
+.\"
+.\"
+.TH shifts\-n 3 "December 27, 2024" "libmpu" "LibMPU Programmer's Manual"
+.SH NAME
+\fBishln\fP, \fBishrn\fP, \fBisaln\fP, \fBisarn\fP \- операции логического и ариметического сдвига на \fBn\fP бит
+.SH SYNOPSIS
+.nf
+.B #include <libmpu.h>
+.PP
+.BI "void ishln( mpu_int *" c ", mpu_int *" a ", unsigned int " ns ", int " nb " );
+.BI "void ishrn( mpu_int *" c ", mpu_int *" a ", unsigned int " ns ", int " nb " );
+.BI "void isaln( mpu_int *" c ", mpu_int *" a ", unsigned int " ns ", int " nb " );
+.BI "void isarn( mpu_int *" c ", mpu_int *" a ", unsigned int " ns ", int " nb " );
+.fi
+.SH DESCRIPTION
+Действие данных функций аналогично функциям \fBishl\fP(), \fBishr\fP(), \fBisal\fP(), \fBisar\fP(),
+за исключением того, что они сдвигают свои операнды на заданное параметром \fBns\fP количество бит.
+Состояние флага переноса \fBC\fPопределяется последним выдвинутым битом.
+.sp
+.SH SEE ALSO
+.BR iadd(3),
+.BR iadc(3),
+.BR isub(3),
+.BR isbb(3),
+.BR ishl(3),
+.BR ishr(3),
+.BR isal(3),
+.BR isar(3),
+.BR irol(3),
+.BR iror(3),
+.BR ircl(3),
+.BR ircr(3),
+.BR iroln(3),
+.BR irorn(3),
+.BR ircln(3),
+.BR ircrn(3).
diff --git a/man/shifts-n.3mpu b/man/shifts-n.3mpu
new file mode 100644
index 0000000..1d4b2ec
--- /dev/null
+++ b/man/shifts-n.3mpu
@@ -0,0 +1,37 @@
+.\" Copyright 2024 Andrew V.Kosteltsev (kx@radix-linux.su)
+.\"
+.\"
+.TH shifts\-n 3 "December 27, 2024" "libmpu" "LibMPU Programmer's Manual"
+.SH NAME
+\fBishln\fP, \fBishrn\fP, \fBisaln\fP, \fBisarn\fP \- Logical and arithmetic shift operations by \fBn\fP bits
+.SH SYNOPSIS
+.nf
+.B #include <libmpu.h>
+.PP
+.BI "void ishln( mpu_int *" c ", mpu_int *" a ", unsigned int " ns ", int " nb " );
+.BI "void ishrn( mpu_int *" c ", mpu_int *" a ", unsigned int " ns ", int " nb " );
+.BI "void isaln( mpu_int *" c ", mpu_int *" a ", unsigned int " ns ", int " nb " );
+.BI "void isarn( mpu_int *" c ", mpu_int *" a ", unsigned int " ns ", int " nb " );
+.fi
+.SH DESCRIPTION
+The action of these functions is similar to \fBishl\fP(), \fBishr\fP(), \fBisal\fP(), \fBisar\fP(),
+except that they shift their operands by the number of bits specified by the \fBns\fP parameter.
+The state of the carry flag \fBC\fP is determined by the last pushed outward bit.
+.sp
+.SH SEE ALSO
+.BR iadd(3),
+.BR iadc(3),
+.BR isub(3),
+.BR isbb(3),
+.BR ishl(3),
+.BR ishr(3),
+.BR isal(3),
+.BR isar(3),
+.BR irol(3),
+.BR iror(3),
+.BR ircl(3),
+.BR ircr(3),
+.BR iroln(3),
+.BR irorn(3),
+.BR ircln(3),
+.BR ircrn(3).
diff --git a/man/shifts.3mpu b/man/shifts.3mpu
index f781348..3f24a3c 100644
--- a/man/shifts.3mpu
+++ b/man/shifts.3mpu
@@ -22,7 +22,7 @@ variable located at address \fBa\fP will remain unchanged after the operation if
occupied by it does not overlap with the space occupied by variable \fBc\fP.
.PP
When performing shift operations, the carry flag \fBC\fP always contains the value of the last
-putted forward bit. There are the following types of shift operations:
+pushed outward bit. There are the following types of shift operations:
.PP
.RS 3
SHL \- logical unsigned shift to the left by one bit.