title: koi8-r(7)

text:
# koi8-r(7)

## ИМЯ
koi8-r - набор русских символов в восьмеричном, десятичном и шестнадцатеричном виде

## ОПИСАНИЕ
В RFC 1489 определён 8-битный набор символов KOI8-R. В KOI8-R описаны символы, используемые в русском языке.

### Символы KOI8-R
В следующей таблице показаны символы из набора KOI8-R, являющиеся печатными и отсутствующие в справочной странице ascii(7).

Вос

Дес

Шес

Симв

Описание

200

128

80

─

ОДИНАРНАЯ ГОРИЗОНТАЛЬНАЯ ЛИНИЯ

201

129

81

│

ОДИНАРНАЯ ВЕРТИКАЛЬНАЯ ЛИНИЯ

202

130

82

┌

ОДИНАРНАЯ УГЛОВАЯ ЛИНИЯ ВНИЗ И НАПРАВО

203

131

83

┐

ОДИНАРНАЯ УГЛОВАЯ ЛИНИЯ ВНИЗ И НАЛЕВО

204

132

84

└

ОДИНАРНАЯ УГЛОВАЯ ЛИНИЯ ВВЕРХ И НАПРАВО

205

133

85

┘

ОДИНАРНАЯ УГЛОВАЯ ЛИНИЯ ВВЕРХ И НАЛЕВО

206

134

86

├

ОДИНАРНАЯ ВЕРТИКАЛЬНАЯ ЛИНИЯ С ЛИНИЕЙ ВПРАВО

207

135

87

┤

ОДИНАРНАЯ ВЕРТИКАЛЬНАЯ ЛИНИЯ С ЛИНИЕЙ ВЛЕВО

210

136

88

┬

ОДИНАРНАЯ ГОРИЗОНТАЛЬНАЯ ЛИНИЯ С ЛИНИЕЙ ВНИЗ

211

137

89

┴

ОДИНАРНАЯ ГОРИЗОНТАЛЬНАЯ ЛИНИЯ С ЛИНИЕЙ ВВЕРХ

212

138

8A

┼

ОДИНАРНАЯ ГОРИЗОНТАЛЬНАЯ ЛИНИЯ С

ОДИНАРНОЙ ВЕРТИКАЛЬНОЙ ЛИНИЕЙ

213

139

8B

▀

ПОЛОВИНА ПРЯМОУГОЛЬНИКА ВВЕРХУ

214

140

8C

▄

ПОЛОВИНА ПРЯМОУГОЛЬНИКА ВНИЗУ

215

141

8D

█

ПОЛНЫЙ ПРЯМОУГОЛЬНИК

216

142

8E

▌

ПОЛОВИНА ПРЯМОУГОЛЬНИКА СЛЕВА

217

143

8F

▐

ПОЛОВИНА ПРЯМОУГОЛЬНИКА СПРАВА

220

144

90

░

ЛЁГКОЕ ЗАПОЛНЕНИЕ

221

145

91

▒

СРЕДНЕЕ ЗАПОЛНЕНИЕ

222

146

92

▓

ТЁМНОЕ ЗАПОЛНЕНИЕ

223

147

93

⌠

ВЕРХНЯЯ ПОЛОВИНА ИНТЕГРАЛА

224

148

94

■

ЧЁРНЫЙ КВАДРАТ

225

149

95

∙

МЕТКА В ЦЕНТРЕ

226

150

96

√

КВАДРАТНЫЙ КОРЕНЬ

227

151

97

≈

ПРИМЕРНО РАВНО

230

152

98

≤

МЕНЬШЕ ИЛИ РАВНО

231

153

99

≥

БОЛЬШЕ ИЛИ РАВНО

232

154

9A

НЕРАЗРЫВНЫЙ ПРОБЕЛ

233

155

9B

⌡

НИЖНЯЯ ЧАСТЬ ИНТЕГРАЛА

234

156

9C

°

ЗНАК ГРАДУСА

235

157

9D

²

ЦИФРА ДВА ВВЕРХУ МЕЛКИМ ШРИФТОМ

236

158

9E

·

ТОЧКА В ЦЕНТРЕ

237

159

9F

÷

ЗНАК ДЕЛЕНИЯ

240

160

A0

═

ДВОЙНАЯ ГОРИЗОНТАЛЬНАЯ ЛИНИЯ

241

161

A1

║

ДВОЙНАЯ ВЕРТИКАЛЬНАЯ ЛИНИЯ

242

162

A2

╒

ДВОЙНАЯ ЛИНИЯ ВПРАВО И ОДИНАРНАЯ ЛИНИЯ ВНИЗ

243

163

A3

ё

КИРИЛЛИЧЕСКАЯ СТРОЧНАЯ БУКВА ё

244

164

A4

╓

ДВОЙНАЯ ЛИНИЯ ВНИЗ И ОДИНАРНАЯ ЛИНИЯ ВПРАВО

245

165

A5

╔

ДВОЙНАЯ ЛИНИЯ ВНИЗ И ВПРАВО

246

166

A6

╕

ОДИНАРНАЯ ЛИНИЯ ВНИЗ И ДВОЙНАЯ ЛИНИЯ ВЛЕВО

247

167

A7

╖

ДВОЙНАЯ ЛИНИЯ ВНИЗ И ОДИНАРНАЯ ЛИНИЯ ВЛЕВО

250

168

A8

╗

ДВОЙНАЯ ЛИНИЯ ВНИЗ И ВЛЕВО

251

169

A9

╘

ОДИНАРНАЯ ЛИНИЯ ВВЕРХ И ДВОЙНАЯ ЛИНИЯ ВПРАВО

252

170

AA

╙

ДВОЙНАЯ ЛИНИЯ ВВЕРХ И ОДИНАРНАЯ ЛИНИЯ ВПРАВО

253

171

AB

╚

ДВОЙНАЯ ЛИНИЯ ВВЕРХ И ВПРАВО

254

172

AC

╛

ОДИНАРНАЯ ЛИНИЯ ВВЕРХ И ДВОЙНАЯ ЛИНИЯ ВЛЕВО

255

173

AD

╜

ДВОЙНАЯ ЛИНИЯ ВВЕРХ И ОДИНАРНАЯ ЛИНИЯ ВЛЕВО

256

174

AE

╝

ДВОЙНАЯ ЛИНИЯ ВВЕРХ И ВЛЕВО

257

175

AF

╞

ОДИНАРНАЯ ВЕРТИКАЛЬНАЯ ЛИНИЯ И

ДВОЙНАЯ ЛИНИЯ ВПРАВО

260

176

B0

╟

ДВОЙНАЯ ВЕРТИКАЛЬНАЯ ЛИНИЯ И

ОДИНАРНАЯ ЛИНИЯ ВПРАВО

261

177

B1

╠

ДВОЙНАЯ ВЕРТИКАЛЬНАЯ ЛИНИЯ И

ДВОЙНАЯ ЛИНИЯ ВПРАВО

262

178

B2

╡

ОДИНАРНАЯ ВЕРТИКАЛЬНАЯ ЛИНИЯ И

ДВОЙНАЯ ЛИНИЯ ВЛЕВО

263

179

B3

Ё

КИРИЛЛИЧЕСКАЯ ПРОПИСНАЯ БУКВА Ё

264

180

B4

╢

ДВОЙНАЯ ВЕРТИКАЛЬНАЯ ЛИНИЯ И

ОДИНАРНАЯ ЛИНИЯ ВЛЕВО

265

181

B5

╣

ДВОЙНАЯ ВЕРТИКАЛЬНАЯ ЛИНИЯ И ДВОЙНАЯ ЛИНИЯ ВЛЕВО

266

182

B6

╤

ДВОЙНАЯ ГОРИЗОНТАЛЬНАЯ ЛИНИЯ И

ОДИНАРНАЯ ЛИНИЯ ВНИЗ

267

183

B7

╥

ОДИНАРНАЯ ГОРИЗОНТАЛЬНАЯ ЛИНИЯ И

ДВОЙНАЯ ЛИНИЯ ВНИЗ

270

184

B8

╦

ДВОЙНАЯ ГОРИЗОНТАЛЬНАЯ ЛИНИЯ И ЛИНИЯ ВНИЗ

271

185

B9

╧

ДВОЙНАЯ ГОРИЗОНТАЛЬНАЯ ЛИНИЯ И

ОДИНАРНАЯ ЛИНИЯ ВВЕРХ

272

186

BA

╨

ОДИНАРНАЯ ГОРИЗОНТАЛЬНАЯ ЛИНИЯ И

ДВОЙНАЯ ЛИНИЯ ВВЕРХ

273

187

BB

╩

ДВОЙНАЯ ГОРИЗОНТАЛЬНАЯ ЛИНИЯ И

ДВОЙНАЯ ЛИНИЯ ВВЕРХ

274

188

BC

╪

ОДИНАРНАЯ ВЕРТИКАЛЬНАЯ ЛИНИЯ И ДВОЙНАЯ ГОРИЗОНТАЛЬНАЯ ЛИНИЯ

275

189

BD

╫

ДВОЙНАЯ ВЕРТИКАЛЬНАЯ ЛИНИЯ И ОДИНАРНАЯ ГОРИЗОНТАЛЬНАЯ ЛИНИЯ

276

190

BE

╬

ДВОЙНАЯ ВЕРТИКАЛЬНАЯ ЛИНИЯ И

ДВОЙНАЯ ГОРИЗОНТАЛЬНАЯ ЛИНИЯ

277

191

BF

©

ЗНАК ОХРАНЫ АВТОРСКОГО ПРАВА

300

192

C0

ю

КИРИЛЛИЧЕСКАЯ СТРОЧНАЯ БУКВА ю

301

193

C1

а

КИРИЛЛИЧЕСКАЯ СТРОЧНАЯ БУКВА а

302

194

C2

б

КИРИЛЛИЧЕСКАЯ СТРОЧНАЯ БУКВА б

303

195

C3

ц

КИРИЛЛИЧЕСКАЯ СТРОЧНАЯ БУКВА ц

304

196

C4

д

КИРИЛЛИЧЕСКАЯ СТРОЧНАЯ БУКВА д

305

197

C5

е

КИРИЛЛИЧЕСКАЯ СТРОЧНАЯ БУКВА е

306

198

C6

ф

КИРИЛЛИЧЕСКАЯ СТРОЧНАЯ БУКВА ф

307

199

C7

г

КИРИЛЛИЧЕСКАЯ СТРОЧНАЯ БУКВА г

310

200

C8

х

КИРИЛЛИЧЕСКАЯ СТРОЧНАЯ БУКВА х

311

201

C9

и

КИРИЛЛИЧЕСКАЯ СТРОЧНАЯ БУКВА и

312

202

CA

й

КИРИЛЛИЧЕСКАЯ СТРОЧНАЯ БУКВА й

313

203

CB

к

КИРИЛЛИЧЕСКАЯ СТРОЧНАЯ БУКВА к

314

204

CC

л

КИРИЛЛИЧЕСКАЯ СТРОЧНАЯ БУКВА л

315

205

CD

м

КИРИЛЛИЧЕСКАЯ СТРОЧНАЯ БУКВА м

316

206

CE

н

КИРИЛЛИЧЕСКАЯ СТРОЧНАЯ БУКВА н

317

207

CF

о

КИРИЛЛИЧЕСКАЯ СТРОЧНАЯ БУКВА о

320

208

D0

п

КИРИЛЛИЧЕСКАЯ СТРОЧНАЯ БУКВА п

321

209

D1

я

КИРИЛЛИЧЕСКАЯ СТРОЧНАЯ БУКВА я

322

210

D2

р

КИРИЛЛИЧЕСКАЯ СТРОЧНАЯ БУКВА р

323

211

D3

с

КИРИЛЛИЧЕСКАЯ СТРОЧНАЯ БУКВА с

324

212

D4

т

КИРИЛЛИЧЕСКАЯ СТРОЧНАЯ БУКВА т

325

213

D5

у

