From cde50f109105109697c9d2c0e76b9f42d223bbb1 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Xristoph=20Hinterm=C3=BCller?= Date: Mon, 25 Sep 2017 12:54:50 +0200 Subject: Added advanced c-sharp linter The existing c-charp linter used the --syntax check mode of the mono mcs compiler only. The new mcsc linter tries to compile the files located in a directory tree located bejond the specified source directory or the current one if no source is explicitly specified. The resulting module target is placed in a temporary file managed by ale. --- doc/ale-cs.txt | 75 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 75 insertions(+) create mode 100644 doc/ale-cs.txt (limited to 'doc') diff --git a/doc/ale-cs.txt b/doc/ale-cs.txt new file mode 100644 index 00000000..357d7387 --- /dev/null +++ b/doc/ale-cs.txt @@ -0,0 +1,75 @@ +=============================================================================== +ALE C# Integration *ale-cs-options* + + +=============================================================================== +mcs *ale-cs-mcs* + + The mcs linter calls the mono mcs compiler setting the --parse and -unsafe + flags. + +g:ale_cs_mcs_options *g:ale_cs_mcs_options* + *b:ale_cs_mcs_options* + + Type: String + Default: `''` + + This variable can be changed to modify flags given to mcs. The options + --parse and -unsafe are implicitly set. + + +=============================================================================== +mcsc *ale-cs-mcsc* + + The mcsc linter uses the mono mcs compiler to generate a temporary module + target file (-t:module) including all '*.cs' files contained in the + directory by specified by |g:ale_cs_mcsc_source| or |b:ale_cs_mcsc_source| + variable and all sub directories. Currently none can be excluded from + linting. It uses the assembly directories as specified by + |g:ale_cs_mcsc_assembly_path| or |b:ale_cs_mcsc_assembly_path| and selects + the assembly files specified by |g:ale_cs_mcsc_assemblies| or + |b:ale_cs_mcsc_assemblies|. The mcs -unsafe option is set implicitly and has + not to be added using |g:ale_cs_mcsc_options| or |b:ale_cs_mcsc_options| + variable. + +g:ale_cs_mcsc_options *g:ale_cs_mcsc_options* + *b:ale_cs_mcsc_options* + Type: |String| + Default: `''` + + This variable can be set to set further options for example adding packages + (eg.: -pkg:dotnet) with are not added per default. + +g:ale_cs_mcsc_source *g:ale_cs_mcsc_source* + *b:ale_cs_mcsc_source* + Type: |String| + Default: `''` + + This variable defines the base path of the directory tree the '*.cs' files + should be included into the compilation of the temporary module. If empty + the current directory is used. + +g:ale_cs_mcsc_assembly_path *g:ale_cs_mcsc_assembly_path* + *b:ale_cs_mcsc_assembly_path* + Type: |List| + Default: `[]` + + This variable defines a list of absolute or relative path strings pointing + to the location of the assembly files (*.dll) to be considered by mcsc + linter. If the list is not empty the list will be added to the mcsc command + line using the -lib: flag of mcs. + +g:ale_cs_mcsc_assemblies *g:ale_cs_mcsc_assemblies* + *b:ale_cs_mcsc_assemblies* + Type: |List| + Default: `[]` + + This variable defines a list of assembly files (*.dll) to be considered by + the mono mcs compiler when generating the temporary module. If the list is + not empty the list of assemblies will be added to the mcsc command + line using the -r: flag of mcs. To change the search path mcs uses to + locate the specified assembly files use |g:ale_cs_mcsc_assembly_path| or + |b:ale_cs_mcsc_assembly_path| variables + +=============================================================================== + vim:tw=78:ts=2:sts=2:sw=2:ft=help:norl: -- cgit v1.2.3