Files
mercury/compiler/mmc_analysis.m
Zoltan Somogyi 2afa32259a Carve four new modules out of unused_args.m.
compiler/unused_args_analysis.m:
    New module containing the parts of the old unused_args.m
    that deal with the intermodule analysis framework.

compiler/unused_args_base_ops.m:
    New module containing the parts of the old unused_args.m
    that define and operate on the main data structure we use
    to find out which variables are unused.

compiler/unused_args_optimize.m:
    New module containing the parts of the old unused_args.m
    that "optimize out" unused arguments.

compiler/unused_args_warn_pragma.m:
    New module containing the parts of the old unused_args.m
    that generate warnings about unused arguments, and that generate
    unused_args pragmas for .opt files. The module contains both
    because they share the same test for whether we want to ignore
    any unused arguments in a predicate.

compiler/unused_args.m:
    Delete the moved code.

compiler/transform_hlds.m:
compiler/notes/compiler_design.html:
    Include and document the new modules.

compiler/mercury_compile_middle_passes.m:
compiler/mmc_analysis.m:
    Conform to the changes above.
2026-02-24 02:32:37 +11:00

168 lines
6.1 KiB
Mathematica

%-----------------------------------------------------------------------------%
% vim: ft=mercury ts=4 sw=4 et
%-----------------------------------------------------------------------------%
% Copyright (C) 2003-2006, 2008-2012 The University of Melbourne.
% Copyright (C) 2014-2020, 2022-2026 The Mercury team.
% This file may only be copied under the terms of the GNU General
% Public License - see the file COPYING in the Mercury distribution.
%-----------------------------------------------------------------------------%
%
% File: mmc_analysis.m.
% Main author: stayl.
%
% Specify Mercury compiler analyses to be used with the inter-module analysis
% framework.
%
%-----------------------------------------------------------------------------%
:- module transform_hlds.mmc_analysis.
:- interface.
:- import_module analysis.
:- import_module analysis.framework.
:- import_module hlds.
:- import_module hlds.hlds_module.
:- import_module hlds.hlds_pred.
:- import_module mdbcomp.
:- import_module mdbcomp.sym_name.
%-----------------------------------------------------------------------------%
:- type mmc
---> mmc.
:- instance compiler(mmc).
:- pred ppid_to_module_name_func_id(module_info::in, pred_proc_id::in,
module_name::out, func_id::out) is det.
:- pred pred_info_proc_id_to_module_name_func_id(pred_info::in, proc_id::in,
module_name::out, func_id::out) is det.
:- pred func_id_to_ppid(module_info::in, module_name::in,
func_id::in, pred_proc_id::out) is det.
%-----------------------------------------------------------------------------%
%-----------------------------------------------------------------------------%
:- implementation.
:- import_module analysis.operations.
:- import_module hlds.pred_table.
:- import_module libs.
:- import_module libs.globals.
:- import_module parse_tree.
:- import_module parse_tree.file_names.
:- import_module parse_tree.find_module.
:- import_module transform_hlds.ctgc.
:- import_module transform_hlds.ctgc.structure_reuse.
:- import_module transform_hlds.ctgc.structure_reuse.analysis.
:- import_module transform_hlds.ctgc.structure_sharing.
:- import_module transform_hlds.ctgc.structure_sharing.analysis.
:- import_module transform_hlds.exception_analysis.
:- import_module transform_hlds.tabling_analysis.
:- import_module transform_hlds.trailing_analysis.
:- import_module transform_hlds.unused_args_analysis.
:- import_module io.
:- import_module list.
:- import_module maybe.
:- import_module unit.
%-----------------------------------------------------------------------------%
:- instance compiler(mmc) where [
compiler_name(mmc) = "mmc",
analyses(mmc, Name, Analysis) :-
(
Name = "mm_tabling_analysis",
Analysis = 'new analysis_type'(
unit1 : unit(any_call),
unit1 : unit(mm_tabling_analysis_answer))
;
Name = "trail_usage",
Analysis = 'new analysis_type'(
unit1 : unit(any_call),
unit1 : unit(trailing_analysis_answer))
;
Name = "exception_analysis",
Analysis = 'new analysis_type'(
unit1 : unit(any_call),
unit1 : unit(exception_analysis_answer))
;
Name = "unused_args",
Analysis = 'new analysis_type'(
unit1 : unit(unused_args_call),
unit1 : unit(unused_args_answer))
;
Name = "structure_sharing",
Analysis = 'new analysis_type'(
unit1 : unit(structure_sharing_call),
unit1 : unit(structure_sharing_answer))
;
Name = "structure_reuse",
Analysis = 'new analysis_type'(
unit1 : unit(structure_reuse_call),
unit1 : unit(structure_reuse_answer))
),
module_name_to_read_file_name(mmc, Globals, Ext,
ModuleName, MaybeFileName, !IO) :-
mmc_module_name_to_read_file_name(Globals, Ext,
ModuleName, MaybeFileName, !IO),
module_name_to_write_file_name(mmc, Globals, Ext,
ModuleName, FileName, !IO) :-
mmc_module_name_to_write_file_name(Globals, Ext,
ModuleName, FileName, !IO)
].
:- pred mmc_module_name_to_read_file_name(globals::in,
ext::in(ext_analysis), module_name::in, maybe_error(string)::out,
io::di, io::uo) is det.
mmc_module_name_to_read_file_name(Globals, Ext,
ModuleName, MaybeFileName, !IO) :-
SearchWhichDirs = search_intermod_dirs,
% XXX LEGACY
module_name_to_search_file_name(Globals, $pred, Ext, ModuleName,
SearchWhichDirs, SearchAuthDirs, FileName0, _FileName0Proposed),
search_for_file(SearchAuthDirs, FileName0,
_SearchDirs, MaybeFileName, !IO).
:- pred mmc_module_name_to_write_file_name(globals::in,
ext::in(ext_analysis), module_name::in, string::out,
io::di, io::uo) is det.
mmc_module_name_to_write_file_name(Globals, Ext,
ModuleName, FileName, !IO) :-
% XXX LEGACY
module_name_to_file_name_create_dirs(Globals, $pred, Ext,
ModuleName, FileName, _FileNameProposed, !IO).
ppid_to_module_name_func_id(ModuleInfo, proc(PredId, ProcId),
PredModule, FuncId) :-
module_info_pred_info(ModuleInfo, PredId, PredInfo),
pred_info_proc_id_to_module_name_func_id(PredInfo, ProcId,
PredModule, FuncId).
pred_info_proc_id_to_module_name_func_id(PredInfo, ProcId,
PredModule, FuncId) :-
PredModule = pred_info_module(PredInfo),
PredName = pred_info_name(PredInfo),
PredOrFunc = pred_info_is_pred_or_func(PredInfo),
PredFormArity = pred_info_pred_form_arity(PredInfo),
FuncId = func_id(PredOrFunc, PredName, PredFormArity, ProcId).
func_id_to_ppid(ModuleInfo, ModuleName, FuncId, PPId) :-
FuncId = func_id(PredOrFunc, FuncName, PredFormArity, ProcId),
module_info_get_predicate_table(ModuleInfo, PredTable),
predicate_table_lookup_pf_fqm_n_a(PredTable, PredOrFunc,
ModuleName, FuncName, PredFormArity, PredId),
PPId = proc(PredId, ProcId).
%-----------------------------------------------------------------------------%
:- end_module transform_hlds.mmc_analysis.
%-----------------------------------------------------------------------------%