КИРИЛЛИЧЕСКАЯ СТРОЧНАЯ БУКВА у

326

214

D6

ж

КИРИЛЛИЧЕСКАЯ СТРОЧНАЯ БУКВА ж

327

215

D7

в

КИРИЛЛИЧЕСКАЯ СТРОЧНАЯ БУКВА в

330

216

D8

ь

КИРИЛЛИЧЕСКАЯ СТРОЧНАЯ БУКВА ь

331

217

D9

ы

КИРИЛЛИЧЕСКАЯ СТРОЧНАЯ БУКВА ы

332

218

DA

з

КИРИЛЛИЧЕСКАЯ СТРОЧНАЯ БУКВА з

333

219

DB

ш

КИРИЛЛИЧЕСКАЯ СТРОЧНАЯ БУКВА ш

334

220

DC

э

КИРИЛЛИЧЕСКАЯ СТРОЧНАЯ БУКВА э

335

221

DD

щ

КИРИЛЛИЧЕСКАЯ СТРОЧНАЯ БУКВА щ

336

222

DE

ч

КИРИЛЛИЧЕСКАЯ СТРОЧНАЯ БУКВА ч

337

223

DF

ъ

КИРИЛЛИЧЕСКАЯ СТРОЧНАЯ БУКВА ъ

340

224

E0

Ю

КИРИЛЛИЧЕСКАЯ ПРОПИСНАЯ БУКВА Ю

341

225

E1

А

КИРИЛЛИЧЕСКАЯ ПРОПИСНАЯ БУКВА А

342

226

E2

Б

КИРИЛЛИЧЕСКАЯ ПРОПИСНАЯ БУКВА Б

343

227

E3

Ц

КИРИЛЛИЧЕСКАЯ ПРОПИСНАЯ БУКВА Ц

344

228

E4

Д

КИРИЛЛИЧЕСКАЯ ПРОПИСНАЯ БУКВА Д

345

229

E5

Е

КИРИЛЛИЧЕСКАЯ ПРОПИСНАЯ БУКВА Е

346

230

E6

Ф

КИРИЛЛИЧЕСКАЯ ПРОПИСНАЯ БУКВА Ф

347

231

E7

Г

КИРИЛЛИЧЕСКАЯ ПРОПИСНАЯ БУКВА Г

350

232

E8

Х

КИРИЛЛИЧЕСКАЯ ПРОПИСНАЯ БУКВА Х

351

233

E9

И

КИРИЛЛИЧЕСКАЯ ПРОПИСНАЯ БУКВА И

352

234

EA

Й

КИРИЛЛИЧЕСКАЯ ПРОПИСНАЯ БУКВА Й

353

235

EB

К

КИРИЛЛИЧЕСКАЯ ПРОПИСНАЯ БУКВА К

354

236

EC

Л

КИРИЛЛИЧЕСКАЯ ПРОПИСНАЯ БУКВА Л

355

237

ED

М

КИРИЛЛИЧЕСКАЯ ПРОПИСНАЯ БУКВА М

356

238

EE

Н

КИРИЛЛИЧЕСКАЯ ПРОПИСНАЯ БУКВА Н

357

239

EF

О

КИРИЛЛИЧЕСКАЯ ПРОПИСНАЯ БУКВА О

360

240

F0

П

КИРИЛЛИЧЕСКАЯ ПРОПИСНАЯ БУКВА П

361

241

F1

Я

КИРИЛЛИЧЕСКАЯ ПРОПИСНАЯ БУКВА Я

362

242

F2

Р

КИРИЛЛИЧЕСКАЯ ПРОПИСНАЯ БУКВА Р

363

243

F3

С

КИРИЛЛИЧЕСКАЯ ПРОПИСНАЯ БУКВА С

364

244

F4

Т

КИРИЛЛИЧЕСКАЯ ПРОПИСНАЯ БУКВА Т

365

245

F5

У

КИРИЛЛИЧЕСКАЯ ПРОПИСНАЯ БУКВА У

366

246

F6

Ж

КИРИЛЛИЧЕСКАЯ ПРОПИСНАЯ БУКВА Ж

367

247

F7

В

КИРИЛЛИЧЕСКАЯ ПРОПИСНАЯ БУКВА В

370

248

F8

Ь

КИРИЛЛИЧЕСКАЯ ПРОПИСНАЯ БУКВА Ь

371

249

F9

Ы

КИРИЛЛИЧЕСКАЯ ПРОПИСНАЯ БУКВА Ы

372

250

FA

З

КИРИЛЛИЧЕСКАЯ ПРОПИСНАЯ БУКВА З

373

251

FB

Ш

КИРИЛЛИЧЕСКАЯ ПРОПИСНАЯ БУКВА Ш

374

252

FC

Э

КИРИЛЛИЧЕСКАЯ ПРОПИСНАЯ БУКВА Э

375

253

FD

Щ

КИРИЛЛИЧЕСКАЯ ПРОПИСНАЯ БУКВА Щ

376

254

FE

Ч

КИРИЛЛИЧЕСКАЯ ПРОПИСНАЯ БУКВА Ч

377

255

FF

Ъ

КИРИЛЛИЧЕСКАЯ ПРОПИСНАЯ БУКВА Ъ

## ЗАМЕЧАНИЯ
Данный набор отличается от KOI8-U в позициях A4, A6, A7, AD, B4, B6, B7 и BD (шестнадцатеричные).

## СМОТРИТЕ ТАКЖЕ
ascii(7), charsets(7), cp1251(7), iso_8859-5(7), koi8-u(7), utf-8(7)


package: man-pages-ru

title: koi8-u(7)

text:
# koi8-u(7)

## ИМЯ
koi8-u - набор украинских символов в восьмеричном, десятичном и шестнадцатеричном виде

## ОПИСАНИЕ
В RFC 2310 определён 8-битный набор символов KOI8-U. В KOI8-U описаны символы, используемые в украинском и белорусском языках.

### Символы KOI8-U
В следующей таблице показаны символы из набора KOI8-U, являющиеся печатными и отсутствующие в справочной странице ascii(7).

Вос

Дес

Шес

Симв

Описание

200

128

80

─

ОДИНАРНАЯ ГОРИЗОНТАЛЬНАЯ ЛИНИЯ

201

129

81

│

ОДИНАРНАЯ ВЕРТИКАЛЬНАЯ ЛИНИЯ

202

130

82

┌

ОДИНАРНАЯ УГЛОВАЯ ЛИНИЯ ВНИЗ И НАПРАВО

203

131

83

┐

ОДИНАРНАЯ УГЛОВАЯ ЛИНИЯ ВНИЗ И НАЛЕВО

204

132

84

└

ОДИНАРНАЯ УГЛОВАЯ ЛИНИЯ ВВЕРХ И НАПРАВО

205

133

85

┘

ОДИНАРНАЯ УГЛОВАЯ ЛИНИЯ ВВЕРХ И НАЛЕВО

206

134

86

├

ОДИНАРНАЯ ВЕРТИКАЛЬНАЯ ЛИНИЯ С ЛИНИЕЙ ВПРАВО

207

135

87

┤

ОДИНАРНАЯ ВЕРТИКАЛЬНАЯ ЛИНИЯ С ЛИНИЕЙ ВЛЕВО

210

136

88

┬

ОДИНАРНАЯ ГОРИЗОНТАЛЬНАЯ ЛИНИЯ С ЛИНИЕЙ ВНИЗ

211

137

89

┴

ОДИНАРНАЯ ГОРИЗОНТАЛЬНАЯ ЛИНИЯ С ЛИНИЕЙ ВВЕРХ

212

138

8A

┼

ОДИНАРНАЯ ГОРИЗОНТАЛЬНАЯ ЛИНИЯ С

ОДИНАРНОЙ ВЕРТИКАЛЬНОЙ ЛИНИЕЙ

213

139

8B

▀

ПОЛОВИНА ПРЯМОУГОЛЬНИКА ВВЕРХУ

214

140

8C

▄

ПОЛОВИНА ПРЯМОУГОЛЬНИКА ВНИЗУ

215

141

8D

█

ПОЛНЫЙ ПРЯМОУГОЛЬНИК

216

142

8E

▌

ПОЛОВИНА ПРЯМОУГОЛЬНИКА СЛЕВА

217

143

8F

▐

ПОЛОВИНА ПРЯМОУГОЛЬНИКА СПРАВА

220

144

90

░

ЛЁГКОЕ ЗАПОЛНЕНИЕ

221

145

91

▒

СРЕДНЕЕ ЗАПОЛНЕНИЕ

222

146

92

▓

ТЁМНОЕ ЗАПОЛНЕНИЕ

223

147

93

⌠

ВЕРХНЯЯ ПОЛОВИНА ИНТЕГРАЛА

224

148

94

■

ЧЁРНЫЙ КВАДРАТ

225

149

95

∙

МЕТКА В ЦЕНТРЕ

226

150

96

√

КВАДРАТНЫЙ КОРЕНЬ

227

151

97

≈

ПРИМЕРНО РАВНО

230

152

98

≤

МЕНЬШЕ ИЛИ РАВНО

231

153

99

≥

БОЛЬШЕ ИЛИ РАВНО

232

154

9A

НЕРАЗРЫВНЫЙ ПРОБЕЛ

233

155

9B

⌡

НИЖНЯЯ ЧАСТЬ ИНТЕГРАЛА

234

156

9C

°

ЗНАК ГРАДУСА

235

157

9D

²

ЦИФРА ДВА ВВЕРХУ МЕЛКИМ ШРИФТОМ

236

158

9E

·

ТОЧКА В ЦЕНТРЕ

237

159

9F

÷

ЗНАК ДЕЛЕНИЯ

240

160

A0

═

ДВОЙНАЯ ГОРИЗОНТАЛЬНАЯ ЛИНИЯ

241

161

A1

║

ДВОЙНАЯ ВЕРТИКАЛЬНАЯ ЛИНИЯ

242

162

A2

╒

ДВОЙНАЯ ЛИНИЯ ВПРАВО И ОДИНАРНАЯ ЛИНИЯ ВНИЗ

243

163

A3

ё

КИРИЛЛИЧЕСКАЯ СТРОЧНАЯ БУКВА ё

244

164

A4

є

КИРИЛЛИЧЕСКАЯ СТРОЧНАЯ БУКВА УКРАИНСКАЯ є

245

165

A5

╔

ДВОЙНАЯ ЛИНИЯ ВНИЗ И ВПРАВО

246

166

A6

і

КИРИЛЛИЧЕСКАЯ СТРОЧНАЯ БУКВА БЕЛОРУССКО-УКРАИНСКАЯ «И»

247

167

A7

ї

КИРИЛЛИЧЕСКАЯ СТРОЧНАЯ БУКВА ї (украинская)

250

168

A8

╗

ДВОЙНАЯ ЛИНИЯ ВНИЗ И ВЛЕВО

251

169

A9

╘

ОДИНАРНАЯ ЛИНИЯ ВВЕРХ И ДВОЙНАЯ ЛИНИЯ ВПРАВО

252

170

AA

╙

ДВОЙНАЯ ЛИНИЯ ВВЕРХ И ОДИНАРНАЯ ЛИНИЯ ВПРАВО

253

171

AB

╚

ДВОЙНАЯ ЛИНИЯ ВВЕРХ И ВПРАВО

254

172

AC

╛

ОДИНАРНАЯ ЛИНИЯ ВВЕРХ И ДВОЙНАЯ ЛИНИЯ ВЛЕВО

255

173

AD

ґ

КИРИЛЛИЧЕСКАЯ СТРОЧНАЯ БУКВА ґ

256

174

AE

╝

ДВОЙНАЯ ЛИНИЯ ВВЕРХ И ВЛЕВО

257

175

AF

╞

ОДИНАРНАЯ ВЕРТИКАЛЬНАЯ ЛИНИЯ И

ДВОЙНАЯ ЛИНИЯ ВПРАВО

260

176

B0

╟

ДВОЙНАЯ ВЕРТИКАЛЬНАЯ ЛИНИЯ И

