<commit_before>#lang scribble/base

@(require "shared.rkt")

@title{Textual Matters}

@; -----------------------------------------------------------------------------
@section{Indentation}

DrRacket indents code. Use it. If you wish to be a real friend of PLT, use
DrRacket all the time, and do request features and changes for things you
don't like.

Real friends of PLT use DrRacket to write their programs, and they don't
override DrRacket's indentation style. They accept it and leave it alone.
The resulting uniformity helps guide eyes.

@margin-note{Okay, okay. We are using emacs to write this guide.} Minor
friends of PLT use Emacs and/or vi(m).  Nevertheless, these minor friends
adjust their chosen editor so that it follows DrRacket's way of indenting
code.

One of the most important disagreements may concern @scheme[if]. So once
and for all:

@(racketmod
racket
#:file good
(if (positive? x)
    (send rocket-object launch)
    (redirect (- x)))
)

@(racketmod
racket
#:file bad
(if (positive? x)
  (send rocket-object launch)
  (redirect (- x)))
)

Also note that the then- and else-branches are separate entities, and each
entity deserves at least one line.

@; -----------------------------------------------------------------------------
@section{Line Width}

A line in Racket is at most 80 characters wide.

If you use Emacs to edit, create a line with ";; " followed by ctrl-U 77
and "-". Okay, use DrRacket to create such lines by holding down the dash
key.

@; -----------------------------------------------------------------------------
@section{Where to Put Parentheses}

Racket isn't C. Put all closing parentheses on one line.<commit_msg>[Style] notes to myself<commit_after>#lang scribble/base

@(require "shared.rkt")

@title{Textual Matters}

@; -----------------------------------------------------------------------------
@section{Indentation}

DrRacket indents code. Use it. If you wish to be a real friend of PLT, use
DrRacket all the time, and do request features and changes for things you
don't like.

Real friends of PLT use DrRacket to write their programs, and they don't
override DrRacket's indentation style. They accept it and leave it alone.
The resulting uniformity helps guide eyes.

@margin-note{Okay, okay. We are using emacs to write this guide.} Minor
friends of PLT use Emacs and/or vi(m).  Nevertheless, these minor friends
adjust their chosen editor so that it follows DrRacket's way of indenting
code.

One of the most important disagreements may concern @scheme[if]. So once
and for all:

@(racketmod
racket
#:file good
(if (positive? x)
    (send rocket-object launch)
    (redirect (- x)))
)

@(racketmod
racket
#:file bad
(if (positive? x)
  (send rocket-object launch)
  (redirect (- x)))
)

Also note that the then- and else-branches are separate entities, and each
entity deserves at least one line.

@; -----------------------------------------------------------------------------
@section{Line Width}

A line in Racket is at most 100 characters wide.

If you use Emacs to edit, create a line with ";; " followed by ctrl-U 77
and "-". Okay, use DrRacket to create such lines by holding down the dash
key.

@; -----------------------------------------------------------------------------
@section{Where to Put Parentheses}

Racket isn't C. Put all closing parentheses on one line.
{'fraction_non_alphanumeric': 0.20832086201736008, 'fraction_numerical': 0.0026938042502244837, 'mean_word_length': 2.2446601941747573, 'pattern_counts': {'":': 0, '<': 3, '<?xml version=': 0, '>': 3, 'https://': 0, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '4998438', 'n_tokens_mistral': 926, 'n_tokens_neox': 875, 'n_words': 428}