Руководство по стилю языка tcl

Ray Johnson, “Руководство по стилю языка tcl”, public translation into Russian from English More about this translation.

See also 128 similar translations

Translate into another language.

Participants

intekus2780 points
shirker542 points
Join Translated.by to translate! If you already have a Translated.by account, please sign in.
If you do not want to register an account, you can sign in with OpenID.
Pages: ← previous Ctrl next next untranslated

Руководство по стилю языка tcl

Руководство по стилю языка tcl

History of edits (Latest: intekus 1 year, 2 months ago) §

*for comments*

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

History of edits (Latest: intekus 5 months, 1 week ago) §

— Понять бы вообще о чем речь))))) shirker

чмаффки всем кто в этам чяти :-* shirker

— Не пугай людей :) Ты же уже хорошо помог. intekus

*glossary*

*Глоссарий*
convention - соглашение (не "правило")
exercize (code) - исполнять
John Ousterhout - Джон Оустерхаут, вариант написания взят из Википедии
Tcl/Tk Engineering Manual - Техническое Руководство по Tcl/Tk (не "инженерное")
test case - тестовый пример
test suite - тестовый комплект / комплект тестов

History of edits (Latest: intekus 1 year, 1 month ago) §

1. Introduction

1. Введение

History of edits (Latest: intekus 1 year, 2 months ago) §

This is a manual for people who are developing Tcl code for Wish or any other Tcl application. It describes a set of conventions for writing code and the associated test scripts. There are three reasons for the conventions. First, the conventions ensure that certain important things get done; for example, every procedure must have documentation that describes each of its arguments and its result, and there must exist test scripts that exercise every line of code. Second, the conventions guarantee that all of the Tcl and Tk code has a uniform style. This makes it easier for us to use, read, and maintain each other’s code. Third, the conventions help to avoid some common mistakes by prohibiting error-prone constructs such as building lists by hand instead of using the list building procedures.

Это руководство предназначено для людей, которые занимаются разработкой tcl-кода для интерпретатора Wish или каких-либо других tcl-приложений. Оно описывает набор соглашений по созданию кода и связанных с ним тестовых скриптов. Появление этих соглашений обусловлено тремя причинами. Во-первых, соглашения обеспечивают то, что определённые важные вещи будут сделаны; например - что каждую процедуру следует снабжать документацией, описывающей каждый из аргументов и возвращаемое значение; или то, что должны существовать тестовые скрипты, исполняющие каждую строку кода. Во-вторых, соглашения обеспечивают единство стиля всего кода Tcl и Tk. Это позволяет различным разработчикам легче использовать, читать и поддерживать код друг друга. В-третьих, соглашения помогают избежать некоторых распространённых ошибок, запрещая чреватые ими конструкции языка - такие как, например, ручное создание списков вместо использования специальной процедуры их построения.

History of edits (Latest: intekus 5 months, 1 week ago) §

— возможно не соглашений, а рекомендаций? shirker

"соглашения удостоверяют" - коряво shirker

— convention - это именно договорённость, соглашение между какими-то сторонами; пусть будет ""обеспечивают intekus

This document is based heavily on the Tcl/Tk Engineering Manual written by John Ousterhout. John’s engineering manual specified the style of the C code used in the implementation of Tcl/Tk and many of its extensions. The manual is very valuable to the development of Tcl/Tk and is an important reason why Tcl is a relatively easy system to maintain.

Этот документ в основном базируется на Техничеком Руководстве по Tcl/Tk, написанном Джоном Оустерхаутом. Изначально оно устанавливало стиль кода на языке C (Си), использовавший при реализации Tcl/Tk и множества расширений. Это Руководство является очень существенным для разработки Tcl /Tk. Во многом именно благодаря ему Tcl является системой, довольно лёгкой в поддержке.

History of edits (Latest: intekus 5 months, 1 week ago) §
Pages: ← previous Ctrl next next untranslated