ОДИНАРНАЯ ЛИНИЯ ВПРАВО

261

177

B1

╠

ДВОЙНАЯ ВЕРТИКАЛЬНАЯ ЛИНИЯ И

ДВОЙНАЯ ЛИНИЯ ВПРАВО

262

178

B2

╡

ОДИНАРНАЯ ВЕРТИКАЛЬНАЯ ЛИНИЯ И

ДВОЙНАЯ ЛИНИЯ ВЛЕВО

263

179

B3

Ё

КИРИЛЛИЧЕСКАЯ ПРОПИСНАЯ БУКВА Ё

264

180

B4

Є

КИРИЛЛИЧЕСКАЯ ПРОПИСНАЯ БУКВА Є

265

181

B5

╣

ДВОЙНАЯ ВЕРТИКАЛЬНАЯ ЛИНИЯ И ДВОЙНАЯ ЛИНИЯ ВЛЕВО

266

182

B6

І

КИРИЛЛИЧЕСКАЯ ПРОПИСНАЯ БУКВА БЕЛОРУССКО-УКРАИНСКАЯ «И»

267

183

B7

Ї

КИРИЛЛИЧЕСКАЯ ПРОПИСНАЯ БУКВА Ї (украинская)

270

184

B8

╦

ДВОЙНАЯ ГОРИЗОНТАЛЬНАЯ ЛИНИЯ И ЛИНИЯ ВНИЗ

271

185

B9

╧

ДВОЙНАЯ ГОРИЗОНТАЛЬНАЯ ЛИНИЯ И

ОДИНАРНАЯ ЛИНИЯ ВВЕРХ

272

186

BA

╨

ОДИНАРНАЯ ГОРИЗОНТАЛЬНАЯ ЛИНИЯ И

ДВОЙНАЯ ЛИНИЯ ВВЕРХ

273

187

BB

╩

ДВОЙНАЯ ГОРИЗОНТАЛЬНАЯ ЛИНИЯ И

ДВОЙНАЯ ЛИНИЯ ВВЕРХ

274

188

BC

╪

ОДИНАРНАЯ ВЕРТИКАЛЬНАЯ ЛИНИЯ И ДВОЙНАЯ ГОРИЗОНТАЛЬНАЯ ЛИНИЯ

275

189

BD

Ґ

КИРИЛЛИЧЕСКАЯ ПРОПИСНАЯ БУКВА Ґ

276

190

BE

╬

ДВОЙНАЯ ВЕРТИКАЛЬНАЯ ЛИНИЯ И

ДВОЙНАЯ ГОРИЗОНТАЛЬНАЯ ЛИНИЯ

277

191

BF

©

ЗНАК ОХРАНЫ АВТОРСКОГО ПРАВА

300

192

C0

ю

КИРИЛЛИЧЕСКАЯ СТРОЧНАЯ БУКВА ю

301

193

C1

а

КИРИЛЛИЧЕСКАЯ СТРОЧНАЯ БУКВА а

302

194

C2

б

КИРИЛЛИЧЕСКАЯ СТРОЧНАЯ БУКВА б

303

195

C3

ц

КИРИЛЛИЧЕСКАЯ СТРОЧНАЯ БУКВА ц

304

196

C4

д

КИРИЛЛИЧЕСКАЯ СТРОЧНАЯ БУКВА д

305

197

C5

е

КИРИЛЛИЧЕСКАЯ СТРОЧНАЯ БУКВА е

306

198

C6

ф

КИРИЛЛИЧЕСКАЯ СТРОЧНАЯ БУКВА ф

307

199

C7

г

КИРИЛЛИЧЕСКАЯ СТРОЧНАЯ БУКВА г

310

200

C8

х

КИРИЛЛИЧЕСКАЯ СТРОЧНАЯ БУКВА х

311

201

C9

и

КИРИЛЛИЧЕСКАЯ СТРОЧНАЯ БУКВА и

312

202

CA

й

КИРИЛЛИЧЕСКАЯ СТРОЧНАЯ БУКВА й

313

203

CB

к

КИРИЛЛИЧЕСКАЯ СТРОЧНАЯ БУКВА к

314

204

CC

л

КИРИЛЛИЧЕСКАЯ СТРОЧНАЯ БУКВА л

315

205

CD

м

КИРИЛЛИЧЕСКАЯ СТРОЧНАЯ БУКВА м

316

206

CE

н

КИРИЛЛИЧЕСКАЯ СТРОЧНАЯ БУКВА н

317

207

CF

о

КИРИЛЛИЧЕСКАЯ СТРОЧНАЯ БУКВА о

320

208

D0

п

КИРИЛЛИЧЕСКАЯ СТРОЧНАЯ БУКВА п

321

209

D1

я

КИРИЛЛИЧЕСКАЯ СТРОЧНАЯ БУКВА я

322

210

D2

р

КИРИЛЛИЧЕСКАЯ СТРОЧНАЯ БУКВА р

323

211

D3

с

КИРИЛЛИЧЕСКАЯ СТРОЧНАЯ БУКВА с

324

212

D4

т

КИРИЛЛИЧЕСКАЯ СТРОЧНАЯ БУКВА т

325

213

D5

у

КИРИЛЛИЧЕСКАЯ СТРОЧНАЯ БУКВА у

326

214

D6

ж

КИРИЛЛИЧЕСКАЯ СТРОЧНАЯ БУКВА ж

327

215

D7

в

КИРИЛЛИЧЕСКАЯ СТРОЧНАЯ БУКВА в

330

216

D8

ь

КИРИЛЛИЧЕСКАЯ СТРОЧНАЯ БУКВА ь

331

217

D9

ы

КИРИЛЛИЧЕСКАЯ СТРОЧНАЯ БУКВА ы

332

218

DA

з

КИРИЛЛИЧЕСКАЯ СТРОЧНАЯ БУКВА з

333

219

DB

ш

КИРИЛЛИЧЕСКАЯ СТРОЧНАЯ БУКВА ш

334

220

DC

э

КИРИЛЛИЧЕСКАЯ СТРОЧНАЯ БУКВА э

335

221

DD

щ

КИРИЛЛИЧЕСКАЯ СТРОЧНАЯ БУКВА щ

336

222

DE

ч

КИРИЛЛИЧЕСКАЯ СТРОЧНАЯ БУКВА ч

337

223

DF

ъ

КИРИЛЛИЧЕСКАЯ СТРОЧНАЯ БУКВА ъ

340

224

E0

Ю

КИРИЛЛИЧЕСКАЯ ПРОПИСНАЯ БУКВА Ю

341

225

E1

А

КИРИЛЛИЧЕСКАЯ ПРОПИСНАЯ БУКВА А

342

226

E2

Б

КИРИЛЛИЧЕСКАЯ ПРОПИСНАЯ БУКВА Б

343

227

E3

Ц

КИРИЛЛИЧЕСКАЯ ПРОПИСНАЯ БУКВА Ц

344

228

E4

Д

КИРИЛЛИЧЕСКАЯ ПРОПИСНАЯ БУКВА Д

345

229

E5

Е

КИРИЛЛИЧЕСКАЯ ПРОПИСНАЯ БУКВА Е

346

230

E6

Ф

КИРИЛЛИЧЕСКАЯ ПРОПИСНАЯ БУКВА Ф

347

231

E7

Г

КИРИЛЛИЧЕСКАЯ ПРОПИСНАЯ БУКВА Г

350

232

E8

Х

КИРИЛЛИЧЕСКАЯ ПРОПИСНАЯ БУКВА Х

351

233

E9

И

КИРИЛЛИЧЕСКАЯ ПРОПИСНАЯ БУКВА И

352

234

EA

Й

КИРИЛЛИЧЕСКАЯ ПРОПИСНАЯ БУКВА Й

353

235

EB

К

КИРИЛЛИЧЕСКАЯ ПРОПИСНАЯ БУКВА К

354

236

EC

Л

КИРИЛЛИЧЕСКАЯ ПРОПИСНАЯ БУКВА Л

355

237

ED

М

КИРИЛЛИЧЕСКАЯ ПРОПИСНАЯ БУКВА М

356

238

EE

Н

КИРИЛЛИЧЕСКАЯ ПРОПИСНАЯ БУКВА Н

357

239

EF

О

КИРИЛЛИЧЕСКАЯ ПРОПИСНАЯ БУКВА О

360

240

F0

П

КИРИЛЛИЧЕСКАЯ ПРОПИСНАЯ БУКВА П

361

241

F1

Я

КИРИЛЛИЧЕСКАЯ ПРОПИСНАЯ БУКВА Я

362

242

F2

Р

КИРИЛЛИЧЕСКАЯ ПРОПИСНАЯ БУКВА Р

363

243

F3

С

КИРИЛЛИЧЕСКАЯ ПРОПИСНАЯ БУКВА С

364

244

F4

Т

КИРИЛЛИЧЕСКАЯ ПРОПИСНАЯ БУКВА Т

365

245

F5

У

КИРИЛЛИЧЕСКАЯ ПРОПИСНАЯ БУКВА У

366

246

F6

Ж

КИРИЛЛИЧЕСКАЯ ПРОПИСНАЯ БУКВА Ж

367

247

F7

В

КИРИЛЛИЧЕСКАЯ ПРОПИСНАЯ БУКВА В

370

248

F8

Ь

КИРИЛЛИЧЕСКАЯ ПРОПИСНАЯ БУКВА Ь

371

249

F9

Ы

КИРИЛЛИЧЕСКАЯ ПРОПИСНАЯ БУКВА Ы

372

250

FA

З

КИРИЛЛИЧЕСКАЯ ПРОПИСНАЯ БУКВА З

373

251

FB

Ш

КИРИЛЛИЧЕСКАЯ ПРОПИСНАЯ БУКВА Ш

374

252

FC

Э

КИРИЛЛИЧЕСКАЯ ПРОПИСНАЯ БУКВА Э

375

253

FD

Щ

КИРИЛЛИЧЕСКАЯ ПРОПИСНАЯ БУКВА Щ

376

254

FE

Ч

КИРИЛЛИЧЕСКАЯ ПРОПИСНАЯ БУКВА Ч

377

255

FF

Ъ

КИРИЛЛИЧЕСКАЯ ПРОПИСНАЯ БУКВА Ъ

## ЗАМЕЧАНИЯ
Данный набор отличается от KOI8-R в позициях A4, A6, A7, AD, B4, B6, B7 и BD (шестнадцатеричные).

## СМОТРИТЕ ТАКЖЕ
ascii(7), charsets(7), cp1251(7), iso_8859-5(7), koi8-r(7), utf-8(7)

branch: sisyphus


libc

title: libc(7)

summary: обзор стандартных библиотек C в Linux

text:
# libc(7)

## ИМЯ
libc - обзор стандартных библиотек C в Linux

## ОПИСАНИЕ
Термин «libc» обычно используется как сокращение обозначения «стандартной библиотеки C» — библиотеки стандартных функций, которые могут использоваться всеми программами, написанными на C (и, иногда, программами, написанными на других языках). Из-за некоторых исторических событий (см. ниже), использование термина «libc» как обозначение стандартной библиотеки С в Linux, несколько некорректно.

### glibc
Вне всяких сомнений, наиболее широко используемой в Linux библиотекой C является библиотека GNU C http://www.gnu.org/software/libc/, (http://wwwgnuorg/software/libc/) часто упоминаемая как glibc. В настоящее время данная библиотека используется во всех основных дистрибутивах Linux. Также эта библиотека описана в соответствующих справочных страницах проекта man-pages (в основном, в разделе 3). Документация к glibc также доступна в руководстве glibc, доступном по команде info libc. Выпуск 1.0 glibc состоялся в сентябре 1992 года (до этого было несколько выпусков 0.x). Следующий большой выпуск glibc версии 2.0 состоялся в начале 1997 года.

Путь /lib/libc.so.6 (или подобный), обычно является символической ссылкой на расположение библиотеки glibc, а выполнение этого пути приводит к отображению различной информации о glibc, установленной в системе.

