{"size": 2643, "ext": "scrbl", "max_stars_repo_path": "share/pkgs/compatibility-doc/mzlib/scribblings/include.scrbl", "max_stars_repo_name": "takikawa/racket-ppa", "max_stars_repo_stars_event_min_datetime": "2018-07-29T04:13:52.000Z", "max_stars_repo_stars_event_max_datetime": "2022-02-14T16:11:17.000Z", "max_issues_repo_path": "compatibility-doc/mzlib/scribblings/include.scrbl", "max_issues_repo_name": "NoahStoryM/compatibility", "max_issues_repo_issues_event_min_datetime": "2017-08-25T20:26:37.000Z", "max_issues_repo_issues_event_max_datetime": "2022-02-26T17:48:40.000Z", "max_forks_repo_path": "compatibility-doc/mzlib/scribblings/include.scrbl", "max_forks_repo_name": "NoahStoryM/compatibility", "max_forks_repo_forks_event_min_datetime": "2015-03-09T12:20:01.000Z", "max_forks_repo_forks_event_max_datetime": "2021-10-09T05:02:56.000Z"}
{"max_stars_count": 10, "max_issues_count": 15, "max_forks_count": 8, "avg_line_length": 37.2253521127, "max_line_length": 78, "alphanum_fraction": 0.6829360575}
#lang scribble/doc
@(require "common.rkt"
          (for-label mzlib/include))

@mzlib[#:mode title include]

@deprecated[@racketmodname[racket/include]]{}

Similar to @racketmodname[scheme/include], but with a different syntax
for paths.

@defform/subs[#:literals (build-path lib up same)
              (include path-spec)
              ([path-spec string
                          (build-path elem ...+)
                          (lib file-string collection-string ...)]
               [elem string
                     up
                     same])]{

Inlines the syntax in the designated file in place of the
@racket[include] expression. The @racket[path-spec] can be any of the
following:

@itemize[

 @item{A literal string that specifies a path to include, parsed
       according to the platform's conventions (which means that it is
       not portable).}

 @item{A path construction of the form @racket[(build-path elem
       ...+)], where @racket[build-path] is
       @racket[module-identifier=?] either to the @racket[build-path]
       export from @racket[mzscheme] or to the top-level
       @racket[build-path], and where each @racket[elem] is a path
       string, @racket[up] (unquoted), or @racket[same] (unquoted).
       The @racket[elem]s are combined in the same way as for the
       @racket[build-path] function to obtain the path to include.}

 @item{A path construction of the form @racket[(lib file-string
       collection-string ...)], where @racket[lib] is free or refers
       to a top-level @racket[lib] variable.  The
       @racket[collection-string]s are passed to
       @racket[collection-path] to obtain a directory; if no
       @racket[collection-strings]s are supplied, @racket["mzlib"] is
       used. The @racket[file-string] is then appended to the
       directory using @racket[build-path] to obtain the path to
       include.}

]

If @racket[path-spec] specifies a relative path to include, the path
is resolved relative to the source for the @racket[include]
expression, if that source is a complete path string. If the source is
not a complete path string, then @racket[path-spec] is resolved
relative to the current load relative directory if one is available,
or to the current directory otherwise.

The included syntax is given the lexical context of the
@racket[include] expression.}

@deftogether[(
@defform[(include-at/relative-to context source path-spec)]
@defform[(include-at/relative-to/reader context source path-spec reader-expr)]
@defform[(include/reader path-spec reader-expr)]
)]{

Variants of @racket[include] analogous to the variants of
@racketmodname[scheme/include].}