### Linux libc
В первой половине 1990х годов какое-то время существовала Linux libc, ответвление glibc 1.x, созданное разработчиками Linux, которые были не удовлетворены ходом разработки glibc для Linux. Часто, эту библиотеку называли (необоснованно) просто «libc». Было несколько основных версий Linux libc — 2, 3, 4 и 5, а также много промежуточных. Linux libc4 была последней версией, которая использовала формат двоичных файлов a.out и первой версий предоставившей (простейшую) поддержку общих библиотек. Linux libc 5 была первой версией с поддержкой формата двоичных файлов ELF; в этой версии использовалась общая библиотека с soname libc.so.5. Некоторое время Linux libc была стандартной библиотекой Си во многих дистрибутивах Linux.

Однако, несмотря на всю первоначальную заинтересованность в разработке Linux libc, к этому времени была выпущена glibc 2.0 (в 1997 году), которая была однозначно лучше Linux libc, и все основные дистрибутивы Linux, которые использовали Linux libc, скоро переключились обратно на glibc. Чтобы избежать двусмысленности в версиях Linux libc, в glibc 2.0 и последующих версиях в качестве имени общей библиотеки используется soname libc.so.6.

Так как переход с Linux libc на glibc 2.0 произошёл давно, в man-pages Linux libc больше не описывается. Тем не менее частичные упоминания о Linux libc ещё встречаются в некоторых справочных страницах под именами libc4 и libc5.

### Другие библиотеки C
Существует несколько других менее распространённых библиотек C для Linux Эти библиотеки, обычно, меньше glibc, как по возможностям так и по потреблению памяти, и часто предназначены для сборки исполняемых файлов малого размера, используемых, в основном, для разработки встраиваемых систем Linux. Такими библиотеками являются uClibc, dietlibc, и musl libc. Описание этих библиотек охватывается проектом man-pages, если что-то известно.

## СМОТРИТЕ ТАКЖЕ
syscalls(2), getauxval(3), proc(5), feature_test_macros(7), man-pages(7), standards(7), vdso(7)


locale

title: locale(7)

summary: описание поддержки нескольких языков

text:
# locale(7)

## ИМЯ
locale - описание поддержки нескольких языков

## ОБЗОР

```
#include <locale.h>
```

## ОПИСАНИЕ
Локаль — это сочетание языковых и культурных аспектов. Они включают в себя: язык сообщений, различные наборы символов, лексикографические соглашения и т.п. Программа должна определять локализацию и действовать согласно её установкам в целях достижения взаимосвязи различных культур.

Файл <locale.h> описывает типы данных, функции и макросы, необходимые для выполнения этой задачи.

В нём описаны функции: setlocale(3), устанавливающая текущую локаль и localeconv(3), которая возвращает информацию о форматировании чисел.

Существуют различные категории информации в локали, которые программа может использовать; они описаны как макросы. Используя их в качестве первого аргумента функции setlocale(3), можно установить значение значение категории в желаемой локали:

LC_ADDRESS (расширение GNU, начиная с glibc 2.2)

Изменяет настройки, которые описывают форматы (например, почтовый адрес), используемые для описания местонахождения и географических объектов. Приложения, в которых требуется эта информация, могут использовать функцию nl_langinfo(3) для получения нестандартных элементов, таких как _NL_ADDRESS_COUNTRY_NAME (название страны на языке локали) и _NL_ADDRESS_LANG_NAME (название языка на языке локали), которая возвращает строку, например «Deutschland» и «Deutsch» (для локалей с немецким языком) (остальные названия элементов перечислены в <langinfo.h>).

LC_COLLATE

Эта категория определяет правила сравнения, используемые при сортировке и регулярных выражениях, включая равенство классов символов и сравнение многосимвольных элементов. Эта категория локали изменяет поведение функций strcoll(3) и strxfrm(3), которые используются для сравнения строк с учётом местного алфавита. Например, немецкая эсцет (sharp s) рассматривается как «ss».

LC_CTYPE

Эта категория определяет интерпретацию последовательности байт в символы (например, одиночный или многобайтовый символ), классификацию символов (например, буквенный или цифровой) и поведение классов символов. В системах с glibc эта категория также определяет правила транслитерации символов для iconv(1) и iconv(3). Она изменяет поведение функций обработки и классификации символов, таких как isupper(3) и toupper(3), а также многобайтных символьных функций, таких как mblen(3) или wctomb(3).

LC_IDENTIFICATION (расширение GNU, начиная с glibc 2.2)

Изменяет настройки, которые относятся к метаданным локали. Приложения, в которых требуется эта информация, могут использовать функцию nl_langinfo(3) для получения нестандартных элементов, таких как _NL_IDENTIFICATION_TITLE (заголовок данной локали) и _NL_IDENTIFICATION_TERRITORY (географическое расположение, для которой создавалась локаль), которая возвращает строку, например «English locale for the USA» и «USA» (остальные названия элементов перечислены в <langinfo.h>).

LC_MONETARY

Эта категория определяет форматирования, используемое для денежных значений. Она изменяет информацию, возвращаемую функцией localeconv(3) , которая описывает способ отображения числа, например, необходимо ли использовать в качестве десятичного разделителя точку или запятую. Эта информация используется в функции strfmon(3).

LC_MESSAGES

Эта категория изменяет язык отображаемых сообщений и указывает, как должны выглядеть положительный и отрицательный ответы. Библиотека GNU C содержит функции gettext(3), ngettext(3) и rpmatch(3) для более удобного использования этой информации. Семейство функций GNU gettext так же учитывает переменную окружения LANGUAGE (содержащую через двоеточие список локалей), если указана допустимая локаль, отличная от "C". Данная категория также влияет на поведение catopen(3).

LC_MEASUREMENT (расширение GNU, начиная с glibc 2.2)

Изменяет настройки, которые в локали описывают систему мер (то есть, метрическую систему мер и систему мер США (US customary unit)). Приложения, в которых требуется эта информация, могут использовать функцию nl_langinfo(3) для получения нестандартного элемента _NL_MEASUREMENT_MEASUREMENT, которая возвращает 1 (метрическая) или 2 (система мер США).

LC_NAME (расширение GNU, начиная с glibc 2.2)

Изменяет настройки, которые описывают форматы, используемые для описания персон. Приложения, в которых требуется эта информация, могут использовать функцию nl_langinfo(3) для получения нестандартных элементов, таких как _NL_NAME_NAME_MR (приветствие мужчин) и _NL_NAME_NAME_MS (приветствие женщин), которая возвращает строку, например «Herr» и «Frau» (для локалей с немецким языком) (остальные названия элементов перечислены в <langinfo.h>).

LC_NUMERIC

Эта категория определяет правила форматирования, используемые для не денежных значений; например, разделительный символ тысяч и дробной части (точка в англоязычных странах, и запятая во многих других). Она влияет на поведение функций printf(3), scanf(3) и strtod(3). Эта информация может быть также прочитана при помощи функции localeconv(3).

LC_PAPER (расширение GNU, начиная с glibc 2.2)

Изменяет настройки, которые относятся к размерам стандартных листов бумаги (например, письмо США и A4). Приложения, в которых требуется эта информация, могут использовать функцию nl_langinfo(3) для получения нестандартных элементов, таких как _NL_PAPER_WIDTH и _NL_PAPER_HEIGHT которая возвращает значение int, определяющее размер в миллиметрах.

LC_TELEPHONE (расширение GNU, начиная с glibc 2.2)

Изменяет настройки, которые описывают форматы, используемые службах телефонии. Приложения, в которых требуется эта информация, могут использовать функцию nl_langinfo(3) для получения нестандартных элементов, таких как _NL_TELEPHONE_INT_PREFIX (международный префикс, используемые для номеров звонков в этой локали), которая возвращает строку, например «49» (для Германии) (остальные названия элементов перечислены в <langinfo.h>).

LC_TIME

Эта категория управляет форматированием значений даты и времени. Например, большая часть Европы использует 24-часовой формат, тогда как в США используют 12-часовой.Значение этой категории влияет на поведение функции strftime(3) и strptime(3).

LC_ALL

Всё вышеперечисленное.

Если второй аргумент функции setlocale(3) равен пустой строке, "", то локаль по умолчанию будет определяться следующим образом:

1.

Если существует непустая переменная окружения LC_ALL, то используется её значение.

2.

Если существует переменная окружения с именем одной из вышеописанных категорий и она непустая, то её значение присваивается этой категории.

3.

Если существует непустая переменная окружения LANG, то используется её значение.

Информация о локальном форматировании чисел доступна в структуре struct lconv, возвращаемой функцией localeconv(3) , которая описана следующим образом:

```
struct lconv {

    /* Информация о числах (не связанная с деньгами) */

    char *decimal_point;     /* Символ разделителя дробной части */

    char *thousands_sep;     /* Разделитель групп цифр слева от

                       символа разделителя дробной части */

    char *grouping;     /* Каждый элемент является номером цифры в группе;

                       элементы c большими номерами находятся левее.

                       Элемент с значением CHAR_MAX означает, что

                       группировка завершена. Элемент со значением 0

                       указывает, что предыдущий элемент используется

                       для всех групп, находящихся левее. */

    /* В оставшихся полях указывается информация о денежных

       величинах */

    char *int_curr_symbol;   /* Первые три символа являются символом

                                валюты, согласно ISO 4217. Четвёртый

                                символ является разделителем. Пятый

                                символ равен '\0'. */

    char *currency_symbol;   /* Местный символ валюты */

    char *mon_decimal_point; /* Символ разделителя дробной части */

    char *mon_thousands_sep; /* Как thousands_sep */

    char *mon_grouping;      /* Как grouping */

    char *positive_sign;     /* Знак положительных значений */

    char *negative_sign;     /* Знак отрицательных значений */

    char  int_frac_digits;   /* Представление дробных чисел в

                                международном формате */

    char  frac_digits;       /* Представление дробных чисел в локальном

                                формате */

    char  p_cs_precedes;     /* 1, если символ валюты указывается перед

                                положительным значение, 0 — если

                                следует за ним. */

    char  p_sep_by_space;    /* 1, если пробел отделяет символ валюты

                                от положительного значения */

    char  n_cs_precedes;     /* 1, если символ валюты предшествует

                                 отрицательному значению,

                                0, если следует за ним */

    char  n_sep_by_space;    /* 1, если пробел отделяет символ валюты

                                от отрицательного значения */

    /* Позиция положительного или отрицательного знака:

       0 Скобки окружают количество и символ валюты.

       1 Знак предшествует количеству и символу валюты.

       2 Знак следует за количеством и символом валюты.

       3 Знак непосредственно предшествует символу валюты.

       4 Знак непосредственно следует за символом валюты. */

    char  p_sign_posn;

    char  n_sign_posn;
};
```

### Расширения POSIX.1-2008 программного интерфейса локали
В POSIX.1-2008 стандартизовано несколько расширений программного интерфейса локали на основе реализаций, которые впервые появились в версии 2.3 библиотеки GNU C. Эти расширения разработаны для решения проблем, возникающих у обычного программного интерфейса локали в многонитевых приложениях и приложениях, которые должны работать с несколькими локалями.

Расширения представляют новые функции для создания и управления объектами локали (newlocale(3), freelocale(3), duplocale(3) и uselocale(3)) и различные новые библиотечные функции с суффиксом«_l» (например, toupper_l(3)), которые расширяют обычный зависящий от локали программный интерфейс (например, toupper(3)) так, что позволяют указать объект локали, который будет использован при работе функции.

## ОКРУЖЕНИЕ
Следующая переменная окружения используется в newlocale(3) и setlocale(3), и поэтому влияет на все не привилегированные локализованные программы:

LOCPATH

Список путей, разделённых двоеточием («:»), который должен использоваться при поиске данных локали. Если переменная установлена, то используются только скомпилированные файлы данных одной локали из LOCPATH и путь к данным системной локали по умолчанию; все другие доступные архивы локалей не используются (смотрите localedef(1)). Скопированные файлы данных одной локали ищутся в подкаталогах, которые зависят от используемой локали в данный момент. Например, если для категории используется en_GB.UTF-8, то будут просмотрены следующие подкаталоги в таком порядке: en_GB.UTF-8, en_GB.utf8, en_GB, en.UTF-8, en.utf8 и en.

## ФАЙЛЫ
/usr/lib/locale/locale-archive

Обычный путь по умолчанию для расположения архива локалей.

/usr/lib/locale

Обычный путь по умолчанию для скомпонованных файлов отдельных локалей.

## СООТВЕТСТВИЕ СТАНДАРТАМ
POSIX.1-2001.

## СМОТРИТЕ ТАКЖЕ
iconv(1), locale(1), localedef(1), catopen(3), gettext(3), iconv(3), localeconv(3), mbstowcs(3), newlocale(3), ngettext(3), nl_langinfo(3), rpmatch(3), setlocale(3), strcoll(3), strfmon(3), strftime(3), strxfrm(3), uselocale(3), wcstombs(3), locale(5), charsets(7), unicode(7), utf-8(7)


mailaddr

title: mailaddr(7)

summary: описание формата почтового адреса

text:
# mailaddr(7)

## ИМЯ
mailaddr - описание формата почтового адреса

## ОПИСАНИЕ
В этой странице кратко описываются почтовые адреса SMTP, используемые в Интернете. Общий формат этих адресов:

пользователь@домен

где «домен» это иерархический список поддоменов, разделённых точками. Примеры корректных записей одного адреса:

john.doe@monet.example.com

John Doe <john.doe@monet.example.com>

john.doe@monet.example.com (John Doe)

Доменная часть («monet.example.com») является доменом, который принимает почту. Это может быть узел (и в прошлом, обычно, это так и было), а может и нет. В доменной части не учитывает регистр букв.

Локальная часть («john.doe») — это, часто, имя пользователя, но точное значение определяется локальным программным обеспечением. Иногда, здесь важен регистр букв, хотя это необычно. Если вы видите, что локальная часть выглядит бессмысленно, то, обычно,это из-за того, что существует шлюз между внутренней почтовой системой электронной почты и сетью, примеры:

"surname/admd=telemail/c=us/o=hp/prmd=hp"@some.where

USER%SOMETHING@some.where

machine!machine!name@some.where

I2461572@some.where

(здесь показан, соответственно, шлюз X.400, шлюз в произвольную внутреннюю почтовую систему без поддержки Интернета, шлюз UUCP и перенаправляющая пользователям политика).

Часть настоящего имени («John Doe») может указываться перед <> или в конце в () (строго говоря, такое размещение неравнозначно, но описание отличий лежит за границами этой страницы). Имя может быть заключено в "", например, если содержит «.»:

"John Q. Doe" <john.doe@monet.example.com>

### Сокращение
Некоторые почтовые системы позволяют пользователям не указывать доменное имя. Например, пользователи в example.com могут указать «john.doe@monet», чтобы отправить письмо John Doe. Так делать не рекомендуется. Иногда это работает, но вы не должны на это полагаться.

### Route-addrs
В прошлом, иногда было нужно перенаправлять сообщение через несколько узлов, чтобы оно дошло до назначения. Адреса, в которых задаются ретрансляторы, называются «route-addrs». Для них используется синтаксис:

<@узелА,@узелБ:пользователь@узелВ>

Здесь указывается, что сообщение должно быть послано узлуА, потом узлуБ и, наконец узлуВ. Многие узлы игнорируют route-addrs и посылают сообщение напрямую узлуВ.

В настоящее время использование route-addrs выглядит очень необычно. Иногда их можно встретить в старых почтовых архивах. Обычно, для определения действительного адреса можно игнорировать всё, кроме части «пользователь@узелВ».

### Postmaster
Для каждого сайта необходим пользователь или псевдоним, называемый «postmaster», которому можно сообщать о проблемах в почтовой системе. В адресе «postmaster» не учитывается регистр символов.

## ФАЙЛЫ
/etc/aliases

~/.forward

## СМОТРИТЕ ТАКЖЕ
mail(1), aliases(5), forward(5), sendmail(8)

IETF RFC 5322


man

title: man(7)

text:
# man(7)

## ИМЯ
man - макросы для форматирования справочных страниц

## ОБЗОР
groff -Tascii -man файл ...

groff -Tps -man файл ...

man [раздел] имя

## ОПИСАНИЕ
В этой справочной странице описывается макет макросов groff an.tmac (часто называемый макетом макросов man). Данный пакет макросов должен использоваться разработчиками для написания или переноса справочных страниц в Linux. Он относительно совместим с другими версиями этого пакета макросов, так что перенос справочных страниц не должен быть большой проблемой (кроме выпуска NET-2 BSD, в котором используется полностью другой пакет макросов mdoc; смотрите mdoc(7)).

Заметим, что справочные страницы NET-2 BSD mdoc можно использовать с groff просто указав параметра -mdoc вместо -man. Однако рекомендуется использовать параметр -mandoc, так как это включает автоматическое определение какой пакет макросов использовать.

Соглашения, которые нужно соблюдать при написании справочных страниц для пакета Linux man-pages смотрите в man-pages(7).

### Заголовок
Первой командой в справочной странице (после комментариев, то есть строк, которые начинаются с .\") должна быть

.TH заголовок раздел дата источник справочник

Описание аргументов команды TH смотрите в man-pages(7).

Заметим, что страницы, отформатированные под BSD mdoc, начинаются с команды Dd, а не TH.

### Разделы
Разделы начинаются с макроса .SH, за которым следует название заголовка.

Единственным обязательным заголовком является ИМЯ, оно должно быть первым разделом и снабжаться однострочным описанием программы на следующей строке:

.SH ИМЯ

элемент \- описание

Чрезвычайно важно следовать этому формату, и ставить наклонную черту влево перед одиночным минусом, который указывается после названия объекта. Этот синтаксис используется программой mandb(8) при создании базы данных кратких описаний для команд whatis(1) и apropos(1) (описание синтаксиса раздела ИМЯ смотрите в lexgrog(1)).

Список разделов, которые могут присутствовать в справочной странице, смотрите в man-pages(7).

### Шрифты
Команды для выбора начертания шрифта:

.B

Полужирный

.BI

Полужирный курсив (часто применяется при описании функций)

.BR

Полужирный прямой (часто применяется для ссылок на другие справочные страницы)

.I

Курсив

.IB

Курсив, чередующийся с полужирным

.IR

Курсив, чередующийся с прямым

.RB

Прямой, чередующийся с полужирным

.RI

Прямой, чередующийся с курсивом

.SB

Капитель, чередующаяся с полужирным

.SM

Капитель (полезна для аббревиатур)

Традиционно, у каждой команды может быть до шести аргументов, но в реализации GNU удалено это ограничение (вы могли бы ограничить себя 6 аргументами с целью переносимости). Аргументы разделяются пробелами. Для указания аргумента с пробелами можно использовать двойные кавычки. Все аргументы будут выведены друг за другом без разделяющих пробелов, поэтому для выделения слова жирным и последующим знаком пунктуации прямым можно использовать команду .BR Если аргументы не заданы, то команда применяется к следующей строке текста.

### Другие макросы и строки
Далее описываются другие сопутствующие макросы и предопределённые строки. Если не указано обратного, все макросы выполняют разрыв (конец текста в текущей строке). Многие из этих макросов изменяют или используют «преобладающий отступ». Это значение изменяется любым макросом с параметром i ниже; в макросы можно не указывать i и в этом случае будет использован текущий преобладающий отступ. Это позволяет использовать единый отступ для рядом стоящих параграфов без указания значения отступа. Обычный (без отступа) параграф сбрасывает значение преобладающего отступа в значение по умолчанию (0.5 дюйма). По умолчанию, задаваемый отступ измеряется в ens; старайтесь использовать для отступов единицы измерения ens или ems, так как при этом автоматически выбирается правильный размер шрифта. Другие основные макросы:

### Обычные параграфы
.LP

Тоже что и .PP (начало нового параграфа).

.P

Тоже что и .PP (начало нового параграфа).

.PP

Начинает новый параграф и сбрасывает преобладающий отступ.

### Относительная граница отступа
.RS i

Начало относительной границы отступа: левая граница i перемещается вправо (если i не задано, то используется преобладающий отступ). Новым значением преобладающего отступа становится 0.5 дюйма. В результате все последующие параграфы будут иметь отступ пока не появится соответствующий .RE.

.RE

Завершает учёт относительной границы отступа и восстанавливает предыдущее значение преобладающего отступа.

### Макросы параграфа с отступом
.HP i

Начинает параграф с висящим отступом (первая строка параграфа имеет левую границу как у обычных параграфов, а остальные строки параграфа имеют отступ).

.IP x i

Параграф с отступом и необязательным весящим тегом. Если тег x не указан, то весь последующий параграф имеет отступ i. Если тег x задан, то он висит у левой границы перед последующим параграфом с отступом (как при .TP, то тег стоит рядом с командой, а не на следующей строке). Если тег слишком длинный, то текст после тега будет помещён вниз на следующую строку (текст не теряется или искажается). Для списков с маркером используйте этот макрос с \(bu (маркер) или \(em (тире) в качестве тега, а для нумерованных списков в качестве тега используйте цифру или букву с точкой; это упрощает трансляцию в другие форматы.

.TP i

Начинает параграф с висящим тегом. Тег задаётся на следующей строке, но результат будет подобен команде .IP.

### Макросы гиперссылок
.UR url

Вставляет гипертекстовую ссылку в URI (URL) url в виде текста ссылки, окружая её текстом до следующего макроса .UE.

.UE

[trailer] Завершает текст ссылки из макроса .UR необязательным trailer (если есть, то это, обычно закрывающая круглая скобка и/или знак конца элемента), указываем тут же. Для устройств, не выводящих HTML (например, man -Tutf8), текст ссылки указывается после URL в угловых скобках; если текста нет, то URL печатается как ссылка, окружённая в квадратных скобках (угловые скобки могут отсутствовать на некоторых устройствах). Для устройств выводящих HTML, текст ссылки ведёт на URL; если текста нет, то печатается URL как ссылка.

Эти макросы поддерживаются в GNU Troff начиная с версии 1.20 (2009-01-05) и в Heirloom Doctools Troff начиная с версии 160217 (2016-02-17).

### Различные макросы
.DT

Сбрасывает значение табуляций в умолчательное (каждые 0.5 дюйма); не приводит к разрыву.

.PD d

Устанавливает вертикальное расстояние между параграфами равным d (если не указано, то d=0.4v); не приводит к разрыву.

.SS t

Подзаголовок t (как .SH, но используется для подраздела внутри раздела).

### Предопределенные строки
В пакете man есть следующие предопределённые строки:

\*R

Символ регистрации прав: ®

\*S

Изменяет размер шрифта по умолчанию

\*(Tm

Това́рный знак: (Tm)

\*(lq

Двойная кавычка с наклоном влево: “

\*(rq

Двойная кавычка с наклоном вправо: "

### Безопасный набор
Хотя технически man и является пакетом макросов troff, большое количество других инструментов обработки файлов справочных страниц не реализуют все свойства troff. То есть, лучше не использовать некоторые экзотические возможности troff, если нужно чтобы такие инструменты работали правильно. Не используйте различные препроцессоры troff (если очень нужно, то, конечно, используйте tbl(1), но старайтесь использовать команды IP и TP вместо двухколоночных таблиц). Не применяйте вычисления; большинство инструментов не обрабатывают их. Используйте простые команды, которые легко транслировать в другие форматы. Следующие макросы troff можно использовать без проблем (хотя во многих случаях они будут игнорироваться трансляторами): \", ., ad, bp, br, ce, de, ds, el, ie, if, fi, ft, hy, ig, in, na, ne, nf, nh, ps, so, sp, ti, tr.

Также можно использовать много экранированных последовательностей troff (начинающихся с \). Если нужно включить обратную косую черту в текст используйте \e. Можно использовать другие последовательности (здесь x или xx могут быть любыми символами и N любой цифрой): \', \`, \-, \., \", \%, \*x, \*(xx, \(xx, \$N, \nx, \n(xx, \fx и \f(xx. Не используйте экранированные последовательности для рисования графики.

Не используйте необязательный параметр bp (разрыв страницы). Используйте только положительные значения для sp (вертикальный отступ). Не определяйте макрос (de) с тем же именем как в этом пакете или пакете макросов mdoc с другим смыслом; такое переопределение, вероятнее всего, будет проигнорировано. Каждый положительный отступ (in) должен составлять пару с отрицательным отступом (хотя для этого лучше использовать макросы RS и RE). В проверке условия (if,ie) нужно использовать только 't' или 'n' в качестве условия. Должны использоваться только трансляции (tr), которые можно игнорировать. Для изменения шрифта (экранированные последовательности ft и \f) должны использоваться только значения 1, 2, 3, 4, R, I, B, P или CW (также команда ft может указываться без параметров).

Если кроме этих возможностей вы используете какие-то другие, то внимательно проверяйте результат на нескольких инструментах. После положительной проверки дополнительной возможности, напишите об этом сопровождающему этого документа о безопасной команде или последовательности, которая будет вставлена в этот список.

## ФАЙЛЫ
/usr/share/groff/[*/]tmac/an.tmac

/usr/man/whatis

## ЗАМЕЧАНИЯ
Всегда включайте полные URL (или URI) в сам текст; некоторые инструменты, например man2html(1), могут автоматически преобразовывать их в гипертекстовые ссылки. Для обозначения ссылок также вы можете использовать макросы UR и UE. При добавлении URL используйте полный URL (например, http://www.kernel.org) , чтобы инструменты могли автоматически найти URL.

Инструменты, обрабатывающие эти файлы, должны открыть файл и исследовать первый непробельный символ. Считается, что точка (.) или одинарная кавычка (') в начале строки указывает, что файл в формате troff (man или mdoc). Левая угловая скобка (<) указывает, что файл в SGML/XML-подобном формате (HTML или Docbook). При нахождении любого другого символа считается, что это простой текст ASCII (например, результат «catman»).

Много справочных страниц начинаются с '\", после которого идёт пробел и список символов, указывающих как страница должна быть предварительно обработана. Для совместимости с не troff подобными трансляторами, мы рекомендуем не использовать что-либо кроме tbl(1), и Linux может обнаружить это автоматически. Однако вы можете захотеть включить эту информацию для того, чтобы ваша справочная страница могла быть обработана другими (менее развитыми) системами. Вот определения препроцессоров, вызываемых этими символами:

e

eqn(1)

g

grap(1)

p

pic(1)

r

refer(1)

t

tbl(1)

v

vgrind(1)

## ДЕФЕКТЫ
Большинство макросов служат для форматирования (например, тип шрифта и интервал), а не для маркировки семантического содержания (например, что текст — ссылка на другую страницу), если сравнивать с форматами mdoc и DocBook (даже в HTML больше семантической маркировки). Это усложняет создание формата man для разных носителей, чтобы выдать непротиворечивый результат для определённого носителя и автоматически вставить перекрестные ссылки. Использование безопасного подмножества, описанного выше, должно упростить автоматизацию перехода между разными форматами ссылок в будущем.

Макрос Sun TX не реализован.

## СМОТРИТЕ ТАКЖЕ
apropos(1), groff(1), lexgrog(1), man(1), man2html(1), whatis(1), groff_man(7), groff_www(7), man-pages(7), mdoc(7)


man-pages

title: man-pages(7)

text:
# man-pages(7)

## ИМЯ
man-pages — правила написания справочных страниц Linux

## ОБЗОР
man [раздел] имя

## ОПИСАНИЕ
На этой странице описаны правила, которые необходимо применять при написании справочных страниц для проекта man-pages Linux, который, в свою очередь, документирует программный интерфейс пространства пользователя, предоставляемый ядром Linux и библиотекой GNU C. Таким образом, проект отвечает за большинство страниц из Раздела 2, за многие страницы из Разделов 3, 4, и 7, и за несколько страниц из Разделов 1, 5 и 8 справочной системы Linux. Данные правила также могут быть полезны при написании справочных страниц для других проектов.

### Разделы справочных страниц
Традиционно они следующие:

1 Команды пользователя (Программы)

Команды, которые пользователь запустить из оболочки.

2 Системные вызовы

Функции, являющиеся оберткой операций, выполняемых ядром.

3 Библиотечные вызовы

Все библиотечные функции (в основном функции libc), за исключением представленных в Разделе 2.

4 Специальные файлы (устройства)

Файлы из /dev, дающие доступ к устройствам через ядро.

5 Форматы файлов и конфигурационные фалы

Описывает различные подходящие для чтения форматы файлов и конфигурационные файлы.

6 Игры

Игры и забавные небольшие программы

7 Обзоры, соглашения и разное

Описания или обзоры, касающиеся различных тем, соглашений и протоколов, а также наборов символов, стандартный шаблон файловой системы, разное.

8 Команды для системного администрирования

Команды подобные mount(8), большинство из которых могут запускаться только суперпользователем.

### Пакет макросов
Новые справочные страницы должны размечаться с помощью пакета groff an.tmac, описанного в man(7). Данный выбор основан, в основном, на том, что большинство из существующих страниц Linux размечены с помощью этих макросов.

### Правила, касающиеся формата исходных файлов
Длина строки не должна превышать 75 символов. В некоторых почтовых клиентах это помогает избежать переноса строк в заплатах, встроенные в письмо.

### Заголовок
Первой должна быть команда TH:

.TH заголовок раздел дата источник справочник

где:

заголовок

Название страницы, написанное заглавными буквами (например MAN-PAGES).

раздел

Номер раздела для размещения страницы (например 7).

дата

Дата последнего значительного изменения справочной страницы (в проекте man-pages необходимые обновления временных отметок выполняются автоматически при помощи сценариев, вручную устанавливать её заплатой не нужно). Дата должна иметь вид YYYY-MM-DD, т. е. год-месяц-день.

источник

Источник команды, функции, системного вызова.

Для нескольких страниц man-pages в Разделах 1 и 8, можно написать GNU.

Для системных вызовов — Linux. (Ранее, стандартной практикой было писать версию ядра, используя которую был написана или проверена страница. Это никогда не было общепринятым. Так что не делайте этого).

Для библиотечных вызовов, являющихся частью glibc или других библиотек GNU — GNU C Library, GNU, или пустую строку.

Для страниц из Раздела 4 — Linux.

Если возникают сомнения — Linux или GNU.

справочник

Название справочника (например для Разделов 2, 3 в пакете man-pages — Linux Programmer's Manual).

### Разделы внутри справочной страницы
Следующий список содержит общепринятые и рекомендуемые разделы. Большинство справочных страниц должно включать в себя по крайней мере выделенные жирным разделы. Соблюдайте очередность, как показано в списке.

```
ИМЯ
ОБЗОР
КОНФИГУРАЦИЯ             [Как правило, только в разделе 4]
ОПИСАНИЕ
ПАРАМЕТРЫ                [Как правило, только в разделах 1, 8]
КОД ВЫХОДА               [Как правило, только в разделах 1, 8]
ВОЗВРАЩАЕМЫЕ ЗНАЧЕНИЯ    [Как правило, только в разделах 2, 3]
ОШИБКИ                   [Обычно только в разделах 2, 3]
ОКРУЖЕНИЕ
ФАЙЛЫ
ВЕРСИИ                   [Как правило, только в разделах 2, 3]
АТРИБУТЫ                 [Как правило, только в разделах 2, 3]
СООТВЕТСТВИЕ СТАНДАРТАМ
ЗАМЕЧАНИЯ
ДЕФЕКТЫ
ПРИМЕРЫ
СМОТРИ ТАКЖЕ
```

Там, где обычно используются заголовки, используйте их; это правило может сделать информацию более доступной для понимания. Если это необходимо, Вы можете создать свои собственные заголовки, если они сделают текст более понятным (это может быть особенно полезным для страниц в разделах 4 и 5). Тем не менее, прежде чем создавать их, подумайте, можно ли обойтись традиционными заголовками с созданием своих собственных подразделов (.SS) в пределах стандартных разделов.

В приведённом ниже списке объясняется назначение каждого из разделов.

ИМЯ

Название данной справочной страниц.

Смотрите man(7), чтобы ознакомиться с правилами написания заголовков, которые должны следовать за командой .SH NAME. Все слова в этой строке (в том числе идущие сразу после «\-») должны быть в нижнем регистре, за исключением тех случаев, когда правилами языка, на котором написана страница, или сложившейся практикой употребления технических терминов определено иное.

ОБЗОР

Краткое описание команды или интерфейса функции

Для команд здесь показываются синтаксис и аргументы (включая параметры); полужирное начертание используется для неизменяемого текста, а курсивом обозначаются меняющиеся аргументы. Квадратные скобки ([]) показывают необязательные аргументы, вертикальная черта (|) указывает на выбор одного из вариантов, многоточие (...) означает возможное повторение. Для функций показываются все необходимые объявления данных или #include директивы с последующим объявлением функции.

Если для получения объявления функции (или переменной) из заголовочного файла требуется определить макрос тестирования свойств, то это указывается в ОБЗОРЕ согласно описанию из feature_test_macros(7).

КОНФИГУРАЦИЯ

Особенности настройки устройства

Этот раздел, как правило, присутствует только в разделе 4.

ОПИСАНИЕ

Объяснение того, для чего предназначена программа, функция или формат

Здесь описывается взаимодействие с файлами и стандартным вводом, и что записывается в стандартный вывода вывод или ошибок; не приводятся детали реализации, если они не критичны для понимания интерфейса; показывается типичное использование; информация о параметрах командной строки программы даётся в разделе OPTIONS.

Если описывается новое поведение или новые флаги системного вызова или библиотечной функции, отметьте где введено изменение — версию ядра или библиотеки С. Данную информацию целесообразно приводить в виде части списка .TP в следующем виде (здесь показан новый флаг системного вызова):

XYZ_FLAG (начиная с Linux 3.7)

Описание флагов…

Включает информацию о версии, что особенно востребовано пользователями, которые вынуждены использовать старые версии ядра или библиотеки C (что характерно, например, для встраиваемых систем).

ПАРАМЕТРЫ

Описание параметров командной строки и их влияния на поведение программы.

Этот раздел как правило содержится только в разделах 1 и 8.

КОД ВЫХОДА

Перечень возможных значений кода выхода программы и ситуаций, при которых программа возвращает данное значение кода.

Этот раздел как правило содержится только в разделах 1 и 8.

ВОЗВРАЩАЕМЫЕ ЗНАЧЕНИЯ

Для разделов 2 и 3 эта секция содержит перечень значений, возвращаемых библиотеками вызывающей их программе и условия, при которых библиотеки возвращают данные значения.

ОШИБКИ

В справочных страницах разделов 2 и 3 здесь описываются значения ошибок, которые могут быть помещены в errno, а также приводится описание причин ошибок.

Если ошибка возникает при нескольких различных условиях, предпочтительней создавать отдельные записи списка (с повторением имени ошибки) для каждого из условий. Такое разделение делает условия более понятными, этот список проще читать и можно указывать метаинформацию (например, номер версии ядра, в котором условие начало действовать) на каждое условие.

Список ошибок должен быть в алфавитном порядке.

ОКРУЖЕНИЕ

Перечень переменных окружения, влияющих на программу и оказываемый ими эффект.

ФАЙЛЫ

Список файлов, используемых программой или функцией, таких как конфигурационные файлы, файлы запуска и файлы, с которыми непосредственно работает программа.

Указывайте полный путь к этим файлам, также используйте возможность изменить во время установки изменить путь в соответствии с предпочтениями пользователя.

АТРИБУТЫ

Общая информация о различных атрибутах функции(функций), описанной на этой странице. Смотри attributes(7) для получения дополнительных сведений.

ВЕРСИИ

Краткое описание ядра Linux или версии glibc, где впервые появился системный вызов или функция библиотеки, либо существенно изменилось их действие.

Как правило, описание каждого нового интерфейса должно включать раздел ВЕРСИИ в справочной странице. К сожалению, в многих справочных страницах эта информация отсутствует (когда они были написаны, не было правила, предписывающего делать это). Заплаты, исправляющие подобные недостатки, приветствуются, но, с точки зрения программистов, пишущих новый код, эта информация, вероятно, имеет значение только в том случае, если интерфейсы ядра были добавлены в Linux 2.4 или позже (т. е., отличаются от ядра 2.2), а для библиотечных функций, если изменения были добавлены начиная с glibc версии 2.1 (т. е., отличаются от glibc 2.0).

Справочная страница syscalls(2) также содержит информацию о версиях ядра, в которых были впервые реализованы различные системные вызовы.

СООТВЕТСТВИЕ СТАНДАРТАМ

Описание любых стандартов или соглашений, относящихся к функции или команде, речь о которой идет на странице.

Предпочтительные обозначения для различных стандартов указаны в качестве заголовков на странице standards(7).

Для страницы из раздела 2 или 3, данный раздел должен показывать версию POSIX.1, которой соответствует вызов, а также есть ли вызов в C99 (наличие в других стандартах, таких как SUS, SUSv2 и XPG, или реализациях стандартов SVr4 и 4.xBSD, не важно; если вызов был в этих стандартах, но отсутствует в текущей версии POSIX.1, то это стоит упомянуть).

Если вызов не соответствует какому-либо стандарту, но существует во многих системах, также упомяните об этом. Если вызов есть только в Linux, то это также стоит отметить.

Если данный раздел состоит только из списка стандартов (что, обычно, и есть), завершите список точкой ('.').

ЗАМЕЧАНИЯ

Различные замечания.

Для разделов 2 и 3 может быть полезным создание подразделов (SS), озаглавленных Примечания для Linux и Примечания для Glibc.

В разделе 2 используйте заголовок Различия между ядром и библиотекой С, чтобы отметить различия (если имеются) между системными вызовами функций библиотеки и ядра.

ДЕФЕКТЫ

Перечень известных ошибок, ограничений, недостатков причиняющих неудобство а также других сомнительных свойств.

ПРИМЕРЫ

Один или несколько примеров, демонстрирующих, каким образом данная функция, команда или файл используются.

Для получения более подробной информации о написании примеров программ смотрите раздел Примеры программ далее.

АВТОРЫ

Список авторов документа или программы.

Использовать раздел АВТОРЫ настоятельно не рекомендуется. Лучше не загромождать каждую страницу списком авторов (список со временем увеличивается); если вы написали или значительно исправили страницу, добавьте уведомление об авторском праве в виде комментария в исходный файл. Если вы автор драйвера устройства и хотите включить адрес для отправки сообщений об ошибках, то сделайте это в разделе ДЕФЕКТЫ.

СМОТРИ ТАКЖЕ

Разделённый запятыми список уместных справочных страниц, возможно, ведущих на другие страницы или документы.

Список должен быть упорядочен по номеру раздела, а затем по алфавиту. Не заканчивайте список точкой.

Если список СМОТРИТЕ ТАКЖЕ содержит много длинных имён справочных страниц, то для улучшения визуального представления может быть полезно воспользоваться командами .ad l (не выравнивать по правому краю) и .nh (отключить перенос). Запретить перенос имён справочных страниц можно с помощью указания перед словом строки «\%».

Учитывая распределённую, автономную природу проектов FOSS и их документирование, иногда необходимо — и во многих случаях желательно — включать в раздел СМОТРИТЕ ТАКЖЕ ссылки на справочные страницы из других проектов.

## РУКОВОДСТВО ПО СТИЛЮ ОФОРМЛЕНИЯ
В следующих абзацах представлен предпочтительный стиль написания страница в проекте man-pages. Если что-то не описано подробно, то следует придерживаться чикагского стилистического справочника (Chicago Manual of Style); также постарайтесь поискать схожие примеры в исходном коде дерева проекта.

### Использование гендерно-нейтральных выражений
Используйте гендерно-нейтральный язык в тексте справочных страниц насколько это возможно. Приемлемо использовать местоимения «они» («им», «себя», «их»).

### Соглашения о форматировании справочных страниц, описывающих команды
Для справочных страниц, описывающих команду (как правило в разделах 1 и 8), аргументы всегда указываются с помощью курсива, даже в разделе ОБЗОР.

Имя команд и их опции, всегда должны быть оформленными полужирным стилем.

### Соглашения по оформлению справочных страниц, описывающих функции
В справочных страницах, которые описывают функции (обычно, в разделах 2 и 3), параметры всегда оформляются, используя курсив; даже в разделе ОБЗОР, где остальная часть функции определена полужирным:

int имя_функции(int argc, char **argv);

Имена переменных, как и имена параметров, должны быть оформлены курсивом.

Любая ссылка на тему текущей справочной страницы должна быть записана с именем оформленным полужирным, включая пару круглых скобок, в прямом(нормальном) шрифте. Например, на странице fcntl(2), ссылки на тему страницы были бы записаны как: fcntl(). Рекомендуемый способ записи в исходном файле:

```
    .BR fcntl ()
```

(используйте этот формат вместо б\fB...\fP ()» — такой подход упрощает создание инструментов разбора исходных файлов справочных страниц)

### Использование семантики новых строк
В исходном тексте справочной страницы новые предложения должны начинаться с новой строки, а длинные предложения должны разбиваться на строки в местах его деления на части (запятыми, точками с запятой, двоеточиями и т. п.). Это соглашение, иногда называемое «семантика новых строк», облегчает просмотр внесённых заплат, которые часто применяются на уровне отдельных предложений или его частей.

### Общие соглашения по оформлению
Параграфы должны разделяться подходящими маркерами (обычно .PP или .IP). Не разделяйте параграфы пробельными строками, так как это приводит к плохому отображению в некоторых выходных форматах (в частности, PostScript и PDF).

Имена файлов (также пути или ссылки на заголовочные файлы) всегда должны быть оформлены курсивом (например, <stdio.h>), кроме раздела ОБЗОР, где включаемые файлы должны быть полужирным (например, #include <stdio.h>). Тут ссылка на стандартный заголовочный файл включает имя заголовочного файл, окружённого угловыми скобками, это типично для C (например, <stdio.h>).

Специальные макросы, которые обычно находятся в верхнем регистре, оформляют полужирным (например, MAXINT). Исключение: не делайте полужирным NULL.

В списке, при перечислении кодов ошибок, коды оформляют полужирным (в этом списке обычно используют макрос .TP).

Составные команды, если они длинные, должны быть записаны с отступом по линии, как самодостаточные, с пустой строкой перед и после команды, например

```
man 7 man-pages
```

Если команда короткая, то её можно включить прямо в текст как курсив, например man 7 man-pages. В этом случае может потребоваться использовать неразрывные пробелы («\ ») в соответствующих местах команды. Параметры команды также должны быть выделены курсивом (например, -l).

Выражения, если не записаны на отдельной строке с отступом, должны выделяться курсивом. Здесь также может потребоваться задавать неразрывные пробелы, если выражение встроено в обычный текст.

При показе примера сеанса оболочки пользовательский ввод должен быть выделен жирным, например

```
$ date
Thu Jul  7 13:01:27 CEST 2016
```

Все ссылки на другие справочные страницы должны выделяться жирным шрифтом, всегда должен быть указан номер раздела шрифтом Roman (обычным) и без пробелов (например, intro(2)). В исходном файле это лучше записывать так:

```
    .BR intro (2)
```

(включение номера раздела в перекрёстных ссылках позволяет таким инструментам как man2html(1) создавать правильные гиперссылки между страницами)

Управляющие знаки следует писать полужирным шрифтом, без кавычек, как в примере ^X.

### Орфография
Начиная с версии man-pages следует при написании Американским соглашениям (до этого использовалось английское и американское написание); пишите новые страницы и присылайте заплаты с учётом этих соглашений.

Кроме известных различий в написании, есть несколько других тонкостей, которые следует учесть:

*

Американский вариант английского языка имеет обыкновение использовать формы «backward» (назад), «upward» (вверх), «toward» (к) и т. д., а в британском варианте это «backwards», «upwards», «towards» и т. д.

### Номера версий BSD
Классической схемой обозначения версий BSD является x.yBSD, где x.y - номер версии (например, 4.2BSD). Избегайте написания в стиле BSD 4.3.

### Печать заглавными буквами
В заголовках разделов («SS») начинайте первое слово заголовка с заглавной буквы, а остальные буквы должны быть строчными, если обратного не требуют правила английского языка (например, имён собственных) или языка программирования (например, идентификаторы имён). Пример:

```
    .SS Юникод в Linux
```

### Отступ при определении структур, содержимого журналов сеансов оболочек и т. п.
При включении определений структур, журналов сеансов оболочек и т. п. в выполняемый текст, нужно использовать отступ в 4 пробела (т. е., блок заключается в .in +4n и .in), форматировать их с помощью макросов .EX и EE и окружить их подходящими маркерами параграфа (.PP или .IP). Пример:

```
    .PP

    .in +4n

    .EX

    int

    main(int argc, char *argv[])

    {

        return 0;

    }

    .EE

    .in

    .PP
```

### Предпочтительные термины
В следующей таблице перечислены некоторые предпочтительные термины, для использования в справочных страницах, главным образом, для непротиворечивости информации на страницах.

Термин (перевод)

Не используйте

Замечания

bit mask (маска битов)

bitmask

built-in (встроенный)

builtin

Epoch (эпоха)

epoch

Эпоха UNIX (00:00:00, 1 января 1970 UTC)

filename (имя файла)

file name

filesystem (файловая система)

file system

hostname (имя узла)

host name

inode

i-node

lowercase (строчные)

lower case, lower-case

nonzero

non-zero

pathname (путь)

path name

pseudoterminal (псевдо-терминал)

pseudo-terminal

privileged port (привилегированный порт)

reserved port, system port

real-time (реальное время)

realtime, real time

run time (время исполнения)

runtime

saved set-group-ID (сохранённый set-group-ID)

saved group ID, saved set-GID

saved set-user-ID (сохранённый saved set-user-ID)

saved user ID, saved set-UID

set-group-ID

set-GID, setgid

set-user-ID

set-UID, setuid

superuser (суперпользователь)

super user, super-user

superblock (суперблок)

super block, super-block

timestamp (метка времени)

time stamp

timezone (часовой пояс)

time zone

uppercase (прописные)

upper case, upper-case

usable (приемлемый)

useable

user space (пространство пользователя)

userspace

username (имя пользователя)

user name

x86-64

x86_64

Кроме случая, когда ссылаются на результат «uname -m» или подобных

zeros (нули)

zeroes

Смотрите также Дефисы в составных терминах далее.

### Термины, которых следует избегать
В следующей таблице перечислены некоторые термины, которые лучше не использовать в справочных страницах и предлагаемые им альтернативы, использование которых поможет избежать противоречий между справочными страницами.

Не используйте

Для использования

Замечания

32bit

32-bit (32-битный)

это же с 8-bit, 16-bit и т. п.

current process (текущий процесс)

calling process (вызывающий процесс)

Частая ошибка, делаемая программистами ядра при написании справочных страниц

manpage

man page, manual page (справочная страница)

minus infinity (минус бесконечность)

negative infinity (отрицательная бесконечность)

non-root

unprivileged user (непривилегированный пользователь)

non-superuser

unprivileged user (непривилегированный пользователь)

nonprivileged

непривилегированный

OS

operating system (операционная система)

plus infinity (плюс бесконечность)

positive infinity (положительная бесконечность)

pty

pseudoterminal (псевдо-терминал)

tty

terminal (терминал)

Unices

UNIX systems (системы UNIX)

Unixes

UNIX systems (системы UNIX)

### Торговые марки
При упоминании торговых марок соблюдайте правильное написание с соблюдением регистра. Вот список правильного написания различных торговых марок, которые иногда указывают неправильно:

DG/UX

HP-UX

UNIX

UnixWare

### NULL, NUL, указатель null и символ null
Указатель null — это указатель, который ни на что не указывает и, как правило, имеет значение константы NULL. С другой стороны, NUL представляет собой байт null, байт со значением 0, который в C представляется символьной константой '\0'.

Данный указатель лучше называть «указатель null» или просто «NULL»; не используйте «указатель NULL».

Для описания байта используйте «байт null». Не пишите «NUL», так как такое наименование легко спутать с «NULL». Также избегайте терминов «нулевой байт» и «символ null». Байт, которым заканчиваются строки в C, нужно описывать как «завершающий байт null» (terminating null byte); про строки можно сказать как «завершающиеся null» (null-terminated), но не используйте «завершающиеся NUL».

### Гиперссылки
Для указания гиперссылок используйте пару макросов .UR/.UE (смотрите groff_man(7)). Они создаёт корректные гиперссылки, которые можно использовать при просмотре в браузере, например так:

BROWSER=firefox man -H имя_страницы

### Использование сокращений e.g. (например), i.e. (т. е.), a.k.a. (также известно как) и подобных
Обычно лучше не использовать сокращения вида «e.g.», «i.e.», «etc.», «cf.», «a.k.a.», а писать слова полностью («например», «то есть», «и так далее», «по сравнению с», «также известно как»).

Единственным приемлемым местом для их использования является короткая сноска (как, напр., эта).

Всегда указывайте точки в подобных аббревиатурах. Также после «напр.р» и «т.е.» всегда ставится запятая.

### Длинное тире
Для написания тире — символический знак, который появится в конце этой фразы—в *roff используется макрос «\(em» (на терминалах с ASCII тире, обычно, отображается в виде двух переносов, но в других типографских контекстах оно может выглядеть как длинное тире). Тире должно записываться без окружающих его пробелов.

### Дефисы в составных терминах
Составные термины пишутся через дефис при использовании в качестве определителя (т. е., для уточнения последующего существительного). Примеры:

32-bit value (32-битное значение)

command-line argument (аргумент командной строки)

floating-point number (число с плавающей запятой)

run-time check (проверка во время выполнения)

user-space function (функция пространства пользователя)

wide-character string (строка широких символов)

### Дефис с multi, non, pre, re, sub и т. п.
Общая тенденция на современном английском языке состоит в том, чтобы не ставить дефисы после префиксов «multi», «non», «pre», «re», «sub» и т. д. В справочных страницах, в основном, нужно следовать этому правилу, когда эти префиксы используются в естественных английских конструкциях с простыми суффиксами. В следующем списке приведены некоторые примеры правильного написания:

interprocess

multithreaded

multiprocess

nonblocking

nondefault

nonempty

noninteractive

nonnegative

nonportable

nonzero

preallocated

precreate

prerecorded

reestablished

reinitialize

rearm

reread

subcomponent

subdirectory

subsystem

Дефисы должны быть сохранены после префиксов для нестандартных английских слов, торговых марок, имён собственных, акронимов или составных терминов. Несколько примеров:

non-ASCII

non-English

non-NULL

non-real-time

И напоследок заметим, что «re-create» и «recreate» — это два различных глагола и первый, вероятно то, что нужно.

### Символ математического минуса
Если требуется символ математического минуса (например, для чисел (-1), перекрёстных ссылок справочных страниц (utf-8(7) или при записи параметров, у которых есть начальные тире (ls -l)), используйте следующую форму записи в справочной странице:

\-

Это правило применимо и в примерах кода.

### Символьные константы
Чтобы получить одинарные кавычки, которые хорошо отображаются и в ASCII и в UTF-8, используйте следующую форму записи символьных констант в справочной странице:

\(aqC\(aq

где C — символ в кавычках. Это правило применимо и в примерах кода.

### Примеры программ и сценариев оболочки
Справочные страницы могут включать примеры программ, демонстрирующие использование системных вызовов или библиотечных функций. При этом нужно учитывать ряд условий:

- Примеры программ должны быть написаны на языке C.

- Примеры программ необходимы и полезны лишь в тех случаях, когда они демонстрируют что-то сверх того, что может быть легко представлено в текстовом описании командного интерфейса. Примеры программ, которые не показывают ничего кроме вызова команды, как правило обладают незначительной полезностью.

- Примеры программ должны быть предельно короткими (желательно менее 100 строк; в идеале менее 50 строк)

- В примерах программ должна быть реализована проверка ошибок после системных вызовов и вызовов библиотечных функций.

- Примеры программ должны быть полными и компилироваться без предупреждений при использовании cc -Wall.

- Там, где это возможно и целесообразно, примеры программ должны демонстрировать эксперимент, изменяя свое поведение в зависимости от входных параметров (в идеале от параметров командной строки или получаемых программой через стандартный ввод).

- Примеры программ должны быть написаны в стиле Кернигана (Kernighan) и Ритчи (Ritchie), с отступом, состоящим из 4 пробелов. (Избегайте использования символа табуляции в исходном коде!) Следующие команды могут быть использованы для форматирования исходного кода в что-то близкое к предпочтительному стилю:

indent -npro -kr -i4 -ts4 -sob -l72 -ss -nut -psl prog.c

*

Для удобства восприятия, все программы должны завершаться с использованием одного из вариантов:

exit(EXIT_SUCCESS);

exit(EXIT_FAILURE);

Избегайте использования следующих форм завершения программы:

exit(0);

exit(1);

return n;

*

В случаях, когда примеру программы предшествует обширный пояснительный текст, определите код в подраздел и пометьте соответствующим заголовком Код программы, как показано ниже:

.SS Код программы

Всегда делайте это, если пояснительный текст включает примеры вывода в терминал.

Если включаете лог вывода в терминал, демонстрирующий использование программы или системной функции:

- Поместите лог терминала выше листинга кода программы.

- Обозначьте лог терминала четырьмя пробелами.

- Выделите полужирным вводимый пользователем текст, чтобы отличить его от вывода системы.

Ознакомиться с тем, как должны выглядеть примеры программ Вы можете, прочитав wait(2) и pipe(2).

## ПРИМЕР
В качестве канонического примера того, как должны выглядеть страницы в пакете man-pages, смотрите pipe(2) и fcntl(2).

## СМОТРИТЕ ТАКЖЕ
man(1), man2html(1), attributes(7), groff(7), groff_man(7), man(7), mdoc(7)


title: math_error(7)

text:
# math_error(7)

## ИМЯ
math_error - определение ошибок при выполнении математических функций

## ОБЗОР

```
#include <math.h>
#include <errno.h>
#include <fenv.h>
```

## ОПИСАНИЕ
При возникновении ошибки большинство библиотечных функций возвращают специальное значение (например, -1 или NULL). Так как математические функции, объявленные в <math.h>, обычно, возвращают число с плавающей запятой, то для выдачи ошибки используются другие способы. Есть два варианта вернуть сообщение об ошибке: старый — изменяя errno; новый — используя механизм исключений плавающей запятой (с помощью feclearexcept(3) и fetestexcept(3) как описано ниже), описанный в fenv(3).

Переносимая программа, которой требуется проверка на ошибки в математических функциях, должна обнулить errno и выполнить вызов

```
feclearexcept(FE_ALL_EXCEPT);
```

перед тем, как вызвать математическую функцию.

По возврату из математической функции, если переменная errno ненулевая, а так же следующий вызов (смотрите fenv(3)) вернул ненулевое значение

```
fetestexcept(FE_INVALID | FE_DIVBYZERO | FE_OVERFLOW |

             FE_UNDERFLOW);
```

то ошибка произошла в математической функции.

Условия возникновения математических ошибок приведены ниже.

### Ошибка области
Ошибка области возникает, когда математической функции передаётся аргумент, чьё значение выходит за границы области, ожидаемой функцией (например, передача отрицательного значения в функцию log(3)). Когда возникает ошибка области, чаще всего, математические функции возвращают NaN (хотя некоторые функции в этом случае возвращают другое значение); errno присваивается EDOM возникает исключение плавающей запятой «invalid» (FE_INVALID).

### Ошибка особой точки
Ошибка особой точки возникает, когда результат математической функции должен быть равен бесконечности (например, логарифм 0 равен отрицательной бесконечности). Когда возникает ошибка особой точки функция возвращает значение (со знаком) HUGE_VAL, HUGE_VALF или HUGE_VALL, в зависимости от типа результата функции — double, float или long double. Знак результата будет математически корректным для функции. Переменной errno присваивается значение ERANGE и возникает исключение плавающей запятой «divide-by-zero» (FE_DIVBYZERO).

### Ошибка диапазона
Ошибка диапазона возникает, когда величина результата функции не может быть представлена типом результата функции. Возвращаемое значение функции зависит от того, было ли при ошибке диапазона переполнение или исчерпание.

Результат с плавающей запятой переполнен, если он является конечным значением, но слишком большим для представления типом результата. При возникновении переполнения функция возвращает значение HUGE_VAL, HUGE_VALF или HUGE_VALL, в зависимости от того, каков тип результата функции — double, float или long double. Переменной errno присваивается значение ERANGE и возникает переполнение плавающей запятой «overflow» (FE_OVERFLOW).

Результат с плавающей запятой потерял значимость, если он слишком мал для представления типом результата. При возникновении исчерпаемости математическая функция, обычно, возвращает 0.0 (в C99 сказано, что функция должна возвращать «определяемое реализацией» значение, чья величина не больше, чем самое маленькое положительное число заданного типа»). Переменной errno может быть присвоено значение ERANGE и может возникать переполнение плавающей запятой «overflow» (FE_UNDERFLOW).

Некоторые функции возвращают ошибку диапазона, ели значение аргумента или правильный результат функции был бы субнормальным. Субнормальное значение — ненулевое значение, но его величина так мала, что не может быть представлена в нормализованном виде (т. е., есть 1 с самом значимом бите значащей части). Представление субнормального числа будет содержать один или более начальных нулей в значащей части.

## ЗАМЕЧАНИЯ
Идентификатор math_errhandling, определённый в C99 и POSIX.1, не поддерживается в glibc. Данный идентификатор предполагается для указания какой из двух способов использован для уведомления об ошибке (errno, исключение, извлекаемое с помощью fettestexcept(3)). Стандарты требуют, чтобы использовался какой-то один, но допускают быть доступным обоим. На данный момент (версия 2.8) ситуация в glibc запутанная. Большинство (но не все) функций вызывают при ошибке исключение. Некоторые также изменяют errno. Несколько функций изменяют errno, но не вызывают исключение. Очень малое количество функций не делают ни того, ни другого. Всё это описано в их справочных страницах.

Чтобы при проверке ошибок избежать сложностей с использованием errno и fetestexcept(3) часто советуют перед вызовом проверять аргументы на некорректные значения. Например, следующий код проверяет, что аргумент log(3) не равен NaN и не равен нулю (ошибка особой точки) или меньше нуля (ошибка области):

```
double x, r;
if (isnan(x) || islessequal(x, 0)) {

    /* обработка NaN / ошибки особой точки / ошибки области */
}
r = log(x);
```

Данная страница не применима к комплексным математическим функциям (описанным в <complex.h>), для которых в C99 and POSIX.1, обычно, не требуется возвращать ошибки.

Параметр gcc(1) -fno-math-errno заставляет в исполняемых файлах вызывать реализации некоторых математических функций, которые быстрее стандартных, но не изменяющие errno при ошибке (параметр gcc(1) -ffast-math также включает -fno-math-errno.) Возникновение ошибки по-прежнему можно проверить с помощью fetestexcept(3).

## СМОТРИТЕ ТАКЖЕ
gcc(1), errno(3), fenv(3), fpclassify(3), INFINITY(3), isgreater(3), matherr(3), nan(3)

info libc